구독 관리
Analytics Hub 구독자는 다음 작업을 수행할 수 있습니다.
- 목록을 구독합니다.
- 특정 프로젝트의 현재 구독을 나열합니다.
- 구독을 삭제합니다.
Analytics Hub 게시자는 다음 작업을 수행할 수 있습니다.
- 목록에 대한 모든 구독을 봅니다.
- 특정 구독에 대한 액세스 권한을 취소합니다.
구독은 구독자 프로젝트에 있는 리전화된 리소스입니다. 구독에는 게시자에 대한 관련 정보를 저장하고 게시자와 구독자 사이의 계약을 나타냅니다.
시작하기 전에
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를 사용 설정하는 데 필요한 권한이 포함되어 있습니다.
roles/serviceusage.serviceUsageAdmin
BigQuery에서 IAM 역할에 대한 상세 설명은 사전 정의된 역할 및 권한을 참조하세요.
Analytics Hub API 사용 설정
Analytics Hub API를 사용 설정하려면 다음 단계를 따르세요.
콘솔
Analytics Hub API 페이지로 이동하여 Google Cloud 프로젝트에 Analytics Hub API를 사용 설정합니다.
gcloud
gcloud services enable 명령어를 실행합니다.
gcloud services enable analyticshub.googleapis.com
필요한 역할
구독을 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 분석 허브 구독 소유자 (roles/analyticshub.subscriptionOwner
) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
구독자 워크플로
구독자는 구독으로 다음 작업을 수행할 수 있습니다.
목록 구독
목록을 구독하려면 목록 및 데이터 교환 보기 및 구독의 단계를 따르세요.
구독 나열
지정된 프로젝트의 현재 구독을 보려면 projects.locations.subscriptions.list
메서드를 사용합니다.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions
다음을 바꿉니다.
PROJECT_ID
: 나열하려는 구독이 포함된 프로젝트 ID입니다.LOCATION
: 기존 구독을 나열하려는 위치입니다.
구독 삭제
구독을 삭제하려면 projects.locations.subscriptions.delete
메서드를 사용합니다.
DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID
다음을 바꿉니다.
PROJECT_ID
: 삭제하려는 구독이 포함된 프로젝트 ID입니다.LOCATION
: 삭제하려는 구독의 위치입니다. BigQuery 공유를 지원하는 위치에 대한 자세한 내용은 지원되는 리전을 참고하세요.SUBSCRIPTION_ID
: 삭제하려는 구독의 ID입니다.
요청 본문은 비어 있어야 합니다. 요청이 성공하면 응답 본문에 작업 인스턴스가 포함됩니다.
구독자가 시작한 경우 구독을 삭제하면 구독자 프로젝트에서 연결된 데이터 세트가 삭제됩니다.
여러 지역(미리보기)의 등록정보에서 구독을 삭제하면 연결된 모든 기본 및 보조 데이터 세트 복제본도 구독자의 프로젝트에서 삭제됩니다.
API를 사용하여 정기 결제에 수행할 수 있는 작업에 대한 자세한 내용은 projects.locations.subscriptions
메서드를 참고하세요.
게시자 워크플로
게시자는 구독으로 다음 작업을 수행할 수 있습니다. 목록 구독 관리에 대한 자세한 내용은 목록 관리를 참조하세요.
구독 나열
모든 구독을 나열하려면 다음 옵션 중 하나를 선택합니다.
콘솔
Google Cloud 콘솔에서 Sharing(Analytics Hub) 페이지로 이동합니다.
액세스할 수 있는 모든 데이터 교환이 나열된 페이지가 표시됩니다.
구독을 나열하려는 데이터 교환 이름을 클릭합니다.
데이터 교환 내에서 목록에 대한 모든 구독을 보려면 구독 탭을 클릭합니다.
API
특정 데이터 교환의 등록정보 구독을 나열하려면 projects.locations.dataExchanges.listSubscriptions
메서드를 사용합니다.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions
다음을 바꿉니다.
PROJECT_ID
: 삭제하려는 구독을 나열하려는 데이터 교환의 프로젝트 IDLOCATION
: 구독을 나열하려는 데이터 교환의 위치DATAEXCHANGE_ID
: 구독을 나열하려는 데이터 교환의 ID
정기 결제 취소
게시자가 구독을 취소하면 구독자는 연결된 데이터 세트를 쿼리할 수 없습니다. 이는 구독자가 소유한 리소스에 대한 게시자 시작 작업이므로 연결된 데이터 세트는 구독자의 프로젝트에서 연결이 끊긴 상태로 유지됩니다. 구독자는 삭제하여 매달린 데이터 세트를 삭제할 수 있습니다.
게시자가 여러 지역의 등록정보에서 구독을 취소하면(미리보기) 구독자는 더 이상 연결된 기본 또는 보조 데이터 세트 복제본을 쿼리할 수 없습니다.
구독을 취소하려면 다음 옵션 중 하나를 선택합니다.
콘솔
Google Cloud 콘솔에서 Sharing(Analytics Hub) 페이지로 이동합니다.
액세스할 수 있는 모든 데이터 교환이 나열된 페이지가 표시됩니다.
목록을 만들려는 데이터 교환 이름을 클릭합니다.
데이터 교환에 대한 모든 구독을 보려면 구독 탭을 클릭합니다.
취소하려는 구독 옆의 체크박스를 선택하거나 모든 구독을 선택합니다.
구독 취소를 클릭합니다.
API
구독을 취소하려면 projects.locations.subscriptions.revoke
메서드를 사용합니다.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke
다음을 바꿉니다.
PROJECT_ID
: 취소하려는 정기 결제의 프로젝트 IDLOCATION
: 구독의 위치SUBSCRIPTION_ID
: 취소하려는 정기 결제의 ID입니다.
제한사항
구독에는 다음과 같은 제한사항이 적용됩니다.
- 2023년 7월 25일 이전에 만든 연결된 데이터 세트는 백필되지 않습니다. 2023년 7월 25일 이후에 생성된 구독만 API 메서드가 작동합니다.
다음 단계
- BigQuery 공유 아키텍처에 대해 알아봅니다.
- 목록 및 데이터 교환을 보고 구독하는 방법 알아보기
- Analytics Hub 사용자 역할 알아보기
- 데이터 세트 만들기 알아보기
- BigQuery 공유 감사 로깅에 대해 알아봅니다.