구글 AlloyDB 로고

Postgres 호환 PostgreSQL을 사용합니다

연결하다 구글 AlloyDB 엑셀, 구글 시트, AI 및 REST로

VPC 내의 프라이빗 IP를 통해 또는 AlloyDB 인증 프록시를 통해 PostgreSQL용 AlloyDB에 액세스할 수 있습니다. 공용 IP는 필요하지 않으며, 인바운드 규칙도 설정할 수 없습니다.

하나의 연결, 모든 표면

AlloyDB 데이터가 저장될 수 있는 위치

Query Streams는 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 비서 및 REST 엔드포인트에서 AlloyDB 데이터를 읽기 전용 연결 하나로 처리합니다. AlloyDB는 연결할 수 있는 공개 호스트 이름이 없으며, Google Cloud VPC 내의 개인 IP 주소 또는 localhost의 AlloyDB 인증 프록시를 통해 접속해야 합니다. 동일한 VPC 내의 작은 VM에 네트워크 에이전트를 설치하면 외부 연결만 수행하면서 인스턴스에 비공개로 접속할 수 있으므로 AlloyDB에 공개 IP 주소가 필요하지 않고 VPC에 인바운드 규칙도 필요하지 않습니다.

Google AlloyDB는 네트워크를 통해 PostgreSQL처럼 작동합니다. — 표준 드라이버이므로 아래의 모든 가이드가 변경 없이 적용됩니다. AlloyDB 관련 부분은 연결 문자열뿐이며, 이는 다음에서 다룹니다. 연결 정보.

  1. 귀사 팀, 협력업체 및 파트너 여러분께
  2. AlloyDB에서 Excel로 마이크로소프트 엑셀 · 엑셀 추가 기능

    AlloyDB의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)

    PostgreSQL 가이드
  3. AlloyDB에서 Google Sheets로 스프레드시트 추가 기능

    사이드바에서 저장된 AlloyDB 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.

    PostgreSQL 가이드
  4. Nova에게 AlloyDB에 대해 문의하세요. Nova AI · 텍스트를 SQL로 변환

    쉬운 영어로 질문하세요. Nova는 이미 AlloyDB 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 자격 증명을 제공할 필요가 없습니다.

    Nova는 어떻게 작동하나요?
  5. AlloyDB에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱

    AlloyDB 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 수 있고, SQL 쿼리나 자격 증명은 절대 볼 수 없습니다.

    데이터 뷰어 작동 방식
  6. 앱 및 시스템용
  7. AlloyDB REST API HTTP 엔드포인트

    AlloyDB 쿼리를 인증된 JSON 엔드포인트로 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양과 Postman, Insomnia, Hoppscotch 컬렉션이 이미 준비되어 있습니다. 데이터베이스 포트는 열지 않습니다.

    PostgreSQL 가이드
  8. AlloyDB에서 Power BI로 파워 쿼리 M

    생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 AlloyDB의 실시간 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.

    Power BI 작동 방식
  9. AlloyDB에서 Airtable로 자동화 플랫폼

    AlloyDB 행을 예약된 시간에 Airtable 베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 행을 가져올 수 있습니다.

    PostgreSQL 가이드
  10. AlloyDB에서 Baserow로 자동화 플랫폼

    AlloyDB에서 Baserow 테이블을 REST 엔드포인트를 통해 제공합니다(자체 호스팅 또는 Baserow 클라우드).

    PostgreSQL 가이드
  11. AlloyDB에서 SeaTable로 자동화 플랫폼

    파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 AlloyDB 데이터로 최신 상태로 유지할 수 있습니다.

    PostgreSQL 가이드
  12. AlloyDB에서 Smartsheet로 자동화 플랫폼

    AlloyDB 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주에 내보낸 데이터가 아닌 원본 시스템에서 읽어오도록 합니다.

    PostgreSQL 가이드
  13. AlloyDB에서 Anvil로 앤빌 웍스 · 앱 플랫폼

    Anvil Python 앱을 AlloyDB로 백업하려면 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하면 됩니다.

    PostgreSQL 가이드
  14. AI 도구의 경우
  15. AlloyDB MCP 서버 Claude, Cursor 및 MCP 고객

    AI 비서에게 올바른 SQL을 작성하는 데 필요한 스키마와 함께 AlloyDB에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅에서 자격 증명을 입력할 필요는 없습니다.

    PostgreSQL 가이드
  16. 사람들에게 전달됨
  17. AlloyDB 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅

    AlloyDB 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.

    알림 및 보고서 작동 방식

작동 방식

5단계, 인바운드 방화벽 변경 없음

01

네트워크 에이전트를 AlloyDB 인스턴스와 동일한 Google Cloud VPC 내의 VM에 배치하십시오. 전체 설계는 이러한 배치를 전제로 합니다.

02

인스턴스의 개인 IP 주소를 입력하십시오. AlloyDB에는 호스트 이름이 없습니다. 주소가 바로 그 주소입니다.

03

또는 에이전트 VM에서 AlloyDB 인증 프록시를 실행하고 카드를 127.0.0.1로 지정하십시오. 카드는 localhost를 인식하고 이에 맞는 적절한 안내를 제공합니다.

04

데이터베이스 사용자 이름과 비밀번호를 입력하세요. AlloyDB는 기본적으로 PostgreSQL이라는 데이터베이스를 사용하며, 카드에 해당 정보가 미리 입력되어 있습니다.

05

저장하세요. Microsoft Excel, Google Sheets, Power BI, MCP 및 REST는 모두 해당 연결 하나를 통해 데이터를 읽거나, 단일 읽기 전용 명령문을 사용하여 다른 소스와 결합할 수 있습니다.

기능 심층 분석

AlloyDB가 제공하는 기능

VPC 내의 에이전트는 전체 설계입니다.

AlloyDB는 비공개로 설계되었고, 네트워크 에이전트는 외부 연결만 수행하도록 설계되었습니다. 이 두 가지 사실이 잘 맞아떨어지기 때문에 비공개 경로가 강화된 옵션이 아닌 기본값으로 설정되었습니다.

  • 동일한 VPC 내의 VM에서 에이전트를 실행하면 에이전트는 해당 인스턴스의 프라이빗 IP를 통해 인스턴스에 접속합니다. AlloyDB에 대한 정보는 공개되지 않으며, 공용 IP도 필요하지 않습니다.
  • 에이전트가 전화를 걸기만 하고 수신하지 않으므로 추가할 인바운드 규칙이 없고 VPC 외부의 누구도 접근할 수 없습니다.
  • AlloyDB는 호스트 이름이 아닌 IP 주소로 접근하기 때문에 Query Streams가 주소에서 인식할 수 있는 정보가 없습니다. AlloyDB 배지는 주소를 스니핑해서 얻는 것이 아니라, 해당 카드를 선택함으로써 얻는 것입니다. — 따라서 동일한 IP 주소에 대한 일반 Postgres 연결은 일반 Postgres로 표시됩니다.
  • AlloyDB는 PostgreSQL과만 호환됩니다. MySQL과 SQL Server도 제공하는 Cloud SQL과는 달리, AlloyDB에는 하나의 엔진만 있으며 엔진 선택 기능은 없습니다.

인증 프록시를 통해 SSL을 끄십시오.

지원되는 다른 경로는 Google의 AlloyDB 인증 프록시이며, 이 경우 양식의 답변 하나가 변경됩니다.

  • 에이전트 컴퓨터에서 프록시를 실행하고 카드가 127.0.0.1을 가리키도록 설정합니다. 카드가 localhost를 인식하고 다음 단계를 알려줍니다.
  • 프록시가 터널 자체를 암호화합니다. Postgres 드라이버에게 그 위에 자체 TLS 협상을 요청하는 것이 여기서 발생하는 SSL 오류의 원인이므로, 프록시 연결에 대한 확인란을 선택 해제하십시오.
  • 사설 IP에 직접 연결하는 경우 체크박스를 선택한 상태로 두세요. AlloyDB는 호스팅 제공업체 중 예외입니다. — 체크박스는 에이전트에 의해 재정의되는 것이 아니라, TLS 사용 여부를 실제로 제어합니다.
  • TLS가 활성화되면 트래픽은 암호화되지만 인증서 체인은 검증되지 않습니다.

일단 연결되면 일반 Postgres

주소와 프록시 이후에는 AlloyDB 관련 특정 프로세스가 없습니다. 실제로 전달되는 것은 PostgreSQL입니다.

  • 연결은 PostgreSQL로 저장되고 AlloyDB가 배지로 유지됩니다. AlloyDB라는 이름의 연결 유형은 없습니다.
  • 인증은 데이터베이스 사용자 이름과 비밀번호를 사용합니다. 이 카드는 Google Cloud IAM 데이터베이스 인증을 지원하지 않습니다.
  • 풀러 구성이 없으며 선택할 수 있는 풀링된 엔드포인트도 없습니다. 에이전트가 직접 연결됩니다.
  • public은 기본 스키마이며, 소스 간 참조 시 사용되는 스키마입니다.
-- 일반 Postgres, 읽기 전용, 개인 IP를 통한 쿼리 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

AlloyDB를 나머지 데이터와 결합하세요

하나의 명령문으로 AlloyDB와 다른 연결들을 동시에 실행할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 스트리밍으로 전송하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며 어떤 데이터도 복사되지 않습니다.

3개의 연결 · 3명의 에이전트

구글 AlloyDB Postgres 호환
Microsoft SQL Server 관계형 엔진
스트라이프 결제 및 청구

한 가지 진술

-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택   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만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식

연결 정보

AlloyDB에 필요한 것

주소
인스턴스의 개인 IP 주소입니다. AlloyDB는 공개 호스트 이름이 없으며, 인증 프록시를 사용하는 경우 127.0.0.1을 사용합니다.
포트
5432
운전사
에이전트에 의해 제공되는 Npgsql이므로 AlloyDB 측에서 설치할 필요가 없습니다.
에이전트 배치
동일 VPC 내의 가상 머신입니다. 아웃바운드 전용이므로 인바운드 규칙이 없고 공개적으로 노출되지 않습니다.
데이터베이스
기본적으로 PostgreSQL이며, 다음과 같이 미리 채워져 있습니다.
입증
데이터베이스 사용자 이름과 비밀번호입니다. IAM 데이터베이스 인증은 지원되지 않습니다.
TLS
체크박스로 제어되며 기본적으로 활성화되어 있습니다. 암호화되지만 인증서 체인은 검증되지 않습니다. 인증 프록시를 통해 연결할 때는 이 기능을 꺼야 합니다. 인증 프록시에서 터널 자체를 암호화합니다.
풀링
설정할 사항이 없습니다. 에이전트가 직접 연결됩니다.
엔진
PostgreSQL만 지원합니다. Cloud SQL과 달리 MySQL이나 SQL Server 옵션은 없습니다.
기본 스키마
연방 참조가 의미하는 바는 바로 '공공'입니다.

AlloyDB는 에이전트의 형태가 데이터베이스의 형태와 가장 잘 일치하는 대표적인 사례입니다. AlloyDB는 공용 IP 없이 사설 IP에서 운영되기를 원하며, 에이전트는 항상 외부 연결만 수행하고 어떤 IP 주소도 수신하지 않습니다. VPC 내에 두 데이터베이스를 함께 배치하면 별도의 협상이 필요하지 않습니다. 공용 IP를 활성화할 필요도 없고, 관리해야 할 승인된 네트워크 목록도 없으며, 나중에 감사해야 할 인바운드 규칙도 없습니다. 일반적으로 사설 데이터베이스에 접근하려면 네트워크 측면에서 비용이 발생하지만, AlloyDB의 경우에는 작은 가상 머신(VM) 하나만 있으면 됩니다.

인증 프록시 관련 각주는 오류가 발생하기 전에 읽어보는 것이 좋습니다. Google 프록시는 이미 터널을 암호화하므로 PostgreSQL 드라이버가 프록시 내부에서 TLS 협상을 시도할 때 연결 테스트가 SSL 오류로 실패하는데, 이 오류는 인증서 문제처럼 보이지만 실제로는 인증서 문제가 아닙니다. 프록시 연결의 경우 SSL 확인란을 해제하면 해결되며, localhost 주소를 감지하는 즉시 해당 메시지가 표시됩니다. 개인 IP에 직접 연결하는 경우에는 확인란을 활성화한 상태로 유지해야 합니다. 대부분의 호스팅 제공업체와 달리 AlloyDB에서는 에이전트가 아닌 확인란이 활성화 여부를 결정합니다.

여러 소스를 연결하는 쿼리의 경우 AlloyDB는 일반 PostgreSQL처럼 작동합니다. alloy_core라는 이름의 연결은 alloy_core.public.orders로 기록되며, CSV 파일이 있는 폴더, 온프레미스 시스템 기록 장치 또는 청구 API와 하나의 읽기 전용 명령으로 조인됩니다. 이때 아무것도 복사되거나 예약되지 않습니다. 조인 작업은 에이전트가 있는 위치에서 실행되므로 AlloyDB의 경우 VPC 내부에서 실행됩니다.

공급업체 문서: 클라우드.구글.com

자주 묻는 질문

Google AlloyDB 관련 질문

쿼리 스트림을 통해 Google AlloyDB 데이터를 읽을 수 있는 도구는 무엇인가요?

Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.

Google AlloyDB 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?

아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.

Query Streams를 사용하여 Google AlloyDB의 데이터를 변경할 수 있습니까?

아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.

Query Streams가 Google AlloyDB에 연결하려면 무엇이 필요합니까?

접근 가능한 호스트, 역할 및 해당 암호 - 에이전트가 드라이버를 제공하므로 데이터베이스에 아무것도 설치하지 않습니다. 주소: 인스턴스의 개인 IP 주소. AlloyDB는 공개 호스트 이름이 없으며, 인증 프록시를 사용하는 경우 127.0.0.1을 사용합니다. 포트: 5432. 드라이버: 에이전트에서 제공하는 Npgsql - AlloyDB 측에 설치할 필요가 없습니다. 에이전트 배치: 동일한 VPC 내의 VM. 아웃바운드 전용이므로 인바운드 규칙이 없고 공개적으로 노출되지 않습니다.

Google AlloyDB를 다른 데이터베이스와 동일한 쿼리로 조인할 수 있나요?

네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Google AlloyDB와 다른 연결을 동시에 참조할 수 있으며, 연결은 `connection.schema.table` 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 반환합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 모든 부분(SELECT, WITH, EXPLAIN)에 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

Google AlloyDB 연결 방식은 PostgreSQL 연결 방식과 다른가요?

연결 문자열만 필요합니다. Google AlloyDB는 PostgreSQL 와이어 프로토콜을 사용하므로 필터, 예약, 공유, Excel 및 Google Sheets 추가 기능, MCP 서버 모두 동일하게 작동합니다. AlloyDB 카드는 공급자가 예상하는 호스트, 포트 및 SSL 설정을 미리 채워 넣습니다.

AlloyDB에서 Excel로 변환하는 가이드가 있나요?

네, 맞습니다. 해당 내용은 PostgreSQL 가이드이며, Google AlloyDB에도 그대로 적용됩니다. AlloyDB는 PostgreSQL 와이어 프로토콜을 사용하므로 AlloyDB에서 Excel, Google Sheets 등으로 데이터를 전송하는 과정은 모두 동일합니다. AlloyDB에 특화된 부분은 연결 문자열뿐이며, AlloyDB 카드에서 해당 부분을 자동으로 입력해 줍니다.

AlloyDB를 작업이 이루어지는 곳에 배치하세요.

에이전트를 설치하고, 데이터베이스를 지정한 다음, 설치 위치를 선택하십시오.

읽기 전용 출국 전용 자격 증명은 에이전트에 저장됩니다.