관리 설정 - 연결

연결 페이지에 액세스하려면 관리 메뉴를 열고 데이터베이스에서 연결을 선택합니다.

연결 보기

연결 페이지에서 데이터베이스 연결과 네트워크 트래픽을 허용하는 데 필요한 IP 주소를 볼 수 있습니다. 새 데이터베이스를 만드는 기능이 인스턴스에 사용 설정되면 새 연결을 추가할 수도 있습니다.

데이터베이스 탭

데이터베이스 탭에는 정의한 데이터베이스 연결에 대한 기본 정보가 표시됩니다. 새 데이터베이스를 만드는 기능이 인스턴스에 사용 설정된 경우 직접 만든 Looker 관리형 연결도 표시됩니다. 또한 데이터베이스 탭에서 이러한 연결의 상태를 테스트하고 연결의 구성을 수정할 수 있습니다.

공개 IP 주소를 클릭하여 Looker 인스턴스의 네트워크 트래픽을 허용하는 데 필요한 IP 주소 목록을 볼 수 있습니다. Looker의 모든 네트워크 트래픽은 Looker 인스턴스가 호스팅되는 리전에 따라 나열된 IP 주소 중 하나에서 시작됩니다. 이러한 IP 주소와 다른 신뢰할 수 있는 IP 주소를 제외한 데이터베이스에 대한 트래픽을 금지하면 데이터 액세스를 제한할 수 있습니다.

다음 표에서는 데이터베이스 탭의 요소를 설명합니다.

열 설명
이름 선택한 연결의 이름으로, connection LookML 매개변수에 사용됩니다. 연결을 테스트하면 Looker에서 연결 이름 아래에 상태 검사 목록을 표시합니다.
데이터베이스 이 연결을 사용할 때 Looker에서 쿼리할 데이터베이스의 이름입니다.
범위 연결을 모든 프로젝트에서 사용할 수 있는지 또는 특정 프로젝트 하나에서만 사용할 수 있는지 여부입니다.
SSH 서버 데이터베이스에 SSH 터널을 만드는 데 사용된 SSH 서버 구성의 이름입니다. 이 열은 Looker 인스턴스에서 SSH 서버 탭이 사용 설정된 경우에만 표시됩니다.
SSL SSL 암호화를 사용하여 Looker와 데이터베이스 간에 이동하는 데이터를 보호하는지 여부(SSL 외에 다른 보안 옵션도 있음)
유형 데이터베이스 연결의 SQL 언어입니다.
작업 연결에 대해 수행할 수 있는 작업으로는 연결 테스트, 연결 수정, 연결에 대한 다른 정보 보기, 연결의 Explore로의 링크 목록으로 이동, 연결 삭제가 있습니다. 인스턴스에 새 데이터베이스를 만드는 기능이 사용 설정된 경우 Looker 관리형 연결에 추가 데이터 소스의 데이터를 추가할 수도 있습니다.

SSH 서버 탭

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

Looker는 SSH 터널을 만들 때 localhost 포트를 자동으로 선택합니다. localhost 포트를 지정할 수 없습니다.

PrestoDB 또는 Trino 데이터베이스에 대한 SSH 연결에는 추가 데이터베이스 구성이 필요할 수 있습니다. SSL이 사용 설정되면 PrestoDB 또는 Trino 데이터베이스는 기본적으로 포트 443에서 리슨합니다. SSH 터널을 설정하려면 Looker는 Looker에서 이미 사용 중인 localhost 포트를 443으로 설정해야 합니다. 이 경우 SSH 터널 설정이 실패합니다. 이 문제를 해결하려면 SSL이 사용 설정될 때 PrestoDB 또는 Trino 데이터베이스가 443 포트가 아닌 포트에서 리슨하도록 구성합니다.

SSH 서버 탭에는 추가한 SSH 서버 구성이 나열되고 SSH 서버 연결 상태가 표시되며 각 SSH 서버를 사용하는 데이터베이스 연결이 나열됩니다. SSH 서버 탭에서 SSH 서버 연결을 테스트하고 SSH 서버 구성을 추가 또는 수정할 수도 있습니다.

다음 표에서는 SSH 서버 탭의 요소를 설명합니다.

열 설명
서버 이름 데이터베이스에 연결하는 데 사용되는 SSH 서버 구성의 이름입니다.
연결 SSH 서버에 연결되는 데이터베이스 연결의 목록입니다. 데이터베이스 연결을 클릭하면 해당 데이터베이스 연결의 연결 수정 페이지가 열립니다.
점 3개로 된 옵션 메뉴 SSH 서버 구성에 대해 수행할 수 있는 작업으로는 SSH 서버 연결 테스트, SSH 서버에 데이터베이스 연결 추가, SSH 서버 구성 수정 또는 SSH 서버 구성 삭제가 있습니다.

SSH 서버 구성 추가 또는 수정

새 SSH 서버 구성을 추가하려면 다음 안내를 따르세요.

  1. SSH 서버 탭에서 서버 추가를 클릭합니다.
  2. 오른쪽 상단에 있는 이름 없는 서버 필드에 SSH 서버 구성 이름을 입력합니다.
  3. 키 다운로드를 클릭하여 공개 키를 텍스트 파일로 다운로드합니다. 나중에 사용할 수 있도록 이 파일을 저장해야 합니다.
  4. 서버 사용자 이름 필드에 Looker에서 SSH 서버에 연결하는 데 사용할 사용자 이름을 입력합니다.
  5. 서버 IP 주소 또는 호스트 이름 필드에 SSH 서버 IP 주소나 호스트 이름을 입력합니다.
  6. 서버 포트 필드에 SSH 서버에 연결하는 데 사용되는 포트 번호를 입력합니다.
  7. 다운로드한 공개 키를 SSH 서버의 승인된 키 파일에 추가합니다. 자세한 내용과 예시는 SSH 서버 사용 문서 페이지를 참조하세요.
  8. Looker가 SSH 서버에 연결할 수 있도록 SSH 서버에서 적절한 Looker IP 주소가 허용 목록에 추가되어 있는지 확인합니다.
  9. 테스트 및 디지털 지문 요청을 클릭하여 SSH 서버와의 연결을 확인합니다.
  10. 새 SSH 구성을 봅니다. 이 화면에서 공개 키를 다운로드하거나 보고 SSH 서버 구성의 고유 디지털 지문을 볼 수도 있습니다.

기존 SSH 서버 구성을 수정하려면 선택한 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭하고 서버 세부정보를 선택합니다.

SSH 서버 연결 테스트

SSH 서버에 대한 모든 데이터베이스 연결을 테스트하려면 다음 안내를 따르세요.

  1. 선택한 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭합니다.
  2. 연결 테스트를 선택합니다.

Looker는 해당 SSH 서버를 사용하여 모든 데이터베이스 연결을 테스트하고 서버 이름 및 연결 테스트를 통과하는 모든 연결 옆에 녹색 체크표시를 표시합니다. 빨간색 느낌표 아이콘은 연결 테스트가 실패했음을 나타냅니다.

SSH 서버에 데이터베이스 연결 추가

SSH 서버를 사용하여 새 데이터베이스 연결을 추가하려면 다음 안내를 따르세요.

  1. 선택한 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭합니다.
  2. 연결 추가를 선택합니다.

Looker에서 연결 설정 페이지가 표시되며 SSH 서버가 SSH 서버 필드에 나열됩니다.

SSH 서버 구성 삭제

SSH 서버 구성을 삭제하려면 다음 안내를 따르세요.

  1. 삭제할 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭합니다.
  2. 서버 삭제를 선택합니다.

연결 테스트

Looker를 사용하면 기존 연결을 테스트하여 연결이 올바르게 작동하는지 확인할 수 있습니다. 데이터베이스에 Looker 연결 문서 페이지에 설명된 대로 연결을 추가할 때도 테스트할 수 있습니다.

각 연결 테스트에는 Looker에서 데이터베이스 연결을 성공적으로 사용할 수 있는지 알려주는 상태 검사 목록이 포함되어 있습니다.

잠재적 문제는 노란색으로 표시되며 오류는 빨간색으로 표시됩니다. 연결이 '통과'하면 녹색으로 표시됩니다.

Snowflake 및 Google BigQuery와 같이 OAuth를 사용하는 데이터베이스 연결을 사용하려면 사용자가 로그인해야 합니다. 이러한 연결 중 하나를 테스트할 때 OAuth 사용자 계정에 로그인하지 않으면 Looker에 로그인 링크와 함께 경고가 표시됩니다. 링크를 클릭하여 OAuth 사용자 인증 정보를 입력하거나 Looker에서 OAuth 계정 정보에 액세스하도록 허용합니다.

다음 항목의 상태를 확인할 수 있습니다.

  • 해당 연결의 맨 오른쪽에 있는 테스트를 클릭하여 단일 연결
  • 모든 연결 상태: 페이지 상단의 모든 연결 테스트 버튼을 클릭하여 확인

다음 두 가지 확인이 혼동의 일반적인 원인입니다.

  • 임시 스키마 찾음
  • 영구 파생 테이블 사용 가능

Looker가 작동하기 위해 이러한 확인이 통과될 필요는 없습니다. 하지만 매우 중요한 모델링 기능인 영구 파생 테이블을 사용하려면 통과해야 합니다.

연결 추가

새 데이터베이스 연결을 추가하려면 데이터베이스에 Looker 연결 문서 페이지에 설명된 단계를 따릅니다.

연결 수정

기존 연결을 수정하려면 관리 메뉴를 선택하여 연결 페이지를 연 후 데이터베이스에서 연결을 선택합니다. 연결의 수정 버튼을 클릭합니다. 연결을 만드는 데 사용한 것과 동일한 페이지가 표시되지만(데이터베이스에 Looker 연결 문서 페이지에 설명되어 있음) 관련 정보가 이미 작성된 상태입니다. 필요한 사항을 변경한 후 연결 업데이트를 클릭합니다.

모든 연결에 사용 가능한 작업

모든 연결은 각 연결 맨 오른쪽에 있는 톱니바퀴 드롭다운 메뉴에서 다음 옵션을 제공합니다.

옵션 설명
SQL Runner 이 옵션을 선택하면 적절한 연결과 스키마가 이미 선택된 상태로 Looker의 SQL Runner로 이동합니다.
탐색 이 옵션을 사용하면 연결에 대해 자동으로 생성된 기본 Explore 옵션 목록이 표시됩니다. 맞춤설정된 데이터 모델 기반은 아니지만 연결 테이블의 원시 데이터에 대한 빠른 보고를 지원합니다. 이는 일반적으로 실제 데이터 분석이 아닌 모델링하기 전에 테이블 콘텐츠를 파악하는 데만 유용합니다.
삭제 기존 연결을 삭제하려면 연결 오른쪽 끝에 있는 톱니바퀴 드롭다운 메뉴를 클릭하고 삭제를 선택합니다. 삭제 여부를 결정할 수 있습니다. 하지만 삭제한 후에는 실행취소할 수 없습니다. 연결을 실수로 삭제하면 이 연결을 사용하는 모든 쿼리가 중지됩니다. 하지만 같은 이름으로 새 연결을 다시 만들면 기능이 복원됩니다.

일부 연결에 사용 가능한 작업

연결 언어에 따라 연결 맨 오른쪽에 있는 톱니바퀴 드롭다운 메뉴는 다음과 같은 추가 옵션을 제공할 수 있습니다.

옵션 설명
테이블 표시 이 옵션을 사용하면 연결 메타데이터를 기반으로 Looker Explore 쿼리를 만들 수 있는 Looker Explore 페이지로 이동합니다. 이 옵션은 스키마 이름, 테이블 이름, 선택한 열 수로 시작되지만 다른 Looker Explore와 마찬가지로 이 옵션을 조작할 수 있습니다.
데이터베이스 표시 이 옵션을 사용하면 연결 메타데이터를 기반으로 Looker Explore 쿼리를 만들 수 있는 Looker Explore 페이지로 이동합니다. 이 옵션은 스키마 이름, 카탈로그 이름, 테이블 수, 선택한 열 수로 시작되지만 다른 Looker Explore와 마찬가지로 이 옵션을 조작할 수 있습니다.
프로세스 표시 이 옵션을 사용하면 이 연결에서 실행되는 프로세스, 현재 상태, 실행 시간, 기타 정보를 기반으로 Looker Explore 쿼리를 만들 수 있는 Looker Explore 페이지로 이동합니다. 이는 Looker가 느리게 실행되거나 쿼리가 전혀 실행되지 않는 경우 원인을 확인하는 데 유용할 수 있습니다.
PDT 이벤트 로그 표시 이 옵션을 사용하면 이 연결의 파생 테이블 활동을 기반으로 Looker Explore 쿼리를 만들 수 있는 Looker Explore 페이지로 이동합니다. 사용 가능한 필드는 영구 파생 테이블 문서 페이지에 자세히 설명되어 있습니다.