MySQL용 Google Cloud SQL에 연결하기

MySQL용 Cloud SQL은 Cloud Platform에서 관계형 MySQL 데이터베이스를 쉽게 설정, 유지, 관리할 수 있는 완전 관리형 데이터베이스 서비스입니다. MySQL용 Cloud SQL 커넥터를 사용하면 Looker Studio에서 MySQL용 Cloud SQL 데이터베이스의 데이터에 액세스할 수 있습니다

이 도움말에서는 다음 내용을 다룹니다.

• 지원되는 버전
• MySQL용 Cloud SQL에 연결하는 방법
• 참고
• 제한사항
• 관련 리소스

지원되는 버전

MySQL용 Cloud SQL 커넥터는 다음 MySQL 버전에서 테스트되었습니다.

• 5.6
• 5.7
• 8.0

지원되는 버전을 사용하는 동안 문제가 발생하는 경우 Looker Studio 도움말 커뮤니티를 통해 Google에 알려주세요. 여기에서 기능 요청을 추가하고 이에 투표할 수 있습니다.

MySQL용 Cloud SQL에 연결하는 방법

Looker Studio 데이터 소스는 단일 MySQL용 Cloud SQL 데이터베이스 표 또는 광고주가 제공하는 커스텀 쿼리에 연결할 수 있습니다.

연결 방법

1. Looker Studio에 로그인합니다.
2. Looker Studio 홈페이지의 왼쪽 상단에서 만들기를 클릭한 다음 데이터 소스를 선택합니다.
3. MySQL용 Cloud SQL 커넥터를 선택합니다.
4. 메시지가 표시되면 Looker Studio에서 내 데이터에 액세스할 수 있도록 승인합니다.
5. 데이터베이스 연결을 설정하는 방법은 다음과 같습니다.

   호스트 이름 또는 IP 주소로 연결

   1. 왼쪽에서 기본을 선택합니다.
   2. 다음 연결 세부정보를 입력합니다.
      1. 인스턴스 연결 이름(인스턴스 연결 나열 방법은 아래 참조)
      2. 데이터베이스
      3. 사용자 이름
      4. 비밀번호

   JDBC URL로 연결

   1. 왼쪽에서 JDBC URL을 선택합니다.
   2. 다음 연결 세부정보를 입력합니다.
      1. JDBC URL

         예
         
         jdbc:google:mysql://<instance connection name>/<database>

      2. 사용자 이름
      3. 비밀번호

   JDBC 호스트 이름 옵션을 사용하는 경우 Whois와 같은 공개 DNS 조회 도구를 통해 액세스할 수 있습니다.

   IPv6 리터럴 주소를 사용하여 연결하려면 주소를 대괄호로 묶습니다. 예:  jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db

   자세한 내용은 https://datatracker.ietf.org/doc/html/rfc2732를 참고하세요.
   참고: Looker Studio에서 localhost에 연결할 수 없습니다. 공개 호스트 이름이나 IP 주소를 사용해야 합니다.
6. 인증을 클릭합니다.
7. 목록에서 표를 선택하거나 맞춤 쿼리를 입력합니다.

   단일 표에 연결하는 대신 SQL 쿼리를 제공하려면 맞춤 쿼리 옵션을 선택하세요. Looker Studio는 이 맞춤 SQL을 생성된 각 데이터베이스 쿼리의 내부 SELECT 문으로 사용합니다.

   커스텀 SQL 쿼리에는 단일 문만 포함할 수 있습니다.

   예를 들어 다음과 같이 여러 SQL 문이 포함되면 작동하지 않습니다.

   DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

   SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

   참고: Looker Studio의 쿼리는 3~5분 후에 타임아웃될 수 있습니다. 맞춤 쿼리가 타임아웃되면 다음 방법으로 문제를 해결해 보세요.

   • 쿼리를 간소화해 쿼리 실행 속도를 단축합니다.
   • 데이터베이스에서 쿼리를 실행하고 결과를 별도의 테이블에 저장합니다. 그런 다음 데이터 소스의 해당 표에 연결합니다.
8. 연결을 클릭합니다.

잠시 후 데이터 소스 필드 목록 페이지가 나타납니다. 오른쪽 상단에서 보고서 만들기 또는 탐색을 클릭하여 데이터 시각화를 시작합니다.

참고

인스턴스 연결 이름 찾기

인스턴스 연결 이름은 Google Cloud에서 인스턴스를 식별합니다. Cloud 콘솔 또는 명령줄을 사용하여 연결 이름을 가져올 수 있습니다.

Cloud 콘솔 사용하기

1. https://console.cloud.google.com/sql/instances로 이동합니다.
2. 연결하려는 인스턴스 ID를 클릭합니다.
3. 왼쪽의 '이 인스턴스에 연결' 섹션에 연결 이름이 표시됩니다.

명령줄 사용하기

Cloud 명령줄 인터페이스를 사용하여 연결 이름을 찾으려면 다음 명령어를 사용합니다.

gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

권한

연결을 생성하려면 MySQL용 Cloud SQL 프로젝트에 cloudsql.client 이상의 권한이 있어야 합니다. 이 액세스 권한이 없거나 권한을 획득할 수 없는 경우 MySQL 커넥터를 대신 사용할 수 있습니다.

네트워크 연결

MySQL용 Cloud SQL 커넥터는 공개 IP 연결 및 비공개 IP 연결을 사용하여 MySQL용 Cloud SQL 인스턴스에 대한 연결을 지원합니다.

MySQL용 Cloud SQL 커넥터를 사용하기 전에 MySQL용 Cloud SQL 인스턴스에 대한 공개 IP 연결 또는 비공개 IP 연결을 구성해야 합니다.

Looker Studio에서 Cloud SQL의 데이터에 액세스하고 비공개 연결을 통해 이 데이터에 쿼리를 실행하려면 MySQL용 Cloud SQL 인스턴스 설정에서 Google Cloud 서비스의 비공개 경로 옵션을 선택합니다. 자세히 알아보기

 

데이터 유형

Looker Studio에서는 데이터베이스의 기본 데이터 유형을 통합된 데이터 유형에 매핑합니다. 지원되지 않는 유형의 표에 있는 열 또는 쿼리가 있는 경우 Looker Studio에서는 이 열에 대한 필드가 생성되지 않습니다.

참고: Looker Studio는 MySQL의 공간 데이터 확장을 지원하지 않습니다.

MySQL용 Cloud SQL 커넥터의 제한사항

• 이 커넥터를 사용하여 쿼리당 최대 150,000개의 행을 쿼리할 수 있습니다. 이 한도를 초과하면 데이터가 잘립니다.
• 열 헤더(필드 이름)는 ASCII 문자만 사용해야 합니다. 비 ASCII 문자는 지원되지 않습니다.

관련 리소스

• 데이터 소스 만들기
• MySQL용 Cloud SQL 개발자 문서