PostgreSQL에 연결

PostgreSQL은 전 세계 자원봉사자팀이 개발한 오픈소스 관계형 데이터베이스 관리 시스템 (RDBMS)입니다.

PostgreSQL 커넥터를 사용하면 Looker Studio에서 PostgreSQL 기반 데이터베이스의 데이터에 액세스할 수 있습니다.

PostgreSQL에 연결하는 방법

이 커넥터는 PostgreSQL JDBC 드라이버를 사용하여 하나의 Looker Studio 데이터 소스를 단일 PostgreSQL 데이터베이스 테이블에 연결합니다.

지원되는 버전

Looker Studio는 다음 PostgreSQL 버전에서 테스트되었습니다.

  • 9.6
  • 10
  • 11
  • 12
  • 13
  • 14

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

연결 방법

  1. Looker Studio에 로그인합니다.
  2. Looker Studio 홈페이지의 왼쪽 상단에서 만들기를 클릭한 다음 데이터 소스를 선택합니다.
  3. PostgreSQL 커넥터를 선택합니다.
  4. 연결 옵션 중 하나를 사용하여 데이터베이스 액세스를 구성합니다 (아래 참고).
  5. 인증을 클릭합니다. 해당 데이터베이스의 표 목록이 표시됩니다.
  6. 를 선택합니다.
  7. 연결을 클릭합니다.

이제 표의 모든 열을 보고서의 필드로 액세스할 수 있습니다.

연결 옵션

BASIC

호스트 이름 또는 IP 주소와 연결하려면 다음 정보를 제공해야 합니다.

  • 호스트 이름 또는 IP 주소
  • 포트 (선택사항)
  • 데이터베이스
  • 사용자 이름
  • 비밀번호

JDBC URL

JDBC URL을 사용하여 연결하려면 다음 연결 정보를 제공하세요.

  • JDBC URL
    • jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
  • 비밀번호

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

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

SSL 사용 설정

Looker Studio는 전송 계층 보안 (TLS) 프로토콜을 사용하여 서버에 대한 보안 (암호화된) 연결을 지원합니다. TLS는 보안 소켓 레이어 (SSL)라고도 합니다. 보안 연결을 사용하려면 SSL 사용을 선택한 다음 SSL 구성 파일을 제공하세요.

이 설정은 Looker Studio에 필요하지 않지만 데이터베이스 구성에는 필요할 수 있습니다. 자세한 내용은 데이터베이스 공급업체에 문의하세요.

클라이언트 인증 사용 설정

이 체크박스를 선택하면 데이터베이스 액세스 권한이 필요한 경우 클라이언트 비공개 키 및 클라이언트 인증서를 업로드할 수 있습니다.

이 설정은 Looker Studio에 필요하지 않지만 데이터베이스 구성에는 필요할 수 있습니다. 자세한 내용은 데이터베이스 공급업체에 문의하세요.

참고 : Looker Studio에는 PKCS-8 클라이언트 키 형식이 필요합니다.

PostgreSQL 보안 연결 자세히 알아보기

맞춤 쿼리

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

예를 들어 다음과 같이 여러 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분 후에는 제한 시간을 초과할 수 있습니다. 맞춤 쿼리가 제한 시간을 초과하면 다음 방법으로 문제를 해결해 보세요.

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

참고

지원되는 데이터 유형

PostgreSQL 커넥터는 다음 데이터 유형을 지원합니다.

  • 숫자
  • 문자 기반이란
  • 불리언
  • 날짜/시간 (간격 제외)

Looker Studio는 지원되지 않는 유형의 열이 있을 경우 이 열에 대한 필드를 만들지 않습니다.

PostgreSQL 데이터 유형에 대해 자세히 알아보기

방화벽 및 데이터베이스 액세스

Looker Studio가 방화벽으로 보호되는 데이터베이스에 연결하고 데이터베이스를 쿼리할 수 있도록 하려면 다음 IP 주소 중 하나에 대한 액세스를 허용해야 합니다. 이 주소로부터의 트래픽을 수락하도록 데이터베이스를 구성해야 할 수도 있습니다. 이 작업을 실행하는 방법은 특정 데이터베이스의 문서를 참고하세요.

IP 주소

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (선택사항, IPv6를 지원하는 플랫폼의 경우)

PostgreSQL 커넥터를 사용할 때는 다음과 같은 네트워킹 제한사항에 유의하세요.

  • Looker Studio는 Cloud SQL의 PostgreSQL에 대한 비공개 IP 연결을 지원하지 않습니다.

  • PostgreSQL 커넥터는 Cloud SQL PostgreSQL 인스턴스에 연결할 때 Cloud SQL 프록시를 사용하지 않습니다. Cloud SQL PostgreSQL 인스턴스에 연결하는 경우 나열된 IP를 승인된 네트워크 목록에 추가해야 합니다. Cloud SQL 문서를 참고하세요.

PostgreSQL 커넥터의 제한사항

  • public 스키마 외부의 테이블 선택은 지원되지 않습니다. 대신 맞춤 쿼리 옵션을 선택하여 모든 스키마의 테이블이 포함된 쿼리를 작성할 수 있습니다.

  • 이 커넥터를 사용하여 쿼리당 최대 150,000개의 행을 쿼리할 수 있습니다. 이 한도를 초과하면 데이터가 잘립니다.

  • 열 헤더 (필드 이름)는 ASCII 문자만 사용해야 합니다. 비 ASCII 문자는 지원되지 않습니다.

문제 해결

일반적인 오류 메시지 목록과 오류 해결 단계는 Looker Studio 문제 해결 가이드를 참고하세요.

데이터 소스 만들기