구독 관리

BigQuery Sharing (이전 명칭: Analytics Hub)에서 구독을 관리하여 데이터 액세스 및 공유를 제어할 수 있습니다. 구독자는 목록을 구독하고, 구독을 확인하고, 구독을 삭제할 수 있습니다. 게시자는 내 등록정보에 액세스할 수 있는 사용자를 모니터링하고 필요에 따라 구독을 취소할 수 있습니다. BigQuery Sharing 구독은 구독자 프로젝트에 있는 리전화된 리소스입니다. 구독에는 구독자에 대한 정보를 저장하고 게시자와 구독자 간의 계약을 나타냅니다.

시작하기 전에

BigQuery Sharing(이전 명칭: Analytics Hub)을 시작하려면 Google Cloud 프로젝트 내에서 Analytics Hub API를 사용 설정해야 합니다.

Analytics Hub API를 사용 설정하려면 다음 Identity and Access Management(IAM) 권한이 필요합니다.

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

다음과 같은 사전 정의된 IAM 역할에는 Analytics Hub API를 사용 설정하는 데 필요한 권한이 포함되어 있습니다.

Analytics Hub API를 사용 설정하려면 다음 옵션 중 하나를 선택합니다.

콘솔

Analytics Hub API 페이지로 이동하여 Google Cloud 프로젝트에 Analytics Hub API를 사용 설정합니다.

Analytics Hub API 사용 설정

gcloud

gcloud services enable 명령어를 실행합니다.

gcloud services enable analyticshub.googleapis.com

필요한 역할

구독을 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 분석 허브 구독 소유자 (roles/analyticshub.subscriptionOwner) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

제한사항

구독에는 다음과 같은 제한사항이 있습니다.

  • Analytics Hub API는 2023년 7월 25일 이후에 생성된 구독을 관리하는 데만 사용할 수 있습니다. 이 날짜 이전에 생성된 연결된 데이터 세트는 필수 구독 리소스가 없으므로 지원되지 않습니다.

구독자로 구독 관리하기

다음 섹션에서는 BigQuery Sharing 구독자가 구독을 관리하는 방법을 설명합니다.

목록 구독

목록을 구독하려면 등록정보 및 데이터 교환 보기 및 구독의 단계를 따르세요.

구독 나열

프로젝트의 구독을 나열하려면 projects.locations.subscriptions.list 메서드를 호출합니다.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions

다음을 바꿉니다.

  • PROJECT_ID: 나열하려는 구독이 포함된 프로젝트의 Google Cloud 프로젝트 ID입니다.
  • LOCATION: 나열할 구독의 위치입니다. 공유를 지원하는 위치에 대한 자세한 내용은 지원되는 지역을 참고하세요.

구독 새로고침

게시자 또는 데이터 참여자가 데이터를 추가하거나 삭제하면 데이터 교환 또는 데이터 클린룸이 오래될 수 있습니다. 이 경우 기존에 연결된 데이터 세트가 자동으로 업데이트되지 않으며 새 리소스에 액세스하려면 구독을 새로고침해야 합니다.

구독을 새로고침하려면 다음 옵션 중 하나를 선택합니다.

콘솔

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

    BigQuery로 이동

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

  3. Sharing(Analytics Hub)을 선택합니다. 탐색 페이지가 열립니다.

  4. 구독 중인 데이터 클린룸 또는 데이터 교환을 찾아 클릭합니다.

  5. 구독을 클릭합니다. 이미 활성 상태인 구독이 있으므로 콘솔에 새로고침 옵션이 표시됩니다.

  6. 새로고침을 클릭하여 연결된 데이터 세트를 최신 리소스로 업데이트합니다.

API

구독을 새로고침하려면 projects.locations.subscriptions.refresh 메서드를 사용합니다.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:refresh

다음을 바꿉니다.

  • PROJECT_ID: 갱신하려는 정기 결제의 프로젝트 ID입니다.
  • LOCATION: 갱신하려는 구독의 위치
  • SUBSCRIPTION_ID: 갱신하려는 정기 결제의 ID입니다.

요청 본문은 비어 있어야 합니다. 성공하면 응답 본문에 작업 인스턴스가 포함됩니다.

구독 삭제

구독을 삭제하려면 projects.locations.subscriptions.delete 메서드를 호출합니다.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID

다음을 바꿉니다.

  • PROJECT_ID: 삭제하려는 구독이 포함된 프로젝트의 Google Cloud 프로젝트 ID입니다.
  • LOCATION: 삭제하려는 구독의 위치입니다.
  • SUBSCRIPTION_ID: 삭제하려는 구독의 ID입니다.

요청 본문은 비어 있어야 합니다. 성공하면 응답 본문에 작업 인스턴스가 포함됩니다.

구독을 삭제하면 연결된 데이터 세트도 프로젝트에서 삭제됩니다.

다중 지역 등록정보에서 구독을 삭제하면 연결된 모든 기본 및 보조 데이터 세트 복제본도 프로젝트에서 삭제됩니다.

Analytics Hub API를 사용하여 구독을 관리하는 방법에 대한 자세한 내용은 projects.locations.subscriptions 메서드를 참고하세요.

게시자로 구독 관리

다음 섹션에서는 BigQuery Sharing 게시자가 구독을 관리하는 방법을 설명합니다. 목록 구독 관리에 대한 자세한 내용은 목록 관리를 참고하세요.

구독 나열

모든 구독을 나열하려면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 Sharing(Analytics Hub) 페이지로 이동합니다.

    Sharing(Analytics Hub)으로 이동

    액세스할 수 있는 모든 데이터 교환이 페이지에 나열됩니다.

  2. 데이터 교환 목록에서 나열하려는 구독이 포함된 데이터 교환의 이름을 클릭합니다.

  3. 구독 탭을 클릭합니다.

API

특정 데이터 교환의 등록정보 구독을 나열하려면 projects.locations.dataExchanges.listSubscriptions 메서드를 호출합니다.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

다음을 바꿉니다.

  • PROJECT_ID: 데이터 교환이 포함된 프로젝트의 Google Cloud 프로젝트 ID입니다.
  • LOCATION: 나열하려는 구독이 포함된 데이터 교환의 위치
  • DATAEXCHANGE_ID: 구독을 나열할 데이터 교환의 ID입니다.

정기 결제 취소

BigQuery Sharing 게시자가 구독을 취소하면 구독자가 더 이상 연결된 데이터 세트를 쿼리할 수 없습니다. 구독자가 소유한 리소스에 대해 이 작업을 시작하므로 연결된 데이터 세트는 구독자 프로젝트에 남아 있습니다. 구독자는 데이터 세트를 삭제하여 데이터 세트를 삭제할 수 있습니다.

멀티 리전 등록정보에서 구독을 취소하면 구독자가 더 이상 기본 또는 보조 연결된 데이터 세트 복제본을 쿼리할 수 없습니다.

구독을 취소하려면 다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 Sharing(Analytics Hub) 페이지로 이동합니다.

    Sharing(Analytics Hub)으로 이동

    액세스할 수 있는 모든 데이터 교환이 페이지에 나열됩니다.

  2. 데이터 교환 목록에서 취소하려는 구독이 포함된 데이터 교환의 이름을 클릭합니다.

  3. 구독 탭을 클릭합니다.

  4. 취소하려는 각 구독 옆의 체크박스를 선택합니다.

  5. 구독 취소를 클릭합니다.

API

구독을 취소하려면 projects.locations.subscriptions.revoke 메서드를 호출합니다.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

다음을 바꿉니다.

  • PROJECT_ID: 취소하려는 구독이 포함된 프로젝트의 Google Cloud 프로젝트 ID
  • LOCATION: 취소하려는 구독의 위치
  • SUBSCRIPTION_ID: 취소하려는 구독의 ID

다음 단계