하나의 연결, 모든 표면
철도 데이터가 저장될 수 있는 곳
- 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 엔드포인트에서 Railway Postgres 데이터베이스를 읽기 전용 연결 하나만으로 처리합니다. Railway는 모든 데이터베이스에 두 개의 주소를 제공합니다. 하나는 Railway 내부에서만 확인되는 개인 주소이고, 다른 하나는 그 외 모든 연결을 위한 공용 TCP 프록시 주소입니다. 네트워크 에이전트는 Railway 외부에서 실행되므로 공용 프록시 주소가 작동합니다. Railway에서 먼저 보여주는 주소가 개인 주소이기 때문에, 네트워크 에이전트는 타임아웃으로 오류를 발생시키는 대신 해당 주소를 이름으로 거부합니다.
Railway는 네트워크를 통해 PostgreSQL을 사용합니다. — 표준 드라이버이므로 아래의 모든 지침이 변경 없이 적용됩니다. 철도 관련 부분은 연결 스트링뿐이며, 이는 다음에서 다룹니다. 연결 정보.
- 귀사 팀, 협력업체 및 파트너 여러분께
-
철도에서 엑셀까지 마이크로소프트 엑셀 · 엑셀 추가 기능
실시간 철도 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)
PostgreSQL 가이드 -
철도에서 구글 시트로 스프레드시트 추가 기능
사이드바에서 저장된 철도 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
PostgreSQL 가이드 -
노바에게 철도에 대해 물어보세요 Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 사용자의 Railway 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성할 필요도 없고 자격 증명을 제공할 필요도 없습니다.
Nova는 어떻게 작동하나요? -
철도에서 데이터 뷰어까지 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
실시간 Railway 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 뿐 SQL 쿼리나 자격 증명은 절대 볼 수 없습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
철도 REST API HTTP 엔드포인트
인증된 JSON 엔드포인트로 Railway 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있도록 하며, OpenAPI 3.1 사양과 Postman, Insomnia, Hoppscotch에서 바로 사용할 수 있는 컬렉션을 제공합니다. 데이터베이스 포트는 열지 않습니다.
PostgreSQL 가이드 -
철도에서 전력 BI까지 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 실시간 철도 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.
Power BI 작동 방식 -
철도에서 에어테이블까지 자동화 플랫폼
정해진 일정에 따라 철도 데이터 행을 Airtable 데이터베이스에 동기화하거나, Airtable 자동화 스크립트 내에서 데이터를 가져올 수 있습니다.
PostgreSQL 가이드 -
바세로행 철도 자동화 플랫폼
Railway에서 Baserow 테이블을 REST 엔드포인트(자체 호스팅 또는 Baserow 클라우드)를 통해 제공합니다.
PostgreSQL 가이드 -
철도에서 바다까지 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 철도 데이터로 최신 상태로 유지하세요.
PostgreSQL 가이드 -
철도에서 스마트시트까지 자동화 플랫폼
철도 관련 결과를 스마트시트 그리드에 추가하여 계획 및 보고서가 지난주 내보내기 데이터가 아닌 원본 시스템에서 읽어오도록 하세요.
PostgreSQL 가이드 -
앤빌까지 가는 철도 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 Railway와 연동할 때 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하는 방법을 알아보세요.
PostgreSQL 가이드 - AI 도구의 경우
-
철도 MCP 서버 Claude, Cursor 및 MCP 고객
AI 비서에게 Railway 데이터베이스에 대한 읽기 전용 액세스 권한을 부여하고, 올바른 SQL 쿼리를 작성하는 데 필요한 스키마만 제공하세요. 채팅창에 자격 증명을 입력할 필요는 없습니다.
PostgreSQL 가이드 - 사람들에게 전달됨
-
철도 경보 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
Railway 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송받거나, 설정한 행 수, 임계값 또는 백분율 변화 기준선을 넘을 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
네트워크 에이전트는 원하는 위치에 설치하십시오. 이 에이전트는 하나의 아웃바운드 연결을 열고 수신 대기는 하지 않으므로 Railway는 일반 클라이언트로 인식하며 네트워크에 인바운드 규칙을 설정할 필요가 없습니다.
Postgres 서비스를 열고 변수 탭으로 이동하여 DATABASE_PUBLIC_URL을 복사하세요. 이것이 공개 변수이고, DATABASE_URL은 비공개 변수이므로 Railway 외부에서는 작동하지 않습니다.
붙여넣으세요. 호스트, 포트, 데이터베이스, 사용자 이름 및 비밀번호가 그대로 읽힙니다.
포트 연결이 제대로 되었는지 확인하세요. 철도 회사는 서비스별로 프록시 포트를 할당하는데, 5432인 경우는 드물기 때문에 저장하기 전에 이 부분을 확인하는 것이 좋습니다.
저장하세요. Microsoft Excel, Google Sheets, Power BI, MCP 및 REST는 모두 해당 연결 하나를 통해 데이터를 읽거나, 단일 읽기 전용 명령문을 사용하여 다른 소스와 결합할 수 있습니다.
기능 심층 분석
철도가 당신에게 주는 것
DATABASE_PUBLIC_URL이지 DATABASE_URL이 아닙니다.
이는 철도 연결이 실패하는 가장 흔한 원인이며, 가장 도움이 되지 않는 방식으로 실패합니다.
- Railway의 개인 호스트 이름은 .railway.internal로 끝나며 Railway 자체 네트워크 내에서만 확인됩니다. 다른 곳에서는 전혀 확인되지 않습니다.
- 해당 담당자는 철도청 외부에서 근무하므로 개인 주소로는 절대 연락이 닿지 않습니다. — 연결이 끊어지면 이유를 알려주지 않고 그냥 연결이 종료됩니다.
- 그래서 카드는 해당 요청을 즉시 거부하고 해결 방법을 제시합니다. 바로 DATABASE_PUBLIC_URL에 있는 공용 TCP 프록시 호스트를 사용하는 것입니다. 이렇게 하면 조용한 타임아웃 메시지가 사용자가 조치를 취할 수 있는 메시지로 바뀝니다.
- 공용 프록시 호스트는 .proxy.rlwy.net으로 끝납니다. 이전 Railway 배포 환경에서는 .railway.app 호스트 이름이 사용되었으며, 서비스에서 해당 호스트 이름을 사용하는 경우 여전히 작동합니다.
포트 번호는 서비스별로 지정되므로 누구도 추측할 수 없습니다.
대부분의 관리형 Postgres 서비스는 5432 포트로 응답합니다. 하지만 Railway의 프록시는 그렇지 않으며, 카드에는 의도적으로 해당 필드가 비어 있습니다.
- 철도 회사는 서비스별로 프록시 포트를 할당합니다. 동일한 프로젝트 내의 두 데이터베이스는 서로 다른 프록시 포트를 가지며, 둘 다 5432 포트를 사용하지 않습니다.
- 포트 필드에 기본값이 없는 이유는 바로 그 때문입니다. 5432로 잘못 입력되면 연결이 실패할 수 있는데, 이는 포트 필드가 비어있는 것보다 더 심각한 문제입니다.
- DATABASE_PUBLIC_URL을 붙여넣으면 포트 번호도 다른 모든 정보와 함께 채워지므로, 일반적인 경로를 사용할 때는 포트 번호를 따로 찾을 필요가 없습니다.
- 필드를 직접 입력하는 경우, 포트 번호를 주의 깊게 복사해야 합니다. — 이는 오류가 발생할 가능성이 가장 높고, 실패하더라도 가장 적은 정보를 제공하는 분야입니다.
자체 서명 인증서와 여기서 암호화의 의미는 무엇일까요?
Railway의 Postgres 이미지는 자체 서명된 인증서를 제공하며, 이 인증서가 에이전트가 TLS를 처리하는 방식을 결정합니다.
- SSL 사용이 기본적으로 활성화되어 있으며 연결이 암호화됩니다. 에이전트는 단순히 TLS를 제공하는 것이 아니라 TLS를 요구합니다.
- 인증서 체인이 검증되지 않았습니다. 전체 검증을 수행하면 Railway의 자체 서명 인증서가 거부되므로, 체인 검증 없이 암호화만 요구하는 설정이 실제로 서비스에 적합한 설정입니다.
- 그건 목적지에 도착했다는 증거라기보다는, 도중에 누군가가 교통 정보를 읽는 것을 막기 위한 보호 장치로 이해하시면 됩니다.
- Railway Postgres 앞에는 풀러가 없으며 카드도 그렇지 않은 척하지 않습니다. — 이는 프록시를 통한 직접 연결이며, 풀링 모드를 선택할 수 없습니다.
-- 일반 Postgres, 읽기 전용, 공용 프록시를 통한 SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;
모든 데이터베이스 커넥터에서 공유됨
모든 데이터베이스 커넥터에 해당되는 사항입니다.
- 출국 전용 — 에이전트는 쿼리 스트림으로 암호화된 연결을 하나만 엽니다. 포트 포워딩도 필요 없고, VPN도 필요 없고, IP 허용 목록도 필요 없으며, 데이터베이스 정보가 인터넷에 노출되는 것도 없습니다.
- 자격 증명은 그대로 유지됩니다. — 데이터베이스 사용자 이름과 비밀번호는 에이전트를 설치한 컴퓨터에 있습니다. Query Streams는 이러한 정보를 수신하지 않으며 자체적으로 데이터베이스에 접근할 수 없습니다.
- 읽기 전용, 강제 적용됨 — 한 번에 하나의 명령문만 사용 가능하며, SELECT 및 관련 명령만 허용됩니다. 쓰기 작업은 서버로 전송되기 전에 사용자 컴퓨터에서 거부되므로, 다른 사용자가 설정해 둔 권한에 의존하지 않습니다.
- 원하는 만큼 에이전트를 배포하세요 사이트, 지역 또는 클라우드별로 하나씩만 있으면 됩니다. 모든 데이터 소스가 단일 드롭다운 메뉴에 표시되므로 어떤 에이전트가 무엇을 호스팅하는지 알 필요가 없습니다.
쿼리가 저장되면 다음과 같은 결과가 나타납니다.
- SQL이 아니라 기능을 공유하세요. — 동료나 외부 파트너는 쿼리를 실행하고 해당 쿼리의 바탕이 된 구문을 전혀 보지 않고도 필터를 변경할 수 있습니다.
- 양방향 필터 — 직접 @variables로 선언하거나, 커넥터가 WHERE 절에 이미 있는 리터럴 값을 감지하여 드롭다운 메뉴로 제공하도록 할 수 있습니다.
- 어디서든 읽어보세요 — Microsoft Excel, Google Sheets, Power BI, REST API, MCP 기반 AI 비서, 쿼리 빌더 및 Nova는 모두 동일한 저장된 쿼리를 읽습니다.
- 여러 개를 동시에 실행하세요 — 5개의 저장된 쿼리가 5개의 워크시트 탭에 동시에 스트리밍되며, 결과 크기에 관계없이 실행됩니다.
- 이미 연결된 다른 항목과 연결하세요. — 다른 데이터베이스, 비즈니스 API 또는 파일 폴더를 하나의 읽기 전용 명령으로 액세스할 수 있습니다.
크로스 소스 SQL
Railway 데이터를 나머지 데이터에 연결하세요
하나의 명령문으로 Railway와 다른 연결들을 동시에 관리할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 다시 스트리밍하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며 어떤 것도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택 c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM 철도 앱.공공.명령1 f
JOIN erp_sql.dbo.customers2 c ON c.id = f.customer_id
JOIN 청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 c.지역
주문 기준 청구서 발행 DESC;
세 가지 요소는 연결, 스키마, 테이블이며, 연결 이름은 사용자가 지정한 대로 지정할 수 있습니다. 열은 예시일 뿐이며, 테이블은 실제 테이블이어야 합니다. 모든 부분은 읽기 전용으로 적용됩니다. SELECT, WITH, EXPLAIN만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
철도에 필요한 것
- 주인
- <name>.proxy.rlwy.net은 공용 TCP 프록시입니다. .railway.app에 배포된 이전 버전도 작동합니다.
- 포트
- 철도 회사에서 서비스별로 할당합니다. 기본값은 없으며, DATABASE_PUBLIC_URL에서 가져옵니다.
- 운전사
- 에이전트가 제공하는 Npgsql이므로 철도 측에서 설치할 필요가 없습니다.
- 붙여넣기 형식
- 서비스 변수 탭에서 DATABASE_PUBLIC_URL을 가져옵니다.
- 데이터베이스
- 철도(Railway)는 Railway에서 기본적으로 사용하는 이름입니다.
- 사용자 이름
- 포스트그레스
- TLS
- Railway 호스트의 에이전트가 필수로 요구하며 강제합니다. 암호화되어 있으며, 인증서 체인은 검증되지 않습니다. 이는 Railway의 자체 서명 인증서에 필요한 사항입니다.
- 풀링
- 없음. 해당 에이전트는 철도에 대한 공동 이용 관련 규정을 적용하지 않습니다.
- 이 카드는 아닙니다
- .railway.internal이라는 개인 호스트 이름은 카드에서 거부하고 대신 사용할 변수를 알려줍니다.
- 저장됨
- PostgreSQL에서 Railway는 일종의 배지로 유지되지만, Railway라는 이름의 연결 유형은 존재하지 않습니다.
- 기본 스키마
- 연방 참조가 의미하는 바는 바로 '공공'입니다.
이 카드의 핵심은 개인용 변수와 공용 변수의 차이입니다. Railway는 DATABASE_URL을 눈에 띄게 표시하며, 이는 Railway 내부에서 실행되는 서비스에 적합한 변수입니다. Railway의 주된 용도가 바로 이러한 내부 서비스 실행입니다. 외부에서 접근하는 경우는 예외이며, 이 예외적인 경우에는 다른 변수가 필요합니다. 내부 호스트 이름을 명시적으로 거부하는 것은, 해당 호스트 이름이 아무것도 찾지 못하고 시간 초과되는 것을 방지하여 5초 만에 문제를 해결하는 것과 20분 동안 방화벽 문제를 의심하는 것 사이의 차이를 만듭니다.
포트 필드를 비워둔 것은 의도적인 조치이며, 그 이유를 설명할 가치가 있습니다. 거의 모든 PostgreSQL 서비스에서 5432 포트를 사용하기 때문에 본능적으로 5432를 미리 채워두는 것이 좋겠지만, Railway의 프록시는 서비스별로 포트를 할당하므로 5432를 미리 채워두면 확실히 잘못된 값이 됩니다. 필수 입력란을 비워두는 것은 의문을 제기하는 것이지만, 잘못된 기본값을 설정하면 잘못된 답변처럼 보이고 마치 확정된 것처럼 느껴집니다.
여러 소스를 연결하는 쿼리의 경우 Railway는 일반 PostgreSQL과 동일합니다. railway_app이라는 연결을 생성하면 railway_app.public.orders로 기록되며, CSV 파일이 있는 폴더, 온프레미스 시스템 기록 또는 청구 API와 하나의 읽기 전용 명령으로 연결됩니다. 이 과정에서 아무것도 복사되거나 예약되지 않습니다.
공급업체 문서: docs.railway.com
자주 묻는 질문
철도에 관한 질문
쿼리 스트림을 통해 철도 데이터를 읽을 수 있는 도구는 무엇입니까?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
철도 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?
아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.
Query Streams를 사용하면 Railway의 데이터가 변경될 수 있나요?
아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.
Query Streams가 Railway에 연결하려면 무엇이 필요합니까?
접근 가능한 호스트, 역할 및 해당 암호 - 에이전트가 드라이버를 포함하므로 데이터베이스에 아무것도 설치하지 않습니다. 호스트: <name>.proxy.rlwy.net, 공용 TCP 프록시입니다. .railway.app에 배포된 이전 버전도 작동합니다. 포트: Railway에서 서비스별로 할당합니다. 기본값은 없으며 DATABASE_PUBLIC_URL에서 가져옵니다. 드라이버: 에이전트에서 제공하는 Npgsql - Railway 측에서 설치할 필요가 없습니다. 붙여넣기 형식: 서비스 변수 탭에서 DATABASE_PUBLIC_URL을 가져옵니다.
동일한 쿼리로 Railway 데이터베이스를 다른 데이터베이스와 조인할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Railway와 다른 연결들을 동시에 참조할 수 있으며, 연결 이름은 connection.schema.table입니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스들이 서로 연결되지 않고, 데이터 복사나 스케줄링도 발생하지 않습니다. 읽기 전용은 SELECT, WITH, EXPLAIN 문에만 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.
철도 연결과 포스트그레스SQL 연결은 어떻게 다른가요?
연결 문자열만 필요합니다. Railway는 PostgreSQL 와이어 프로토콜을 사용하므로 필터, 예약, 공유, Excel 및 Google Sheets 추가 기능, MCP 서버 모두 동일하게 작동합니다. Railway 카드는 공급자가 예상하는 호스트, 포트 및 SSL 설정을 미리 채워 넣습니다.
철도에서 엑셀로 가는 길을 안내하는 가이드가 있나요?
네, 맞습니다. 해당 내용은 PostgreSQL 가이드이며, Railway에 맞게 정확하게 작성되었습니다. Railway는 PostgreSQL 와이어 프로토콜을 사용하므로 Railway에서 Excel, Google Sheets 등으로 데이터를 전송할 때 동일한 단계를 따릅니다. Railway에 특화된 부분은 연결 문자열뿐이며, Railway 카드에서 해당 부분을 자동으로 입력해 줍니다.

