데이터베이스 REST API: 모든 SQL 쿼리를 엔드포인트로 변환

데이터베이스 REST API · 허브

아무거나 SQL 쿼리 ~으로 REST API 엔드포인트

쿼리 빌더에서 59개 커넥터 중 하나를 대상으로 쿼리를 작성하고 클릭하세요. 새로운 엔드포인트api.querystreams.com이라는 URL과 해당 키가 제공됩니다. SQL 쿼리는 이미 데이터가 저장된 에이전트에서 읽기 전용으로 실행되며, 호출자는 JSON 또는 CSV 형식의 응답을 받게 되고 SQL 쿼리, 스키마 또는 자격 증명은 볼 수 없습니다. 서버를 호스팅하거나 포트를 열 필요가 없으며, 무료 플랜을 포함한 모든 플랜에서 이용 가능합니다. 이 페이지는 개요이며, 각 커넥터에 대한 자세한 설명은 아래에서 확인할 수 있습니다.

저장된 쿼리에서 약 90초가 걸립니다. 호스팅할 서버가 없습니다 데이터는 네트워크에 남아 있습니다. 발신자 한 명당 키 하나씩 제공되며, 언제든지 취소할 수 있습니다.

당신이 최종적으로 얻게 될 것

저장된 쿼리의 행들을 키를 가진 모든 사용자에게 반환하는 URL입니다. 공유하기 전에 포털 콘솔에서 테스트를 완료해야 합니다. 예시는 다음과 같습니다.

{
  "도시": "시애틀"
}

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"city": "Seattle"}'

{
  "컬럼": [ { "이름": "고객 ID", "유형": "정수" }, { "이름": "이름", "유형": "끈" }, { "이름": "도시", "유형": "끈" } ],
  "행": [
    { "고객 ID": 1042, "이름": "노스윈드 트레이더스", "도시": "시애틀" },
    { "고객 ID": 1057, "이름": "알파인 아웃피터스", "도시": "덴버" },
    { "고객 ID": 1063, "이름": "하버 푸드", "도시": "핼리팩스" }
  ],
  "메타": { "행 개수": 3, "에이전트_지속시간_밀리초": 41, "요청 ID": "req_7Hq2mKd9" }
}

PostgREST, Hasura, DreamFactory, Directus 및 직접 작성하는 프레임워크를 포함하여 데이터베이스에 REST API를 구축하는 대부분의 도구는 스키마를 노출합니다. 즉, 모든 테이블이 엔드포인트가 되고 호출자는 해당 테이블을 탐색합니다. Query Streams는 정반대입니다. 저장된 쿼리 하나로 엔드포인트가 반환하는 값을 정확하게 정의할 수 있습니다. 호출자는 해당 행만 가져오고 생성 과정에 대한 정보는 전혀 가져오지 않습니다. 또한, 이미 설치된 에이전트가 쿼리를 실행하고 api.querystreams.com이 HTTP 응답을 처리하므로 API 서버를 실행할 필요가 없습니다.

필요한 것

Query Streams 계정

모든 플랜에는 REST API가 포함되어 있습니다. 무료 플랜은 엔드포인트 1개, 키 2개, 호출당 250개 행을 제공하며, 이는 이 가이드를 작성하는 데 충분합니다. 가입은 다음 링크에서 하세요. my.querystreams.com.

사용자 데이터베이스에 접근할 수 있는 컴퓨터에 설치된 에이전트(연결이 추가됨)

대개 데이터베이스 서버 자체이거나 동일 네트워크에 연결된 상시 작동 컴퓨터입니다.

쿼리 빌더에 저장된 쿼리

엔드포인트는 저장된 쿼리 하나만 래핑합니다. SELECT 문을 작성하고 한 번 실행한 다음 저장하세요. 동적 필터(a)를 추가하세요. @variable (WHERE 절에서) 호출자가 필터링할 수 있어야 합니다.

네 단계로 설정하세요

1. 쿼리를 저장하세요

   ~ 안에 쿼리 빌더 연결을 선택하고, SELECT 문을 작성한 다음 한 번 실행하세요. @variable WHERE 절의 값이 API 매개변수가 됩니다.

   저장된 쿼리 · 동적 필터 1개 포함

   선택 고객 ID, 이름, 도시
   FROM 고객
   어디 도시 = @도시
   주문하다 에 의해 이름;

   클릭 저장해당 이름은 엔드포인트의 표시 이름이 됩니다.

2. 엔드포인트를 생성합니다

   열려 있는 API 상단 바에서 클릭하세요 새로운 엔드포인트그리고 위에 쿼리 선택 저장한 쿼리를 클릭하세요. 다음.

   오픈 API

3. 매개변수를 구성하고 잠급니다.

   ~에 구성 유지하다 수명 영구적인, 응답 모드 정적 및 내부 형식 첫 번째 엔드포인트에 대한 JSON 형식입니다. 모드와 형식은 생성 후 고정됩니다. 잠금 매개변수 떠나다 도시 ~처럼 호출 가능, 또는 잠그다 호출자가 변경할 수 없는 고정 값으로 설정합니다. 클릭하세요. 다음.

4. 공유하고 키를 받으세요

   초대하다 사람들 이메일로 추가하세요 서비스 키 도구를 사용하려면 클릭하거나, 지금은 건너뛰려면 클릭한 다음 클릭하세요. 키를 생성하고 받으세요49자로 시작하는 키를 복사하세요. qsapi_; 그것은 나중에 다시 드러날 수 있습니다. 공유 탭을 클릭하세요. 보내다 콘솔에서 첫 번째 호출을 수행합니다.

어디에서든 전화하세요

엔드포인트 ID를 본인의 것으로 바꾸세요. qsapi_YOUR_KEY 열쇠를 가지고:

curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "X-API-Key: qsapi_YOUR_KEY"

{
  "컬럼": [ { "이름": "고객 ID", "유형": "정수" }, { "이름": "이름", "유형": "끈" }, { "이름": "도시", "유형": "끈" } ],
  "행": [
    { "고객 ID": 1042, "이름": "노스윈드 트레이더스", "도시": "시애틀" },
    { "고객 ID": 1057, "이름": "알파인 아웃피터스", "도시": "덴버" },
    { "고객 ID": 1063, "이름": "하버 푸드", "도시": "핼리팩스" }
  ],
  "메타": { "행 개수": 3, "에이전트_지속시간_밀리초": 41, "요청 ID": "req_7Hq2mKd9" }
}

행은 열 이름을 키로 하는 객체로 반환되며, 열 목록과 함께 표시됩니다. 메타 이 블록에는 행 수, 결과 잘림 여부, 그리고 지원 요청 시 인용할 수 있는 요청 ID가 표시됩니다. POST 요청과 동일한 방식으로 호출하면 매개변수가 JSON 본문에 담겨 전송되는데, 이는 긴 값 목록에 적합한 방식입니다.

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "X-API-Key: qsapi_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"params": {"city": "Seattle"}}'

?format=csv

JSON 형식이 아닌 CSV 형식이며, 헤더 행이 포함되어 있습니다. 허용 형식: 텍스트/CSV 마찬가지로 작동합니다. 스트리밍 엔드포인트는 마지막에 NDJSON(한 줄에 하나의 JSON 객체)을 반환합니다. {"_summary": true, "row_count": N} 줄; 마지막 줄을 확인하세요.

?샘플=true

최대 5줄까지 사용 가능하며, 요금은 부과되지 않습니다. 고객 연결 작업에 유용합니다.

?compression=lz4

디코더가 내장된 고용량 통화용 LZ4 프레임 본체; 암호 탭에는 언어별 디코더 스니펫이 있습니다. 일반 gzip 압축은 클라이언트가 전송할 때 자동으로 수행됩니다. Accept-Encoding: gzip.

인증: Bearer qsapi_…

별칭으로 인정됨 X-API-키브라우저 코드에서 사용하세요.

플러그를 꽂는 곳

커넥터별 가이드

Query Streams에서 지원하는 모든 커넥터는 이러한 방식으로 게시할 수 있습니다. 원하는 커넥터를 선택하세요.

운영하는 데이터베이스

• Microsoft SQL Server
• PostgreSQL
• MySQL
• MariaDB
• Oracle
• SQLite
• Microsoft Access
• DuckDB
• 수파베이스

데이터 웨어하우스

• 눈송이
• 구글 빅쿼리

호스팅 데이터베이스

• 네온
• 아마존 RDS
• Azure Database for PostgreSQL
• Azure Database for MySQL
• Azure SQL
• Google Cloud SQL
• 구글 AlloyDB
• DigitalOcean 관리형 데이터베이스
• 아이벤
• 크런치 브릿지
• Heroku Postgres
• 세우다
• 철도
• Fly.io 포스트그레스
• Vultr 관리형 데이터베이스
• OVHcloud 관리형 데이터베이스
• 스케일웨이 관리형 데이터베이스
• PostgreSQL을 사용하는 OCI 데이터베이스
• MySQL 히트웨이브
• IBM 클라우드 데이터베이스(PostgreSQL용)
• MariaDB SkySQL
• 자타
• 타임스케일 클라우드
• PlanetScale Postgres
• 프리즈마 포스트그레스
• 코예브
• 나일 강

파일 및 로그 폴더

• 파일 시스템
• CSV 폴더
• 마루 폴더
• 엑셀 폴더
• SQLite 폴더
• JSONL 폴더
• 다중 레코드 CSV
• 기계 로그
• 웹 서버 로그
• 컨테이너 로그
• 애플리케이션 로그
• 시스템 로그
• 사용자 지정 로그

SaaS 및 API 커넥터

• 스트라이프
• Shopify
• HubSpot
• 구글 광고
• Google 애널리틱스 4
• Google 검색 콘솔
• ShipStation
• 아이틱

소비자 측 가이드: Power BI와 Power Query를 통한 Excel M.

계획이 허용하는 것

모든 호출에는 60초의 고정 쿼리 시간 제한과 8MiB의 응답 용량 제한이 있으며, 반환되는 바이트 수는 사용자의 요금제 월별 데이터 허용량에 포함됩니다. 이 허용량은 Excel 및 Google Sheets 추가 기능에서 사용하는 것과 동일합니다. 무료 요금제는 엔드포인트 1개와 월 5MB의 데이터 허용량을 제공하며, 이는 하루에 여러 번 호출되는 작은 테이블을 처리하기에 충분합니다. 가격 페이지를 참조하세요. 계획별 수당에 대해서.

안전하게 보관하기

무언가가 작동하지 않을 때

모든 오류체는 다음과 같은 형태를 가지고 있습니다. {"오류": {"코드": "…", "메시지": "…"}} 그리고 모든 답변에는… X-QS-요청 ID 헤더. 지원팀에 문의할 때는 ID를 따옴표로 묶어주세요.

사람들이 묻는 질문

관련 가이드

• Power BI REST API: ODBC 드라이버 없이 실시간 SQL 데이터에 연결
• MCP를 통해 쿼리 스트림을 Claude에 연결합니다.
• 자격 증명이 아닌 실시간 데이터를 공유하세요.
• 데이터베이스 REST API 기능 개요