MariaDB 로고

관계형 엔진

연결하다 MariaDB 엑셀, 구글 시트, AI 및 REST로

MySQL과 호환되는 관계형 엔진입니다. SkySQL 및 자체 호스팅 클러스터를 포함한 대부분의 MySQL 워크로드에 바로 사용할 수 있습니다.

하나의 연결, 모든 표면

MariaDB 데이터가 저장될 수 있는 위치

Query Streams는 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 비서 및 REST 엔드포인트에서 MariaDB 데이터베이스를 실시간 SQL로 읽어옵니다. 자체 호스팅 에이전트는 네트워크 내부에서 3306번 포트를 통해 외부로 연결되므로 인바운드 포트, VPN 또는 IP 허용 목록이 필요하지 않습니다. MariaDB는 MySQL을 다른 이름으로 인식하는 것이 아니라 그 자체로 인식됩니다. 에이전트는 연결 시 서버 배너를 읽고 실제 제품 및 버전을 보고하므로 잘못된 문서를 참조하여 디버깅하는 일이 없습니다.

  1. 귀사 팀, 협력업체 및 파트너 여러분께
  2. MariaDB를 Excel로 마이크로소프트 엑셀 · 엑셀 추가 기능

    MariaDB의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. 데스크톱 Excel, Excel Online, Microsoft 365에서 사용 가능합니다.

    MariaDB 가이드
  3. MariaDB에서 Google Sheets로 스프레드시트 추가 기능

    사이드바에서 저장된 MariaDB 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.

    MariaDB 가이드
  4. Nova에게 MariaDB에 대해 문의하세요. Nova AI · 텍스트를 SQL로 변환

    쉬운 영어로 질문하세요. Nova는 이미 사용자의 MariaDB 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 계정 정보를 제공할 필요가 없습니다.

    Nova는 어떻게 작동하나요?
  5. MariaDB에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱

    MariaDB 실행 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유하세요. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 수 있고, SQL 쿼리나 계정 정보는 절대 볼 수 없습니다.

    데이터 뷰어 작동 방식
  6. 앱 및 시스템용
  7. MariaDB REST API HTTP 엔드포인트

    인증된 JSON 엔드포인트로 MariaDB 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양을 지원하며 Postman, Insomnia, Hoppscotch 컬렉션이 이미 준비되어 있습니다. 데이터베이스 포트는 열지 않습니다.

    MariaDB 가이드
  8. MariaDB에서 Power BI로 파워 쿼리 M

    생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 MariaDB 결과를 실시간으로 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.

    Power BI 작동 방식
  9. MariaDB에서 Airtable로 자동화 플랫폼

    MariaDB 행을 예약된 시간에 Airtable 데이터베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 행을 가져올 수 있습니다.

    MariaDB 가이드
  10. MariaDB에서 Baserow로 자동화 플랫폼

    MariaDB에서 Baserow 테이블을 REST 엔드포인트를 통해 제공합니다(자체 호스팅 또는 Baserow 클라우드 환경).

    MariaDB 가이드
  11. MariaDB에서 SeaTable로 자동화 플랫폼

    파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 MariaDB 데이터로 최신 상태로 유지하세요.

    MariaDB 가이드
  12. MariaDB에서 Smartsheet로 자동화 플랫폼

    MariaDB 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기 데이터가 아닌 원본 시스템의 데이터를 읽도록 합니다.

    MariaDB 가이드
  13. MariaDB에서 Anvil로 앤빌 웍스 · 앱 플랫폼

    Anvil Python 앱을 MariaDB로 백업하려면 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하면 됩니다.

    MariaDB 가이드
  14. AI 도구의 경우
  15. MariaDB MCP 서버 Claude, Cursor 및 MCP 고객

    AI 비서에게 올바른 SQL 쿼리를 작성하는 데 필요한 스키마와 함께 MariaDB에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅에서 자격 증명을 입력할 필요는 없습니다.

    MariaDB 가이드
  16. 사람들에게 전달됨
  17. MariaDB 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅

    MariaDB 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.

    알림 및 보고서 작동 방식

작동 방식

5단계, 인바운드 방화벽 변경 없음

01

서버에 이미 접속 가능한 시스템(자체 호스팅 클러스터, SkySQL 또는 동일 호스트의 컨테이너)에 네트워크 에이전트를 설치하십시오.

02

호스트, 포트, 데이터베이스, 사용자 이름 및 비밀번호를 입력하십시오. 서버에서 TLS를 지원하는 경우 활성화하십시오. 클라이언트 인증서가 필요한 경우 사용할 수 있습니다.

03

에이전트는 서버 배너를 읽고 MySQL이 아닌 MariaDB인지 확인한 다음 테이블 및 열 레이아웃을 읽어 쿼리 빌더가 실제 이름을 제공할 수 있도록 합니다.

04

읽기 전용 SQL을 직접 작성하거나 Nova가 작성하도록 할 수 있습니다. 필터는 사용자가 선언하는 @변수이거나 커넥터가 WHERE 절에 배치하는 리터럴 값일 수 있습니다.

05

Excel, Sheets, Power BI, MCP 또는 REST에서 저장된 쿼리를 읽고, 해당 쿼리문을 전혀 보지 못하는 사람과 공유할 수 있습니다.

기능 심층 분석

MariaDB가 제공하는 기능

실제 MariaDB 데이터의 어색한 부분

MariaDB는 MySQL의 관대한 특성을 계승했으며, 장기간 사용되는 스키마에는 이러한 특성이 많이 나타납니다. 이러한 특성은 회피하기보다는 처리됩니다.

  • 제로 데이트 — '0000-00-00'은 대부분의 클라이언트에서 합법적이지만 치명적인 오류를 발생시킵니다. 전체 쿼리를 처리하는 대신 빈 날짜로 인식되기 때문입니다.
  • tinyint는 tinyint를 의미합니다. — tinyint(1)는 일반적인 부울이며 true 또는 false로 나타나지만 일반 tinyint는 작은 정수로 유지됩니다.
  • 정확한 소수점 - 소수점 열은 지정한 정밀도와 비율을 유지합니다. 자금이 나갈 때 변동 금액으로 바뀌지 않습니다.
  • 기본 인코딩이 utf8mb4이므로 이모티콘과 모든 CJK 문자가 그대로 유지됩니다.
  • 데이터베이스 간 조인은 하나의 연결에서 작동합니다. — 로그인 계정이 동일 서버에 있는 두 개의 데이터베이스를 볼 수 있다면, 하나의 쿼리로 두 데이터베이스 모두를 읽을 수 있습니다.

설정한 적 없는 플러그인 이름을 입력하여 로그인이 실패하는 경우

시간을 들여 작업하기 전에 알아두면 좋습니다. MariaDB는 인식하지 못하는 계정에 대한 로그인 시도에 대해 의도적으로 조작된 핸드셰이크 응답을 보냅니다. 이는 공격자가 오류 메시지를 통해 어떤 사용자 이름이 존재하는지 알아낼 수 없도록 하기 위한 것입니다. MariaDB가 언급하는 플러그인은 종종 auth_gssapi_client인데, 이 때문에 오류가 마치 Kerberos 문제처럼 보이지만 실제로는 전혀 관련이 없습니다.

  • 이는 서버 동작이지 쿼리 스트림 동작이 아닙니다. 즉, 해당 계정이 존재하지 않거나 에이전트가 실행되는 호스트에서 권한이 부여되지 않았다는 의미입니다.
  • 실제로 존재하는 계정의 경우 단순히 '접근 거부'라는 오류 메시지가 표시되므로 두 가지를 쉽게 구분할 수 있습니다. 실제 존재하는 사용자 이름에 대해 일부러 잘못된 비밀번호를 입력해 보세요.
  • 문제는 서버에 있습니다. — 사용자를 생성하고 에이전트의 호스트 이름 또는 '%'를 사용하여 권한을 부여합니다.

연합 조인은 데이터베이스 이름을 사용합니다.

MariaDB는 데이터베이스와 테이블 사이에 스키마 계층이 없으므로, 세 부분으로 구성된 이름의 중간 부분은 데이터베이스 자체가 됩니다.

-- shop_prod는 연결 이름이고, sales는 MariaDB 데이터베이스입니다. SELECT c.region, COUNT(*) AS orders FROM shop_prod.sales.orders o JOIN pg_crm.public.customers c ON c.id = o.customer_id GROUP BY c.region

모든 데이터베이스 커넥터에서 공유됨

모든 데이터베이스 커넥터에 해당되는 사항입니다.

  • 출국 전용 — 에이전트는 쿼리 스트림으로 암호화된 연결을 하나만 엽니다. 포트 포워딩도 필요 없고, VPN도 필요 없고, IP 허용 목록도 필요 없으며, 데이터베이스 정보가 인터넷에 노출되는 것도 없습니다.
  • 자격 증명은 그대로 유지됩니다. — 데이터베이스 사용자 이름과 비밀번호는 에이전트를 설치한 컴퓨터에 있습니다. Query Streams는 이러한 정보를 수신하지 않으며 자체적으로 데이터베이스에 접근할 수 없습니다.
  • 읽기 전용, 강제 적용됨 — 한 번에 하나의 명령문만 사용 가능하며, SELECT 및 관련 명령만 허용됩니다. 쓰기 작업은 서버로 전송되기 전에 사용자 컴퓨터에서 거부되므로, 다른 사용자가 설정해 둔 권한에 의존하지 않습니다.
  • 원하는 만큼 에이전트를 배포하세요 사이트, 지역 또는 클라우드별로 하나씩만 있으면 됩니다. 모든 데이터 소스가 단일 드롭다운 메뉴에 표시되므로 어떤 에이전트가 무엇을 호스팅하는지 알 필요가 없습니다.

쿼리가 저장되면 다음과 같은 결과가 나타납니다.

  • SQL이 아니라 기능을 공유하세요. — 동료나 외부 파트너는 쿼리를 실행하고 해당 쿼리의 바탕이 된 구문을 전혀 보지 않고도 필터를 변경할 수 있습니다.
  • 양방향 필터 — 직접 @variables로 선언하거나, 커넥터가 WHERE 절에 이미 있는 리터럴 값을 감지하여 드롭다운 메뉴로 제공하도록 할 수 있습니다.
  • 어디서든 읽어보세요 — Microsoft Excel, Google Sheets, Power BI, REST API, MCP 기반 AI 비서, 쿼리 빌더 및 Nova는 모두 동일한 저장된 쿼리를 읽습니다.
  • 여러 개를 동시에 실행하세요 — 5개의 저장된 쿼리가 5개의 워크시트 탭에 동시에 스트리밍되며, 결과 크기에 관계없이 실행됩니다.
  • 이미 연결된 다른 항목과 연결하세요. — 다른 데이터베이스, 비즈니스 API 또는 파일 폴더를 하나의 읽기 전용 명령으로 액세스할 수 있습니다.

크로스 소스 SQL

MariaDB를 나머지 데이터와 결합하세요

하나의 명령문으로 MariaDB와 다른 연결들을 동시에 실행할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 스트리밍으로 전송하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며, 어떤 데이터도 복사되지 않습니다.

3개의 연결 · 3명의 에이전트

MariaDB 관계형 엔진
PostgreSQL 관계형 엔진
스트라이프 결제 및 청구

한 가지 진술

-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM     샵_프로드.shopdb.orders1 f
JOIN     pg_crm.공개.고객2 c ON c.id = f.customer_id
JOIN     청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 c.지역
주문 기준 청구서 발행 DESC;

세 가지 요소는 연결, 스키마, 테이블이며, 연결 이름은 사용자가 지정한 대로 지정할 수 있습니다. 열은 예시일 뿐이며, 테이블은 실제 테이블이어야 합니다. 모든 부분은 읽기 전용으로 적용됩니다. SELECT, WITH, EXPLAIN만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식

연결 정보

MariaDB에 필요한 것

포트
기본값은 3306이며, 모든 포트가 허용됩니다.
암호화
TLS는 선택 사항입니다. 활성화하지 않으면 비활성화되지만, 활성화하면 권장 사항이 아닌 필수 사항이 됩니다. CA, 클라이언트 인증서 및 키가 허용됩니다.
자격 증명
에이전트에 저장된 데이터베이스 사용자 이름과 비밀번호입니다. 쿼리 스트림은 이러한 정보를 수신하지 않습니다.
운전사
MySQLConnector 2.5.0은 번들로 제공되므로 서버나 클라이언트에 별도로 설치할 필요가 없습니다.
서버 감지
배너는 연결 시 읽히므로 보고되는 제품 및 버전 정보는 MariaDB 자체 정보입니다.
문자 세트
utf8mb4 형식이라 이모지와 CJK 전체 문자가 왕복 과정에서 손상되지 않고 그대로 전달됩니다.
레거시 데이트
'0000-00-00'은 오류를 발생시키는 대신 빈 날짜로 읽힙니다.
타임아웃
연결하는 데 30초, 스트리밍 중에는 각 문장당 30초가 소요됩니다.
읽기 전용
서버로 전송되기 전에 사용자 컴퓨터에서 먼저 적용됩니다.

MariaDB와 MySQL은 와이어 프로토콜을 공유하므로 여기서는 드라이버를 공유하지만, 동일한 제품으로 취급되지는 않습니다. 에이전트는 모든 연결 테스트에서 서버 배너를 읽고 MariaDB 자체 버전 문자열을 보고하는데, 이는 사용하려는 함수가 포크된 서버에 존재하는지 여부를 알아야 할 때 중요합니다.

여러 소스를 연결하는 쿼리에서 3부분으로 구성된 참조의 중간 부분은 MariaDB 데이터베이스 이름입니다. MariaDB에는 별도의 스키마 계층이 없기 때문입니다. 예를 들어, shop_prod라는 연결이 sales 데이터베이스를 읽는 경우 shop_prod.sales.orders와 같이 기록됩니다.

공급업체 문서: mariadb.org

자주 묻는 질문

MariaDB 관련 질문

쿼리 스트림을 통해 MariaDB 데이터를 읽을 수 있는 도구는 무엇입니까?

Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.

MariaDB 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?

아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.

쿼리 스트림을 사용하여 MariaDB의 데이터를 변경할 수 있습니까?

아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.

Query Streams가 MariaDB에 연결하려면 무엇이 필요합니까?

접근 가능한 호스트, 역할 및 암호 - 에이전트에 드라이버가 포함되어 있으므로 데이터베이스에는 아무것도 설치되지 않습니다. 포트: 기본값은 3306이며, 모든 포트가 허용됩니다. 암호화: TLS는 선택 사항이며, 활성화하지 않으면 비활성화됩니다. 활성화하면 권장 사항이 아닌 필수 사항이 됩니다. CA, 클라이언트 인증서 및 키가 허용됩니다. 자격 증명: 에이전트에 저장된 데이터베이스 사용자 이름과 암호. 쿼리 스트림은 이러한 자격 증명을 수신하지 않습니다. 드라이버: MySqlConnector 2.5.0이 번들로 제공되므로 서버나 클라이언트에 설치할 필요가 없습니다.

MariaDB를 다른 데이터베이스와 동일한 쿼리로 조인할 수 있나요?

네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 MariaDB와 다른 연결을 동시에 참조할 수 있으며, 연결.스키마.테이블 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 반환합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 스케줄링도 발생하지 않습니다. 읽기 전용은 SELECT, WITH, EXPLAIN 절에만 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

MariaDB를 작업이 이루어지는 곳에 두세요.

에이전트를 설치하고, 데이터베이스를 지정한 다음, 설치 위치를 선택하십시오.

읽기 전용 출국 전용 자격 증명은 에이전트에 저장됩니다.