하나의 연결, 모든 표면
Supabase 데이터가 저장될 수 있는 위치
- 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 엔드포인트에서 Supabase 프로젝트를 실시간 SQL로 읽어옵니다. Supabase 대시보드에서 문자열을 붙여넣으면 호스트, 포트, 데이터베이스 및 역할이 자동으로 읽힙니다. 직접 연결, 세션 풀러 연결, 트랜잭션 풀러 연결의 세 가지 연결 모드가 모두 인식되며, 모든 Supabase 호스트에서 TLS가 강제 적용되고 플랫폼 자체 스키마는 숨겨집니다. 따라서 인증, 저장소 및 실시간 정보가 아닌 테이블 정보만 표시됩니다.
- 귀사 팀, 협력업체 및 파트너 여러분께
-
수파베이스에서 엑셀로 마이크로소프트 엑셀 · 엑셀 추가 기능
Supabase의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. 데스크톱 Excel, Excel Online, Microsoft 365에서 사용 가능합니다.
PostgreSQL 가이드 -
Supabase에서 Google Sheets로 스프레드시트 추가 기능
사이드바에서 저장된 Supabase 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
PostgreSQL 가이드 -
Supabase에 대해 Nova에게 문의하세요. Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 사용자의 Supabase 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 계정 정보를 제공할 필요가 없습니다.
Nova는 어떻게 작동하나요? -
수파베이스에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
Supabase 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유하세요. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 뿐, SQL 쿼리나 계정 정보는 전혀 볼 수 없습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
수파베이스 REST API HTTP 엔드포인트
Supabase 쿼리를 인증된 JSON 엔드포인트로 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양과 Postman, Insomnia, Hoppscotch 컬렉션이 바로 사용 가능합니다. 데이터베이스 포트는 열지 않습니다.
PostgreSQL 가이드 -
Supabase에서 Power BI로 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 실시간 Supabase 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.
Power BI 작동 방식 -
수파베이스에서 에어테이블로 자동화 플랫폼
Supabase 행을 예약된 시간에 Airtable 베이스로 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.
PostgreSQL 가이드 -
수파베이스에서 베이스로우까지 자동화 플랫폼
Supabase의 Baserow 테이블을 REST 엔드포인트를 통해 제공합니다(자체 호스팅 또는 Baserow 클라우드 환경).
PostgreSQL 가이드 -
수파베이스에서 시테이블까지 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 Supabase 데이터로 최신 상태로 유지하세요.
PostgreSQL 가이드 -
Supabase에서 Smartsheet로 자동화 플랫폼
Supabase 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기가 아닌 원본 시스템의 데이터를 읽도록 합니다.
PostgreSQL 가이드 -
수파베이스에서 앤빌까지 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 Supabase로 백업할 때 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하는 방법입니다.
PostgreSQL 가이드 - AI 도구의 경우
-
수파베이스 MCP 서버 Claude, Cursor 및 MCP 고객
AI 어시스턴트에게 올바른 SQL 쿼리를 작성하는 데 필요한 스키마와 함께 Supabase에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅에서 자격 증명을 입력할 필요는 없습니다.
PostgreSQL 가이드 - 사람들에게 전달됨
-
Supabase 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
Supabase 쿼리를 예약 실행하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
네트워크 에이전트는 아웃바운드 HTTPS가 지원되는 모든 곳에 설치할 수 있습니다. Supabase는 공용 엔드포인트이므로 인바운드 규칙이나 허용 목록은 필요하지 않습니다.
Supabase 대시보드에서 연결 문자열을 복사하여 붙여넣으세요. 호스트, 포트, 데이터베이스 및 역할은 문자열에서 읽어오고, 문자열 자체는 저장되지 않습니다.
모드를 선택하세요. 세션 풀러가 기본값이며, 에이전트가 장시간 연결을 유지하기 때문에 이 경우에 적합한 선택입니다.
저장하세요. 테이블이 읽혔습니다. Supabase 자체 플랫폼 스키마는 목록에서 제외되므로 선택기에 사용자가 작성하지 않은 항목이 가득 차지 않습니다.
읽기 전용 SQL을 직접 작성하거나, Nova가 작성하도록 할 수 있습니다. 저장된 쿼리는 Excel, Sheets, Power BI, MCP 또는 REST에서 읽을 수 있습니다.
기능 심층 분석
Supabase가 제공하는 기능
진입 방법 세 가지, 어떤 방법을 선택해야 할까요?
Supabase는 직접 연결과 두 개의 풀러 엔드포인트를 제공하며, 어떤 엔드포인트를 선택하느냐는 겉보기보다 중요합니다. 에이전트는 호스트와 포트를 통해 사용자가 지정한 엔드포인트를 인식하고 자동으로 작동합니다.
- 세션 풀러 — pooler.supabase.com 호스트의 5432번 포트입니다. 이는 기본 설정이며 권장 사항입니다. 세션 모드의 풀러는 장시간 연결을 위해 설계되었기 때문입니다.
- 거래 풀러 — 포트 6543. 다음 사항을 인식하고 조정했습니다. 세션은 종료 시 재설정되지 않으며, 서버 측 준비된 문은 비활성화됩니다. 이는 트랜잭션 풀러가 문 간에 백엔드를 재할당하는데, 이 과정에서 준비된 문이 유지되지 않기 때문입니다.
- 직접 — db.<project>.supabase.co 호스트의 5432번 포트입니다. Supabase는 IPv4 추가 기능을 구매하지 않은 경우 IPv6으로만 서비스를 제공한다는 점을 알아두세요. 에이전트 네트워크가 IPv4 전용인 경우 연결이 실패하고, 오류 메시지에 해당 내용이 표시되며 세션 풀러를 사용하라는 안내가 나옵니다.
- 사용자 이름 모양은 서로 다릅니다. — 풀러는 postgres.<project-ref>를 원하고, 직접 쿼리는 일반 postgres를 원합니다. — 그리고 이는 첫 번째 쿼리 시점이 아니라 입력하는 동안 확인됩니다.
Supabase의 내부 구조가 아니라 스키마를 직접 구성하세요.
수파베이스 프로젝트는 자체 스키마에 상당한 양의 기능을 포함하고 있습니다. 그대로 두면 테이블 선택기가 보고하고 싶지 않은 정보로 가득 차게 됩니다.
- auth, storage, realtime, supabase_functions, supabase_migrations, pgbouncer 등은 Supabase 호스트의 목록에서 숨겨져 있습니다.
- 필터링 키는 호스트에서 분리되므로, 'auth'라는 스키마를 가진 일반 Postgres 서버는 해당 키를 유지합니다. Supabase 데이터베이스가 아닌 다른 데이터베이스에서는 아무것도 숨겨지지 않습니다.
- `public`은 기본 스키마로 유지되며, 이는 소스 간 쿼리가 중간 부분으로 사용하는 스키마입니다.
비밀번호 입력이 거부될 경우
Supabase 설정 실패의 가장 흔한 원인은 다소 혼란스럽습니다. 대시보드 로그인과 데이터베이스 암호는 서로 다른 것이며, 실제로 필요한 것은 데이터베이스 암호입니다. PostgreSQL이 자격 증명을 거부할 경우, 에이전트는 오류 메시지를 그대로 전달하는 대신 어떤 암호가 잘못되었는지 알려줍니다.
-- supabase_app은 연결 이름이고, public은 PostgreSQL 스키마입니다. SELECT p.plan, COUNT(*) AS accounts FROM supabase_app.public.profiles p JOIN stripe.stripe.subscriptions s ON s.customer_id = p.stripe_id WHERE s.status = 'active' GROUP BY p.plan
모든 데이터베이스 커넥터에서 공유됨
모든 데이터베이스 커넥터에 해당되는 사항입니다.
- 출국 전용 — 에이전트는 쿼리 스트림으로 암호화된 연결을 하나만 엽니다. 포트 포워딩도 필요 없고, VPN도 필요 없고, IP 허용 목록도 필요 없으며, 데이터베이스 정보가 인터넷에 노출되는 것도 없습니다.
- 자격 증명은 그대로 유지됩니다. — 데이터베이스 사용자 이름과 비밀번호는 에이전트를 설치한 컴퓨터에 있습니다. Query Streams는 이러한 정보를 수신하지 않으며 자체적으로 데이터베이스에 접근할 수 없습니다.
- 읽기 전용, 강제 적용됨 — 한 번에 하나의 명령문만 사용 가능하며, SELECT 및 관련 명령만 허용됩니다. 쓰기 작업은 서버로 전송되기 전에 사용자 컴퓨터에서 거부되므로, 다른 사용자가 설정해 둔 권한에 의존하지 않습니다.
- 원하는 만큼 에이전트를 배포하세요 사이트, 지역 또는 클라우드별로 하나씩만 있으면 됩니다. 모든 데이터 소스가 단일 드롭다운 메뉴에 표시되므로 어떤 에이전트가 무엇을 호스팅하는지 알 필요가 없습니다.
쿼리가 저장되면 다음과 같은 결과가 나타납니다.
- SQL이 아니라 기능을 공유하세요. — 동료나 외부 파트너는 쿼리를 실행하고 해당 쿼리의 바탕이 된 구문을 전혀 보지 않고도 필터를 변경할 수 있습니다.
- 양방향 필터 — 직접 @variables로 선언하거나, 커넥터가 WHERE 절에 이미 있는 리터럴 값을 감지하여 드롭다운 메뉴로 제공하도록 할 수 있습니다.
- 어디서든 읽어보세요 — Microsoft Excel, Google Sheets, Power BI, REST API, MCP 기반 AI 비서, 쿼리 빌더 및 Nova는 모두 동일한 저장된 쿼리를 읽습니다.
- 여러 개를 동시에 실행하세요 — 5개의 저장된 쿼리가 5개의 워크시트 탭에 동시에 스트리밍되며, 결과 크기에 관계없이 실행됩니다.
- 이미 연결된 다른 항목과 연결하세요. — 다른 데이터베이스, 비즈니스 API 또는 파일 폴더를 하나의 읽기 전용 명령으로 액세스할 수 있습니다.
크로스 소스 SQL
Supabase를 나머지 데이터와 통합하세요
하나의 명령문으로 Supabase와 다른 연결들을 동시에 관리할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 스트리밍으로 전송하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며, 어떤 데이터도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택 c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM supabase_app.공공.명령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만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
Supabase에 필요한 것
- 포트
- 직접 접속 및 세션 풀러의 경우 5432, 트랜잭션 풀러의 경우 6543을 사용합니다.
- TLS
- .supabase.co 또는 .pooler.supabase.com 호스트에 대해 에이전트가 필수로 요구하며 강제합니다. sslmode가 손실된 붙여넣기 문자열도 암호화된 연결을 유지합니다.
- 데이터베이스
- postgres입니다. 이름을 바꾸지 않았다면요.
- 역할
- 대시보드 로그인 정보가 아니라 데이터베이스 역할과 해당 데이터베이스 암호를 사용해야 합니다. SELECT 권한만 있는 역할이 적합합니다.
- 사용자 이름 모양
- 풀러 호스트에서는 postgres.<project-ref>로, 직접 호스트에서는 일반 postgres로 실행됩니다. 지금 바로 확인해 보겠습니다.
- 운전사
- 에이전트에 포함된 Npgsql 9.0.3 버전이므로 Supabase 측에서 별도로 설치할 사항은 없습니다.
- 직접 호스트
- IPv4 추가 기능이 없는 경우 IPv6만 지원합니다. 세션 풀러는 IPv4와 IPv6 모두에서 접근 가능합니다.
- 숨겨진 스키마
- 인증, 스토리지, 실시간, supabase_functions, supabase_migrations, pgbouncer 및 관련 기능은 Supabase 호스트에서만 사용 가능합니다.
- 읽기 전용
- 명세서가 수파베이스로 전송되기 전에 에이전트에게 적용됩니다.
역할에 SELECT 권한만 부여하고 그 이상은 아무것도 부여하지 마세요. Supabase는 기본적으로 PostgreSQL을 기반으로 하므로, `GRANT SELECT ON ALL TABLES IN SCHEMA public` 명령과 `ALTER DEFAULT PRIVILEGES` 명령만으로 나중에 추가하는 테이블에도 접근할 수 있습니다. 이러한 권한 부여 여부와 관계없이, 에이전트는 읽기 작업이 아닌 모든 명령은 Supabase에 도달하기 전에 거부합니다.
행 수준 보안은 여전히 적용됩니다. 연결은 사용자가 부여한 역할로 읽히므로, 정책에서 해당 역할이 볼 수 있는 항목을 제한하는 경우 저장된 쿼리는 동일한 하위 집합을 보게 됩니다. 이는 보고 연결의 범위를 의도적으로 제한하는 합리적인 방법입니다.
여러 소스를 연결하는 쿼리에서 3부분으로 구성된 참조의 중간 부분은 공개되어 있으며, 이는 PostgreSQL 스키마를 가리킵니다. supabase_app이라는 연결은 supabase_app.public.profiles로 기록됩니다.
공급업체 문서: 수파베이스닷컴
자주 묻는 질문
수파베이스 관련 질문
쿼리 스트림을 통해 Supabase 데이터를 읽을 수 있는 도구는 무엇입니까?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
Supabase 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?
아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.
쿼리 스트림을 통해 Supabase의 데이터를 변경할 수 있나요?
아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.
Query Streams가 Supabase에 연결하려면 무엇이 필요합니까?
접근 가능한 호스트, 역할 및 해당 암호 - 에이전트가 드라이버를 제공하므로 데이터베이스에는 아무것도 설치되지 않습니다. 포트: 직접 연결 및 세션 풀러의 경우 5432, 트랜잭션 풀러의 경우 6543. TLS: 필수이며, 에이전트에서 .supabase.co 또는 .pooler.supabase.com 호스트에 대해 강제로 사용합니다. sslmode가 누락된 문자열을 붙여넣더라도 암호화된 연결이 됩니다. 데이터베이스: postgres(이름을 변경하지 않은 경우). 역할: 데이터베이스 역할 및 해당 데이터베이스 암호(대시보드 로그인이 아님). SELECT 전용 역할을 사용해야 합니다.
Supabase를 다른 데이터베이스와 동일한 쿼리로 조인할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Supabase와 다른 연결을 동시에 참조할 수 있으며, 연결.스키마.테이블 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 모든 부분(SELECT, WITH, EXPLAIN만 해당)에 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.
Supabase에서 Excel로 변환하는 가이드가 있나요?
네, 맞습니다. 해당 내용은 PostgreSQL 가이드이며, Supabase에 맞게 정확하게 작성되었습니다. Supabase는 PostgreSQL 와이어 프로토콜을 사용하므로 Supabase에서 Excel, Google Sheets 등으로의 연결은 모두 동일한 단계를 따릅니다. Supabase 관련 부분은 연결 문자열뿐이며, Supabase 카드에 해당 내용이 자동으로 입력되어 있습니다.

