데이터베이스에 Looker 연결

데이터베이스를 보안 및 구성하면 데이터베이스를 Looker에 연결할 수 있습니다. 이 페이지에서는 새 Looker 연결 워크플로를 설명합니다.

• Looker (원본) 인스턴스의 경우 기존 연결 페이지 사용 기존 전환 버튼이 사용 설정된 경우 기존 연결 UI에 관한 자세한 내용은 기존 워크플로를 사용하여 Looker를 데이터베이스에 연결 문서 페이지를 참고하세요.

• Looker (Google Cloud 핵심 서비스) 인스턴스의 경우 이 페이지에 설명된 새 데이터베이스 연결 워크플로만 지원됩니다.

Looker의 Looker에 데이터베이스 연결 페이지에서 데이터베이스 연결을 만듭니다. Looker에 데이터베이스 연결 페이지를 여는 방법에는 두 가지가 있습니다.

• menu 기본 메뉴 아이콘을 클릭하고 관리를 선택한 다음 관리 패널의 데이터베이스 섹션에서 연결을 선택합니다. 연결 페이지에서 연결 추가 버튼을 클릭합니다.
• 기본 탐색 메뉴에서 만들기 버튼을 클릭한 다음 연결 메뉴 항목을 선택합니다.

이 페이지에서는 Looker가 데이터베이스를 Looker에 연결 페이지에 표시하는 일반적인 필드를 설명합니다. 페이지에 표시되는 정확한 필드는 언어 설정에 따라 다릅니다.

연결 설정에 사용자 속성을 적용하는 방법에 대한 자세한 내용은 사용자 속성 문서 페이지의 연결 섹션을 참고하세요.

데이터베이스 연결 설정에는 다음 4가지 섹션이 있습니다.

• 일반 설정
• 데이터베이스 설정
• 선택적 설정
• 검토

일반 설정

이름

연결에 지정한 이름입니다. LookML 모델의 connection 매개변수에 사용할 데이터베이스 연결 이름이 필요합니다. 또한, 데이터베이스 연결 이름은 Looker의 연결 관리 페이지에서 식별되는 이름이기도 합니다. 이 설정에 폴더 이름을 사용하지 마세요. 이 값은 데이터베이스의 어떤 항목과도 일치하지 않아도 됩니다. Name은 Looker UI 내에서 이 연결을 식별하는 라벨입니다.

SQL 언어

연결과 일치하는 SQL 언어입니다. 적절한 연결 옵션이 표시되도록 올바른 값을 선택해야 Looker가 LookML을 SQL로 적절하게 변환할 수 있습니다.

최신 드라이버 버전 사용

기본적으로 Looker는 항상 데이터베이스 언어의 최신 버전 JDBC 드라이버를 사용하여 데이터베이스에 연결합니다. 선택한 데이터베이스 언어에 Looker에서 지원하는 JDBC 드라이버 버전이 두 개 이상 있는 경우 최신 드라이버 버전 사용 전환 버튼을 사용 중지하여 연결에 이전 JDBC 드라이버 버전을 선택할 수 있습니다. 이전 버전의 JDBC 드라이버를 선택하려면 연결에서 최신 드라이버 버전 사용 전환 버튼을 사용 중지한 다음 드라이버 버전 풀다운 메뉴에서 드라이버 버전을 선택하면 됩니다.

이전 JDBC 드라이버 버전을 선택하면 Looker에서 지원하는 한 Looker는 해당 이전 버전을 계속 사용합니다.

Looker는 다음 두 가지 시나리오에서 드라이버 버전 지원을 중단합니다.

• Looker 지원에서 드라이버 버전이 삭제되었습니다. 이 경우 연결은 Looker에서 언어에 대해 지원하는 가장 오래된 드라이버 버전을 사용합니다.
• Looker 롤백으로 인해 아직 드라이버 버전이 없습니다. 이 경우 연결은 롤백된 출시에서 지원하는 최신 드라이버 버전을 사용합니다.

선택한 드라이버 버전이 더 이상 Looker에서 지원되지 않는 경우 Looker는 데이터베이스 연결 수정 페이지의 드라이버 버전 필드 아래에 선택한 드라이버 버전이 더 이상 지원되지 않는다는 알림을 표시합니다. 또한 Looker에서 연결에 사용 중인 드라이버 버전도 알림에 표시됩니다. 이 알림을 삭제하려면 드라이버 버전 풀다운 메뉴에서 지원되는 JDBC 드라이버 버전을 선택하거나 최신 드라이버 버전 사용 전환 버튼을 사용 설정하여 최신 드라이버 버전을 사용하세요.

프로젝트 범위

연결을 모든 프로젝트에서 또는 프로젝트 하나에서만 사용할 수 있어야 하는지 여부를 선택합니다.

• 모든 프로젝트: 인스턴스의 모든 LookML 프로젝트에서 연결에 액세스할 수 있으므로 연결 이름을 해당 프로젝트의 모델 파일 connection 파라미터에 지정할 수 있습니다.
• 선택한 프로젝트: 인스턴스의 LookML 프로젝트 하나만 연결에 액세스할 수 있습니다. 이 옵션을 선택하면 연결 화면에 인스턴스의 프로젝트 드롭다운 메뉴가 표시됩니다. 이 연결에 액세스할 수 있는 프로젝트를 선택합니다.

연결 관리 및 모델 구성을 위임하려면 다음 권한과 함께 이 옵션을 사용합니다.

• manage_project_connections
• manage_project_models
• use_global_connections

상태 세부정보

상태 세부정보 섹션을 확장하여 연결 설정을 테스트합니다.

데이터베이스 설정

SSH 서버 사용 설정

SSH 서버 옵션은 인스턴스가 Kubernetes 인프라에 배포되어 있고 Looker 인스턴스에 SSH 서버 구성 정보를 추가하는 기능이 사용 설정된 경우에만 사용할 수 있습니다. Looker 인스턴스에서 이 옵션을 사용 설정하지 않고 이를 사용 설정하려면 Google Cloud 영업 전문가에게 문의하거나 지원 요청을 제출하세요. SSH 서버 사용 설정 옵션을 사용 설정하면 Looker에 SSH 서버 및 SSH 터널 필드가 표시됩니다.

SSH 서버

localhost 포트를 지정할 수 없습니다. SSH 서버에서 localhost 포트를 자동으로 선택합니다. localhost 포트를 지정해야 하는 SSH 연결을 만들어야 하는 경우 지원 요청을 엽니다.

드롭다운 목록에서 SSH 서버 구성을 선택합니다. 적절한 SSH 터널을 선택하거나 만들려면 SSH 서버가 필요합니다. 연결 패널의 SSH 서버 탭에서 새 SSH 서버를 만들 수 있습니다.

SSH 터널

드롭다운 목록에서 기존 SSH 터널을 선택하거나 호스트 이름 및 포트 또는 로컬 포트가 있는 새 SSH 터널을 만들려면 새 터널 만들기 아이콘을 클릭합니다.

호스트 이름

Looker에서 데이터베이스 호스트에 연결하는 데 사용할 데이터베이스 호스트 이름입니다.

Looker 분석가와 협력하여 데이터베이스에 대한 SSH 터널을 구성한 경우 호스트 필드에 "localhost"를 입력합니다. 사용자 속성을 호스트 필드에 적용하면 사용자 속성에 수정 가능으로 설정된 사용자 액세스 수준이 없을 수 있습니다. 데이터베이스에 연결하도록 SSH 터널을 구성한 경우 원격 호스트:포트 필드에 사용자 속성을 적용할 수 없습니다.

포트

Looker에서 데이터베이스 호스트에 연결하는 데 사용할 데이터베이스 포트입니다.

Looker 분석가와 협력하여 데이터베이스에 대한 SSH 터널을 구성한 경우 포트 필드에 Looker 분석가가 제공해야 하는 데이터베이스로 리디렉션하는 포트 번호를 입력합니다.

로컬 포트

기본적으로 Looker는 SSH 터널에 사용 가능한 로컬 포트를 자동으로 선택합니다. 로컬 포트를 수동으로 선택하려면 수동 항목를 선택하고 커스텀 로컬 포트 필드에 포트 번호를 입력합니다. 인스턴스에서 로컬 포트를 사용할 수 있는지 확인하세요.

결제 프로젝트 ID (Google BigQuery만 해당)

결제 프로젝트 ID는 Google Cloud 프로젝트 ID입니다. 자세한 내용은 Google BigQuery 문서 페이지를 참고하세요.

스토리지 프로젝트 ID (Google BigQuery만 해당)

컴퓨팅과 스토리지를 별도의 프로젝트로 구분하는 경우 스토리지 프로젝트 ID의 이름입니다. LookML 개발자가 LookML 뷰, 탐색 또는 조인의 sql_table_name 매개변수에 전체 범위 테이블 이름을 지정한 경우 다른 Google Cloud 프로젝트에서 데이터 세트를 쿼리할 수 있습니다. 자세한 내용은 Google BigQuery 문서 페이지를 참고하세요.

기본 데이터 세트 (Google BigQuery만 해당)

Looker가 데이터베이스를 쿼리할 때 기본값으로 지정할 데이터 세트의 이름입니다. 자세한 내용은 Google BigQuery 문서 페이지를 참고하세요.

데이터베이스 이름

호스트의 데이터베이스 이름입니다. 예를 들어 sales_info라는 데이터베이스에 my-instance.us-east-1.redshift.amazonaws.com 호스트 이름이 있을 수 있습니다. 이 필드에 sales_info를 입력합니다. 동일한 호스트에 데이터베이스가 여러 개 있는 경우 여러 연결을 만들어 이를 사용해야 할 수도 있습니다. 단, database라는 단어가 대부분의 SQL 언어와는 약간 다른 의미를 갖는 MySQL은 예외입니다.

기본 스키마

스키마가 지정되지 않은 경우 Looker에서 사용하는 기본 스키마입니다. 이는 SQL Runner를 사용할 때, LookML 프로젝트를 생성하는 중에, 테이블을 쿼리할 때 적용됩니다.

인증 설정

Google BigQuery, Snowflake, Trino, Databricks 연결의 경우 Looker에서 데이터베이스에 액세스할 떄 사용하기를 원하는 인증 유형을 선택하세요.

• Google BigQuery 연결의 경우 Looker가 데이터베이스에 인증할 때 사용할 OAuth 또는 서비스 계정을 구성할 수 있습니다.
• Snowflake, Trino, Databricks 연결의 경우 Looker가 데이터베이스에 인증할 때 사용할 OAuth 또는 데이터베이스 계정을 구성할 수 있습니다.

OAuth를 사용하는 경우 사용자가 Looker에서 쿼리를 실행하려면 데이터베이스에 로그인해야 합니다. Looker 연결에서 OAuth를 구성하는 방법에 대한 자세한 내용은 Google BigQuery, Snowflake, Trino, 또는 Databricks 연결 절차를 참조하세요.

사용자 이름

Looker에서 데이터베이스에 연결하는 데 사용할 수 있는 데이터베이스에 대한 사용자 계정의 사용자 이름입니다.

비밀번호

Looker에서 데이터베이스에 연결하는 데 사용할 수 있는 데이터베이스에 대한 사용자 계정의 비밀번호입니다.

상태 세부정보 섹션을 확장하여 연결 설정을 테스트합니다.

설정(선택사항)

노드당 최대 연결 수

여기에서 Looker에서 데이터베이스로 설정할 수 있는 최대 연결 수를 설정할 수 있습니다. 대부분의 경우 Looker가 데이터베이스에서 실행할 수 있는 동시 쿼리 수를 설정합니다. 또한 Looker는 쿼리가 종료될 수 있도록 연결을 최대 3개까지 예약합니다. 연결 풀이 매우 작으면 Looker에서 연결을 더 적게 예약합니다.

이 값을 신중하게 설정합니다. 값이 너무 높으면 데이터베이스에 과부하가 발생할 수 있습니다. 값이 너무 낮으면 쿼리에서 소수의 연결을 공유해야 하므로 이전 쿼리가 반환될 때까지 기다려야 하므로 많은 쿼리가 느리게 보일 수 있습니다.

일반적으로 기본값(SQL 언어에 따라 다름)이 적절한 시작점입니다. 대부분의 데이터베이스에는 수락할 최대 연결 수에 대한 자체 설정도 있습니다. 데이터베이스 구성에서 연결을 제한하는 경우 노드당 최대 연결 수 값이 데이터베이스 한도 이하인지 확인합니다.

연결 풀 제한 시간

사용자가 노드당 최대 연결 수 설정보다 더 많은 연결을 요청하면 요청은 다른 요청이 완료될 때까지 기다린 후에 실행됩니다. 여기에서 요청이 대기하는 최대 시간을 구성합니다. 기본 설정은 120초입니다.

이 값을 신중하게 설정합니다. 값이 너무 낮으면 다른 사용자의 쿼리가 완료될 수 있는 시간이 부족하므로 사용자의 쿼리가 취소될 수 있습니다. 이 값이 너무 높으면 다수의 쿼리가 생성되어 사용자가 너무 오래 기다릴 수 있습니다. 일반적으로 기본값이 적절한 시작점입니다.

이 연결의 최대 동시 쿼리 수

이 선택적 값은 Looker가 이 데이터베이스 연결에 한 번에 제출할 수 있는 동시 쿼리 수를 제한합니다. 동일한 연결을 요구하는 동시 요청이 더 수신되면 Looker가 이를 내부적으로 큐에 추가하고 순서대로 처리합니다. 이 값을 설정하면 기존 노드당 최대 연결 수 값이 덮어쓰기됩니다.

이 연결의 사용자당 최대 동시 쿼리 수

이 선택적 값은 Looker가 이 데이터베이스 연결에 한 번에 제출할 수 있는 사용자 1명의 동시 쿼리 수를 제한합니다. 동일한 연결을 요구하는 동시 요청이 더 수신되면 Looker가 이를 내부적으로 큐에 추가하고 순서대로 처리합니다.

추가 JDBC 매개변수

필요한 경우 여기에서 쿼리용으로 추가 자바 데이터베이스 연결(JDBC) 매개변수를 포함할 수 있습니다.

JDBC 매개변수에서 사용자 속성을 참조하려면 Liquid 템플릿 문법 _user_attributes['name_of_attribute']를 사용합니다. 아래 예시를 참조하세요.

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

유지보수 일정

Looker 재생성기는 데이터 그룹과 sql_trigger_value을 기반으로 하는 영구 테이블(집계 테이블 및 영구 파생 테이블 모두)를 검사합니다. Looker 재생성기는 이러한 검사에 따라 데이터베이스의 스크래치 스키마에서 영구 테이블을 다시 빌드하거나 삭제합니다.

유지보수 일정 값은 Looker 재생성기의 cron 간격을 설정합니다. Looker 재생성기는 재생성 주기를 시작하여 데이터 그룹과 영구 테이블을 cron 간격으로 확인합니다. Looker 재생성기 주기가 다음 cron 간격으로 계속 진행 중이면 Looker 재생성기는 진행 중인 재생성기 주기를 완료한 후 후속 cron 간격이 시작될 때까지 기다렸다가 다음 재생성기 주기를 시작합니다.

유지보수 일정 설정은 cron 표현식을 허용합니다. 기본값은 */5 * * * *입니다. 즉, 이전 재생성기 주기가 완료되면 Looker 재생성기 주기가 5분 간격으로 주기를 시작합니다. 이전 재생성기 주기가 완료되지 않으면 Looker 재생성기는 주기가 완료된 후 다음 5분 간격으로 시작합니다.

기본 간격인 5분은 유지보수 일정에 지원되는 가장 짧은 간격입니다. Looker는 유지보수 일정에 최대 간격을 적용하지 않습니다. 즉, cron 표현식으로 지정할 수 있는 한 Looker 재생성기 주기 간 간격을 연장할 수 있습니다. Looker 재생성기 주기가 길어지면 캐시와 영구 테이블의 데이터 최신 상태에 부정적인 영향을 줄 수 있습니다.

Looker 재생성기는 주기에서 모든 검사와 PDT 재빌드를 완료한 후 다음 주기가 시작할 때까지 다음 cron 간격 동안 기다립니다. 장기 실행 PDT 빌드가 있는 경우 Looker 재생성기 주기 간의 기간이 길 수 있습니다. Looker의 파생 테이블 페이지에 있는 영구 테이블 구현을 위한 중요 고려사항 섹션의 설명대로 다른 요소가 테이블을 다시 빌드하는 데 필요한 시간에 영향을 줄 수 있습니다.

데이터베이스가 연중무휴가 아닌 경우 데이터베이스가 실행된 시간으로 검사를 제한하는 것이 좋습니다. 다음은 몇 가지 추가적인 cron 표현식입니다.

cron 표현식을 만들 때 다음 사항에 유의하세요.

• Looker는 cron 표현식에서 ?를 지원하지 않는 parse-cron v0.1.3을 사용합니다.
• cron 표현식은 Looker 애플리케이션 시간대를 사용하여 확인이 수행되는 시점을 결정합니다.
• PDT가 빌드되지 않으면 크론 문자열을 다시 */5 * * * * 기본값으로 재설정합니다.

다음은 cron 문자열을 만드는 데 도움이 되는 몇 가지 리소스입니다.

• https://crontab.guru — cron 문자열을 수정하고 테스트하는 데 도움이 됩니다.
• http://www.crontab-generator.org — 시간 설정을 선택하면 생성기에서 해당 cron 문자열을 만듭니다.

SSL

Looker와 데이터베이스 간에 데이터가 전달될 때 SSL 암호화를 사용하여 데이터를 보호할지 여부를 선택합니다. SSL은 데이터를 보호하는 데 사용할 수 있는 유일한 옵션입니다. 다른 보안 옵션은 보안 데이터베이스 액세스 사용 설정 문서 페이지에 설명되어 있습니다.

SSL 확인

연결에 사용되는 SSL 인증서를 확인해야 하는지 여부를 선택합니다. 확인이 필요한 경우 SSL 인증서에 서명한 SSL 인증 기관(CA)은 클라이언트의 신뢰할 수 있는 소스 목록에서 가져와야 합니다. CA가 신뢰할 수 있는 소스가 아니면 데이터베이스 연결은 설정되지 않습니다.

이 상자를 선택하지 않으면 SSL 암호화가 연결에 계속 사용되지만 SSL 연결 확인이 필요하지 않으므로 CA가 클라이언트의 신뢰할 수 있는 소스 목록에 없을 때 연결을 설정할 수 있습니다.

테이블 및 열 사전 캐시

SQL Runner에서는 연결과 스키마를 선택하는 즉시 모든 테이블 정보가 미리 로드됩니다. 이렇게 하면 테이블 이름을 클릭하는 즉시 SQL Runner에서 테이블 열을 빠르게 표시할 수 있습니다. 하지만 테이블이 많거나 테이블이 매우 큰 연결 또는 스키마의 경우 SQL Runner에서 모든 정보를 미리 로드하지 않는 것이 좋습니다.

테이블을 선택할 때만 SQL Runner에서 테이블 정보를 로드하려면 테이블 및 열 사전 캐시 옵션을 선택 해제하여 연결에 대해 SQL Runner 사전 로드를 사용 중지합니다.

스키마 가져오기 및 캐시

집계 인식과 같은 일부 SQL 쓰기 기능의 경우 Looker는 데이터베이스의 정보 스키마를 사용하여 SQL 쓰기를 최적화합니다. 정보 스키마가 캐시되지 않으면 정보 스키마를 가져올 수 있도록 Looker에서 데이터베이스에 대한 SQL 쓰기를 차단해야 하는 경우가 있습니다. Hadoop 분산 파일 시스템(HDFS)을 사용하는 언어의 경우 정보 스키마를 가져오면 시간이 걸려 Looker 쿼리의 성능에 상당한 영향을 줄 수 있습니다. 정보 스키마가 느린 경우 연결에 대한 스키마 가져오기 및 캐시 옵션을 사용 중지할 수 있습니다. 이 기능을 사용 중지하면 특정 기능에 대한 Looker SQL 최적화 중 일부가 차단되므로 연결의 정보 스키마가 특히 느리다는 점을 모르는 경우 스키마 가져오기 및 캐시 옵션을 사용 설정해야 합니다.

예상 비용

비용 추정 전환 버튼은 다음 데이터베이스 연결에만 적용됩니다.

• Snowflake
• Amazon Redshift
• Amazon Aurora
• PostgreSQL, PostgreSQL용 Google Cloud SQL, Microsoft Azure PostgreSQL

비용 추정 전환 버튼은 연결에 다음 기능을 사용 설정합니다.

• Explore 쿼리의 비용 추정
• SQL Runner 쿼리의 비용 추정
• 집계 인식 쿼리의 예상 계산 절감액

자세한 내용은 Looker에서 데이터 탐색 문서 페이지를 참조하세요.

데이터베이스 연결 풀링

데이터베이스 연결 풀링을 지원하는 언어의 경우 이 기능을 사용하면 Looker가 JDBC 드라이버를 통해 연결 풀을 사용할 수 있습니다. 데이터베이스 연결 풀링은 더 빠른 쿼리 성능을 가능하게 해줍니다. 새 쿼리를 수행할 때 새 데이터베이스 연결을 만들 필요가 없고 대신 연결 풀의 기존 연결을 사용할 수 있습니다. 연결 풀링 기능은 쿼리 실행 후 연결을 삭제하고 쿼리 실행이 종료된 후 연결을 재사용할 수 있도록 보장합니다. 자세한 내용은 데이터베이스 연결 풀링 문서 페이지를 참조하세요.

영구 파생 테이블 (PDT) 설정

PDT가 사용 설정된 경우 다음 설정이 표시됩니다.

PDT 사용 설정

PDT 사용 설정 전환 버튼을 사용 설정하여 영구 파생 테이블을 사용 설정합니다. PDT가 사용 설정되면 연결 창에 추가 PDT 필드와 PDT 재정의 섹션이 표시됩니다. 데이터베이스 언어에서 PDT를 사용할 수 있는 경우에만 Looker에 PDT 사용 설정 전환 버튼이 표시됩니다.

PDT에 대한 다음 사항에 유의하세요.

• OAuth를 사용하는 Snowflake 연결에는 PDT가 지원되지 않습니다.
• 연결에서 PDT를 중지해도 PDT와 연결된 데이터 그룹은 중지되지 않습니다. PDT를 사용 중지해도 기존 데이터 그룹은 데이터베이스에 대해 sql_trigger 쿼리를 계속 실행합니다. 데이터 그룹이 데이터베이스에 대해 sql_trigger 쿼리를 실행하지 못하도록 하려면 LookML 프로젝트에서 datagroup 매개변수를 삭제하거나 주석 처리해야 합니다. 또는 Looker에서 PDT 및 데이터 그룹을 매우 자주 또는 전혀 확인하지 않도록 연결의 유지보수 일정 설정을 업데이트할 수 있습니다.
• Snowflake 연결의 경우 Looker가 AUTOCOMMIT 매개변수의 값을 TRUE(Snowflake의 기본값)로 설정합니다. Looker에서 PDT 등록 시스템을 유지하는 데 실행하는 SQL 명령어에는 AUTOCOMMIT이 필요합니다.

임시 데이터베이스

임시 데이터베이스라는 라벨이 지정되어 있지만 Looker에서 영구 파생 테이블을 만드는 데 사용할 데이터베이스 이름 또는 스키마 이름(사용하는 SQL 언어에 적합한 이름)을 입력하게 됩니다. 사전에 적절한 쓰기 권한을 사용하여 이 데이터베이스나 스키마를 구성해야 합니다. 데이터베이스 구성 안내 문서 페이지에서 데이터베이스 언어를 선택하여 해당 언어의 안내를 확인합니다.

각 연결에는 자체 임시 데이터베이스 또는 스키마가 있어야 하며 이러한 항목은 연결 간에 공유할 수 없습니다.

최대 PDT 빌더 연결 수

최대 PDT 빌더 연결 수 설정을 사용하면 Looker 재생기가 데이터베이스 연결에서 시작할 수 있는 동시 실행 테이블 빌드 수를 지정할 수 있습니다. 최대 PDT 빌더 연결 수 설정은 Looker 재생기에서 다시 빌드를 시작하는 테이블 유형에만 적용됩니다.

• 트리거 지속 테이블(datagroup_trigger 또는 sql_trigger_value 지속성 전략을 사용하는 영구 파생 테이블 및 집계 테이블)
• persist_for 전략을 사용하는 영구 테이블입니다. 단, persist_for 테이블이 datagroup_trigger 또는 sql_trigger_value 지속성 전략을 사용하는 테이블에 종속된 파생 테이블 캐스케이드의 일부인 경우에만 해당합니다. 이 경우 Looker 재생기는 persist_for 테이블을 다시 빌드합니다. 이 테이블은 캐스케이드에서 다른 테이블을 다시 빌드하는 데 필요합니다. 그렇지 않으면 재생기가 persist_for 테이블의 빌드를 시작하지 않습니다.

최대 PDT 빌더 연결 수 설정은 기본적으로 1로 설정되지만 10까지 설정할 수 있습니다. 하지만 이 값은 Looker의 시작 옵션에 설정된 per-user-query-limit 또는 노드당 최대 연결 수 필드에 설정된 값보다 높을 수 없습니다.

이 값을 신중하게 설정합니다. 값이 너무 높으면 데이터베이스에 과부하가 발생할 수 있습니다. 값이 낮으면 장기 실행 PDT 또는 집계 테이블로 인해 다른 영구 테이블 생성이 지연되거나 연결에서 다른 쿼리가 느려질 수 있습니다. BigQuery, Snowflake, Redshift와 같이 멀티테넌시를 지원하는 데이터베이스는 병렬 쿼리 빌드 처리 성능이 더 높을 수 있습니다.

최대 PDT 빌더 연결 수 설정을 늘리려면 먼저 1씩 늘리는 것이 좋습니다. 예상치 못한 동작이 발생하면 기본값 1로 다시 설정합니다. 또는 쿼리 성능이 영향을 받지 않는 경우 설정을 더 늘리기 전에 1만큼 높일 때마다 성능을 확인하는 방식으로 계속 증분할 수 있습니다.

최대 PDT 빌더 연결 수 설정에 대한 다음 사항에 유의하세요.

• 최대 PDT 빌더 연결 수 설정은 트리거 검사에 필요한 연결이 아니라 테이블의 다시 빌드에 필요한 연결에만 적용됩니다. 트리거 검사는 테이블의 지속성 전략이 트리거되었는지 확인하는 쿼리입니다. 이러한 트리거 검사 쿼리는 항상 순차적으로 실행되므로 최대 PDT 빌더 연결 수 설정이 적용되지 않습니다.
• 클러스터링된 Looker 인스턴스에서 재생기는 기본 노드에서만 실행됩니다. 최대 PDT 빌더 연결 수 설정은 기본 노드에만 적용되므로 전체 클러스터에 대한 제한을 설정합니다.
• 다음 유형의 테이블에는 최대 PDT 빌더 연결 수 설정이 적용되지 않습니다. 이러한 유형의 테이블은 연속으로 빌드됩니다.
  • 테이블이 datagroup_trigger 또는 sql_trigger_value 전략을 사용하는 테이블에 종속되지 않는 한 persist_for 매개변수를 통해 유지되는 테이블
  • 개발 모드의 테이블
  • 파생된 테이블 다시 빌드 및 실행 옵션으로 다시 빌드된 테이블
  • 종속 항목 캐스케이드에서 다른 테이블에 종속되는 테이블. 테이블은 종속되는 테이블과 동시에 빌드할 수 없습니다. 예를 들어 table_B가 table_A에 종속되는 경우 table_B가 다시 빌드하기 전에 table_A가 다시 빌드를 완료해야 합니다.

실패한 PDT 빌드 재시도

실패한 PDT 빌드 재시도 전환 버튼은 Looker 재생성기가 이전 재생성기 주기에서 실패한 트리거 지속 테이블을 다시 빌드하려고 시도하는 방법을 구성합니다. Looker 재생성기는 트리거 지속 테이블 (PDT 및 집계 테이블)을 유지보수 일정 연결 설정에서 구성된 간격에 따라 다시 빌드하는 프로세스입니다. 실패한 PDT 빌드 재시도 전환 버튼이 사용 설정되면 Looker 재생성기는 PDT의 트리거 조건이 충족되지 않더라도 이전 재생성기 주기에서 실패한 PDT를 다시 빌드하려고 시도합니다. 이 설정을 사용 중지하면 Looker 재생기는 PDT의 트리거 조건이 충족될 때만 이전에 실패한 PDT를 다시 빌드하려고 시도합니다. 실패한 PDT 빌드 재시도는 기본적으로 중지되어 있습니다.

Looker 재생기에 대한 자세한 내용은 Looker의 파생 테이블 문서 페이지를 참조하세요.

PDT API 제어

PDT API 제어 전환 버튼은 start_pdt_build, check_pdt_build, stop_pdt_build API 호출을 이 연결에 사용할 수 있는지 결정합니다. PDT API 제어 전환 버튼이 중지되면 이 연결에서 PDT를 참조할 때 이러한 API 호출이 실패합니다. PDT API 제어 전환 버튼은 기본적으로 중지되어 있습니다.

PDT 재정의 사용 설정

데이터베이스에서 영구 파생 테이블이 지원되고 연결 설정에서 PDT 사용 설정 전환 버튼을 사용 설정한 경우 Looker에 PDT 재정의 전환 버튼이 표시됩니다. PDT 재정의 전환 버튼을 사용 설정하여 PDT 재정의 섹션을 표시합니다. 이 섹션에서 PDT 프로세스에 해당하는 별도의 JDBC 매개변수 (호스트, 포트, 데이터베이스, 사용자 이름, 비밀번호, 스키마, 추가 매개변수, 연결 문 뒤)를 입력할 수 있습니다. 이렇게 하면 다음과 같은 다양한 이유로 유용할 수 있습니다.

• PDT 프로세스에 별도의 데이터베이스 사용자를 만들면 데이터베이스 로그인 사용자 인증 정보에 사용자 속성을 할당하거나 데이터베이스 연결에 OAuth를 사용하는 경우에도 Looker 프로젝트에서 PDT를 사용할 수 있습니다.
• PDT 프로세스는 우선순위가 더 높은 별도의 데이터베이스 사용자를 통해 인증할 수 있습니다. 이 방식으로 데이터베이스에서 보다 덜 중요한 사용자 쿼리보다 PDT 작업을 우선 처리할 수 있습니다.
• 표준 Looker 데이터베이스 연결에 대한 쓰기 액세스 권한이 취소될 수 있으며 PDT 프로세스에서 인증에 사용할 특수 사용자에게만 부여됩니다. 대부분의 조직에서 이 방법이 더욱 효과적인 보안 전략입니다.
• Snowflake와 같은 데이터베이스의 경우 PDT 프로세스가 나머지 Looker 사용자와 공유되지 않는 보다 강력한 하드웨어로 라우팅될 수 있습니다. 이렇게 하면 비용이 많이 드는 하드웨어를 풀타임으로 실행하는 비용 없이 PDT가 빠르게 빌드할 수 있습니다.

예를 들어 사용자 이름 및 비밀번호 필드가 사용자 속성으로 설정된 연결에서 PDT 재정의 섹션은 자체 비밀번호를 사용하여 별도의 사용자 (pdt_user)를 만들 수 있습니다. 이 구성을 사용하면 다음이 발생합니다.

• 각 사용자는 사용자 속성에 따라 할당된 개별 사용자 인증 정보를 사용하여 데이터베이스에 액세스할 수 있습니다.
• pdt_user 계정은 PDT 생성 및 업데이트에 적합한 액세스 수준으로 모든 PDT 프로세스에 사용됩니다.
• 시스템 활동을 사용한 모니터링과 같은 목적으로 사용자 쿼리 트래픽과 PDT 프로세스 트래픽을 빠르게 구분할 수 있습니다.

데이터베이스 시간대

데이터베이스에 시간 기반 정보가 저장되는 시간대입니다. Looker는 사용자의 시간 값을 변환하여 시간 기반 데이터를 더 쉽게 이해하고 사용할 수 있도록 이 정보를 알아야 합니다. 자세한 내용은 시간대 설정 사용 문서 페이지를 참조하세요.

쿼리 시간대

쿼리 시간대 옵션은 사용자별 시간대를 중지한 경우에만 표시됩니다.

사용자별 시간대가 사용 중지된 경우 쿼리 시간대는 사용자가 시간 기반 데이터를 쿼리할 때 표시되는 시간대와 Looker가 데이터베이스 시간대에서 시간 기반 데이터를 변환하는 시간대입니다.

자세한 내용은 시간대 설정 사용 문서 페이지를 참조하세요.

상태 세부정보 섹션을 확장하여 연결 설정을 테스트합니다.

검토

데이터베이스 연결 설정을 모두 입력한 후 연결을 검토하고 테스트하여 올바르게 구성되었는지 확인할 수 있습니다.

Looker UI의 몇몇 위치에서 연결 설정을 테스트할 수 있습니다.

• 연결 설정 페이지 하단의 상태 세부정보 섹션에서 테스트 버튼을 선택합니다.
• 연결 문서 페이지에 설명된 대로 연결 관리 페이지의 연결 목록 옆에 있는 테스트 버튼을 선택합니다.

Looker에 연결 가능이 표시되면 연결을 눌러 연결을 만듭니다. 그러면 데이터베이스 연결이 Looker 연결 관리 페이지의 목록에 추가됩니다.

사용자 속성에 연결 매개변수 값을 하나 이상 설정한 경우 사용자로 테스트 옵션이 표시됩니다. 사용자를 선택한 후 테스트를 클릭하여 데이터베이스가 이 사용자로 연결하고 쿼리를 실행할 수 있는지 확인합니다.

문제 해결

연결이 하나 이상의 테스트를 통과하지 못한 경우 다음 사항에 유의하세요.

• Atlas에서 Mongo 버전 3.6 이하를 실행하고 있고 통신 링크 실패가 발생하는 경우 Mongo 커넥터 문서 페이지를 참조하세요.
• 임시 스키마 및 PDT와 관련하여 성공적인 연결 메시지를 수신하려면 Looker 데이터베이스를 설정할 때 이 기능을 허용해야 합니다. 이 작업을 수행하는 방법은 데이터베이스 구성 안내 문서 페이지를 참조하세요.
• Snowflake 및 Google BigQuery와 같이 OAuth를 사용하는 데이터베이스 연결을 사용하려면 사용자가 로그인해야 합니다. 이러한 연결 중 하나를 테스트할 때 OAuth 사용자 계정에 로그인하지 않으면 Looker에 로그인 링크와 함께 경고가 표시됩니다. 링크를 클릭하여 OAuth 사용자 인증 정보를 입력하거나 Looker에서 OAuth 계정 정보에 액세스하도록 허용합니다.
• 고객 호스팅 Looker 인스턴스의 경우 문제 해결 도움말은 고객 호스팅 인스턴스의 데이터베이스 연결 테스트 문서 페이지를 참고하세요.

다음 단계

데이터베이스를 Looker에 연결한 후에는 사용자를 위해 로그인 옵션을 구성할 수 있습니다.