하나의 연결, 모든 표면
PlanetScale 데이터가 저장될 수 있는 위치
- 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 엔드포인트에서 PlanetScale Postgres 데이터베이스를 읽기 전용 연결 하나로 처리합니다. 이 카드는 PlanetScale Postgres(.horizon.psdb.cloud의 최신 제품) 전용이며, PlanetScale이 더 잘 알려진 Vitess 기반 MySQL 서비스용이 아닙니다. 이 카드는 기본적으로 대부분의 PlanetScale Postgres 데이터베이스에서 사용하는 포트인 6432번 포트의 PSBouncer에 연결되며, 에이전트는 이에 맞춰 준비된 문(prepared statements)을 비활성화합니다.
PlanetScale Postgres는 네트워크를 통한 PostgreSQL입니다. — 표준 드라이버이므로 아래의 모든 안내 사항이 변경 없이 적용됩니다. PlanetScale 관련 부분은 연결 문자열뿐이며, 이는 다음에서 다룹니다. 연결 정보.
- 귀사 팀, 협력업체 및 파트너 여러분께
-
PlanetScale에서 Excel까지 마이크로소프트 엑셀 · 엑셀 추가 기능
PlanetScale의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. 데스크톱 Excel, Excel Online, Microsoft 365에서 사용 가능합니다.
PostgreSQL 가이드 -
PlanetScale에서 Google Sheets로 스프레드시트 추가 기능
사이드바에서 저장된 PlanetScale 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
PostgreSQL 가이드 -
노바에게 플래닛스케일(PlanetScale)에 대해 물어보세요. Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 사용자의 PlanetScale 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 자격 증명을 제공할 필요가 없습니다.
Nova는 어떻게 작동하나요? -
PlanetScale에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
PlanetScale의 실시간 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 수 있고, SQL 쿼리나 자격 증명은 절대 볼 수 없습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
PlanetScale REST API HTTP 엔드포인트
PlanetScale 쿼리를 인증된 JSON 엔드포인트로 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양과 Postman, Insomnia, Hoppscotch 컬렉션이 이미 준비되어 있습니다. 데이터베이스 포트는 열지 않습니다.
PostgreSQL 가이드 -
PlanetScale에서 Power BI로 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 PlanetScale의 실시간 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.
Power BI 작동 방식 -
PlanetScale에서 Airtable로 자동화 플랫폼
PlanetScale의 행을 예약된 시간에 Airtable 베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.
PostgreSQL 가이드 -
플래닛스케일에서 베이스로우까지 자동화 플랫폼
PlanetScale의 Baserow 테이블을 REST 엔드포인트를 통해 제공합니다(자체 호스팅 또는 Baserow 클라우드).
PostgreSQL 가이드 -
플래닛스케일에서 씨테이블까지 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 PlanetScale 데이터로 최신 상태로 유지하세요.
PostgreSQL 가이드 -
PlanetScale에서 Smartsheet로 자동화 플랫폼
PlanetScale 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기가 아닌 원본 시스템에서 읽어오도록 하세요.
PostgreSQL 가이드 -
플래닛스케일에서 앤빌까지 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 PlanetScale로 백업하려면 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하면 됩니다.
PostgreSQL 가이드 - AI 도구의 경우
-
PlanetScale MCP 서버 Claude, Cursor 및 MCP 고객
AI 어시스턴트에게 올바른 SQL을 작성하는 데 필요한 스키마와 함께 PlanetScale에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅에서 자격 증명을 주고받을 필요는 없습니다.
PostgreSQL 가이드 - 사람들에게 전달됨
-
PlanetScale 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
PlanetScale 쿼리를 예약 실행하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송받거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
네트워크 에이전트는 원하는 위치에 설치하십시오. 이 에이전트는 하나의 아웃바운드 연결을 열고 수신 대기는 하지 않으므로 PlanetScale은 일반 클라이언트로 인식하며 네트워크에 인바운드 규칙을 설정할 필요가 없습니다.
PlanetScale 콘솔에서 "Database"를 클릭한 다음 "Connect"를 클릭하여 문자열을 복사한 후 붙여넣으세요. postgresql:// 형식과 host= 키워드 형식 모두 읽어옵니다.
특별한 이유가 없는 한 PSBouncer Pool 모드를 유지하세요. PlanetScale이 기본적으로 가리키는 동일 호스트의 6432번 포트를 사용합니다.
사용자 이름에 점이 포함되어 있는지 확인하세요. PlanetScale 사용자 이름은 postgres.<데이터베이스 ID> 형식이며, 점 뒤의 부분이 올바른 데이터베이스로 연결되는 부분입니다.
저장하세요. Microsoft Excel, Google Sheets, Power BI, MCP 및 REST는 모두 해당 연결 하나를 통해 데이터를 읽거나, 단일 읽기 전용 명령문을 사용하여 다른 소스와 결합할 수 있습니다.
기능 심층 분석
PlanetScale이 제공하는 것
이것은 PlanetScale Postgres이지 PlanetScale MySQL이 아닙니다.
PlanetScale은 수년간 Vitess라는 회사로 운영되었기 때문에 이 카드가 어떤 제품과 연결되는지 솔직하게 밝히는 것이 중요합니다.
- 이 커넥터는 PlanetScale Postgres용입니다. — .horizon.psdb.cloud에서 관리되는 Postgres 서비스입니다. 이 서비스는 Postgres 와이어 프로토콜을 사용하며, 에이전트는 Npgsql을 사용하여 해당 서비스에 연결합니다.
- 이 카드는 Vitess 기반 MySQL 서비스용이 아닙니다. 해당 서비스에 대한 사전 설정이 없으며, PlanetScale에서 제공하는 MySQL 연결 문자열은 이 카드에 맞지 않습니다.
- 연결 정보는 PostgreSQL 형식으로 저장되며, PlanetScale은 배지로 유지됩니다. PlanetScale이라는 이름의 연결 유형은 존재하지 않습니다. 즉, 이전에 .horizon.psdb.cloud 호스트에 설정한 일반 Postgres 연결도 즉시 브랜딩을 인식하게 된다는 의미입니다.
- 그 이후의 모든 것은 일반적인 PostgreSQL과 같습니다. 스키마, 타입, 그리고 소스 간 참조에서 기본 스키마로 사용되는 public 등이 모두 동일합니다.
PSBouncer가 기본 설정이며, 포트 번호가 이를 결정합니다.
PlanetScale은 직접 엔드포인트와 동일한 호스트 이름에서 포트 하나만 다른 포트에서 풀러를 실행합니다. 네트워크 카드는 PlanetScale이 가리키는 풀링된 엔드포인트를 기본적으로 사용합니다.
- Direct 포트는 5432입니다. PSBouncer PlanetScale의 트랜잭션 풀러는 동일 호스트의 6432번 포트를 사용합니다. 그 외에는 아무런 변경 사항이 없습니다.
- 6432 포트에서 에이전트는 준비된 문장 기능을 끄고 세션 종료 시 세션 재설정을 중지합니다. 트랜잭션 풀러는 문장 실행 간에 다른 백엔드를 제공할 수 있으며, 그렇지 않다고 가정하는 드라이버는 무작위적인 것처럼 보이는 방식으로 오류를 발생시킵니다.
- 포트가 그 문제를 일으키는 것이지 드롭다운 메뉴가 아닙니다. 드롭다운 메뉴는 카드가 두 가지 선택이 일치하지 않을 경우를 방지하기 위해 존재합니다. 예를 들어, 잘못된 포트로 풀링을 선택하거나 6432 포트로 직접 연결하는 경우, 첫 번째 오류가 발생하기 전이 아니라 저장하기 전에 알려줍니다.
- 별도의 호스트 이름을 기억할 필요도 없고, 두 번째 자격 증명 세트도 필요하지 않습니다. 포트만 변경하면 스위치 전체가 작동합니다.
사용자 이름에 점이 들어가 있는데, 그게 중요합니다.
네 가지 항목 중 두 가지는 미묘하게 틀리기 쉬우므로, 카드에는 두 가지 모두 확인란이 있습니다.
- PlanetScale 사용자 이름은 postgres.<데이터베이스 ID> 형식입니다. 마침표(.) 없이 붙여넣으면 오류가 발생하는데, 마침표 뒤의 부분이 데이터베이스를 선택하는 부분이기 때문입니다.
- 비밀번호 앞뒤에 공백이 있는 경우 문제가 될 수 있습니다. 이는 클립보드에서 발생하는 오류이며, 일반적인 인증 오류로 인식되어 사용자가 잘못된 문제 해결에 집중하게 만듭니다.
- Postgres 연결 문자열이 아닌 모든 것은 잘못된 필드로 부분적으로 파싱되는 대신, 올바른 연결 문자열의 위치를 알려주는 메시지와 함께 거부됩니다.
- 붙여넣은 문자열은 절대 저장되지 않습니다. 폼을 채우기 위해 한 번 읽어 들인 후 삭제되므로 비밀번호는 두 곳이 아닌 한 곳에만 저장됩니다.
-- 일반 Postgres, 읽기 전용, PSBouncer 또는 직접 실행 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
PlanetScale을 나머지 데이터와 연결하세요
하나의 명령문으로 PlanetScale과 다른 연결들을 동시에 관리할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 스트리밍으로 전송하며, 최종 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며, 어떤 데이터도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택 c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM ps_앱.공공.명령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만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
PlanetScale에 필요한 것
- 주인
- <이름>.<지역>.horizon.psdb.cloud
- 포트
- PSBouncer의 경우 6432, 직접 연결 시 5432입니다. 어느 쪽이든 호스트는 동일하며, 카드는 기본적으로 6432를 사용합니다.
- 운전사
- 에이전트에서 제공하는 Npgsql이므로 PlanetScale 측에서 설치할 필요가 없습니다.
- 사용자 이름
- postgres.<데이터베이스 ID>처럼 점이 찍혀 있습니다. 카드는 점이 있는지 확인합니다.
- TLS
- 필수 항목이며, 모든 .horizon.psdb.cloud 호스트에 대해 에이전트에 의해 강제 적용됩니다. 암호화되어 있으며, 인증서 체인은 검증되지 않습니다.
- 풀링
- 6432 포트에서 에이전트는 준비된 문장을 비활성화하고 세션 재설정을 건너뛰는데, 이는 트랜잭션 풀러에 필요한 동작입니다.
- 저장됨
- PostgreSQL에서 PlanetScale을 배지로만 사용하는 것이지, PlanetScale이라는 이름의 연결 유형은 없습니다.
- 이 카드는 아닙니다
- PlanetScale의 Vitess 기반 MySQL 서비스입니다. 이 사전 설정은 PostgreSQL 제품에만 해당됩니다.
- 기본 스키마
- 연방 참조가 의미하는 바는 바로 '공공'입니다.
풀러 관련 세부 정보가 바로 이 부분을 설명하는 핵심입니다. PlanetScale은 PSBouncer를 트랜잭션 모드로 설정하는데, 이는 사용자가 유지하는 연결이 특정 백엔드에 고정되지 않고 두 개의 명령문 실행 사이에 다른 백엔드로 이동될 수 있음을 의미합니다. 기본 설정으로 유지되는 Postgres 드라이버는 이와 반대로 작동합니다. 명령문을 한 번 준비하고 다음에 실행할 때도 그대로 유지될 것으로 예상하며, 연결이 종료될 때 세션을 재설정합니다. 트랜잭션 풀러를 사용하는 경우 이러한 두 가지 가정이 모두 무너지며, 그마저도 간헐적으로 발생하는데, 이는 최악의 상황입니다. 에이전트는 포트 6432를 감지하면 이 두 가지 가정을 모두 해제하므로 사용자는 이러한 내용을 알 필요가 없습니다.
제품 경계를 명확히 하는 것은 단순한 사소함이 아닙니다. PlanetScale은 Vitess로 유명하기 때문에 PlanetScale 연결 문자열을 가지고 이 페이지에 접속한 사용자는 MySQL 연결 문자열도 가지고 있을 가능성이 높습니다. 따라서 이 카드가 PostgreSQL 서비스이며 Vitess 제품에는 사전 설정이 없다는 점을 명확히 밝히는 것은 한 문장으로 충분하며, 고객 지원팀과의 불필요한 대화를 방지할 수 있습니다.
여러 소스를 연결하는 쿼리의 경우 PlanetScale은 일반 PostgreSQL처럼 작동합니다. 사용자가 ps_app이라고 명명한 연결은 ps_app.public.orders로 기록되며, CSV 파일이 있는 폴더, 온프레미스 시스템 기록 또는 청구 API와 하나의 읽기 전용 명령으로 연결됩니다. 이 과정에서 아무것도 복사되거나 예약되지 않습니다.
공급업체 문서: 플래닛스케일닷컴
자주 묻는 질문
PlanetScale Postgres에 대한 질문
쿼리 스트림을 통해 PlanetScale PostgreSQL 데이터를 읽을 수 있는 도구는 무엇입니까?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
PlanetScale Postgres 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?
아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.
PlanetScale Postgres에서 Query Streams를 사용하여 데이터를 변경할 수 있습니까?
아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.
Query Streams가 PlanetScale Postgres에 연결하려면 무엇이 필요합니까?
접근 가능한 호스트, 역할 및 해당 암호 — 에이전트가 드라이버를 제공하므로 데이터베이스에 아무것도 설치하지 않습니다. 호스트: <이름>.<지역>.horizon.psdb.cloud. 포트: PSBouncer의 경우 6432, 직접 연결 시 5432. 어느 경우든 호스트는 동일하며, 카드는 기본적으로 6432를 사용합니다. 드라이버: 에이전트에서 제공하는 Npgsql 드라이버이므로 PlanetScale 측에서 설치할 필요가 없습니다. 사용자 이름: postgres.<데이터베이스 ID>와 같이 점으로 구분됩니다. 카드는 점이 있는지 확인합니다.
PlanetScale PostgreSQL 데이터베이스를 다른 데이터베이스와 동일한 쿼리로 조인할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 PlanetScale Postgres와 다른 연결들을 동시에 참조할 수 있으며, 연결 정보는 connection.schema.table 형식으로 작성됩니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스들이 서로 직접 연결되지 않고, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 SELECT, WITH, EXPLAIN 절에만 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.
PlanetScale Postgres에 연결하는 방법은 PostgreSQL에 연결하는 방법과 다른가요?
연결 문자열만 필요합니다. PlanetScale Postgres는 PostgreSQL 와이어 프로토콜을 사용하므로 필터, 예약, 공유, Excel 및 Google Sheets 추가 기능, MCP 서버 모두 동일하게 작동합니다. PlanetScale 카드는 공급자가 예상하는 호스트, 포트 및 SSL 설정을 미리 채워 넣습니다.
PlanetScale을 Excel로 변환하는 가이드가 있나요?
네, 맞습니다. 해당 문서는 PostgreSQL 가이드이며, PlanetScale PostgreSQL에 맞게 정확하게 작성되었습니다. PlanetScale은 PostgreSQL 와이어 프로토콜을 사용하므로 PlanetScale에서 Excel, Google Sheets 등으로의 전송은 모두 동일한 단계를 따릅니다. PlanetScale에 특화된 부분은 연결 문자열뿐이며, PlanetScale 카드에 해당 내용이 자동으로 입력되어 있습니다.

