Looker용 연결된 시트 사용

Looker용 연결된 시트를 사용하면 사용자가 대화형으로 익숙한 Google Sheets 스프레드시트 인터페이스를 통해 LookML 모델의 데이터를 탐색할 수 있습니다. Sheets 사용자는 Looker에서 지원하는 데이터베이스 50개 이상에서 관리형 데이터에 액세스할 수 있습니다. 탐색은 연결된 시트가 Looker에서 정의한 대로 뷰, 필드, 측정값을 사용한 모델의 체계적인 뷰를 제공하므로 직관적입니다. 연결된 시트를 통한 Looker 데이터는 피벗 테이블, 차트, 수식 등 표준 Sheets 구성에서 사용할 수 있으므로 익숙한 구성을 통해 분석을 유연하게 수행할 수 있습니다.

연결된 시트 사용 설정

연결된 시트를 사용하려면 다음 안내를 따르세요.

  • Looker(원본)에서 Looker 관리자는 Looker 관리자 메뉴의 플랫폼 섹션에 있는 BI 커넥터 패널에서 모든 Looker BI 커넥터 또는 연결된 시트 전환 버튼을 사용 설정해야 합니다. Looker(Google Cloud 핵심 서비스)에서 이러한 옵션은 기본적으로 사용 설정됩니다.
  • Looker 인스턴스는 Looker에서 호스팅되어야 합니다.
  • 인스턴스가 Google Cloud에서 호스팅되는 경우 Looker 인스턴스는 Looker 22.20 이상을 실행해야 합니다. Looker 인스턴스가 Google Cloud에서 호스팅되지 않으면 인스턴스는 Looker 23.4 이상을 실행해야 합니다.
  • Google Sheets에서 Looker 인스턴스에 연결하려는 각 사용자는 Looker 사용자 계정에서 Google Workspace 계정에 사용하는 것과 동일한 이메일 주소를 사용해야 합니다. Google Workspace 및 Looker 계정 이메일 주소가 다른 경우 Sheets에서 Looker에 연결하려 하면 오류가 발생합니다.
  • 개별 설정이 없는 서비스에 대한 액세스 권한은 Google Workspace 관리 콘솔에서 사용 설정되어 있어야 합니다. 이 기능은 기본적으로 사용 설정되어 있습니다. 자세한 내용은 개별 설정이 없는 서비스에 대한 액세스 권한 관리하기 도움말을 참고하세요.

Google Sheets에서 Looker에 연결

  1. Google Sheets 데이터 메뉴에서 데이터 커넥터를 선택한 후 Looker에 연결을 선택합니다.

  2. Looker에 연결 대화상자에서 Looker 인스턴스 이름을 입력하거나 최근에 연결한 인스턴스의 이름을 선택하고 계속을 선택합니다.

  3. 다음 대화상자에서 쿼리에 사용할 Looker 모델Explore 를 선택하고 연결을 선택합니다.

Sheets가 Looker 인스턴스에 연결되면 Sheets는 Looker 개발자가 추가한 뷰, 측정기준, 측정 및 필드 설명을 포함하여 선택한 Explore의 구조를 보여주는 새 시트를 엽니다.

Google Sheets를 사용하여 Looker 쿼리 빌드하기

Looker 쿼리는 Sheets 피벗 테이블을 통해 빌드됩니다. Looker 데이터를 시트에 추가하려면 다음 안내를 따르세요.

  1. Explore를 보여주는 시트에서 피벗 테이블을 선택합니다.

  2. 새 피벗 테이블을 새 시트 또는 기존 시트 중 어디에 삽입할지 선택하고 만들기를 선택합니다.

    비어 있는 새로운 피벗 테이블이 생성되고 피벗 테이블 편집기 창이 열립니다. Looker Explore의 측정기준과 측정을 기반으로 행, 열, 값, 필터를 추가하여 쿼리를 빌드할 수 있습니다.

    피벗 편집기의 행, 열, 값 및 필터는 다음과 같은 방식으로 Looker 측정기준 및 측정과 동일합니다.

    • 행은 Looker 측정기준과 동일합니다.
    • 열은 Looker 피벗된 측정기준과 동일합니다.
    • 값은 Looker 측정과 동일합니다. Looker 측정기준 및 함수 기준 요약 Sheets를 선택하여 커스텀 측정을 만들 수 있습니다.
    • 필터는 Looker 필터와 동일합니다.

    또한 피벗 편집기는 Explore에 포함된 뷰 목록을 표시하며, 해당 뷰에 포함된 측정기준 및 측정을 표시하도록 선택할 수 있습니다.

  3. 추가를 선택하여 행, 열, 값 또는 필터를 추가합니다. 연결된 시트에는 Explore에서 사용할 수 있는 뷰 목록이 표시됩니다. 뷰에 측정기준 및 측정 목록을 표시할 뷰 이름을 선택한 다음 행, 열, 값 또는 필터에 대한 데이터를 제공하는 필드를 선택합니다.

  4. 쿼리를 빌드하기 위한 Looker 필드와 필터를 추가한 후 Apply를 선택합니다. 이렇게 하면 시트가 Looker 인스턴스의 데이터로 채워집니다.

피벗 테이블에 Looker 데이터를 추가한 후에는 Google Sheets를 사용하여 데이터 형식을 지정하거나 Looker 데이터를 기반으로 새로운 Sheets 수식을 빌드할 수 있습니다.

필터링 옵션

Looker용 연결된 시트가 처음 출시된 이후 새로운 필터링 옵션이 추가되었습니다.

값 기준 필터링 - 2023년 8월 추가됨

Looker용 연결된 시트 피벗 테이블에서는 값 목록을 보고 관심 있는 값을 선택 및 선택 취소하여 Looker 치수를 필터링할 수 있습니다. 이전에는 조건별 필터링을 사용할 때 필터 값을 수동으로 입력해야 했습니다.

이 기능을 사용하려면 필드를 피벗 테이블의 필터 섹션에 추가하고 상태 드롭다운을 클릭하여 필터 옵션을 엽니다. 그런 다음 필터 추가를 클릭합니다.

사이드바가 열리고 Sheets는 Looker에서 가장 자주 발견되는 500개의 값을 가져옵니다.

그런 다음 항목을 검색하거나, 항목을 모두 선택 또는 선택 취소하거나, 빈도 또는 알파벳순으로 항목을 정렬할 수 있습니다. 하단에서 확인을 클릭하면 Sheets에서 선택사항을 저장합니다. 그런 다음 적용을 클릭하여 새 필터를 적용한 상태에서 피벗 테이블을 평소처럼 새로 고칠 수 있습니다.

Looker 필터 표현식을 사용하는 필터 - 2023년 9월에 추가됨

Looker 필터 표현식을 사용하여 연결된 시트에서 상대 날짜 필터와 기타 여러 고급 필터를 적용할 수 있습니다. 예를 들어 연결된 시트에 '지난 30분 동안' 또는 '지난 10일 동안'과 같은 필터를 적용할 수 있습니다.

Looker 필터 표현식을 사용하려면 다음 안내를 따르세요.

  1. 필드를 피벗 테이블의 필터 섹션에 추가합니다.

  2. 상태 드롭다운을 클릭하여 필터 옵션을 표시하고 필터 표현식을 선택합니다.

  3. Looker 필터 표현식을 필드에 입력합니다.

    예를 들어 지난 7일을 필터링하려면 '7일' 또는 '지난 7일' 중 하나를 작성할 수 있습니다.

  4. 확인을 클릭합니다.

상대적 날짜 필터링 외에 이제 사용할 수 있는 다른 필터링 예시는 다음과 같습니다.

  • -FOO%로 시작하지 않는 문자열
  • 포괄적이고 배타적인 숫자 범위: (12, 20]

사용 가능한 모든 필터 표현식을 보려면 Looker 필터 표현식 문서 페이지를 참조하세요.

Looker 매개변수 및 필터 전용 필드 사용 — 2023년 10월에 추가됨

이제 연결된 시트에서 매개변수필터 전용 필드를 사용할 수 있습니다.

필터 전용 필드 및 매개변수는 Looker에서와 마찬가지로 Sheets의 필드 선택 도구의 필터 전용 필드 섹션에 표시됩니다. 아키텍처 구성요소를 사용하려면 다음 단계를 따르세요.

  1. 측정기준 또는 측정값으로 필터링할 때와 마찬가지로 선택한 매개변수와 필터 전용 필드를 필터 섹션에 추가하거나 드래그합니다.
  2. 허용된 값이 있는 매개변수의 경우 이러한 값은 조건으로 필터링 대화상자의 드롭다운에 표시됩니다.
  3. 필터 전용 필드의 경우 일반 조건으로 필터링 대화상자를 사용할 수 있습니다. 필드에 Looker 모델에 정의된 제안이 있는 경우 값으로 필터링 기능도 사용할 수 있습니다.

Google Sheets에서 데이터 새로고침

피벗 테이블의 데이터는 정적이지만 언제든지 새로고침될 수 있습니다. 데이터를 새로고침하면 Looker에서 데이터베이스를 쿼리하고 최신 데이터로 피벗 테이블을 업데이트합니다.

피벗 테이블과 Explore를 표시하는 시트에는 가장 최근에 새로고침한 시간이 표시됩니다.

새로고침을 선택하여 피벗 테이블의 데이터를 업데이트합니다.

정기적인 새로고침 시간 예약

데이터 자동 업데이트를 예약하려면 피벗 테이블에서 점 3개로 된 메뉴를 선택한 다음 새로고침 옵션을 선택하거나 Explore 시트에서 새로고침 옵션을 선택합니다. Looker에 예약된 새로고침 대화상자가 표시됩니다.

피벗 테이블 설정 수정

피벗 테이블에 포함된 행, 열, 값 또는 필터를 수정하려면 점 3개로 된 메뉴 옆에 있는 연필 아이콘을 선택하여 피벗 테이블 편집기 패널을 엽니다.

연결된 시트 모니터링

Looker 관리자는 시스템 활동 내역 Explore에서 쿼리 API 클라이언트 속성 필드 그룹을 사용하여 연결된 시트 사용량을 볼 수 있습니다. 새 쿼리가 실행될 때마다 기록 Explore에 항목이 생성됩니다.

쿼리 API 클라이언트 속성 필드 그룹에는 연결된 시트에 대한 세 개의 새 필드가 있습니다.

  • API 클라이언트 이름 — 이 필드에서는 연결된 시트 항목을 식별하기 위해 항상 Connected Sheets를 표시합니다.
  • 연결된 시트 스프레드시트 ID — 이 필드에서는 해당 시트의 Google Sheets URL에 포함된 시트 ID를 표시합니다.
  • 연결된 시트 트리거 — 이 필드는 사용자가 Sheets에서 새로고침 버튼을 선택하거나 예약된 새로고침을 통해 쿼리가 트리거되었는지 여부를 보여줍니다.

다음은 연결된 시트 사용량을 보여주는 시스템 활동 URL의 예시입니다. <instance_name.looker.com>을 인스턴스 URL로 바꿉니다.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

연결된 시트 API 지원

AppsScriptGoogle Sheets API를 통해 Looker용 연결된 시트의 API 지원에 액세스할 수 있습니다.

API 지원을 통해 프로그래매틱 방식으로 수행할 수 있는 작업은 다음과 같습니다.

  • 자동 데이터 새로고침: Looker 기반 스프레드시트의 정기 업데이트를 예약하여 최신 정보를 사용할 수 있습니다.
  • 커스텀 워크플로: Looker 데이터를 기존 Google Sheets 워크플로에 통합하는 복잡한 프로세스를 빌드할 수 있습니다.
  • 다른 애플리케이션과의 통합: AppsScript 또는 Google Sheets API를 사용하여 Looker 데이터를 외부 도구와 서비스에 연결할 수 있습니다.

Google Sheets API를 사용하여 Looker를 데이터 소스로 지정하려면 DataSourceSpec REST 리소스와 함께 looker 객체를 사용합니다.

알아두어야 할 사항

  • 피벗 테이블에 표시된 데이터에 대한 대소문자 구분은 모델에 대한 대소문자 구분 설정에 따라 결정됩니다. 하지만 피벗 테이블의 필터는 필터가 기본 Sheets 데이터에 대해 대소문자를 구분하지 않는 상황에서 대소문자를 구분하지 않습니다.
  • 시트에 대한 뷰어 액세스 권한이 있는 사용자는 피벗 테이블에서 캐시된 데이터를 볼 수 있습니다.
  • 시트에 대한 편집자 액세스 권환 외에도 피벗 테이블을 수정하거나 새로고침해야 하는 모든 사용자는 데이터 모델에 액세스하기 위해 Looker에서 올바른 권한이 필요합니다. 여기에는 피벗 테이블의 기반이 되는 모델에 대한 액세스, 데이터를 볼 수 있는 권한, 액세스 필터 또는 액세스 권한 부여를 통한 데이터에 대한 적절한 액세스가 포함됩니다.
  • 사용자가 OAuth를 사용하여 BigQuery 데이터베이스에 인증하는 경우, 기본 데이터베이스에 대한 권한을 부여해야 할 수 있습니다.

연결된 시트 행 및 데이터 한도

연결된 시트로 생성되는 쿼리는 최대 100,000개의 행으로 제한됩니다. 쿼리 결과에 더 많은 행이 포함된 경우 Sheets가 사용자에게 오류를 표시합니다. 사용자에게 download_without_limit 권한이 없는 경우 결과는 Sheets 제한에 관계없이 최대 5,000행으로 잘립니다.

또한 연결된 시트 쿼리에는 데이터 크기 한도가 적용됩니다. 너무 많은 데이터를 반환하는 쿼리로 인해 오류가 발생합니다.

이러한 오류 중 하나가 나타나면 쿼리에 필터를 추가하고 더 적거나 덜 세부적인 측정기준을 사용하는 것이 좋습니다.

연결된 시트 문제 해결

Google Sheets에서 Looker에 연결하려고 할 때 몇 가지 문제가 발생할 수 있습니다. 이 섹션에서는 이러한 문제와 해결 방법에 대해 설명합니다.

오류: Looker 인스턴스에 연결하는 중에 오류가 발생했습니다. 다시 시도해 주세요. 문제가 계속되면 의견을 제출해 주세요.

이 오류는 여러 가지 이유로 발생할 수 있습니다.

  • Looker 인스턴스 이름이 잘못 입력되었습니다. 이 경우 Looker 인스턴스 이름을 확인하고 다시 연결해 보세요.
  • Sheets에서 Looker API에 연결할 수 없습니다. Looker 인스턴스에서 기본 API 호스트 URL을 사용하지 않으면 이 문제가 발생할 수 있습니다. 이 문제를 해결하려면 API 관리자 패널API 호스트 URL 필드를 비워 두세요.

오류: Looker 인스턴스가 이 기능을 사용하도록 구성되지 않았습니다. Looker 관리자에게 연락하여 이 기능을 사용할 수 있는지 확인하세요.

이 오류는 여러 가지 이유로 발생할 수 있습니다.

  • 새로 만든 Looker 인스턴스에 연결하려고 합니다. 새 Looker 인스턴스를 연결된 시트에서 사용할 수 있으려면 최대 24시간이 걸릴 수 있습니다.
  • Looker 호스팅이 아닌 Looker 인스턴스에 연결하려 합니다. Looker 호스팅인 다른 Looker 인스턴스에 연결합니다.

Looker 인스턴스에 연결한 후에 모델이 표시되지 않음

이는 인스턴스에서 모델을 보는 데 필요한 권한이 없음을 나타냅니다.

뷰어 역할이 있는 Looker 사용자는 Looker에서 Explore UI를 사용할 수 있는 충분한 권한이 없을 때와 같이 Sheets에서 연결을 만들 수 있는 권한이 없습니다. 사용자가 Looker용 연결된 시트를 사용하려면 explore 권한이 있어야 합니다. 관리자, 개발자, 사용자 역할에는 explore 권한이 포함됩니다. Looker 관리자는 사용자에게 explore 권한을 부여할 수 있으며, 이 경우 사용자는 인스턴스에서 모델을 볼 수 있어야 합니다.

오류: 연결된 Looker 계정 이메일 주소가 Google 계정 이메일 주소와 다릅니다.

이는 Looker 계정 이메일 주소가 Google 계정과 함께 사용되는 이메일 주소와 일치하지 않음을 나타냅니다. Looker 계정과 일치하는 이메일 주소를 가진 Google 계정에 로그인했는지 확인합니다. 또는 Looker 관리자가 현재 Google 이메일 주소를 사용하는 새 Looker 사용자 계정을 만들 수 있습니다.

오류: 잘못된 요청: 사용 설정된 클라이언트를 찾을 수 없습니다.

이 오류는 연결된 시트 커넥터가 사용 설정되지 않았음을 나타냅니다. Looker 관리자는 Looker 관리자 메뉴의 플랫폼 섹션에 있는 BI 커넥터 패널에서 모든 Looker BI 커넥터 또는 연결된 시트 전환 버튼을 사용 설정해야 합니다.

오류: 403 금지됨

Looker 인스턴스에 IP 허용 목록이 구성되어 있으면 허용 목록으로 인해 Sheets가 Looker API에 연결되지 않게 할 수 있습니다. 허용 목록이 원인인지 확인하려면 Looker 인스턴스 URL로 이동하여 허용 목록에 IP 주소 없음 오류가 있는지 확인합니다.