Gerenciar assinaturas

É possível gerenciar suas assinaturas no BigQuery Sharing (antigo Analytics Hub) para controlar o acesso e o compartilhamento de dados. Como assinante, você pode se inscrever em listagens, ver suas assinaturas e excluí-las. Como editor, você pode monitorar quem tem acesso às suas listagens e revogar assinaturas conforme necessário. Uma assinatura de BigQuery Sharing é um recurso regionalizado que reside no projeto do assinante. As assinaturas armazenam informações sobre o assinante e representam o contrato entre o publisher e o assinante.

Antes de começar

Para começar a usar o BigQuery Sharing (antigo Analytics Hub), é necessário ativar a API Analytics Hub no projeto do 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 para seu projeto do Google Cloud .

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 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 papéis personalizados ou outros papéis predefinidos.

Limitações

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

  • Só é possível usar a API Analytics Hub 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.

Gerenciar assinaturas como assinante

As seções a seguir descrevem como os assinantes do compartilhamento do BigQuery gerenciam 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 em um projeto, chame o método projects.locations.subscriptions.list:

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

Substitua:

  • PROJECT_ID: o ID do projeto do Google Cloud projeto que contém as assinaturas que você quer listar.
  • LOCATION: o local das assinaturas que você quer listar. Para mais informações sobre locais que aceitam o compartilhamento, consulte Regiões compatíveis.

Atualizar uma assinatura

Uma troca de dados ou data clean room pode ficar desatualizada quando um editor ou colaborador de dados adiciona ou remove dados. Quando isso acontece, o conjunto de dados vinculado não é atualizado automaticamente, e você precisa atualizar sua assinatura para acessar os novos recursos.

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

Console

  1. No console do Google Cloud , acesse a página BigQuery.

    Acessar o BigQuery

  2. No painel Explorer, clique em Adicionar dados.

  3. Selecione Compartilhamento (Analytics Hub). Uma página de descoberta é aberta.

  4. Encontre e clique na data clean room ou na troca de dados em que você se inscreveu.

  5. Clique em Assinar. Como você já tem uma assinatura ativa, o console apresenta uma opção Atualizar.

  6. Clique em Atualizar para atualizar o conjunto de dados vinculado com os recursos mais recentes.

API

Para atualizar uma assinatura, use o método projects.locations.subscriptions.refresh:

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

Substitua:

  • PROJECT_ID: o ID do projeto da assinatura que você quer atualizar.
  • LOCATION: o local da assinatura que você quer atualizar.
  • SUBSCRIPTION_ID: o ID da assinatura que você quer atualizar.

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.

Excluir uma inscrição

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

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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud do projeto que contém a assinatura que você quer excluir.
  • LOCATION: o local da assinatura que você quer excluir.
  • SUBSCRIPTION_ID: o ID da assinatura que você quer excluir.

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 você exclui uma assinatura, o conjunto de dados vinculado também é excluído do seu projeto.

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

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

Gerenciar assinaturas como editor

As seções a seguir descrevem como os editores de compartilhamento do BigQuery gerenciam 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 do Google Cloud , acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (Analytics Hub)

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

  2. Na lista de trocas de dados, clique no nome da troca de dados que contém as assinaturas que você quer listar.

  3. Clique na guia Assinaturas.

API

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

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

Substitua:

  • PROJECT_ID: o ID do projeto do Google Cloud projeto que contém a troca de dados.
  • LOCATION: o local da troca de dados que contém as assinaturas que você quer listar.
  • DATAEXCHANGE_ID: o ID da troca de dados em que as assinaturas serão listadas.

Revogar uma assinatura

Quando você revoga uma assinatura como editor de BigQuery Sharing, o assinante não pode mais consultar o conjunto de dados vinculado. Como você inicia essa ação 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.

Quando você revoga uma assinatura de uma listagem multirregional, os assinantes não podem 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 do Google Cloud , acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (Analytics Hub)

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

  2. Na lista de trocas de dados, clique no nome da troca de dados que contém a assinatura que você quer revogar.

  3. Clique na guia Assinaturas.

  4. Marque a caixa de seleção ao lado de cada assinatura que você quer revogar.

  5. Clique em Revogar assinaturas.

API

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

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

Substitua:

  • PROJECT_ID: o ID do projeto do Google Cloud projeto que contém a assinatura que você quer revogar.
  • LOCATION: o local da assinatura que você quer revogar.
  • SUBSCRIPTION_ID: o ID da assinatura que você quer revogar.

A seguir