Looker–Tableau Connector를 사용하면 Tableau 데스크톱을 사용하여 Looker Explore의 데이터에 연결할 수 있습니다. Looker–Tableau Connector는 JDBC를 사용하여 데이터 소스에 연결하는 애플리케이션에 대해 LookML 모델 및 Explore에 액세스할 수 있게 해주는 Looker 개방형 SQL 인터페이스를 기반으로 합니다. 자세한 내용은 개방형 SQL 인터페이스 문서를 참조하세요.
이 가이드는 Looker–Tableau Connector의 공개 미리보기용입니다. 질문하거나 의견을 공유하려면
요구사항
Looker–Tableau Connector를 사용하려면 다음 구성요소가 필요합니다.
- Looker 호스팅이고 Looker 23.18 이상을 실행하는 Looker 인스턴스.
- Google BigQuery 연결의 데이터를 사용하는 LookML 프로젝트. (LookML 프로젝트에는
connection
매개변수에 Google BigQuery 연결을 지정하는 모델 파일이 있어야 합니다.) - Tableau에서 액세스하려는 LookML 모델에 대한
explore
권한이 포함된 Looker 사용자 역할.
또한 Looker–Tableau Connector를 설정하기 전에 다음 단계를 완료해야 합니다.
- Looker(원본) 인스턴스의 경우 Looker 인스턴스에서 SQL 인터페이스 실험용 실험실 기능을 사용 설정합니다.
- Looker(Google Cloud 핵심 서비스) 인스턴스의 경우 Looker SQL 인터페이스 사전 GA 계약 신청 양식을 작성하세요. Google팀이 인스턴스에 SQL 인터페이스 기능을 사용 설정할 것입니다.
Looker에 연결하도록 Tableau 데스크톱 설정
공개 미리보기에서 Looker–Tableau Connector를 사용하려면 다음을 수행해야 합니다.
- Looker 인스턴스에 Tableau OAuth 앱 추가: Looker 관리자는 Looker API를 사용하여 Looker 인스턴스에서 Looker–Tableau Connector를 위해 Tableau OAuth 앱을 등록해야 합니다. Tableau OAuth 앱은 각 Looker 인스턴스에 대해 한 번만 등록해야 하며 Looker 인스턴스의 모든 사용자에게 적용됩니다.
- Tableau Connector 파일 및 JDBC 드라이버 파일 다운로드 및 저장: Looker–Tableau Connector에 액세스하려는 각 사용자는
avatica-<release_number>-looker.jar
파일 및 패키징된 Tableau 커넥터(.taco
) 파일을 다운로드하여 이를 컴퓨터의 특정 디렉터리에 저장해야 합니다.
다음 섹션에서 각 단계를 자세히 설명합니다.
Looker 인스턴스에 Tableau OAuth 앱 추가
Looker–Tableau Connector를 사용하려면 Looker 인스턴스에 Tableau OAuth 앱이 있어야 합니다. Looker 인스턴스에 Tableau OAuth 앱을 등록하는 가장 쉬운 방법은 Looker API 탐색기를 사용하는 것입니다.
Looker 인스턴스에 API 탐색기가 이미 설치되어 있으면 다음 URL 형식을 사용하여 액세스할 수 있습니다.
https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/
Looker 인스턴스에 API 탐색기가 없는 경우 Looker Marketplace에서 설치할 수 있습니다. 자세한 내용은 API 탐색기 사용 페이지를 참조하세요.
다음 단계에 설명된 대로 API 탐색기를 사용하여 Looker 인스턴스에 Tableau OAuth 앱을 등록합니다.
- Looker API 탐색기를 엽니다(자세한 내용은 API 탐색기 사용 페이지 참조).
- API 탐색기의 검색 필드에 OAuth 앱 등록을 입력합니다.
- 검색 결과에서 OAuth 앱 등록을 클릭합니다.
- OAuth 앱 등록 페이지에서 실행 버튼을 클릭합니다.
실행 대화상자의 요청 탭에서 해당 필드에 다음 정보를 입력합니다.
client_guid:
35FBB268-0CB0-4822-AFE3-28638C1C6269
body:
{ "redirect_uri": "http://localhost:55556/Callback", "display_name": "Tableau Desktop", "description": "Tableau Desktop client for JDBC Server", "enabled": true, "group_id": "" }
이 API 엔드포인트가 데이터를 변경한다는 것을 이해합니다. 체크박스를 선택합니다.
실행을 클릭합니다.
API 탐색기에서
Get OAuth Client App
메서드를 사용하여 Tableau OAuth 앱을 성공적으로 등록했는지 확인할 수 있습니다.- API 탐색기의 검색 필드에 OAuth 클라이언트 앱 가져오기를 입력합니다.
- 실행을 클릭합니다.
client_guid 필드에 Tableau OAuth 앱의 값을 입력합니다.
35FBB268-0CB0-4822-AFE3-28638C1C6269
Tableau OAuth 앱을 성공적으로 등록한 경우 앱을 등록할 때 입력한 값이 응답 탭에 반환됩니다.
이 단계는 필수가 아닙니다. 하지만 나중에 Looker–Tableau Connector를 더 이상 사용하지 않고 Tableau OAuth 앱을 삭제하려면 OAuth 앱 삭제를 참조하세요.
커넥터 파일 다운로드 및 저장
Looker–Tableau Connector를 사용하려면 각 Tableau 사용자가 다음 두 파일을 다운로드해야 합니다.
다음 섹션에서는 이러한 파일을 다운로드하는 방법과 컴퓨터에 파일을 저장하는 위치를 설명합니다.
Tableau 커넥터(.taco
) 파일
Tableau 커넥터 파일은 looker-jdbc-v0.2.0.taco
입니다. 각 사용자는 다음 단계에 따라 .taco
파일을 다운로드하고 컴퓨터에 저장해야 합니다.
- Tableau 커넥터 파일을 다운로드하려면
looker-jdbc-v0.2.0.taco
링크를 클릭합니다. 다운로드가 완료되면
looker-jdbc-v0.2.0.taco
파일을My Tableau Repository
디렉터리의Connectors
하위 디렉터리로 이동합니다. 기본 디렉터리 경로는 다음과 같습니다.- Windows:
C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors
MacOS:
/Users/[user]/Documents/My Tableau Repository/Connectors
- Windows:
JDBC 드라이버(looker.jar
) 파일
JDBC 드라이버의 이름은 avatica-<release_number>-looker.jar
입니다. 각 사용자는 다음 단계에 따라 GitHub에서 looker.jar
파일을 다운로드하고 파일을 컴퓨터에 저장해야 합니다.
- https://github.com/looker-open-source/calcite-avatica/releases로 이동합니다.
avatica-<release_number>-looker.jar
파일의 최신 버전을 다운로드합니다.avatica-<release_number>-looker.jar
파일을 각 사용자 컴퓨터의 다음 위치에 저장합니다.- Windows:
C:\Program Files\Tableau\Drivers
MacOS:
/Library/JDBC
또는~/Library/JDBC
- Windows:
Tableau 데스크톱에서 Looker 데이터에 연결
Looker 인스턴스에 Tableau OAuth 앱을 추가하고 looker-jdbc-v0.2.0.taco
및 avatica-<release_number>-looker.jar
파일을 다운로드한 후에는 다음 단계에 따라 Tableau 데스크톱을 사용하여 Looker 인스턴스의 데이터에 연결할 수 있습니다.
- Tableau 데스크톱의 왼쪽 연결 창에서 서버로 섹션에 있는 더보기... 옵션을 선택합니다.
- 검색창에 Looker JDBC by Google을 입력합니다.
- Looker JDBC by Google 옵션을 선택합니다.
- 대화상자 창에서 다음 매개변수를 입력합니다.
- 서버:
https://
없이 Looker 인스턴스 URL을 입력합니다. 예를 들면example.cloud.looker.com
입니다. - 포트:
443
- 인증:
OAuth
- OAuth 인스턴스 URL:
https://
를 사용하여 전체 Looker 인스턴스 URL을 입력합니다. 예를 들면https://example.cloud.looker.com
입니다.
- 서버:
- 로그인을 선택합니다. Tableau에서 Looker 인스턴스에 연결하고 OAuth로 계정을 인증하기 위해 브라우저 창을 엽니다.
- 메시지가 표시되면 OAuth 사용자 인증 정보를 입력합니다. 이미 로그인한 경우 브라우저 창에 Tableau가 브라우저 창을 사용하여 Looker에 인증했으며 이제 브라우저 창을 닫을 수 있다는 메시지가 표시됩니다.
- Looker에 인증이 완료되면 Tableau에서 Looker 인스턴스에 연결된 데이터 소스 페이지를 엽니다.
- 스키마 드롭다운 메뉴를 사용하여 Tableau 데스크톱에서 보려는 데이터가 포함된 Looker 모델을 선택합니다. Tableau는 선택한 Looker 모델의 Looker Explores로 테이블 목록을 채웁니다.
- 데이터 탐색을 시작하려면 테이블 목록에서 객체를 선택하여 캔버스로 드래그합니다.
Looker UI에서 Looker – Tableau Connector 쿼리 식별
Tableau의 쿼리는 개방형 SQL 인터페이스를 통해 수행됩니다. Looker 관리자는 개방형 SQL 인터페이스 문서의 설명대로 Looker UI를 사용하여 Open SQL 인터페이스에서 시작된 쿼리를 식별할 수 있습니다.
Looker–Tableau Connector의 쿼리는 소스 값이 'sql_interface' 또는 'Sql Interface'입니다.
고려사항
Tableau 데스크톱으로 Looker 데이터를 탐색하는 경우 다음 사항을 고려하세요.
- Looker–Tableau Connector는 Looker 개방형 SQL 인터페이스를 기반으로 하며 개방형 SQL 인터페이스와 동일한 LookML 제한사항을 갖습니다. 자세한 내용은 개방형 SQL 인터페이스 문서를 참조하세요.
- Tableau는 Looker–Tableau Connector를 사용하여 필드를 추가 및 삭제할 때를 포함하여 쿼리가 변경될 때마다 자동으로 데이터베이스를 쿼리합니다. Tableau에서 자동 업데이트를 사용 중지할 수 있습니다. 자세한 내용은 Tableau 문서를 참조하세요.
- Tableau를 사용하여 2개의 Looker Explore에 조인할 수 없습니다. 여러 Explore에 조인하려면 Looker를 사용하여 Looker 모델에 조인을 만드세요. Looker에서 조인을 사용하는 방법에 대한 자세한 내용은 Looker 문서 페이지 LookML에서 조인으로 작업하기 및 조인 매개변수를 참조하세요.
버그 신고
버그를 신고하려면
- 수행한 단계의 자세한 목록
- 예상한 동작
- 실제 동작(가능한 경우 스크린샷 포함)
Tableau OAuth 앱 삭제(선택사항)
이 단계는 필수가 아닙니다. 하지만 나중에 Looker–Tableau Connector를 더 이상 사용하지 않고 Looker 인스턴스에서 Tableau OAuth 앱을 삭제하려는 경우 다음 단계에 따라 API 탐색기를 사용하여 삭제할 수 있습니다.
- Looker API 탐색기를 엽니다(자세한 내용은 API 탐색기 사용 페이지 참조).
- API 탐색기의 검색 필드에 OAuth 클라이언트 앱 삭제를 입력합니다.
- 검색결과에서 OAuth 클라이언트 앱 삭제를 클릭합니다.
- OAuth 클라이언트 앱 삭제 페이지에서 실행 버튼을 클릭합니다.
실행 대화상자의 요청 탭에서 Tableau OAuth 앱의 client_guid 값을 입력합니다.
35FBB268-0CB0-4822-AFE3-28638C1C6269
이 API 엔드포인트가 데이터를 변경한다는 것을 이해합니다. 체크박스를 선택합니다.
API 탐색기에서
Get OAuth Client App
메서드를 사용하여 Tableau OAuth 앱을 성공적으로 삭제했는지 확인할 수 있습니다.- API 탐색기의 검색 필드에 OAuth 클라이언트 앱 가져오기를 입력합니다.
- 실행을 클릭합니다.
client_guid 필드에 Tableau OAuth 앱의 값을 입력합니다.
35FBB268-0CB0-4822-AFE3-28638C1C6269
Tableau OAuth 앱을 성공적으로 삭제한 경우 응답 탭이 빈 본문 값을 반환합니다.