관리자 설정: 연결

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

연결 보기

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

데이터베이스 탭

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

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

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

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

SSH 서버 탭

SSH 서버 옵션은 인스턴스가 Kubernetes 인프라에 배포되고 SSH 서버 구성 정보를 Looker 인스턴스에 추가하는 기능이 사용 설정된 경우에만 사용할 수 있습니다. 이 옵션이 Looker 인스턴스에 사용 설정되지 않은 상태에서 사용 설정하려면 Looker 계정 관리자에게 문의하거나 Looker 고객센터에서 지원 요청을 여세요.

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

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

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

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

설명
서버 이름 사용자가 선택한 SSH 서버 구성의 이름이며 데이터베이스에 연결하는 데 사용됩니다.
연결 SSH 서버에 연결하는 데이터베이스 연결 목록입니다. 데이터베이스 연결을 클릭하면 데이터베이스 연결의 연결 수정 페이지가 열립니다.
옵션 메뉴 SSH 서버 구성에 대해 수행할 수 있는 작업은 SSH 서버 연결 테스트, SSH 서버에 데이터베이스 연결 추가, SSH 서버 구성 수정, SSH 서버 구성 삭제입니다.

SSH 서버 구성 추가 또는 수정

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

  1. SSH 서버 탭에서 서버 추가를 클릭합니다.
  2. 오른쪽 상단의 이름이 없는 서버 입력란에 SSH 서버 구성의 이름을 입력합니다.
  3. 키 다운로드를 클릭하여 공개 키를 텍스트 파일로 다운로드합니다. 나중에 사용할 수 있도록 이 파일을 저장해야 합니다.
  4. Server Username(서버 사용자 이름) 입력란에 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에서 데이터베이스 연결을 성공적으로 사용할 수 있는지 여부를 알려주는 상태 확인 목록이 포함되어 있습니다. 예를 들면 다음과 같습니다.

발생할 수 있는 문제는 노란색으로 표시되며 오류는 빨간색으로 표시됩니다. 연결이 끊어지면 녹색으로 표시됩니다.

SnowflakeGoogle BigQuery와 같이 OAuth를 사용하는 데이터베이스 연결에는 사용자 로그인이 필요합니다. 이러한 연결 중 하나를 테스트할 때 OAuth 사용자 계정에 로그인하지 않은 경우 Looker에서 로그인 링크와 함께 경고를 표시합니다. 링크를 클릭하여 OAuth 사용자 인증 정보를 입력하거나 Looker에서 OAuth 계정 정보에 액세스하도록 허용합니다.

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

  • 연결의 오른쪽에 있는 테스트를 클릭하여 단일 연결
  • 페이지 상단의 모든 연결 테스트 버튼을 클릭하여 모든 연결을 표시합니다.

혼란을 유발하는 일반적인 원인은 다음 두 가지입니다.

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

이러한 검사는 Looker가 작동하는 데 통과할 필요가 없습니다. 그러나 매우 중요한 모델링 기능인 영구 파생 테이블을 사용하려면 전달해야 합니다.

연결 추가

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

연결 수정

기존 연결을 수정하려면 각 연결의 오른쪽에 있는 수정 버튼을 클릭합니다. Looker를 데이터베이스에 연결 문서 페이지에 설명된 대로 연결을 만드는 데 사용하는 것과 동일한 페이지가 표시되지만 관련 정보는 이미 작성되어 있습니다. 필요에 따라 변경한 다음 연결 업데이트를 클릭합니다.

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

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

옵션 설명
SQL Runner 이 옵션을 선택하면 적절한 연결과 스키마가 이미 선택되어 있는 Looker의 SQL Runner로 이동합니다.
탐색 이 옵션을 사용하면 연결에 대해 자동으로 생성된 기본 탐색 옵션 목록이 표시됩니다. 맞춤설정된 데이터 모델을 기반으로 하지 않지만 연결의 원시 데이터에 대한 빠른 보고를 지원합니다. 이는 일반적으로 실제 데이터 분석을 목적으로 하는 것이 아니라 모델링하기 전에 표 내용을 이해하는 데 유용합니다.
삭제 기존 연결을 삭제하려면 연결 오른쪽 끝에 있는 톱니바퀴 드롭다운 메뉴를 클릭하고 삭제를 선택합니다. 삭제를 확인할 수 있는 기회를 얻게 되며, 삭제한 후에는 실행취소할 수 없습니다. 연결을 실수로 삭제하면 해당 연결을 사용하는 모든 쿼리가 사용 중지됩니다. 그러나 동일한 이름으로 새 연결을 다시 만들면 기능이 복원됩니다.

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

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

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