Gerenciar assinaturas

Este documento descreve como gerenciar assinaturas no BigQuery Sharing (antigo Analytics Hub), abrangendo tarefas para assinantes e editores.

Os assinantes do BigQuery Sharing podem fazer o seguinte:

  • Assinar uma listagem.
  • Listar suas assinaturas atuais em um determinado Google Cloud projeto.
  • Excluir uma assinatura.

Os editores do BigQuery Sharing podem fazer o seguinte:

  • Ver todas as assinaturas da sua listagem.
  • Revogar o acesso a uma assinatura específica.

Uma assinatura do BigQuery Sharing é um recurso regionalizado que reside no projeto do assinante. As assinaturas armazenam informações relevantes sobre o assinante e representam o contrato entre o editor e o assinante.

Antes de começar

Para começar a usar o BigQuery Sharing (antigo Analytics Hub), você precisa ativar a API Analytics Hub no seu Google Cloud projeto.

Para ativar a API Analytics Hub, você precisa das seguintes permissões do Identity and Access Management (IAM):

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

O papel predefinido do IAM a seguir inclui as permissões necessárias para ativar a API Analytics Hub:

Para ativar a API Analytics Hub, selecione uma das seguintes opções:

Console

Acesse a página da API Analytics Hub e ative a API Analytics Hub para seu Google Cloud projeto.

Ativar a API Analytics Hub

gcloud

Execute o gcloud services enable comando:

gcloud services enable analyticshub.googleapis.com

Funções exigidas

Para receber as permissões necessárias para gerenciar assinaturas, peça ao administrador para conceder a você o papel do IAM Proprietário da assinatura do Analytics Hub (roles/analyticshub.subscriptionOwner) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Fluxos de trabalho de assinantes para gerenciar assinaturas

Esta seção descreve como os assinantes do BigQuery Sharing gerenciam assinaturas.

Assinar listagens

Para fazer isso, siga as etapas em Ver e assinar listagens e trocas de dados.

Listar assinaturas

Para listar suas assinaturas atuais em um determinado projeto, use o projects.locations.subscriptions.list método:

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

Substitua:

  • PROJECT_ID: o Google Cloud ID do projeto para as assinaturas que você quer listar.
  • LOCATION: o local das assinaturas que você quer listar.

Excluir uma assinatura

Para excluir uma assinatura, use o projects.locations.subscriptions.delete método:

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

Substitua:

  • PROJECT_ID: o ID do projeto da assinatura a ser excluída.
  • LOCATION: o local da assinatura a ser excluída. Para mais informações sobre locais que oferecem suporte ao compartilhamento, consulte Regiões com suporte.
  • SUBSCRIPTION_ID: o ID da assinatura a ser excluída.

O corpo da solicitação precisa estar vazio. Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de operação.

Quando um assinante do BigQuery Sharing exclui uma assinatura, ele também exclui o conjunto de dados vinculado do projeto do assinante.

Quando você exclui uma assinatura de uma listagem multirregional, todas as réplicas de conjuntos de dados vinculados primários e secundários também são excluídas do projeto do assinante.

Para mais informações sobre como gerenciar assinaturas usando a API, consulte os projects.locations.subscriptions métodos.

Fluxos de trabalho do editor para gerenciar assinaturas

Esta seção descreve como os editores do BigQuery Sharing gerenciam assinaturas. Para mais informações sobre como gerenciar assinaturas em listagens, consulte Gerenciar listagens.

Listar assinaturas

Para listar todas as assinaturas, selecione uma das seguintes opções.

Console

  1. Noconsol, acesse a página Compartilhamento (Analytics Hub). Google Cloud

    Acessar o compartilhamento (Analytics Hub)

    A página lista todas as trocas de dados que você pode acessar.

  2. Selecione o nome da troca de dados em que você quer listar as assinaturas.

  3. Selecione a guia Assinaturas para conferir todas as assinaturas de listagens na troca de dados.

API

Para listar assinaturas de listagens em uma troca de dados específica, use o projects.locations.dataExchanges.listSubscriptions método.

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

Substitua:

  • PROJECT_ID: o ID do projeto da troca de dados para listar as assinaturas.
  • LOCATION: o local da troca de dados para listar as assinaturas.
  • DATAEXCHANGE_ID: o ID da troca de dados para listar as assinaturas.

Revogar uma assinatura

Quando um editor do BigQuery Sharing revoga uma assinatura, o assinante não pode mais consultar o conjunto de dados vinculado. Como essa ação é iniciada pelo editor em um recurso de propriedade do assinante, o conjunto de dados vinculado permanece no projeto do assinante. O assinante pode remover o conjunto de dados excluindo-o.

Se um editor revogar uma assinatura de uma listagem multirregional, os assinantes não poderão mais consultar nenhuma réplica de conjunto de dados vinculado primário ou secundário.

Para revogar uma assinatura, selecione uma das seguintes opções:

Console

  1. Noconsol, acesse a página Compartilhamento (Analytics Hub). Google Cloud

    Acessar o compartilhamento (Analytics Hub)

    A página lista todas as trocas de dados que você pode acessar.

  2. Selecione o nome da troca de dados em que você quer revogar a listagem.

  3. Selecione a guia Assinaturas para conferir todas as assinaturas da troca de dados.

  4. Selecione as assinaturas a serem revogadas.

  5. Clique em Revogar assinaturas.

API

Para revogar uma assinatura, use o projects.locations.subscriptions.revoke método.

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

Substitua:

  • PROJECT_ID: o ID do projeto da assinatura a ser revogada.
  • LOCATION: o local da assinatura.
  • SUBSCRIPTION_ID: o ID da assinatura a ser revogada.

Limitações

As assinaturas têm as seguintes limitações:

  • Só é possível usar a API para gerenciar assinaturas criadas após 25 de julho de 2023. Os conjuntos de dados vinculados criados antes dessa data não são compatíveis porque não têm o recurso de assinatura necessário.

A seguir