Gerenciar assinaturas

Neste documento, descrevemos como gerenciar suas assinaturas de compartilhamento do BigQuery, abordando tarefas para assinantes e editores.

Como assinante do BigQuery Sharing, você pode fazer o seguinte:

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

Como editor de compartilhamento do BigQuery, você pode fazer o seguinte:

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

Uma assinatura de compartilhamento do BigQuery é 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), ative a API Analytics Hub no projeto Google Cloud .

Para ativar a API Analytics Hub, você precisa das seguintes permissões de gerenciamento de identidade e acesso (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 para seu Google Cloud projeto.

Ativar a API Analytics Hub

gcloud

Execute o comando gcloud services enable:

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 de Proprietário da assinatura do Hub de análise (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 papéis personalizados ou outros papéis predefinidos.

Fluxos de trabalho de inscritos para gerenciar assinaturas

As seções a seguir descrevem o que os assinantes do BigQuery Sharing podem fazer com as 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 método projects.locations.subscriptions.list:

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

Substitua:

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

Excluir uma inscrição

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

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 aceitam compartilhamento, consulte Regiões compatíveis.
  • 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 vai conter uma instância de operação.

Quando um assinante do compartilhamento do BigQuery exclui uma assinatura, o conjunto de dados vinculado também é excluído do projeto do assinante.

Quando você exclui uma assinatura de uma listagem multirregional (prévia), 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 as tarefas que podem ser feitas com assinaturas usando a API, consulte os métodos projects.locations.subscriptions.

Fluxos de trabalho do editor para gerenciar assinaturas

As seções a seguir descrevem o que os editores de compartilhamento do BigQuery podem fazer com as 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. No console Google Cloud , acesse a página Compartilhamento (Analytics Hub).

    Acessar Compartilhamento (Analytics Hub)

    A página lista todas as trocas de dados a que você tem acesso.

  2. Clique no nome da troca de dados em que você quer listar as assinaturas.

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

API

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

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 de compartilhamento do BigQuery revoga uma assinatura, o assinante não pode mais consultar o conjunto de dados vinculado. Como essa ação é iniciada pelo publisher 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 página de detalhes multirregional (Prévia), os assinantes não poderão mais consultar réplicas de conjuntos de dados vinculados primários ou secundários.

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

Console

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

    Acessar Compartilhamento (Analytics Hub)

    A página lista todas as trocas de dados a que você tem acesso.

  2. Clique no nome da troca de dados em que você quer revogar a listagem.

  3. Clique na guia Assinaturas para conferir todas as assinaturas na troca de dados.

  4. Selecione as assinaturas que você quer revogar.

  5. Clique em Revogar assinaturas.

API

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

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