하나의 연결, 모든 표면
DuckDB 데이터가 저장될 수 있는 곳
- 1 발신 연결
- 0 입국항
- 읽기 전용 · 자격 증명은 그대로 유지됩니다
실행 중
- 귀사 팀, 협력업체 및 파트너 여러분께
-
Excel 추가 기능 · 필요에 따라 새로 고침
-
Google 스프레드시트 추가 기능 · 필요에 따라 새로 고침
-
Nova AI 쉬운 말로 질문해 주세요 · 텍스트를 SQL로 변환
-
데이터 뷰어 실시간 결과 공유 · 팀, 협력업체, 파트너 · 모든 기기에서
- 앱 및 시스템용
-
REST API JSON 엔드포인트 · OpenAPI 3.1
-
파워 BI 파워 쿼리 M
-
예약된 동기화 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- AI 도구의 경우
-
AI 비서 클로드 · 커서 · MCP 서버
- 사람들에게 전달됨
-
알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
Query Streams는 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 비서 및 REST 엔드포인트에서 DuckDB 파일을 실시간 SQL로 읽어옵니다. 별도의 서버를 실행하거나 다른 곳에 아무것도 로드할 필요가 없습니다. 엔진이 에이전트에 내장되어 있으므로 디스크의 .duckdb 파일이 데이터베이스 역할을 합니다. 사용자가 작성한 SQL은 DuckDB에 그대로 전달되므로 GROUP BY ALL, QUALIFY, SELECT * EXCLUDE, 리스트 및 구조체 접근과 같이 사용자들이 DuckDB를 선택하는 주요 기능들이 모두 정상적으로 작동하며, 공통 분모로 평준화되지 않습니다.
- 귀사 팀, 협력업체 및 파트너 여러분께
-
DuckDB를 Excel로 마이크로소프트 엑셀 · 엑셀 추가 기능
DuckDB의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)
DuckDB 가이드 -
「Anvil.works Snowflake 통합 – 실시간 데이터베이스 데이터 자동 동기화」에 대한 리뷰 스프레드시트 추가 기능
사이드바에서 저장된 DuckDB 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
DuckDB 가이드 -
Nova에게 DuckDB에 대해 물어보세요 Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 사용자의 DuckDB 테이블을 알고 있으므로 SQL 쿼리를 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 직접 작성하거나 계정 정보를 제공할 필요가 없습니다.
Nova는 어떻게 작동하나요? -
DuckDB에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
DuckDB의 실시간 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유하세요. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침됩니다. 상대방은 결과만 볼 수 있고, SQL 쿼리나 계정 정보는 절대 볼 수 없습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
DuckDB REST API HTTP 엔드포인트
DuckDB 쿼리를 인증된 JSON 엔드포인트로 게시하여 모든 애플리케이션에서 호출할 수 있도록 지원합니다. OpenAPI 3.1 사양을 제공하며 Postman, Insomnia, Hoppscotch 컬렉션을 바로 사용할 수 있습니다. 데이터베이스 포트는 열지 않습니다.
DuckDB 가이드 -
DuckDB에서 Power BI로 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 ODBC 드라이버나 데이터베이스 포트를 열 필요 없이 HTTPS를 통해 DuckDB의 실시간 결과를 읽어옵니다.
Power BI 작동 방식 -
DuckDB에서 Airtable로 자동화 플랫폼
DuckDB 행을 예약된 시간에 Airtable 베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.
DuckDB 가이드 -
DuckDB에서 Baserow로 자동화 플랫폼
DuckDB에서 Baserow 테이블로 데이터를 REST 엔드포인트를 통해 전송하세요. 자체 호스팅 환경이든 Baserow 클라우드 환경이든 상관없습니다.
DuckDB 가이드 -
DuckDB에서 SeaTable로 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 DuckDB 데이터로 최신 상태로 유지하세요.
DuckDB 가이드 -
DuckDB에서 Smartsheet로 자동화 플랫폼
DuckDB 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기 데이터가 아닌 원본 시스템의 데이터를 읽도록 합니다.
DuckDB 가이드 -
DuckDB에서 Anvil까지 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 DuckDB로 백업할 때 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하는 방법입니다.
DuckDB 가이드 - AI 도구의 경우
-
DuckDB MCP 서버 Claude, Cursor 및 MCP 고객
AI 비서에게 DuckDB에 대한 읽기 전용 액세스 권한과 올바른 SQL 쿼리를 작성하는 데 필요한 스키마를 제공하세요. 채팅에서 자격 증명을 입력할 필요는 없습니다.
DuckDB 가이드 - 사람들에게 전달됨
-
DuckDB 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
DuckDB 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송받거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 넘을 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
파일이 있는 컴퓨터에 네트워크 에이전트를 설치하세요. DuckDB 서버를 구축하거나 포트를 열 필요가 없습니다. 모든 기능은 에이전트 내부에 내장되어 있습니다.
로컬 디스크 또는 해당 컴퓨터가 접근할 수 있는 공유 폴더에 있는 .duckdb, .db 또는 .ddb 파일을 가리키도록 설정하십시오.
에이전트는 파일의 테이블과 뷰를 읽고 열 유형을 기록하므로 쿼리 빌더와 Nova는 사용자가 코드를 작성하기 전에 테이블의 구조를 알 수 있습니다.
DuckDB SQL 문을 직접 작성하거나, 원하는 내용을 설명하면 Nova가 자동으로 생성해 줍니다. 이 과정에서 번역 작업은 전혀 필요하지 않습니다.
Microsoft Excel, Google Sheets, Power BI, MCP 또는 REST에서 저장된 쿼리를 읽고 필요한 경우 다른 연결과 결합합니다.
기능 심층 분석
DuckDB가 제공하는 기능
파일 형태의 분석 엔진
DuckDB는 컬럼형 벡터화 방식을 사용하는데, 이는 기술적으로 노트북에서 수백만 개의 행을 문제없이 집계할 수 있다는 뜻입니다. 이러한 특징 때문에 스프레드시트 뒤에 DuckDB를 연결해 사용하는 것은 특이하면서도 매우 유용한 작업입니다.
- 서버도, 서비스도, 포트도 필요 없습니다. 파일 자체가 데이터베이스이며, 엔진은 해당 파일을 읽는 에이전트 내부에서 실행됩니다.
- 집계는 파일이 저장된 컴퓨터의 DuckDB에서 이루어집니다. 네트워크를 통해 전송되는 것은 그 결과입니다. — 보통 수억 개의 행 중에서 몇백 개 정도만 해당됩니다.
- 이는 데이터 파이프라인의 자연스러운 최종 단계입니다. 누군가가 Parquet이나 CSV 파일에서 .duckdb 파일을 생성하면, 나머지 회사 구성원들은 데이터 웨어하우스를 거치지 않고 이 파일을 읽어들입니다.
- 뷰와 테이블이 모두 나열되므로, 유용한 표면이 선별된 뷰 집합인 파일은 원시 테이블이 아닌 뷰 집합 자체로 쿼리할 수 있습니다.
DuckDB SQL은 수정 없이 그대로 전달됩니다.
에이전트에는 번역 계층이 없습니다. 사용자가 저장하는 문장이 DuckDB가 수신하는 문장이므로, 방언의 좋은 부분들이 근사치가 아닌 그대로 제공됩니다.
- GROUP BY ALL과 ORDER BY ALL 명령어를 사용하면 분석 쿼리에서 대부분의 번거로움을 줄일 수 있습니다.
- SELECT * EXCLUDE (col) 및 SELECT * REPLACE (...)는 아무도 필요로 하지 않는 하나의 열을 제외하고 모든 열을 가져오려는 경우에 사용합니다.
- QUALIFY를 사용하면 전체를 서브쿼리로 감싸지 않고도 윈도우 함수를 필터링할 수 있습니다.
- 전체 창 함수, CTE 및 리스트 컴프리헨션 — DuckDB 고유의 언어 방언이지, 그 휴대 가능한 하위 집합이 아닙니다.
-- DuckDB SQL, 작성된 그대로 엔진에 도달합니다. SELECT * EXCLUDE (internal_id) FROM ( SELECT region, product, sum(amount) AS revenue, internal_id, row_number() OVER (PARTITION BY region ORDER BY sum(amount) DESC) AS rk FROM sales GROUP BY ALL ) QUALIFY rk <= 3 ORDER BY region, revenue DESC
중첩된 열은 JSON 형식으로 제공됩니다.
DuckDB는 스프레드시트 셀보다 훨씬 정교한 데이터 유형 체계를 가지고 있으므로, DuckDB를 기반으로 보고서를 작성하기 전에 어떤 데이터가 어디에 저장되는지 알아두는 것이 좋습니다.
- STRUCT, LIST, MAP 및 UNION 열은 JSON 텍스트로 반환됩니다. — 읽기 쉽고, 구문 분석이 가능하며, 의도치 않게 잘못된 내용으로 잘리지 않습니다.
- BLOB 열은 삭제되는 대신 base64로 인코딩됩니다.
- 날짜, 타임스탬프, 시간대가 포함된 타임스탬프 및 소수점 이하 자릿수가 없는 타임스탬프는 그대로 전달되므로 숫자는 숫자로 유지되고 반올림 값도 그대로 유지됩니다.
- 운전자가 실제로 표현할 수 없는 내용은 빈칸으로 표시되는 대신 해당 셀에 '그렇다'라고 표시됩니다. 그렇지 않으면 사용자가 직접 확인해야 합니다.
모든 데이터베이스 커넥터에서 공유됨
모든 데이터베이스 커넥터에 해당되는 사항입니다.
- 출국 전용 — 에이전트는 쿼리 스트림으로 암호화된 연결을 하나만 엽니다. 포트 포워딩도 필요 없고, VPN도 필요 없고, IP 허용 목록도 필요 없으며, 데이터베이스 정보가 인터넷에 노출되는 것도 없습니다.
- 자격 증명은 그대로 유지됩니다. — 데이터베이스 사용자 이름과 비밀번호는 에이전트를 설치한 컴퓨터에 있습니다. Query Streams는 이러한 정보를 수신하지 않으며 자체적으로 데이터베이스에 접근할 수 없습니다.
- 읽기 전용, 강제 적용됨 — 한 번에 하나의 명령문만 사용 가능하며, SELECT 및 관련 명령만 허용됩니다. 쓰기 작업은 서버로 전송되기 전에 사용자 컴퓨터에서 거부되므로, 다른 사용자가 설정해 둔 권한에 의존하지 않습니다.
- 원하는 만큼 에이전트를 배포하세요 사이트, 지역 또는 클라우드별로 하나씩만 있으면 됩니다. 모든 데이터 소스가 단일 드롭다운 메뉴에 표시되므로 어떤 에이전트가 무엇을 호스팅하는지 알 필요가 없습니다.
쿼리가 저장되면 다음과 같은 결과가 나타납니다.
- SQL이 아니라 기능을 공유하세요. — 동료나 외부 파트너는 쿼리를 실행하고 해당 쿼리의 바탕이 된 구문을 전혀 보지 않고도 필터를 변경할 수 있습니다.
- 양방향 필터 — 직접 @variables로 선언하거나, 커넥터가 WHERE 절에 이미 있는 리터럴 값을 감지하여 드롭다운 메뉴로 제공하도록 할 수 있습니다.
- 어디서든 읽어보세요 — Microsoft Excel, Google Sheets, Power BI, REST API, MCP 기반 AI 비서, 쿼리 빌더 및 Nova는 모두 동일한 저장된 쿼리를 읽습니다.
- 여러 개를 동시에 실행하세요 — 5개의 저장된 쿼리가 5개의 워크시트 탭에 동시에 스트리밍되며, 결과 크기에 관계없이 실행됩니다.
- 이미 연결된 다른 항목과 연결하세요. — 다른 데이터베이스, 비즈니스 API 또는 파일 폴더를 하나의 읽기 전용 명령으로 액세스할 수 있습니다.
크로스 소스 SQL
DuckDB를 나머지 데이터와 연결하세요
하나의 명령으로 DuckDB와 다른 연결을 동시에 관리할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 스트리밍으로 전송하며, 최종 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며, 어떤 데이터도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택 c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM 분석.메인.주문1 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만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
DuckDB에 필요한 것
- 당신이 가리키는 것
- 에이전트가 실행되는 머신에 .duckdb, .db 또는 .ddb 파일이 하나 있어야 합니다.
- 길
- 로컬 경로 또는 시스템이 접근할 수 있는 UNC 공유 폴더 - 로컬 디스크가 더 빠릅니다.
- 엔진
- DuckDB 1.4.4 버전이 에이전트에 내장되어 있습니다. 설치, 시작 또는 실행 유지가 필요하지 않습니다.
- 항구
- 없습니다. 접속할 DuckDB 서버가 없으므로 열 수 있는 것이 없습니다.
- 사물
- 파일 내의 테이블 및 뷰
- SQL 방언
- DuckDB SQL은 사용자가 작성한 그대로 엔진에 전달됩니다. 변환 과정이 없습니다.
- 읽기 전용
- 문장 실행 전에 확인됨 — SELECT, WITH 및 관련 구문만 해당
- 중첩 유형
- STRUCT, LIST, MAP 및 UNION은 JSON 텍스트로 반환되고, BLOB은 base64로 반환됩니다.
- 스키마
- DuckDB의 기본 스키마는 main이며, 연합 참조는 이 스키마를 그대로 사용합니다.
DuckDB는 파이프라인의 시작보다는 끝부분에 등장하는 경우가 많습니다. 누군가가 Parquet 파일이나 CSV 파일들을 모아서 질문에 필요한 형태로 파일을 만들고, 그 답을 필요로 하는 사람들이 Microsoft Excel을 사용하고 있다는 사실을 알게 되는 경우가 흔합니다. 그러면 보통 다음 단계는 이미 디스크에 저장 가능한 파일을 위한 저장소를 구축하는 것입니다. 이 커넥터는 다른 대안을 제시합니다. 파일을 원래 위치에 그대로 두고 스프레드시트 프로그램이 직접 읽도록 하는 것입니다.
데이터 유형 매핑은 계획을 세울 때 고려해야 할 중요한 부분입니다. STRUCT 또는 LIST는 스프레드시트에서 사용할 수 없는 실제 DuckDB 데이터이므로 JSON 텍스트로 표시됩니다. JSON 텍스트는 정직하고 파싱 가능하지만, 합계를 계산할 수 있는 숫자는 아닙니다. 중첩된 열이 보고서의 핵심이라면, DuckDB가 효율적이고 간편하게 처리할 수 있도록 보고서 최종 결과물이 아닌 쿼리 단계에서 중첩을 해제하는 것이 좋습니다.
여러 소스를 아우르는 쿼리의 경우 DuckDB의 기본 스키마는 main이므로, 웨어하우스 파일을 읽는 analytics라는 연결은 analytics.main.sales로 기록됩니다. 여기서 흥미로운 점은, 기록이 가득한 분석 파일이 여전히 변경 중인 운영 데이터베이스 및 청구 API와 하나의 명령문으로 조인된다는 것입니다.
공급업체 문서: duckdb.org
자주 묻는 질문
DuckDB 관련 질문
쿼리 스트림을 통해 DuckDB 데이터를 읽을 수 있는 도구는 무엇인가요?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
DuckDB 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?
아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.
쿼리 스트림을 통해 DuckDB의 데이터를 변경할 수 있나요?
아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.
Query Streams가 DuckDB에 연결하려면 무엇이 필요합니까?
접근 가능한 호스트, 역할 및 해당 암호만 있으면 됩니다. 에이전트에 드라이버가 내장되어 있으므로 데이터베이스에 아무것도 설치할 필요가 없습니다. 지정할 대상: 에이전트가 실행되는 컴퓨터의 .duckdb, .db 또는 .ddb 파일 하나. 경로: 로컬 경로 또는 컴퓨터에서 접근 가능한 UNC 공유 폴더 - 로컬 디스크를 사용하는 것이 더 빠릅니다. 엔진: 에이전트에 내장된 DuckDB 1.4.4 버전. 설치, 시작 또는 유지 관리해야 할 것이 없습니다. 포트: 없음. 접근할 DuckDB 서버가 없으므로 열어야 할 포트가 없습니다.
DuckDB를 다른 데이터베이스와 동일한 쿼리로 조인할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 DuckDB와 다른 연결을 동시에 참조할 수 있으며, 연결 스키마 테이블 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 전송합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되거나 데이터가 복사되거나 예약되지 않습니다. 읽기 전용은 모든 부분(SELECT, WITH, EXPLAIN)에 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

