철도 REST API: SQL 쿼리를 엔드포인트로 변환

REST API · 철도에서 엔드포인트까지

돌려 철도 SQL 쿼리를 REST API 엔드포인트

쿼리 빌더에서 쿼리를 저장하려면 클릭하세요. 새로운 엔드포인트그리고 api.querystreams.com이라는 URL과 해당 키가 있습니다. SQL은 이미 Railway 데이터베이스와 연결된 에이전트에서 읽기 전용으로 실행됩니다. 호출자는 JSON 또는 CSV 형식의 응답을 받게 되며 SQL 쿼리, 스키마 또는 비밀번호는 전혀 볼 수 없습니다. 호스팅할 것도 없고 포트를 열 필요도 없습니다. 저장된 쿼리에서 약 90초 정도 소요되며, 무료 플랜으로 첫 번째 엔드포인트를 사용할 수 있습니다.

저장된 쿼리에서 약 90초가 걸립니다. 호스팅할 서버가 없습니다 자격증명은 영구적으로 보관됩니다. 발신자 한 명당 키 하나씩 제공되며, 언제든지 취소할 수 있습니다.

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

URL api.querystreams.com 저장된 Railway 쿼리의 행을 JSON 또는 CSV 형식으로 키를 가진 모든 사용자에게 반환하는 기능입니다. 공유하기 전에 포털 콘솔에서 테스트를 거쳤습니다. 예시는 다음과 같습니다.

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

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" }
}

Railway는 클라우드에 데이터를 저장하고, 해당 클라우드 환경은 공급업체가 운영합니다. 누군가 자신의 앱, 대시보드 또는 스크립트에서 데이터의 일부를 사용하고 싶어 할 때, 기존의 해결책들은 너무 많은 권한을 넘겨주는 방식입니다. 예를 들어 프로젝트 기간보다 오래 지속되는 데이터베이스 로그인 정보, 아침이 되면 이미 오래된 데이터가 되어버리는 야간 데이터 내보내기, 또는 누군가가 직접 실행하고 패치해야 하는 소규모 API 서버 등이 있습니다. Query Streams는 엔드포인트를 저장된 쿼리와 키로 구성합니다. Railway PostgreSQL 데이터베이스와 이미 연결된 에이전트가 쿼리를 실행하고, api.querystreams.com에서 키와 요청 제한을 확인한 후, 호출자는 결과를 받아볼 수 있습니다. SQL 쿼리, 스키마 및 자격 증명은 절대 사용자 계정 외부로 유출되지 않습니다.

필요한 것

Query Streams 계정

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

철도 연결이 추가된 상시 접속형 컴퓨터의 에이전트

인터넷 접속만 있으면 됩니다.

쿼리 빌더에 저장된 쿼리

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

네 단계로 설정하세요

1. 쿼리를 저장하세요

   ~ 안에 쿼리 빌더 원하는 철도 연결을 선택하고, 게시할 SELECT 쿼리를 작성한 다음, 한 번 실행하여 행을 확인하세요. 호출자가 필요로 하는 열만 포함하도록 쿼리를 작성하면 엔드포인트는 쿼리 결과를 그대로 반환합니다.

   저장된 쿼리 · 고객

   선택 고객 ID, 이름, 도시
   FROM 공개 고객
   주문하다 에 의해 이름
   LIMIT 100;

   발신자가 필터링할 수 있도록 하려면 동적 필터를 추가하세요. 예를 들어... 도시 = @city인 경우. 각 @variable 3단계에서 API 매개변수가 됩니다. 클릭하세요. 저장 그리고 쿼리에 이름을 지정하세요. 그 이름이 엔드포인트의 표시 이름이 됩니다.

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

   열려 있는 API 상단 바에서 클릭하세요 새로운 엔드포인트마법사는 네 단계를 거칩니다. 쿼리 선택, 구성, 잠금 매개변수 그리고 공유. 에 쿼리 선택방금 저장한 쿼리를 클릭하세요. 상담원이 오프라인인 쿼리는 회색으로 표시됩니다. 다음.

   오픈 API

   지름길. 쿼리 빌더에서 열려 있는 쿼리를 직접 노출할 수 있으며, 그러면 마법사가 시작됩니다. 구성 쿼리가 이미 선택된 상태입니다.

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

   ~에 구성 첫 번째 엔드포인트에 대해서는 기본 설정이 올바릅니다. 표시 이름 쿼리에서 채워졌습니다. 수명 영구적 (선택) 만료 중 (일시적인 지분의 경우) 응답 모드 정적(JSON 응답 하나; 선택) 스트리밍 플랜의 고정 행 제한을 초과하는 결과를 얻으려면) 내부 형식 JSON 형식입니다. 응답 모드와 형식은 생성 후 고정되므로 여기서 결정하세요. 클릭하세요. 다음.

   ~에 잠금 매개변수 쿼리에 사용된 모든 동적 필터가 나열됩니다. 호출자가 설정할 수 있는 필터는 그대로 두십시오. 호출 가능 그리고 각각에게 쿼리 문자열 이름; 체크 필수의 만약 이 값이 없으면 호출이 실패할 것입니다. 호출자가 변경해서는 안 되는 값을 고정하십시오. 잠김또는 다음과 같은 데이트 시나리오 월초. 숨겨진 쿼리 자체의 기본값을 유지하고 기본값 설정 시도를 거부합니다. 클릭하세요. 다음.

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

   ~에 공유 초대할 수 있습니다 사람들 이메일로 보내시거나 추가해 주세요. 서비스 키 서버 또는 자동화 도구를 선택하거나, 지금은 둘 다 건너뛸 수도 있습니다. 클릭하세요. 키를 생성하고 받으세요성공 화면에는 엔드포인트 URL과 키가 표시됩니다. 키는 49자로 시작하는 문자열입니다. qsapi_복사해 두세요. 나중에 엔드포인트에서 다시 확인할 수 있습니다. 공유 탭을 저장해두면 화면을 닫아도 탭 내용이 사라지지 않습니다.

   클릭 보내다 콘솔에서 포털 자체에서 첫 번째 호출을 수행합니다. 응답 창에는 다음이 표시됩니다. 상태, 시간 그리고 크기, 그 몸 탭에는 JSON이 표시되고, 호출은 해당 위치에 나타납니다. 활동 몇 초 후에 탭을 누르세요.

어디에서든 전화하세요

콘솔의 URL 표시줄에 있는 엔드포인트 ID로 해당 부분을 바꾸세요. qsapi_YOUR_KEY 키를 사용하세요. 호출 가능한 매개변수는 GET 요청 시 쿼리 문자열에 포함됩니다. 여기에 저장된 쿼리가 표시됩니다. 도시:

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-키브라우저 코드에서 사용하세요.

플러그를 꽂는 곳

계획이 허용하는 것

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

안전하게 보관하기

무언가가 작동하지 않을 때

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

사람들이 묻는 질문

관련 가이드

• MCP를 통해 클로드까지 철도를 연결하세요
• 데이터베이스 REST API: 모든 SQL 쿼리를 엔드포인트로 변환
• Microsoft SQL Server REST API
• PostgreSQL REST API
• MySQL REST API
• 스노우플레이크 REST API