관리자 설정 - 셀프 서비스 탐색

셀프서비스 Explore 기능을 사용하면 Looker 사용자가 Looker에 CSV, XLS, XLSX 파일을 업로드한 다음 LookML 모델을 구성하거나 Git 버전 제어를 설정하지 않고도 Looker Explore에서 데이터를 쿼리하고 시각화할 수 있습니다.

Looker 관리자는 Looker 관리 메뉴에서 셀프 서비스 Explore 옵션을 선택하여 셀프 서비스 Explore 기능을 구성하고 인스턴스에서 데이터 업로드를 볼 수 있습니다.

시작하기 전에

셀프 서비스 탐색 분석을 사용하려면 Looker 인스턴스가 다음 요구사항을 충족해야 합니다.

• BigQuery 연결의 경우 Looker 25.20 이상, Snowflake 연결의 경우 Looker 26.8 이상을 실행합니다.
• BigQuery 또는 Snowflake 데이터베이스에 연결되어 있으며 연결이 다음과 같이 구성되어 있어야 합니다.
  • 연결이 모든 프로젝트 범위로 구성되어 있어야 합니다. 연결의 범위를 확인하려면 Looker 관리 메뉴의 연결 페이지에 있는 데이터베이스 탭의 범위 열을 참고하세요. 연결이 생성된 후에는 연결의 프로젝트 범위 값을 수정할 수 없습니다.
  • 영구 파생 테이블 (PDT)의 연결이 사용 설정되어 있어야 합니다. 연결에서 PDT가 사용 설정되었는지 확인하려면 Looker 연결 페이지를 열고 연결의 수정 버튼을 클릭하고 설정(선택사항) 탭을 열고 PDT 사용 설정 전환 버튼이 사용 설정되어 있는지 확인합니다.
  • Snowflake 연결의 경우 데이터베이스 관리자가 Looker 역할에 CREATE STAGE를 부여해야 합니다. 자세한 내용은 Snowflake에 대한 Looker 연결 만들기 문서 페이지를 참고하세요.
• 셀프 서비스 Explore를 만들 사용자의 Looker 사용자 계정에는 사용자가 인스턴스에 CSV 파일을 업로드할 수 있는 upload_data 권한이 있어야 합니다.

Google Sheets에서 데이터를 업로드할 때 다음 제한사항에 유의하세요.

• Private Service Connect를 사용하는 Looker (Google Cloud 핵심 서비스) 인스턴스는 Google Sheets 업로드의 OAuth 흐름을 지원하지 않습니다. 이러한 인스턴스는 수동 URL 흐름을 사용하여 Google Sheets에서 데이터를 업로드해야 합니다.
• VPC 서비스 제어를 사용하는 Looker (Google Cloud 핵심 서비스) 인스턴스는 Google Sheets 업로드를 지원하지 않습니다.

셀프서비스 Explore 사용 설정

중요:

• 셀프 서비스 탐색 기능을 지원하기 위해 Looker 25.20으로 업그레이드하면 Looker 인스턴스에서 explore 권한이 포함된 모든 역할 또는 권한 세트(맞춤 권한 세트 포함)에 upload_data 권한을 추가합니다. Looker 인스턴스에서 데이터 업로드를 사용 설정하면 upload_data 권한이 있는 모든 사용자가 인스턴스에서 셀프 서비스 Explore를 만들기 위해 데이터를 업로드할 수 있습니다.
• 인스턴스에 기존의 셀프 서비스 탐색이 있는 경우 셀프 서비스 탐색 관리 페이지에서 설정을 변경할 때 다음 사항에 유의하세요.
  • 데이터 업로드를 사용 중지하면 사용자가 더 이상 Explore 메뉴에서 기존 셀프서비스 Explore에 액세스할 수 없으며, 데이터에 의존하는 Look 또는 대시보드가 영향을 받을 수 있습니다.
  • 셀프 서비스 Explore의 기본 연결을 변경하면 인스턴스의 기존 셀프 서비스 Explore와 해당 데이터에 의존하는 Look 또는 대시보드에 영향을 미칠 수 있습니다.

사용자가 셀프 서비스 Explore를 만들 수 있으려면 Looker 관리자가 다음 단계에 따라 기능을 구성해야 합니다.

1. Looker 관리 메뉴의 일반 섹션에서 셀프 서비스 탐색 관리 페이지를 선택합니다.
2. 셀프 서비스 Explore 관리 페이지의 기본 연결 드롭다운 메뉴에서 셀프 서비스 Explore의 데이터를 저장하는 데 사용할 BigQuery 또는 Snowflake 연결을 선택합니다. Looker는 인스턴스의 셀프 서비스 Explore를 위해 이 데이터베이스에 데이터를 저장합니다.
3. 데이터 업로드 전환 버튼 옆에 있는 테스트 버튼을 클릭하여 기본 연결이 유효하고 영구 파생 테이블 (PDT)에 연결이 사용 설정되어 있는지 확인합니다(연결 요구사항은 시작하기 전 섹션 참고). 테스트에 실패하면 데이터 업로드를 사용 설정할 수 없습니다. 연결 관리 페이지로 이동하여 연결 문제를 해결합니다.
4. 테스트를 통과하면 데이터 업로드 전환 버튼을 켜서 셀프 서비스 탐색 기능을 사용 설정합니다.
5. Looker 인스턴스에서 Google Sheets의 데이터 업로드를 지원하려면 다음 단계를 따르세요.
   • 셀프 서비스 Explore를 위해 BigQuery 연결을 구성했는지 확인합니다 (Google Sheets 업로드는 BigQuery 연결에서만 지원됨).
   • Google Cloud 콘솔을 사용하여 Google Sheets 업로드를 지원하는 데 필요한 API를 사용 설정합니다.
   • 사용자가 Google 드라이브 탐색을 사용하여 데이터 업로드용 Google Sheets 파일을 선택할 수 있도록 하려면 Google Sheets 업로드용 OAuth를 사용 설정하세요(선택사항).
   • Google Sheets 데이터 가져오기 전환 버튼 옆에 있는 테스트 버튼을 클릭하여 Google Sheets 업로드와 관련된 테스트를 실행합니다.
   • Google Sheets 데이터 가져오기 전환 버튼을 켭니다. (Google Sheets에서 데이터를 업로드하려면 데이터 업로드 전환 버튼과 Google Sheets 데이터 가져오기 전환 버튼을 모두 사용 설정해야 합니다.)

Google Sheets 업로드를 지원하는 API 사용 설정

Looker가 BigQuery 연결을 위해 Google Sheets에서 데이터를 업로드하도록 지원하려면 IAM roles/serviceusage.serviceUsageAdmin 권한이 있는 IAM 사용자가 Google Cloud 콘솔에서 다음 API를 사용 설정해야 합니다.

• 이 API는 셀프 서비스 Explore 관리 페이지의 기본 연결 드롭다운 메뉴에 지정된 BigQuery 연결이 있는 Google Cloud 프로젝트에서 사용 설정해야 합니다.

  • BigQuery API: 모든 BigQuery 작업에 필요

• 이러한 API는 데이터를 업로드하는 데 사용되는 서비스 계정과 연결된 Google Cloud 프로젝트에서 사용 설정해야 합니다 (셀프 서비스 탐색 분석 관리 페이지의 기본 연결 드롭다운 메뉴에 지정된 Google Cloud 프로젝트와 동일할 수도 있고 아닐 수도 있는 BigQuery 연결의 PDT 프로세스에 사용되는 서비스 계정).

  • BigQuery API: 모든 BigQuery 작업에 필요
  • Google Sheets API: Google Sheets 문서의 각 시트 이름을 가져오는 데 필요합니다.
  • Google Drive API: BigQuery가 드라이브에서 파일을 읽는 데 필요합니다.

다음 단계를 따라 API를 사용 설정하세요.

1. Google Cloud 콘솔의 프로젝트 선택기 열기에서 셀프 서비스 탐색 관리 페이지의 기본 연결 드롭다운 메뉴에 지정된 BigQuery 연결이 있는 프로젝트를 선택합니다.

2. Google Cloud 콘솔 탐색 메뉴에서 API 및 서비스 > 라이브러리로 이동하여 BigQuery API를 엽니다.

   BigQuery API로 이동

3. BigQuery API 페이지에서 API가 아직 사용 설정되지 않은 경우 사용 설정을 클릭합니다.

4. BigQuery API 페이지에서 Google Cloud 콘솔 프로젝트 선택기 열기를 선택하고 데이터를 업로드하는 데 사용되는 서비스 계정 (BigQuery 연결의 PDT 프로세스에 사용되는 서비스 계정)과 연결된 Google Cloud 프로젝트를 선택합니다.

5. BigQuery API 페이지에서 API가 아직 사용 설정되지 않은 경우 사용 설정을 클릭합니다.

6. Google Cloud 콘솔 탐색 메뉴에서 API 및 서비스 > 라이브러리로 이동하여 Google Sheets API를 엽니다.

   Google Sheets API로 이동

7. Google Sheets API 페이지에서 API가 아직 사용 설정되지 않은 경우 사용 설정을 클릭합니다.

8. Google Cloud 콘솔 탐색 메뉴에서 API 및 서비스 > 라이브러리로 이동하여 Google Drive API를 엽니다.

   Google Drive API로 이동하기

9. Google Drive API 페이지에서 API가 아직 사용 설정되지 않은 경우 사용 설정을 클릭합니다.

Private Service Connect 인스턴스 구성

Looker (Google Cloud 핵심 서비스) 인스턴스에서 Private Service Connect (PSC)를 사용하는 경우 Google Sheets 업로드를 지원하기 위해 추가 단계를 실행해야 합니다.

Looker가 Google Sheets API에 도달하도록 허용하려면 Private Service Connect를 사용하여 Google Sheets를 서비스로 게시한 다음 Looker (Google Cloud 핵심 서비스) 구성의 로컬 FQDN 설정에 Google Sheets를 추가해야 합니다. 로컬 FQDN을 구성할 때는 로컬 FQDN 필드에 sheets.googleapis.com를 사용하고 타겟 서비스 연결 URI 필드에 게시된 서비스의 서비스 연결 URI를 사용합니다. 자세한 내용은 로컬 FQDN을 사용하여 게시된 서비스에 연결 문서를 참고하세요.

Google Sheets 업로드용 OAuth 사용 설정

중요: Private Service Connect를 사용하는 Looker (Google Cloud 핵심 서비스) 인스턴스는 Google Sheets 업로드용 OAuth 흐름을 지원하지 않습니다. 이러한 인스턴스는 수동 URL 흐름을 사용하여 Google Sheets에서 데이터를 업로드해야 합니다.

셀프 서비스 탐색 분석을 사용 설정하고, Google Sheets 업로드를 지원하는 API를 사용 설정하고, Google Sheets 데이터 가져오기 전환 버튼을 사용 설정한 후에는 사용자가 Google Drive 탐색을 사용하여 데이터 업로드용 Google Sheets 문서를 선택할 수 있도록 설정할 수도 있습니다.

Looker 인스턴스에서 Google Drive 탐색을 사용 설정하려면 필요한 역할이 있는 IAM 사용자가 Google Cloud 콘솔에서 OAuth 클라이언트를 만든 다음 이 섹션의 절차에 설명된 대로 Looker 인스턴스의 셀프 서비스 탐색 분석 관리 페이지에 OAuth 사용자 인증 정보를 입력해야 합니다.

참고: OAuth 사용자 인증 정보를 생성하려면 먼저 사용자가 비공개 데이터에 대한 액세스 권한을 부여하는 방법을 선택할 수 있는 OAuth 동의 화면을 구성해야 합니다. 선택한 Google Cloud 콘솔 프로젝트에 대해 OAuth 동의 화면을 아직 구성하지 않은 경우 Google Cloud 콘솔에 동의 화면 구성 버튼이 포함된 알림이 표시됩니다. 버튼을 클릭하고 OAuth 동의 화면 구성 및 범위 선택 Workspace 문서 페이지의 절차를 따른 후 이 절차로 돌아옵니다.

OAuth 클라이언트를 만들고 Looker 인스턴스에 사용자 인증 정보를 입력하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Google Cloud 콘솔 프로젝트 선택기 열기를 사용하여 데이터를 업로드하는 데 사용되는 서비스 계정 (BigQuery 연결의 PDT 프로세스에 사용되는 서비스 계정)과 연결된 Google Cloud 프로젝트를 선택합니다.

   Google Cloud 콘솔로 이동

2. Google Cloud 콘솔 기본 메뉴를 사용하여 API 및 서비스 > 사용자 인증 정보로 이동합니다.

3. 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 드롭다운 메뉴를 클릭한 다음 OAuth 클라이언트 ID를 선택합니다.

4. 애플리케이션 유형 드롭다운에서 웹 애플리케이션을 선택합니다.

5. 이름 필드에 OAuth 클라이언트 이름(예: Looker upload data from Sheets)을 입력합니다.

6. 승인된 JavaScript 출처 섹션에서 URI 추가 버튼을 클릭합니다. Looker 인스턴스 URL을 입력합니다.

   https://LOOKER_INSTANCE_URL
   

7. 만들기를 클릭합니다.

8. 만들기를 클릭하면 OAuth 클라이언트가 생성됨 창이 나타납니다. 이 창에는 Google Cloud 콘솔에서 OAuth 클라이언트에 생성한 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 이 값을 복사하여 기록해 둡니다.

9. Looker 인스턴스에서 관리 패널의 일반 섹션에서 셀프 서비스 탐색을 선택합니다.

10. 셀프 서비스 탐색 분석 페이지의 클라이언트 ID 및 클라이언트 보안 비밀번호 필드에 Google Cloud 콘솔에서 OAuth 클라이언트를 만들 때 Google Cloud 콘솔에서 복사한 값을 붙여넣습니다.

11. 저장을 클릭합니다.

12. Google Sheets 데이터 가져오기 전환 버튼 옆에 있는 테스트 버튼을 클릭하여 Google Sheets 업로드 구성 외에 OAuth 구성을 테스트합니다. (데이터 업로드 전환 버튼 옆에 있는 테스트 버튼을 클릭하여 Google Sheets 구성 외에 연결을 확인할 수도 있습니다.)

이제 사용자가 클라우드에서 가져오기 옵션을 사용하여 데이터를 업로드하면 Looker에 Google Sheets 문서를 선택하기 위한 Google Drive 탐색이 표시됩니다.

Looker 인스턴스에서 데이터 업로드 보기

인스턴스에서 셀프서비스 Explore가 사용 설정된 경우 Looker 관리자는 셀프서비스 Explore 관리 페이지의 데이터 업로드 표를 사용하여 사용자가 인스턴스에 업로드한 데이터를 볼 수 있습니다.

데이터 업로드 표에는 인스턴스의 데이터 업로드에 관한 다음 정보가 표시됩니다.

• 셀프서비스 Explore의 이름입니다. 셀프서비스 Explore를 여는 하이퍼링크이기도 합니다.
• 데이터 업로드의 소유자
• 데이터가 업로드된 날짜
• Looker 관리자가 파일 업로드 및 연결된 셀프 서비스 탐색을 삭제할 수 있는 삭제 버튼

Looker 관리자는 데이터 업로드 표의 링크를 사용하여 인스턴스에서 셀프서비스 Explore를 열 수 있습니다. 하지만 Looker Explore 메뉴의 Self-service Explores 섹션에는 내가 소유한 또는 소유자가 나와 특별히 공유한 셀프 서비스 Explore만 표시됩니다. Looker 관리자의 경우 Explore 메뉴가 번거로워질 수 있으므로 인스턴스의 모든 셀프 서비스 Explore가 Explore 메뉴에 나열되지는 않습니다.

데이터 업로드 삭제

데이터 업로드 소유자는 셀프 서비스 탐색 수정 페이지에서 업로드를 삭제할 수 있습니다. 또한 Looker 관리자는 다음 단계에 따라 셀프 서비스 Explore 관리 페이지에서 데이터 업로드를 삭제할 수 있습니다.

1. Looker 관리 메뉴의 일반 섹션에서 셀프 서비스 탐색 관리 페이지를 선택합니다.
2. 데이터 업로드 표에서 삭제하려는 데이터 업로드의 삭제 버튼을 클릭합니다.
3. 확인 대화상자에서 삭제를 클릭합니다.