연결 페이지에 액세스하려면 관리 메뉴를 열고 데이터베이스에서 연결을 선택합니다.
연결 보기
연결 페이지에서 네트워크 트래픽을 허용하는 데 필요한 데이터베이스 연결 및 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이 사용 설정된 경우 포트 443이 아닌 포트에서 리슨하도록 PrestoDB 또는 Trino 데이터베이스를 구성해야 합니다.
SSH 서버 탭에는 추가한 SSH 서버 구성이 나열되고, SSH 서버 연결 상태가 표시되고, 각 SSH 서버를 사용하는 데이터베이스 연결이 나열됩니다. SSH 서버 탭에서 SSH 서버에 대한 연결을 테스트하고 SSH 서버 구성을 추가 또는 수정할 수도 있습니다.
다음 표에서는 SSH 서버 탭의 요소를 설명합니다.
| 열 | 설명 |
|---|---|
| 서버 이름 | 선택한 SSH 서버 구성의 이름으로, 데이터베이스에 연결하는 데 사용됩니다. |
| 연결 | SSH 서버에 연결되는 데이터베이스 연결 목록입니다. 데이터베이스 연결을 클릭하면 해당 데이터베이스 연결의 연결 수정 페이지가 열립니다. |
| 점 3개로 된 옵션 메뉴 | SSH 서버 구성에 대해 수행할 수 있는 작업으로는 SSH 서버 연결 테스트, SSH 서버에 데이터베이스 연결 추가, SSH 서버 구성 수정 또는 SSH 서버 구성 삭제가 있습니다. |
SSH 서버 구성 추가 또는 수정
새 SSH 서버 구성을 추가하려면 다음 안내를 따르세요.
- SSH 서버 탭에서 서버 추가를 클릭합니다.
- 오른쪽 상단의 이름이 지정되지 않은 서버 필드에 SSH 서버 구성 이름을 입력합니다.
- 키 다운로드를 클릭하여 공개 키를 텍스트 파일로 다운로드합니다. 나중에 사용할 수 있도록 이 파일을 저장해야 합니다.
- 서버 사용자 이름 필드에 Looker가 SSH 서버에 연결하는 데 사용할 사용자 이름을 입력합니다.
- 서버 IP 주소 또는 호스트 이름 필드에 SSH 서버 IP 주소 또는 호스트 이름을 입력합니다.
- 서버 포트 필드에 SSH 서버 연결에 사용되는 포트 번호를 입력합니다.
- 다운로드한 공개 키를 SSH 서버의 승인된 키 파일에 추가합니다. 자세한 내용과 예시는 SSH 서버 사용 문서 페이지를 참조하세요.
- Looker가 SSH 서버에 연결할 수 있도록 적절한 Looker IP 주소를 SSH 서버의 허용 목록에 추가했는지 확인합니다.
- 테스트 및 디지털 지문 요청을 클릭하여 SSH 서버와의 연결을 확인합니다.
- 새 SSH 구성을 봅니다. 이 화면에서 공개 키를 다운로드하거나 보고 SSH 서버 구성의 고유 디지털 지문을 볼 수도 있습니다.
기존 SSH 서버 구성을 수정하려면 선택한 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭하고 서버 세부정보를 선택합니다.
SSH 서버 연결 테스트
SSH 서버에 대한 모든 데이터베이스 연결을 테스트하려면 다음 안내를 따르세요.
- 선택한 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭합니다.
- 연결 테스트를 선택합니다.
Looker는 해당 SSH 서버를 사용하여 모든 데이터베이스 연결을 테스트하고 서버 이름 및 연결 테스트를 통과하는 모든 연결 옆에 녹색 체크표시를 표시합니다. 빨간색 느낌표 아이콘은 연결이 테스트에 실패했음을 나타냅니다.
SSH 서버에 데이터베이스 연결 추가
SSH 서버를 사용하여 새 데이터베이스 연결을 추가하려면 다음 안내를 따르세요.
- 선택한 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭합니다.
- 연결 추가를 선택합니다.
Looker에서 연결 설정 페이지가 표시되며 SSH 서버가 SSH 서버 필드에 나열됩니다.
SSH 서버 구성 삭제
SSH 서버 구성을 삭제하려면 다음 안내를 따르세요.
- 삭제할 SSH 서버 행에서 점 3개로 된 옵션 메뉴를 클릭합니다.
- 서버 삭제를 선택합니다.
연결 테스트
Looker를 사용하면 기존 연결을 테스트하여 제대로 작동하는지 확인할 수 있습니다. 데이터베이스에 Looker 연결 문서 페이지에 설명된 대로 연결을 추가할 때도 테스트할 수 있습니다.
각 연결 테스트에는 Looker가 데이터베이스 연결을 성공적으로 사용할 수 있는지 여부를 알려주는 상태 확인 목록이 포함되어 있습니다.
잠재적 문제는 노란색으로 표시되며 오류는 빨간색으로 표시됩니다. 연결이 '통과'되면 녹색으로 표시됩니다.
Snowflake 및 Google BigQuery와 같이 OAuth를 사용하는 데이터베이스 연결에는 사용자 로그인이 필요합니다. 이러한 연결 중 하나를 테스트할 때 OAuth 사용자 계정에 로그인하지 않은 경우 Looker에 로그인 링크와 함께 경고가 표시됩니다. 링크를 클릭하여 OAuth 사용자 인증 정보를 입력하거나 Looker가 OAuth 계정 정보에 액세스하도록 허용합니다.
다음 항목의 상태를 확인할 수 있습니다.
- 해당 연결의 맨 오른쪽에 있는 테스트를 클릭하여 단일 연결
- 페이지 상단의 모든 연결 테스트 버튼을 클릭하여 모든 연결
다음 두 가지 확인이 혼동의 일반적인 원인입니다.
- 임시 스키마 찾음
- 영구 파생 테이블 사용 가능
Looker가 작동하기 위해 이러한 확인이 통과될 필요는 없습니다. 하지만 매우 중요한 모델링 기능인 영구 파생 테이블을 사용하려면 통과해야 합니다.
연결 추가
새 데이터베이스 연결을 추가하려면 데이터베이스에 Looker 연결 문서 페이지에 설명된 단계를 따릅니다.
연결 수정
기존 연결을 수정하려면 관리 메뉴를 선택하여 연결 페이지를 연 후 데이터베이스에서 연결을 선택합니다. 연결의 수정 버튼을 클릭합니다. 연결을 만드는 데 사용한 것과 동일한 페이지가 표시되지만(데이터베이스에 Looker 연결 문서 페이지에 설명되어 있음) 관련 정보가 이미 작성된 상태입니다. 필요한 사항을 변경한 후 연결 업데이트를 클릭합니다.
모든 연결에 사용 가능한 작업
모든 연결은 각 연결 맨 오른쪽에 있는 톱니바퀴 드롭다운 메뉴에서 다음 옵션을 제공합니다.
| 옵션 | 설명 |
|---|---|
| SQL Runner | 이 옵션을 사용하면 적절한 연결 및 스키마가 이미 선택된 Looker의 SQL Runner로 이동합니다. |
| 탐색 | 이 옵션을 사용하면 연결에 대해 자동으로 생성된 기본 Explore 옵션 목록이 표시됩니다. 맞춤 데이터 모델을 기반으로 하지 않지만 연결 테이블의 원시 데이터를 빠르게 보고할 수 있습니다. 이는 일반적으로 실제 데이터 분석이 아닌 모델링하기 전에 테이블 콘텐츠를 파악하는 데만 유용합니다. |
| 삭제 | 기존 연결을 삭제하려면 연결 맨 오른쪽에 있는 톱니바퀴 드롭다운 메뉴를 클릭하고 삭제를 선택합니다. 삭제 확인 메시지를 받게 되지만, 확인 후 실행취소할 수 없습니다. 연결을 실수로 삭제하면 연결을 사용하는 모든 쿼리가 사용 중지됩니다. 그러나 이름이 같은 새 연결을 다시 만들면 기능이 복원됩니다. |
일부 연결에 사용 가능한 작업
연결 언어에 따라 연결 맨 오른쪽에 있는 톱니바퀴 드롭다운 메뉴는 다음과 같은 추가 옵션을 제공할 수 있습니다.
| 옵션 | 설명 |
|---|---|
| 테이블 표시 | 이 옵션을 사용하면 연결의 메타데이터를 기반으로 Looker 보고서를 만들 수 있는 Looker Explore 페이지로 이동합니다. 이 옵션은 스키마 이름, 테이블 이름, 열 수가 선택되지만 다른 Looker 보고서와 마찬가지로 조작할 수 있습니다. |
| 데이터베이스 표시 | 이 옵션을 사용하면 연결의 메타데이터를 기반으로 Looker 보고서를 만들 수 있는 Looker Explore 페이지로 이동합니다. 이 옵션은 스키마 이름, 카탈로그 이름, 테이블 수, 열 수가 선택되지만 다른 Looker 보고서와 마찬가지로 조작할 수 있습니다. |
| 프로세스 표시 | 이 옵션을 사용하면 이 연결에서 실행되는 프로세스, 현재 상태, 실행 시간 및 기타 정보를 기반으로 Looker 보고서를 만들 수 있는 Looker Explore 페이지로 이동합니다. 이는 Looker가 느리게 실행되는 경우 또는 쿼리가 전혀 실행되지 않는 경우 원인을 확인하는 데 유용할 수 있습니다. |
| PDT 이벤트 로그 표시 | 이 옵션을 사용하면 이 연결의 파생 테이블 활동을 기반으로 Looker 보고서를 만들 수 있는 Looker Explore 페이지로 이동합니다. 사용 가능한 필드는 영구 파생 테이블 문서 페이지에 자세히 설명되어 있습니다. |