Gerenciar assinaturas

Como assinante do Analytics Hub, você pode realizar as seguintes tarefas:

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

Como editor do Analytics Hub, você pode realizar as seguintes tarefas:

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

Uma assinatura é 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 .

Permissões necessárias

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:

  • roles/serviceusage.serviceUsageAdmin

Para mais informações sobre os papéis do IAM no BigQuery, consulte Papéis e permissões predefinidos.

Ativar a API Analytics Hub

Para ativar a API Analytics Hub, faça o seguinte:

Console

Acesse a página da API Analytics Hub e ative-a para seu projeto 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 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.

Fluxo de trabalho dos assinantes

Os assinantes podem realizar as ações a seguir com as assinaturas.

Assinar listagens

Para fazer isso, siga as etapas em Assinar listagens.

Listar assinaturas

Para conferir 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 que contém as assinaturas que você quer listar.

  • LOCATION: o local em que você quer listar as assinaturas atuais.

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 que contém a assinatura que você quer excluir.
  • LOCATION: o local da assinatura que você quer excluir. Para mais informações sobre os locais que oferecem suporte ao compartilhamento do BigQuery, consulte Regiões com suporte.
  • 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 da operação.

Quando iniciada por um assinante, a exclusão de uma assinatura remove o conjunto de dados vinculado do projeto dele.

Ao excluir uma assinatura de uma listagem para várias regiões (prévia), todas as réplicas de conjuntos de dados vinculados principais e secundários também são excluídas do projeto do assinante.

Para mais informações sobre as tarefas que podem ser realizadas em assinaturas usando a API, consulte os métodos projects.locations.subscriptions.

Fluxo de trabalho do editor

Os editores podem realizar as ações a seguir 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)

    Uma página vai aparecer com todas as trocas de dados que você pode acessar.

  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 em 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 do Data Exchange em que você quer listar as assinaturas que quer remover.
  • LOCATION: o local da troca de dados em que você quer listar as assinaturas.
  • DATAEXCHANGE_ID: o ID do Data Exchange em que você quer listar as assinaturas.

Revogar uma assinatura

Quando um editor revoga uma assinatura, o assinante perde a capacidade de consultar o conjunto de dados vinculado. Como essa é uma ação iniciada pelo editor em um recurso de propriedade do assinante, o conjunto de dados vinculado permanece pendente 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 para várias regiões (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)

    Será exibida uma página que lista todas as trocas de dados que é possível acessar.

  2. Clique no nome da troca de dados na qual você quer criar a listagem.

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

  4. Marque a caixa de seleção ao lado das assinaturas que você quer revogar ou selecione todas.

  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 que você quer revogar.
  • LOCATION: o local da assinatura.
  • SUBSCRIPTION_ID: o ID da assinatura que você quer revogar.

Limitações

As assinaturas estão sujeitas às seguintes limitações:

  • Os conjuntos de dados vinculados criados antes de 25 de julho de 2023 não são preenchidos. Apenas assinaturas criadas após 25 de julho de 2023 vão funcionar com os métodos da API.

A seguir