이 페이지에서는 Looker의 Explore 작업 톱니바퀴 메뉴에서 연결된 시트 빠른 링크 옵션을 사용 설정하고 사용하는 방법을 설명합니다. 연결된 시트 옵션을 사용하면 Google Sheets가 열리고 Google Sheets에서 Looker Explore로의 연결이 시작됩니다. 그런 다음 선택한 Looker Explore의 필드를 사용하여 새로 만든 Google Sheets 내에서 보고서, 피벗 테이블 또는 차트를 빌드할 수 있습니다.
시작하기 전에
연결된 시트 빠른 링크를 사용하려면 다음이 필요합니다.
- 이 페이지의 연결된 시트 빠른 링크 사용 설정 및 구성 섹션에 설명된 대로 관리자가 이 기능을 사용 설정하고 구성한 Looker 인스턴스
- Sheets에 연결하려는 LookML 모델에 대한
explore권한이 있는 Looker 사용자 계정 - Looker 계정과 연결된 이메일 주소와 동일한 이메일 주소를 가진 Google 계정
Explore에서 연결된 시트 빠른 링크 사용
Looker 관리자가 기능을 사용 설정한 경우 Google Sheets와 액세스 권한이 있는 Explore 간의 연결을 시작할 수 있습니다.
Google 계정과 연결된 이메일 주소로 Looker에 로그인합니다.
Looker에서 데이터 소스로 사용할 Explore로 이동합니다.
Explore 작업 톱니바퀴 아이콘을 클릭하고 연결된 시트를 선택합니다.
이 기능을 처음 사용할 때는 Looker가 Google 계정에 액세스하도록 승인하라는 메시지가 표시됩니다. 사용하려는 Google 계정을 선택합니다. Google 계정의 이메일 주소가 Looker 사용자 계정과 연결된 이메일 주소와 일치해야 합니다.
동의 화면에서 요청된 권한을 검토하고 허용을 클릭합니다.
Google Sheets가 새 브라우저 탭에서 열리고 Google 계정을 Looker 계정에 연결할지 묻는 대화상자가 표시됩니다. 계정 연결을 클릭합니다.
이제 Google 시트가 시작한 Looker Explore에 연결됩니다. Google Sheets 내에서 Explore의 필드를 추가하고, 피벗 테이블을 만들고, 차트를 빌드하고, 수식을 적용하여 Looker Explore의 데이터를 분석할 수 있습니다.
연결된 시트에서 쿼리를 작성하는 방법에 대한 자세한 내용은 Looker용 연결된 시트 사용 문서 페이지를 참고하세요.
연결된 시트 빠른 링크 사용 설정 및 구성
Explore 작업 톱니바퀴 메뉴에서 연결된 시트 빠른 링크를 사용 설정하려면 Looker 인스턴스가 다음 요구사항을 충족해야 합니다.
- 인스턴스는 Looker 25.20 이상을 실행해야 합니다.
- Looker (Google Cloud 핵심 서비스) 인스턴스의 경우 연결된 시트 빠른 링크는 공개 보안 연결 또는 하이브리드 연결 네트워크 연결에서만 지원됩니다. Looker (Google Cloud 핵심 서비스) 비공개 연결 (비공개 서비스 액세스) 인스턴스는 지원되지 않습니다.
- Looker (원본) 인스턴스의 경우 연결된 시트 빠른 링크는 Looker 호스팅 인스턴스에서만 지원됩니다. 고객 호스팅 Looker 인스턴스는 지원되지 않습니다.
Looker 인스턴스의 Explore 작업 톱니바퀴 메뉴에서 커넥티드 시트 옵션을 사용 설정하려면 관리자가 다음 섹션에 설명된 일반 작업을 수행해야 합니다.
- Google Cloud 콘솔에서 Google Sheets API를 사용 설정합니다.
- Google Sheets API가 사용 설정된 동일한 Google Cloud 콘솔 프로젝트에서 Google Cloud 콘솔에 OAuth 클라이언트 만들기
- Looker BI 커넥터 페이지에서 연결된 시트 빠른 링크 사용 설정 옵션을 사용 설정하고 구성합니다.
Google Cloud 콘솔에서 Google Sheets API 사용 설정
커넥티드 시트 빠른 링크는 Google Sheets API를 사용하므로 OAuth 클라이언트를 만드는 데 사용할 프로젝트에서 이 API를 사용 설정해야 합니다. Google Sheets API는 IAM roles/serviceusage.serviceUsageAdmin 권한이 있는 IAM 사용자가 사용 설정할 수 있습니다.
Google Sheets API를 사용 설정하려면 다음 단계를 따르세요.
Google Cloud 콘솔 탐색 메뉴에서 API 및 서비스 > 라이브러리로 이동하여 Google Sheets API를 엽니다.
Google Cloud 콘솔의 프로젝트 선택 도구 열기에서 Looker Explore에서 Google Sheets에 연결하는 데 사용할 프로젝트를 선택합니다. OAuth를 구성하는 동일한 프로젝트에서 Google Sheets API가 사용 설정되도록 커넥티드 시트 빠른 링크 설정 절차 전반에 걸쳐 동일한 Google Cloud 콘솔 프로젝트를 사용해야 합니다.
Google Sheets API 페이지에서 API가 아직 사용 설정되어 있지 않다면 사용 설정을 클릭합니다.
OAuth 클라이언트 만들기
필요한 역할이 있는 IAM 사용자가 OAuth 클라이언트를 만들어야 합니다.
원하는 Google Cloud 프로젝트에서 OAuth 클라이언트를 설정할 수 있습니다. 하지만 이 동일한 프로젝트에서 Google Sheets API를 사용 설정해야 합니다.
클라이언트와 사용자 인증 정보를 만들려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Google Cloud 콘솔 프로젝트 선택기 열기를 사용하여 Google Sheets API를 사용 설정한 것과 동일한 프로젝트를 엽니다.
Google Cloud 콘솔 기본 메뉴를 사용하여 API 및 서비스 > 사용자 인증 정보로 이동합니다.
사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 드롭다운 메뉴를 클릭한 다음 OAuth 클라이언트 ID를 선택합니다.
애플리케이션 유형 드롭다운에서 웹 애플리케이션을 선택합니다.
이름 필드에 OAuth 클라이언트 이름(예:
Looker to Connected Sheets)을 입력합니다.승인된 리디렉션 URI 섹션에서 URI 추가 버튼을 클릭합니다. 다음 URI를 추가합니다.
https://LOOKER_INSTANCE_URL/oauth2callbackURI 추가 버튼을 클릭하여 다음 URI도 추가합니다.
https://LOOKER_INSTANCE_URL/external_oauth/redirect만들기를 클릭합니다.
만들기를 클릭하면 OAuth 클라이언트가 생성됨 창이 나타납니다. 이 창에는 Google Cloud 콘솔에서 OAuth 클라이언트에 생성한 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 연결된 시트 사용 설정 빠른 링크 옵션을 구성할 때 필요하므로 이 값을 복사하여 기록해 둡니다.
'연결된 시트 사용 설정' 빠른 링크 옵션 구성
Google Cloud 콘솔에서 Google Sheets API를 사용 설정하고 Google Cloud 콘솔에서 OAuth 클라이언트를 만든 후 다음 단계에 따라 Looker 인스턴스에서 커넥티드 시트 빠른 링크를 사용 설정할 수 있습니다.
- Looker 인스턴스에서 관리 패널의 플랫폼 섹션에서 BI 커넥터를 선택합니다.
- Google Sheets 전환 버튼을 사용 설정합니다(아직 사용 설정되지 않은 경우).
- 중첩된 전환 버튼 연결된 시트 빠른 링크 사용 설정을 사용 설정합니다.
- 클라이언트 ID 및 클라이언트 보안 비밀번호 필드에 Google Cloud 콘솔에서 OAuth 클라이언트를 생성할 때 Google Cloud 콘솔에서 복사한 값을 붙여넣습니다.
- 저장을 클릭합니다.
이제 Looker 인스턴스에 Explore 작업 톱니바퀴 메뉴의 연결된 시트 옵션이 설정됩니다.
파일럿 프로그램에서 이전
조직이 시트에서 열기 기능의 이전 파일럿 프로그램에 참여한 경우 Looker 인스턴스에서 Looker가 제공한 중앙 관리 OAuth 클라이언트를 사용했습니다. 이 설정은 각 Looker 관리자가 Looker 인스턴스에 대해 자체 OAuth 클라이언트를 구성하는 더 안전하고 확장 가능한 방법으로 대체됩니다. 기존 파일럿 고객은 계속 기능을 사용하려면 이 새로운 구성으로 전환해야 합니다.
새 버전으로 이전하려면 관리자가 Google Cloud 콘솔에서 조직의 자체 OAuth 클라이언트를 설정한 다음 Looker BI 커넥터 관리자 페이지에서 사용자 인증 정보를 구성해야 합니다. 단계는 이 페이지의 다음 섹션에 설명된 초기 설정과 동일합니다.
- Google Cloud 콘솔에서 Google Sheets API 사용 설정
- Google Sheets API가 사용 설정된 동일한 Google Cloud 콘솔 프로젝트에서 Google Cloud 콘솔에 OAuth 클라이언트 만들기
- Looker BI 커넥터 페이지에서 연결된 시트 빠른 링크 사용 설정 옵션을 사용 설정하고 구성합니다
관리자가 이 단계를 완료하면 인스턴스에서 새 고객 관리 OAuth 흐름을 자동으로 사용합니다. 이전 파일럿 기능과 Looker 관리 OAuth 클라이언트에 대한 의존성이 더 이상 활성화되지 않습니다.
문제 해결
- 이메일 불일치 오류: Google 인증 단계에서 오류가 발생하면 선택한 Google 계정의 이메일 주소가 Looker 사용자 계정의 이메일 주소와 정확히 동일한지 확인합니다.
- '커넥티드 시트' 옵션이 표시되지 않음: 이 옵션은 Looker 관리자가 BI 커넥터 설정에서 이 기능을 사용 설정한 경우에만 작업 탐색 톱니바퀴 메뉴에 표시됩니다. Looker 관리자에게 문의하여 도움을 받으세요.
- Google Cloud 콘솔 권한: OAuth 클라이언트 및 동의 화면을 구성하는 관리자에게는 Google Cloud 프로젝트에 대한
roles/oauthconfig.editor및roles/serviceusage.serviceUsageAdmin권한이 필요합니다. - 공개 프리뷰 기간 중 기타 문제나 의견이 있으면
looker-connected-sheets-external@google.com 으로 이메일을 보내주세요.