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

