하나의 연결, 모든 표면
클라우드 SQL 데이터가 저장될 수 있는 위치
- 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 엔드포인트에서 Google Cloud SQL을 읽기 전용 연결 하나로 처리합니다. 하나의 카드로 PostgreSQL, MySQL 및 SQL Server를 모두 지원합니다. 네트워크 에이전트는 VPC 내 VM에서 실행되며 인스턴스의 프라이빗 IP를 통해 연결하고 외부로만 통신합니다. 따라서 인스턴스에는 공용 IP나 인증된 네트워크 항목이 필요하지 않습니다.
Google Cloud SQL은 네트워크를 통해 PostgreSQL/MySQL/Microsoft SQL Server를 사용하는 것과 같습니다. — 표준 드라이버이므로 아래의 모든 가이드가 변경 없이 적용됩니다. 클라우드 SQL 관련 부분은 연결 문자열뿐이며, 이는 다음에서 다룹니다. 연결 정보.
- 귀사 팀, 협력업체 및 파트너 여러분께
-
클라우드 SQL을 엑셀로 마이크로소프트 엑셀 · 엑셀 추가 기능
클라우드 SQL 결과를 실시간으로 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)
PostgreSQL 가이드 -
클라우드 SQL에서 Google Sheets로 스프레드시트 추가 기능
사이드바에서 저장된 클라우드 SQL 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
PostgreSQL 가이드 -
Nova에게 클라우드 SQL에 대해 문의하세요. Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 클라우드 SQL 테이블을 알고 있으므로 SQL 쿼리를 작성하고 실행한 다음 결과를 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 자격 증명을 제공할 필요가 없습니다.
Nova는 어떻게 작동하나요? -
클라우드 SQL에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
클라우드 SQL 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 수 있고, SQL 쿼리문이나 계정 정보는 절대 볼 수 없습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
클라우드 SQL REST API HTTP 엔드포인트
인증된 JSON 엔드포인트로 클라우드 SQL 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있으며, OpenAPI 3.1 사양과 Postman, Insomnia, Hoppscotch 컬렉션이 바로 사용 가능합니다. 데이터베이스 포트는 열지 않습니다.
PostgreSQL 가이드 -
클라우드 SQL에서 Power BI로 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 실시간 클라우드 SQL 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.
Power BI 작동 방식 -
클라우드 SQL에서 Airtable로 자동화 플랫폼
클라우드 SQL 행을 예약된 시간에 Airtable 데이터베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 행을 가져올 수 있습니다.
PostgreSQL 가이드 -
클라우드 SQL에서 Baserow로 자동화 플랫폼
클라우드 SQL에서 Baserow 테이블을 REST 엔드포인트를 통해 제공합니다(자체 호스팅 또는 Baserow 클라우드).
PostgreSQL 가이드 -
클라우드 SQL에서 SeaTable로 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 기본 데이터를 Cloud SQL 데이터로 최신 상태로 유지하세요.
PostgreSQL 가이드 -
클라우드 SQL에서 스마트시트로 자동화 플랫폼
Cloud SQL 결과를 Smartsheet 그리드에 푸시하여 계획 및 보고서가 지난주 내보내기가 아닌 원본 시스템에서 읽어오도록 합니다.
PostgreSQL 가이드 -
클라우드 SQL에서 Anvil까지 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 Cloud SQL로 백업하려면 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하면 됩니다.
PostgreSQL 가이드 - AI 도구의 경우
-
클라우드 SQL MCP 서버 Claude, Cursor 및 MCP 고객
AI 어시스턴트에게 올바른 SQL 쿼리를 작성하는 데 필요한 스키마와 함께 Cloud SQL에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅에서 자격 증명을 입력할 필요가 없습니다.
PostgreSQL 가이드 - 사람들에게 전달됨
-
클라우드 SQL 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
클라우드 SQL 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
Google Cloud VPC 내의 VM에 네트워크 에이전트를 설치하세요. 이 에이전트는 외부 연결만 수행하므로 인스턴스의 공용 IP를 끄고 승인된 네트워크를 비워둘 수 있습니다.
PostgreSQL, MySQL 또는 SQL Server 중에서 사용할 엔진을 선택하세요. 나머지 양식은 선택한 엔진에 따라 작성하시면 됩니다.
인스턴스의 개인 IP 주소를 입력하세요. 이미 공용 IP 주소로 접속하고 있다면 공용 IP 주소를 입력해도 되고, 클라우드 SQL 인증 프록시를 통해 접속하고 있다면 127.0.0.1을 입력해도 됩니다.
읽고자 하는 데이터에 대해 SELECT 권한이 있는 데이터베이스 사용자와 데이터베이스 이름을 추가하세요.
저장하세요. Microsoft Excel, Google Sheets, Power BI, MCP 및 REST는 모두 하나의 연결을 통해 해당 인스턴스를 읽거나 단일 명령문으로 다른 소스와 결합할 수 있습니다.
기능 심층 분석
클라우드 SQL이 제공하는 기능
사설 IP를 사용하는 것이 권장되는 방법이며, 가장 쉬운 방법이기도 합니다.
일반적으로 클라우드 SQL 연결은 이러한 데이터를 어디든 가져오는 데 있어 가장 어려운 부분입니다. 하지만 데이터를 읽는 주체가 이미 VPC 내부에 있다면 더 이상 어려운 문제가 아닙니다.
- 에이전트는 아웃바운드 연결만 수행하므로 VPC의 VM에 에이전트를 배치할 경우 인바운드 규칙이 필요하지 않습니다.
- 해당 인스턴스는 공용 IP 주소를 보유하지 않으며, 승인된 네트워크 목록은 비어 있습니다. — 사무실 주소가 변경되어도 업데이트할 사항이 없습니다.
- 호스트 이름이 없기 때문에 Cloud SQL은 IP 주소로 접근합니다. 이는 서비스의 특성이지 여기서의 제약 사항은 아닙니다.
- 기존에 공용 IP를 사용하고 있다면 여전히 작동합니다. 에이전트는 해당 IP가 어느 쪽에 있는지 상관하지 않습니다.
인증 프록시가 이해되었습니다.
많은 팀이 IP 주소를 직접 사용하는 대신 클라우드 SQL 인증 프록시를 통해 클라우드 SQL에 액세스하며, 카드는 이러한 방식을 감지합니다.
- 127.0.0.1 또는 localhost를 입력하면 프록시로 인식되며, 카드에는 해당 기능이 지원되는지 여부를 궁금해할 필요 없이 바로 표시되므로 안심하고 사용할 수 있습니다.
- 프록시 서버가 터널 자체를 암호화하므로 해당 경로에 대해서는 SSL 옵션을 꺼야 합니다. — 카드는 SSL 오류로 인해 혼란스러워질 수 있는 시점에 이 사실을 알려줍니다.
- IP 직접 연결의 경우 SSL 옵션을 켜야 하며, 기본적으로 켜져 있습니다.
- 프록시는 사용자가 직접 실행하고 관리해야 하는 프로세스이며, 에이전트에는 프록시 관련 내용이 전혀 포함되어 있지 않습니다.
엔진 세 개, 그리고 잘못된 엔진을 선택하지 않도록 하는 안전장치
멀티 엔진 카드를 사용할 때 한 가지 특정 실수가 발생하기 쉽습니다. 선택한 엔진과 다른 엔진에 속하는 포트를 붙여넣는 경우입니다. 이러한 조합은 연결 시 아무런 유용한 메시지 없이 실패하므로 양식에서 바로 감지됩니다.
- PostgreSQL은 5432, MySQL은 3306, SQL Server는 1433 포트에서 실행 중입니다. — 선택하신 엔진에 맞게 미리 채워져 있습니다.
- PostgreSQL이 선택된 상태에서 3306번 포트를 입력하면 카드가 해당 포트가 MySQL에 속한다고 알려주고, 포트를 통과시키는 대신 엔진을 확인하라고 요청합니다.
- 비밀번호 앞뒤에 공백이 있는 경우에도 문제가 발생합니다. 이는 거의 항상 클립보드에서 가져온 내용이며, 불투명한 인증 오류로 간주되어 실패하기 때문입니다.
- 어떤 엔진을 선택하든, 연결 정보는 해당 엔진 이름으로 저장됩니다. — 클라우드 SQL은 연결 유형이 아닌 카드에 배지로 표시됩니다.
-- 인스턴스가 실행되는 엔진에 관계없이 동일한 읽기 결과: SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM customers AS c JOIN orders AS o ON o.customer_id = c.id 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
클라우드 SQL을 나머지 데이터와 결합하세요
하나의 명령문으로 클라우드 SQL과 다른 연결들을 동시에 실행할 수 있습니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 스트리밍 방식으로 반환하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며 어떤 데이터도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택 c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM gcp_sales.공공.명령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만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
클라우드 SQL에 필요한 것
- 엔진
- PostgreSQL, MySQL 및 SQL Server를 하나의 카드에 담았습니다.
- 주소
- 인스턴스의 개인 또는 공용 IP 주소, 또는 Cloud SQL 인증 프록시를 통한 127.0.0.1을 사용합니다. Cloud SQL에는 가리킬 호스트 이름이 없습니다.
- 항구
- PostgreSQL 5432개, MySQL 3306개, SQL Server 1433개 — 엔진별로 미리 채워져 있으며, 사용자가 선택한 엔진과 교차 검증됩니다.
- TLS
- 직접 IP 연결의 경우 기본적으로 활성화되어 있으며, 인증 프록시를 통한 연결에서는 비활성화되어 있어야 합니다. 인증 프록시는 자체 터널을 암호화합니다.
- 저장됨
- 선택한 엔진에 Cloud SQL이라는 표시가 남아 있지만, Cloud SQL이라는 이름의 연결 유형은 없습니다.
- 인식
- 호스트 이름이 없기 때문에 배지는 이 카드에서 생성된 연결을 기반으로 표시됩니다. 이전에 동일한 인스턴스에 대해 생성된 일반 연결은 소급하여 배지를 표시하지 않습니다.
- 권한
- 읽고자 하는 항목에 대해 SELECT 권한을 가진 데이터베이스 사용자
- 네트워크
- 에이전트에서 나가는 트래픽만 허용됩니다. 공용 IP 주소, 승인된 네트워크 항목, 수신 규칙은 허용되지 않습니다.
Cloud SQL은 이 제품군에서 유일하게 식별 가능한 접미사가 없는 호스팅 서비스입니다. 다른 모든 관리형 서비스 제공업체는 알아보기 쉬운 접미사가 붙은 호스트 이름을 제공하지만, Cloud SQL은 IP 주소 또는 인증 프록시를 사용하는 경우 루프백 주소를 제공합니다. 이로 인해 한 가지 중요한 결과가 발생합니다. Cloud SQL 배지는 이 카드에서 연결을 생성했기 때문에, 이전에 동일한 인스턴스를 가리키는 일반 PostgreSQL 연결은 계속해서 일반 PostgreSQL로 표시됩니다. 어느 쪽이든 기능은 동일하며, 단지 레이블만 다릅니다.
공용 IP 경로가 제공되더라도 사설 IP 경로를 사용하는 것이 좋습니다. VPC 내 VM에 설치된 에이전트는 연결 문제를 완전히 해결합니다. 인스턴스에 공용 IP가 할당되지 않고, 관리해야 할 승인된 네트워크도 없으며, 수신 규칙도 없고, 누군가가 업데이트를 기억해야 하는 고정 IP 주소도 필요 없습니다. 에이전트가 외부로 연결을 시도하므로 Cloud SQL은 항상 검색 가능한 상태여야 합니다.
여러 소스를 연결하는 쿼리의 경우, 연결이 저장되는 방식이 엔진 이름이기 때문에 한정자는 엔진 이름을 따릅니다. 예를 들어, gcp_sales라는 이름의 Cloud SQL PostgreSQL 연결은 gcp_sales.public.orders로 저장되고, SQL Server의 동일한 인스턴스는 gcp_sales.dbo.orders로 저장됩니다. 이렇게 하면 CSV 파일 폴더, 온프레미스 시스템 레코드 또는 청구 API에 하나의 읽기 전용 문으로 연결할 수 있습니다.
공급업체 문서: 클라우드.구글.com
자주 묻는 질문
Google Cloud SQL에 대한 질문
쿼리 스트림을 통해 Google Cloud SQL 데이터를 읽을 수 있는 도구는 무엇인가요?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 기능을 하나의 연결로 이용할 수 있습니다. 데이터베이스를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로, 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
Google Cloud SQL 데이터베이스에 접근하려면 방화벽 포트를 열어야 하나요?
아니요. Query Streams 네트워크 에이전트는 사용자 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 감시하는 기능은 없으며 VPN도 필요하지 않고 데이터베이스는 기존 방화벽 규칙을 유지합니다.
Query Streams를 사용하여 Google Cloud SQL의 데이터를 변경할 수 있습니까?
아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.
Query Streams가 Google Cloud SQL에 연결하려면 무엇이 필요합니까?
접근 가능한 호스트, 역할 및 해당 암호 — 에이전트가 드라이버를 포함하므로 데이터베이스에는 아무것도 설치되지 않습니다. 엔진: PostgreSQL, MySQL 및 SQL Server를 하나의 카드에서 지원합니다. 주소: 인스턴스의 개인 또는 공용 IP 주소, 또는 Cloud SQL 인증 프록시를 통한 127.0.0.1 — Cloud SQL은 지정할 호스트 이름이 없습니다. 포트: PostgreSQL 5432, MySQL 3306, SQL Server 1433 — 엔진별로 미리 채워져 있으며, 사용자가 선택한 엔진과 대조하여 확인됩니다. TLS: 직접 IP 연결의 경우 기본적으로 활성화되어 있으며, 인증 프록시를 통한 연결은 자체 터널을 암호화하므로 비활성화하는 것이 올바릅니다.
동일한 쿼리에서 Google Cloud SQL을 다른 데이터베이스와 조인할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문으로 Google Cloud SQL과 다른 연결을 동시에 참조할 수 있으며, 연결.스키마.테이블 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 모든 부분(SELECT, WITH, EXPLAIN만 해당)에 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.
Google Cloud SQL 연결 방식은 PostgreSQL 연결 방식과 다른가요?
연결 문자열만 필요합니다. Google Cloud SQL은 PostgreSQL 와이어 프로토콜을 사용하므로 필터, 예약, 공유, Excel 및 Google Sheets 추가 기능, MCP 서버 모두 동일하게 작동합니다. Cloud SQL 카드에는 공급자가 예상하는 호스트, 포트 및 SSL 설정이 미리 채워져 있습니다.
클라우드 SQL을 Excel로 변환하는 가이드가 있나요?
네, 맞습니다. 해당 내용은 PostgreSQL 가이드이며, Google Cloud SQL에도 그대로 적용됩니다. Cloud SQL은 PostgreSQL 와이어 프로토콜을 사용하므로 Cloud SQL에서 Excel, Google Sheets 등으로 데이터를 전송할 때 동일한 단계를 따릅니다. Cloud SQL에 특화된 부분은 연결 문자열뿐이며, Cloud SQL 카드에 해당 내용이 자세히 나와 있습니다.

