목록 보기 및 구독

Analytics Hub 구독자는 액세스 권한이 있는 목록을 보고 구독할 수 있습니다. 목록을 구독하면 프로젝트에 연결된 데이터 세트가 생성됩니다.

필요한 역할

목록을 사용하는 데 필요한 권한을 얻으려면 관리자에게 다음 Identity and Access Management(IAM) 역할을 부여해 달라고 요청하세요.

목록을 구독하려면 목록 게시자에게 목록, 교환 또는 프로젝트에 대한 Analytics Hub 구독자 역할(roles/analyticshub.subscriber) 중 사용 사례에 가장 적합한 범위를 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 이 문서의 작업을 수행하는 데 필요한 권한이 포함되어 있습니다. 데이터 세트를 만들고 쿼리하는 데 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼칩니다.

필수 권한

  • 새 데이터 세트 만들기: bigquery.datasets.create 또는 bigquery.datasets.*로 데이터 세트에 대한 추가 작업을 수행합니다.
  • 데이터 세트 쿼리: bigquery.jobs.create 또는 bigquery.jobs.*로 작업에 대한 추가 작업을 수행합니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

목록 탐색

공개 및 비공개 목록을 탐색하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.

    BigQuery로 이동

  2. 탐색기 창에서 데이터 추가를 클릭합니다.

  3. 데이터 추가 대화상자에서 Analytics Hub를 클릭합니다. 액세스할 수 있는 목록이 포함된 Analytics Hub 대화상자가 나타납니다. Salesforce Data Cloud 목록의 경우 탐색기 창에 관련 목록을 자동으로 필터링하는 버튼이 있습니다.

    또는 Analytics Hub 대화상자를 열려면 Analytics Hub로 이동하고 목록 검색을 클릭하세요.

  4. 이름 또는 설명으로 목록을 필터링하려면 목록 검색 필드에 목록의 이름 또는 설명을 입력합니다.

  5. 필터 섹션에서 다음 필드를 기준으로 목록을 필터링할 수 있습니다.

    • 목록: 비공개 목록, 공개 목록, 조직 내 목록을 표시할지 여부를 선택합니다.

    • 카테고리: 원하는 카테고리를 선택합니다.

    • 위치: 원하는 위치를 선택합니다. 자세한 내용은 지원되는 리전을 참조하세요.

    • 제공업체: 데이터 제공업체를 선택합니다. 일부 데이터 제공업체는 상용 데이터 세트에 대한 액세스를 요청해야 합니다. 액세스 권한을 요청한 후 데이터 제공업체는 데이터 세트를 공유하기 위해 연락합니다.

  6. 필터링된 목록을 찾아봅니다.

목록 구독

목록을 구독하면 프로젝트에 연결된 데이터 세트가 생성되어 목록의 데이터에 대한 읽기 전용 액세스 권한이 부여됩니다.

목록을 구독하려면 다음 단계를 따르세요.

콘솔

  1. 액세스 권한이 있는 목록을 보려면 목록 보기 단계를 따르세요.

  2. 목록을 찾아보고 구독하려는 목록을 클릭합니다. 목록의 세부정보가 포함된 대화상자가 나타납니다.

  3. 상용 데이터 세트를 참조하는 목록과 같이 목록을 구독할 수 있는 액세스 권한이 없으면 액세스 요청을 클릭합니다. 구독할 수 있는 데이터 세트를 클릭한 경우 프로젝트에 데이터 세트 추가를 클릭하여 연결된 데이터 세트 만들기 대화상자를 엽니다.

  4. 프로젝트에서 Analytics Hub API를 사용 설정하지 않은 경우 API를 사용 설정할 수 있는 링크와 함께 오류 메시지가 표시됩니다. Analytics Hub API 사용 설정을 클릭합니다.

  5. 연결된 데이터 세트 만들기 대화상자에서 다음 세부정보를 지정합니다.

    • 프로젝트: 데이터 세트를 추가할 프로젝트의 이름을 지정합니다.
    • 연결된 데이터 세트 이름: 연결된 데이터 세트의 이름을 지정합니다.

  6. 변경사항을 저장하려면 저장을 클릭합니다. 연결된 데이터 세트가 프로젝트에 나열됩니다.

API

projects.locations.dataExchanges.listings.subscribe 메서드를 사용합니다.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

다음을 바꿉니다.

  • PROJECT_ID: 구독하려는 목록의 프로젝트 ID입니다.
  • LOCATION: 구독하려는 목록의 위치입니다.
  • DATAEXCHANGE_ID: 구독하려는 목록의 데이터 교환 ID입니다.
  • LISTING_ID: 구독하려는 목록 ID입니다.

요청 본문에서 연결된 데이터 세트를 만들 데이터 세트를 지정합니다. 성공한 경우 응답 본문은 비어 있습니다.

연결된 데이터 세트 보기

연결된 데이터 세트는 Google Cloud 콘솔에 다른 데이터 세트와 함께 표시됩니다.

프로젝트에서 연결된 데이터 세트를 보려면 다음 단계를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.

    BigQuery로 이동

  2. 탐색기 패널에서 연결된 데이터 세트가 포함된 프로젝트 이름을 클릭합니다.

또는 Data Catalog를 사용하여 연결된 데이터세트를 검색하고 확인할 수도 있습니다. Analytics Hub에 연결된 모든 데이터 세트를 일치시키려면 type=dataset.linked 조건자를 사용합니다. 자세한 내용은 Data Catalog 검색 구문을 참조하세요.

Cloud Shell

다음 명령어를 실행합니다.

PROJECT=<your project ID> \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

연결된 데이터 세트 쿼리

다른 BigQuery 테이블을 쿼리할 때와 같은 방식으로 연결된 데이터 세트의 테이블과 뷰를 쿼리할 수 있습니다.

연결된 데이터 세트 업데이트

연결된 데이터 세트의 리소스는 읽기 전용입니다. 연결된 데이터 세트에 있는 리소스의 데이터 또는 메타데이터를 수정하거나 개별 리소스에 대한 권한을 지정할 수 없습니다.

연결된 데이터 세트의 설명과 라벨만 업데이트할 수 있습니다. 연결된 데이터 세트의 변경사항은 소스 또는 공유 데이터 세트에 영향을 주지 않습니다.

연결된 데이터 세트의 설명과 라벨을 업데이트하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.

    BigQuery로 이동

  2. 탐색기 패널에서 프로젝트 이름을 클릭한 다음 연결된 데이터 세트를 클릭합니다.

  3. 작업 옵션을 펼치고 열기를 클릭합니다.

  4. 세부정보 패널에서 세부정보 수정을 클릭한 후 다음 세부정보를 지정합니다.

    1. 라벨을 추가하려면 데이터 세트에 라벨 추가를 참조하세요.

    2. 콜레이션을 사용 설정하려면 고급 옵션 섹션을 펼치고 다음 단계를 수행합니다.

      1. 기본 콜레이션 사용 설정을 선택합니다.
      2. 기본 콜레이션 목록에서 옵션을 선택합니다.

  5. 저장을 클릭합니다.

테이블 메타데이터 보기

기본 테이블 메타데이터를 보려면 INFORMATION_SCHEMA.TABLES 뷰를 쿼리합니다.

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

LINKED-DATASET를 연결된 데이터 세트의 이름으로 바꿉니다.

연결된 데이터 세트 삭제

Analytics Hub 게시자가 구독을 제거하면 연결된 데이터 세트가 공유 데이터 세트에서 연결 해제됩니다. 연결 해제된 데이터 세트는 쿼리할 수 없으므로 연결 해제된 데이터 세트를 삭제할 수 있습니다.

연결된 데이터 세트를 삭제해도 소스 데이터 세트는 삭제되지 않습니다. 삭제한 연결된 데이터 세트는 검색할 수 없습니다. 하지만 다시 목록을 구독하고 프로젝트에 데이터 세트를 추가하여 다시 만들 수 있습니다.

연결된 데이터 세트를 삭제하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.

    BigQuery로 이동

  2. 탐색기 패널에서 프로젝트 이름을 클릭한 다음 연결된 데이터 세트를 클릭합니다.

  3. 작업 옵션을 펼치고 삭제를 클릭합니다.

  4. 연결된 데이터 세트를 삭제하시겠습니까? 대화상자에서 delete를 입력하여 삭제를 확인합니다.

  5. Delete(삭제)를 클릭합니다.

다음 단계