DuckDB 데이터베이스를 안전한 REST API로 노출하는 방법

덕DB REST API

DuckDB 쿼리를 안전한 방식으로 변환하세요 REST API — httpserver 확장 프로그램이 없으면 호스팅할 서비스가 없습니다.

DuckDB는 서버 프로세스나 내장 인증 기능이 없는 빠르고 파일 기반의 분석 엔진입니다. SQL 쿼리를 저장하여 데이터를 분석하세요. .duckdb 파일을 생성하고, 수신자별 API 키를 발급하고, 파트너에게 실제 JSON 엔드포인트를 제공하는 등의 작업은 필요하지 않습니다. http서버 확장 기능을 노출할 필요도 없고, FastAPI 래퍼를 빌드할 필요도 없고, 데이터베이스 파일을 배포할 필요도 없습니다. 관리되는 읽기 전용 파일만 있으면 됩니다. DuckDB REST API 몇 분 안에.

실행할 서버가 없습니다 수신자별 키 읽기 전용 강제 적용 배포할 항목이 없습니다

DuckDB REST API를 무료로 구축하세요 API 플랫폼을 참조하세요.

얻다 api.querystreams.com/v1/endpoints/revenue-by-month

권한 부여: 교군꾼 qsapi_K7…ZmQ

수용하다: 애플리케이션/json

200 좋아요 DuckDB · 41ms

[

  { "월": “2026년 4월”, "수익": 428100 },

  { "월": “2026년 5월”, "수익": 511920 }

]

이 가이드 외에도 쿼리 스트림의 모든 기능 보기 무료로 시작하기

지원

+더 보기

라이브 데이터

내보내기를 온디맨드 SQL로 바꾸기

Excel 시트

BI 및 AI 분석

Nova에 문의하여 SQL + 차트 가져오기

노바 만나기

데이터베이스 REST API

파트너당 키 1개. 자격 증명은 공유되지 않습니다.

API를 구축하세요

+더 보기

자동화

6개 이상의 플랫폼에 예약 동기화

탐색

+더 보기

API에서 SQL로

코드 없이 SQL로 API 쿼리

탐색

+더 보기

AI 데이터베이스 MCP

Claude, Cursor, ChatGPT 및 Grok은 여러분의 데이터와 소통합니다.

Connect AI

Query Streams는 저장된 모든 DuckDB 쿼리를 파트너가 바로 사용할 수 있는 REST API 엔드포인트로 변환하는 안전한 실시간 데이터베이스 통합 플랫폼입니다. 수신자별 키, 읽기 전용 적용, 전체 감사 추적 기능을 제공합니다. 라이브 방송을 시청하세요 DuckDB REST API 서버를 실행하지 않고 설치하는 것 http서버 확장 프로그램이나 데이터베이스 파일 전송에 대해 알아보세요. QueryStreams.com에서 더 자세히 알아보세요. 그리고 무료로 가입하세요 DuckDB 엔드포인트를 몇 분 만에 게시하세요.

DuckDB 데이터베이스를 REST API로 공개하는 이유는 무엇일까요?

DuckDB가 뛰어난 이유는 서버가 없기 때문입니다. 프로세스 내에서 실행되며 단일 디스크에서 데이터를 읽습니다. .duckdb 서버리스는 파일(또는 Parquet, CSV, JSON 형식의 데이터를 직접 쿼리)을 처리하고, 노트북이나 cron 서버에서 컬럼 스토어 속도로 분석 워크로드를 처리합니다. 하지만 팀 외부의 누군가가 해당 데이터가 필요할 때, 예를 들어 클라이언트가 실시간 피드를 원하거나, 파트너의 앱이 집계 데이터를 읽어야 하거나, 분석가가 대시보드에서 집계 데이터를 필요로 할 때, 서버리스의 강점은 오히려 걸림돌이 됩니다. 연결할 포트도 없고, 제공할 로그인 정보도 없습니다. 일반적인 해결 방법들은 모두 비효율적입니다. 이메일을 보내는 수밖에 없죠. .duckdb (이제 당신의 데이터 전체 복사본이 다른 사람의 드라이브에 저장되어 있습니다.) 당신은 커뮤니티를 일어서게 됩니다. http서버 확장 프로그램이나 FastAPI 래퍼를 사용하면 (이제 HTTP 서비스, 인증 및 TLS를 소유하게 됩니다) 또 다른 CSV 내보내기를 예약할 수 있습니다. DuckDB REST API 깔끔한 버전입니다. 파트너는 파일이 아닌 URL과 토큰을 받습니다. Query Streams는 저장된 쿼리와 키를 함께 제공합니다.

DuckDB에 REST API를 배포하는 일반적인 방법과 그 문제점

여기에는 여러 가지 실제적인 옵션이 있으며, 각 옵션마다 장점이 있습니다. 하지만 모든 옵션에는 인프라를 직접 관리하거나, 데이터의 전체 복사본을 제공하거나, 또는 둘 다를 해야 한다는 단점이 있습니다. 특정 파트너가 특정 결과 집합을 읽을 수 있도록 하는 것이 목표일 때, 일반적인 접근 방식과 Query Streams 공유 엔드포인트를 비교 분석해 보겠습니다.

Query Streams를 사용하면 DuckDB 쿼리를 REST API로 변환할 수 있습니다.

DuckDB 파일 옆에 네트워크 에이전트를 설치하고 커넥터를 구성한 후에는 저장된 쿼리를 공유 REST 엔드포인트로 승격하는 데 약 3단계가 소요됩니다. Excel, Google Sheets 또는 MCP 서버용 쿼리 스트림을 이미 사용하고 있다면 에이전트와 커넥터가 이미 설치되어 있으므로 2단계부터 시작할 수 있습니다.

실행할 서버도 없고, 전달할 파일도 없습니다.

팀들이 다른 방식 대신 이 방식을 선택하는 이유는 바로 보안 모델 때문입니다. http서버 확장자 또는 공유 파일. DuckDB 파일은 사용자의 컴퓨터를 벗어나지 않으며, 파일 경로는 네트워크의 에이전트 구성 내에만 존재합니다. DuckDB 클라우드로 전송되지 않으며 수신자에게 노출되지 않습니다. DuckDB 자체는 읽기 전용 모드로 열리며, 네트워크의 유효성 검사기가 SELECT 문이 아닌 모든 문을 거부합니다. 읽기 전용 위반 실행되기 전에.

DuckDB REST API를 호출하세요

수신자는 다른 REST API와 마찬가지로 베어러 토큰과 URL을 사용하여 엔드포인트를 호출합니다. 노출된 저장된 쿼리 매개변수는 호출별로 설정할 수 있으며, 쿼리 문자열에 설정할 수도 있습니다. 얻다 또는 JSON 본문에 우편에이전트는 해당 값을 문자열 연결이 아닌 적절한 준비된 문 매개변수로 바인딩하므로 수신자가 필터를 우회하여 SQL을 삽입할 수 없습니다.

호출별로 출력 형식을 선택하세요. 수용하다 헤더(또는 ?형식= 쿼리 매개변수): JSON 단일 배열의 경우, CSV 스프레드시트 및 팬더스의 경우, 또는 스트리밍 엔드포인트에서, NDYSON (한 줄에 하나의 JSON 행)은 파이프라인에서 파싱을 즉시 처리하는 데 유용하며, DuckDB가 생성하도록 설계된 대규모 분석 결과 세트에 적합합니다. 대역폭에 민감한 사용자는 이 옵션을 선택하세요. LZ4 페이로드 압축 Accept-Encoding: lz4압축되지 않은 응답도 표준을 따릅니다. gzip 자동으로 네트워크를 통해 전송됩니다. 정적 모드와 스트리밍 모드, 네 가지 네트워크 조합, OpenAPI 3.1 생성에 대한 자세한 내용은 다음을 참조하십시오. SQL 데이터베이스를 위한 즉시 사용 가능한 REST API 가이드.

Power BI, Tableau 등 JSON 파일을 읽을 수 있는 모든 프로그램에 연결하세요.

DuckDB는 분석 엔진이므로 대부분의 경우 결과는 대시보드로 전송됩니다. 모든 엔드포인트가 표준 결과를 반환하기 때문입니다. JSON CSV 및 스트리밍 NDJSON 형식을 지원하므로 REST 피드를 읽을 수 있는 모든 도구는 별도의 설치 없이 DuckDB 데이터를 직접 사용할 수 있습니다. 파워 쿼리 Microsoft BI 스택으로 진입하는 가장 쉬운 방법은 다음과 같습니다. 파워 BI 선택하다 웹에서 데이터 가져오기 →엔드포인트 URL을 붙여넣고, 다음을 추가하세요. 권한 부여 헤더를 포함하면 Power Query가 JSON을 구문 분석하여 데이터 모델에 제공되는 새로 고침 가능한 테이블로 변환합니다. (스프레드시트 내의 실시간 데이터의 경우 기본 기능을 사용합니다.) Query Streams Excel 추가 기능 더 간단한 방법입니다. Power Query는 Power BI 모델 자체에서 데이터를 가져오려는 경우에 사용할 수 있습니다.

파워 쿼리 데이터 가져오기 → 웹에서 URL과 베어러 토큰을 붙여넣고 JSON을 새로 고침 가능한 테이블로 확장합니다.

파워 BI 동일한 Power Query 엔진을 사용합니다. 엔드포인트를 모델에 바로 로드하고 새로 고침을 예약하세요.

테이블 실시간 대시보드를 위해 웹 데이터 커넥터 또는 JSON 소스를 해당 엔드포인트로 연결하세요.

우편 집배원 OpenAPI 3.1 사양을 가져온 다음, 한 번의 클릭으로 요청을 보내고, 검사하고, 공유하세요.

또한 영양을 공급합니다 n8n, 퀼릭, 컬, 파이썬 (요청 또는 pandas.read_json), Insomnia, Hoppscotch 또는 HTTP 요청을 보내고 JSON을 읽을 수 있는 모든 스크립트 또는 워크플로.

로컬 파일 및 네트워크 공유와 호환됩니다.

네트워크 에이전트는 로컬 네트워크에도 동일한 방식으로 연결됩니다. .duckdb 파일, 네트워크 공유의 데이터베이스 파일 또는 메모리 내 DuckDB 등 어떤 형식의 데이터든 에이전트를 통해 데이터를 가져올 수 있으며, Parquet, CSV 또는 JSON 파일 등 DuckDB 인스턴스에서 접근 가능한 모든 쿼리를 처리할 수 있습니다. 지연 시간을 최소화하려면 데이터가 저장된 머신 또는 그 근처에서 에이전트를 실행하세요. 하나의 Query Streams 계정으로 여러 머신과 사이트에서 에이전트를 실행할 수 있으며, 단일 엔드포인트는 어떤 에이전트가 서비스를 제공하든 동일하게 작동합니다.

자주 묻는 질문

시작하기

관련 가이드: SQL 데이터베이스를 위한 즉시 사용 가능한 REST API | PostgreSQL을 REST API로 노출합니다 | 데이터베이스 REST API 플랫폼 | 커넥터 설정 가이드

카테고리: API 플랫폼

태그: duckdb-rest-api, duckdb, duckdb-server, duckdb-api, rest-api, expose-duckdb-as-api, httpserver-alternative, share-duckdb-data, per-recipient-keys, no-code-api, database-rest-api

메타 설명: DuckDB 쿼리를 수신자별 키를 사용하는 안전한 읽기 전용 REST API로 변환합니다. httpserver 확장 프로그램, 서버, 코드가 필요하지 않습니다.