관리 설정 - 연결

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

연결 보기

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

데이터베이스 탭

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

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

관리자 역할이 있는 경우 Looker 연결 페이지 상단에 있는 연결 가능성 테스트 버튼을 클릭하여 Looker가 네트워크를 통해 호스트 이름과 포트에 연결할 수 있는지 확인할 수 있습니다. 자세한 내용은 네트워크 도달 가능성 진단을 참조하세요.

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

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

SSH 서버 탭

Looker (Google Cloud 핵심 서비스) 인스턴스에서는 SSH 서버 탭을 사용할 수 없습니다.

SSH 서버 옵션은 Looker (원본) 인스턴스가 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에서 데이터베이스 연결을 성공적으로 사용할 수 있는지 알려주는 상태 검사 목록이 포함되어 있습니다.

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

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

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

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

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

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

네트워크 진단

Looker는 연결 문제가 방화벽 규칙 또는 누락된 경로와 같은 네트워크로 인해 발생했는지 아니면 잘못된 사용자 인증 정보와 같은 데이터베이스로 인해 발생했는지 확인하는 데 도움이 되는 두 가지 도구를 제공합니다.

두 도구 모두 DNS에서 호스트 이름을 조회한 다음 조회가 반환하는 각 IP 주소에 대한 TCP 연결을 열려고 시도합니다. ICMP 핑 요청 대신 TCP 연결을 사용하므로 핑 요청을 차단하는 호스트가 연결 가능한 것으로 표시될 수 있습니다.

연결 테스트 결과의 네트워크 진단

연결 테스트에서 데이터베이스에 연결할 수 없는 경우 Looker는 다음 엔드포인트를 테스트하고 결과를 오류 메시지 끝에 있는 Network Diagnostics: 아래에 추가합니다.

  • 모든 연결의 경우 연결에 구성된 호스트 및 포트입니다.
  • Amazon Athena 연결의 경우 연결의 AWS 리전에 대한 AWS Glue 엔드포인트(포트 443)(예: glue.us-east-1.amazonaws.com)
  • 호스트 필드에 인스턴스 연결 이름(예: my-project:us-central1:my-instance)이 포함된 Cloud SQL 연결의 경우 포트 443의 sqladmin.googleapis.com 엔드포인트입니다. Cloud SQL 커넥터는 이 엔드포인트를 사용하여 인스턴스 정보와 인증서를 가져옵니다.

Looker는 각 엔드포인트에 대해 최대 3개의 IP 주소를 테스트하며 진단에는 최대 3초가 걸립니다. Looker는 SSH 터널을 사용하는 연결에 대해 네트워크 진단을 실행하지 않습니다.

예를 들어 다음 진단은 Looker가 Athena 엔드포인트에 도달할 수 있지만 AWS Glue 엔드포인트에 대한 연결이 타임아웃됨을 보여줍니다.

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

각 IP 주소에는 다음 결과 중 하나가 표시됩니다.

  • success: Looker가 IP 주소 및 포트에 대한 TCP 연결을 열었습니다. 모든 IP 주소에 success가 표시되지만 테스트가 계속 실패하면 사용자 인증 정보, SSL 설정, 데이터베이스 사용자 권한과 같은 연결 설정을 확인합니다.
  • timeout (3000ms): Looker가 3초 이내에 응답을 받지 못했습니다. 이 결과는 방화벽 규칙, 보안 그룹 또는 누락된 네트워크 경로가 트래픽을 삭제함을 의미하는 경우가 많습니다.
  • failed: 다음에 이유가 표시됩니다. 연결이 거부되었거나 네트워크에 연결할 수 없습니다. 예를 들어 Connection refused는 포트에서 수신 대기 중인 항목이 없거나 방화벽이 연결을 거부했음을 의미합니다.
  • blocked (sensitive IP): IP 주소가 제한된 범위에 있으므로 Looker에서 IP 주소를 테스트하지 않았습니다.

DNS 조회가 실패하면 엔드포인트에 DNS resolution failed:와 그 이유가 표시됩니다. 호스트 이름에 오타가 있는지 확인합니다. 데이터베이스에서 비공개 호스트 이름을 사용하는 경우 Looker에서 이를 확인할 수 있는지 확인합니다.

네트워크 도달성 진단

Looker 관리자 역할이 있는 경우 연결을 추가하기 전에 데이터베이스 호스트를 테스트하거나 연결이 종속된 엔드포인트(예: 포트 443의 sqladmin.googleapis.com)를 테스트할 수 있습니다.

네트워크 도달 가능성을 테스트하려면 다음 단계를 따르세요.

  1. 연결 페이지에서 페이지 상단의 연결 가능성 테스트 버튼을 클릭합니다.
  2. 네트워크 도달 가능성 진단 대화상자의 호스트 이름 또는 도메인 필드에 호스트 이름 또는 IP 주소를 입력합니다.
  3. 포트 필드에 테스트할 포트를 입력합니다. 기본값은 443입니다.
  4. 테스트를 클릭합니다.

Looker는 호스트 이름에 대해 최대 5개의 IP 주소를 테스트하며 테스트에는 최대 3초가 걸립니다. 다음은 호스트 이름과 포트의 테스트 결과를 보여주는 네트워크 도달성 진단 대화상자의 예입니다.

호스트 이름 및 포트의 테스트 결과를 보여주는 네트워크 도달성 진단 대화상자

각 IP 주소에 대해 대화상자에는 메시지, 연결에 걸린 시간(밀리초, 성공한 경우), 다음 상태 중 하나가 표시됩니다.

  • 연결됨: Looker가 IP 주소 및 포트에 대한 TCP 연결을 열었습니다.
  • 시간 초과: Looker가 3초 이내에 응답을 받지 못했습니다.
  • 실패: 연결이 거부되었거나 네트워크에 연결할 수 없습니다. 메시지에 이유가 표시됩니다.
  • SSRF 차단됨: IP 주소가 제한된 범위에 있으므로 Looker에서 IP 주소를 테스트하지 않았습니다. 이러한 제한사항은 서버 측 요청 위조 (SSRF)를 방지합니다.

Looker에서 호스트 이름을 확인할 수 없거나 포트가 제한된 경우 대화상자에 결과 대신 오류 메시지가 표시됩니다.

제한된 주소 및 포트

인스턴스를 보호하기 위해 Looker 네트워크 진단은 다음 범위의 IP 주소를 테스트하지 않습니다.

  • 루프백, 링크 로컬, 멀티캐스트, 메타데이터 서버 주소 169.254.169.254를 포함한 기타 제한된 주소 범위
  • 공개 보안 연결만 사용하는 Looker(Google Cloud 핵심 서비스) 인스턴스의 비공개 주소 범위(10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)

또한 연결 가능성 테스트 기능은 포트 22와 같이 보안상의 이유로 제한된 일부 포트를 테스트하지 않습니다. 이러한 포트 중 하나를 입력하면 대화상자에 Port 22 is restricted from diagnostic probing for security reasons과 같은 메시지가 표시됩니다.

연결 추가

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

연결 수정

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

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

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

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

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

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

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

데이터베이스 연결을 안전하게 삭제하기

LookML 모델에서 여전히 참조하는 데이터베이스 연결을 삭제하면 검증 오류가 발생하여 개발자가 브랜치를 커밋하거나 병합하지 못할 수 있습니다. 연결을 안전하게 삭제하려면 다음 단계를 따르세요.

  1. 종속 항목 식별: 개발 모드에서 프로젝트 검색을 사용하여 connection: CONNECTION_NAME를 검색하고 연결을 참조하는 모든 LookML 모델 파일을 찾습니다.
  2. 종속 항목 삭제: 해당 모델 파일의 connection 매개변수를 업데이트하여 유효한 연결을 가리키도록 하거나 더 이상 필요하지 않은 경우 종속 모델을 삭제합니다.
  3. 콘텐츠 검증: 콘텐츠 검사기를 실행하여 연결을 사용하는 모델에 의존하는 Look 또는 대시보드를 식별하고 수정합니다.
  4. 변경사항 배포: 이러한 LookML 변경사항을 프로덕션 브랜치에 커밋하고 배포합니다.
  5. 연결 삭제: 프로덕션 브랜치에서 모든 참조가 삭제되면 관리 > 데이터베이스 > 연결로 이동하여 연결을 삭제합니다.