Cloud SQL 커넥터는 Cloud SQL 인스턴스에 연결할 때 암호화 및 Identity and Access Management(IAM) 기반 승인을 제공하는 라이브러리입니다. Cloud SQL 인스턴스가 아직 없는 경우 Cloud SQL 인스턴스에 대한 네트워크 경로를 제공할 수 없습니다.
Cloud SQL 인스턴스에 연결하는 다른 방법에는 데이터베이스 클라이언트 사용 또는 Cloud SQL 인증 프록시가 포함됩니다. Cloud SQL 인스턴스에 연결하는 방법에 대한 자세한 내용은 연결 옵션 정보 페이지를 참조하세요.
이 페이지에서는 다음 Cloud SQL 커넥터에 대해 설명합니다.
- Cloud SQL Java 커넥터
- Cloud SQL Python 커넥터(Colab에서 열기)
- Cloud SQL Go 커넥터
- Cloud SQL Node.js 커넥터
이점
Cloud SQL 커넥터를 사용하면 다음과 같은 이점이 있습니다.
- IAM 승인: IAM 권한을 사용하여 Cloud SQL 인스턴스에 연결할 수 있는 사용자 또는 대상을 제어합니다.
- 편의성: SSL 인증서 관리, 방화벽 규칙 구성 또는 승인된 네트워크 사용 설정에 대한 요구사항을 삭제합니다.
- IAM 데이터베이스 인증: Cloud SQL의 자동 IAM 데이터베이스 인증 기능에 대한 지원을 제공합니다.
시작하기 전에
- Cloud SQL Admin API를 사용 설정합니다.
- Cloud SQL 인스턴스를 만들고 기본 사용자를 구성합니다.
인스턴스를 만드는 방법에 대한 자세한 내용은 인스턴스 만들기를 참조하세요.
기본 사용자를 구성하는 방법에 대한 자세한 내용은 기본 사용자 계정의 비밀번호 설정을 참조하세요.
- Cloud SQL 인스턴스에 연결하는 데 필요한 역할과 권한이 구성되었습니다.
설정
자바
Cloud SQL Java 커넥터는 Cloud SQL 인스턴스에 연결할 때 IAM 기반 승인 및 암호화를 제공하는 라이브러리입니다. Cloud SQL 인스턴스가 아직 없으면 네트워크 경로를 제공할 수 없습니다.
설치
Cloud SQL Java 커넥터를 사용하여 JDBC 및 R2DBC용 드라이버를 빌드하고 사용하는 방법은 다음 링크를 참조하세요.
- JDBC: JDBC를 사용하여 Cloud SQL에 연결
- R2DBC: R2DBC를 사용하여 Cloud SQL에 연결
애플리케이션의 컨텍스트에서 사용되는 이 라이브러리의 예시는 다음 샘플 애플리케이션을 참조하세요.
인증
이 라이브러리는 애플리케이션 기본 사용자 인증 정보를 사용하여 Cloud SQL 서버와의 연결을 인증합니다.
사용자 인증 정보를 로컬에서 활성화하려면 다음 gcloud 명령어를 사용하세요.
gcloud auth application-default login
Intellij와 연결
Cloud SQL 인스턴스에 IntelliJ를 연결하려면 드라이버 설정 페이지의 추가 파일 섹션에서 종속 항목을 사용하여 라이브러리를 jar로 추가해야 합니다. 예를 들어 이를 위해 Cloud SQL Java 커넥터 출시 페이지에서 사전 빌드된 fat jar를 찾아볼 수 있습니다.
Python
Cloud SQL Python 커넥터는 Cloud SQL 데이터베이스에 연결할 수 있는 충분한 권한이 있는 사용자가 IP를 직접 허용 목록에 추가하거나 SSL 인증서를 관리할 필요 없이 데이터베이스 드라이버와 함께 사용할 수 있는 라이브러리입니다.
Cloud SQL Python 커넥터 사용의 대화형 예시는 Cloud SQL Python 커넥터 노트북을 엽니다.
현재 지원되는 PostgreSQL용 드라이버는 pg8000입니다.
설치
최신 출시 버전을 설치하려면 이 안내를 따르세요.
인증
이 라이브러리는 애플리케이션 기본 사용자 인증 정보를 사용하여 Cloud SQL 서버와의 연결을 인증합니다.
사용자 인증 정보를 로컬에서 활성화하려면 다음 gcloud 명령어를 사용하세요.
gcloud auth application-default login
Go
Cloud SQL Go 커넥터는 Go 언어와 함께 사용할 수 있도록 설계된 Cloud SQL 커넥터입니다. 이 커넥터는 보안 향상을 위해 데이터베이스 프로토콜에 관계없이 클라이언트 커넥터와 서버 측 프록시 사이에 강력하고 수동으로 인증된 TLS 1.3 암호화를 사용합니다.
설치
go get
으로 이 저장소를 설치할 수 있습니다.
go get cloud.google.com/go/cloudsqlconn
Node.js
Node.js 커넥터는 Cloud SQL 인스턴스에 안전하게 연결할 수 있는 Node.js 런타임에 사용하도록 설계된 라이브러리입니다.
설치
npm install
로 라이브러리를 설치할 수 있습니다.
npm install @google-cloud/cloud-sql-connector
사용
자바
웹 애플리케이션의 컨텍스트에서 이 스니펫을 보려면 GitHub의 README를 참조하세요.
Python
라이브러리 사용에 대한 자세한 내용은 이 커넥터 사용 방법을 참조하세요. GitHub에서 연결 테스트 코드 예시를 봅니다.
Go
라이브러리 사용에 대한 자세한 안내는 사용량을 참조하세요. GitHub에서 연결 테스트 코드 예시를 봅니다.
Node.js
라이브러리 사용 방법에 대한 자세한 내용은 사용을 참조하세요.
문제 해결
드라이버 버전
비호환성을 방지하려면 최신 버전의 Cloud SQL 커넥터 및 데이터베이스 드라이버를 사용해야 합니다. 일부 이전 버전의 드라이버는 지원되지 않습니다.
연결 경로
Cloud SQL 커넥터는 연결에 대한 승인을 제공하지만 연결에 대한 새 경로는 제공하지 않습니다. 예를 들어 비공개 IP 주소를 사용하여 Cloud SQL 인스턴스에 연결하려면 애플리케이션에 이미 VPC 액세스 권한이 있어야 합니다.
연결 문제 디버그
연결 문제와 관련해 추가 도움이 필요하면 문제 해결 및 연결 문제 디버그 페이지를 참조하세요.
다음 단계
- GitHub의 Cloud SQL Java 커넥터 홈페이지 살펴보기
- GitHub의 Cloud SQL Python 커넥터 홈페이지 살펴보기
- Cloud SQL 인증 프록시 자세히 알아보기
- IAM 자세히 알아보기
- 지원 옵션 알아보기