Gerenciar assinaturas

É possível gerenciar suas assinaturas no BigQuery Sharing (antigo Analytics Hub) para controlar o acesso aos dados e o compartilhamento. Como assinante, você pode se inscrever em listagens, ver suas assinaturas e excluí-las. Como editor, você pode monitorar quem tem acesso às suas páginas de detalhes 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), ative a API Analytics Hub no seu 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.

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 assinaturas.

Assinar listagens

Para assinar listagens, 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 Google Cloud 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 compartilhamento, consulte Regiões compatíveis.

Atualizar uma assinatura

Uma troca de dados ou data clean room pode ficar obsoleta 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 a que você está inscrito.

  5. Clique em Assinar. Como você já tem uma assinatura ativa, o console apresenta a 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 Google Cloud ID 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ários e secundários 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 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 que você pode acessar.

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

  3. Clique na guia Assinaturas.

API

Para listar assinaturas de fichas 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 Google Cloud 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 para listar as assinaturas.

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 dele. 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 Google Cloud , acesse a página Compartilhamento (Analytics Hub).

    Acessar 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 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 Google Cloud 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