Gerir subscrições

Este documento descreve como gerir as suas subscrições de partilha do BigQuery, abordando tarefas para subscritores e publicadores.

Enquanto subscritor da partilha do BigQuery, pode fazer o seguinte:

  • Subscreva uma ficha.
  • Liste as suas subscrições atuais num determinado Google Cloud projeto.
  • Elimine uma subscrição.

Enquanto publicador de partilha do BigQuery, pode fazer o seguinte:

  • Veja todas as subscrições da sua ficha.
  • Revogar o acesso a uma subscrição específica.

Uma subscrição de partilha do BigQuery é um recurso regionalizado que reside no projeto do subscritor. As subscrições armazenam informações relevantes sobre o subscritor e representam o contrato entre o publicador e o subscritor.

Antes de começar

Para começar a usar a partilha do BigQuery (anteriormente Analytics Hub), tem de ativar a API Analytics Hub no seu Google Cloud projeto.

Para ativar a API Analytics Hub, precisa das seguintes autorizações de gestão de identidades e acessos (IAM):

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

A seguinte função de IAM predefinida inclui as autorizações necessárias para ativar a API Analytics Hub:

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

Consola

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

Ative a API Analytics Hub

gcloud

Execute o comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Funções necessárias

Para receber as autorizações de que precisa para gerir subscrições, peça ao seu administrador para lhe conceder a função de proprietário da subscrição do Analytics Hub (roles/analyticshub.subscriptionOwner) do IAM no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Fluxos de trabalho dos subscritores para gerir subscrições

As secções seguintes descrevem o que os subscritores da partilha do BigQuery podem fazer com as subscrições.

Subscreva fichas

Para subscrever fichas, siga os passos em Veja e subscreva fichas e trocas de dados.

Liste as subscrições

Para listar as suas subscrições atuais num determinado projeto, use o método projects.locations.subscriptions.list:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto para as subscrições que quer listar. Google Cloud
  • LOCATION: a localização das subscrições que quer apresentar.

Elimine uma subscrição

Para eliminar uma subscrição, use o método projects.locations.subscriptions.delete:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto da subscrição a eliminar.
  • LOCATION: a localização da subscrição a eliminar. Para mais informações sobre as localizações que suportam a partilha, consulte o artigo Regiões suportadas.
  • SUBSCRIPTION_ID: o ID da subscrição a eliminar.

O corpo do pedido tem de estar vazio. Se for bem-sucedido, o corpo da resposta contém uma instância de operação.

Quando um subscritor da partilha do BigQuery elimina uma subscrição, também elimina o conjunto de dados associado do projeto do subscritor.

Quando elimina uma subscrição de uma ficha de várias regiões (pré-visualização), todas as réplicas do conjunto de dados principal e secundário associadas também são eliminadas do projeto do subscritor.

Para mais informações sobre as tarefas que pode realizar com subscrições através da API, consulte os métodos projects.locations.subscriptions.

Fluxos de trabalho do publicador para gerir subscrições

As secções seguintes descrevem o que os publicadores de partilha do BigQuery podem fazer com as subscrições. Para mais informações sobre como gerir subscrições de fichas, consulte o artigo Faça a gestão das fichas.

Liste as subscrições

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

Consola

  1. Na Google Cloud consola, aceda à página Partilha (Analytics Hub).

    Aceda à partilha (Analytics Hub)

    A página apresenta todas as trocas de dados a que pode aceder.

  2. Clique no nome da troca de dados onde quer listar as subscrições.

  3. Clique no separador Subscrições para ver todas as subscrições de fichas na troca de dados.

API

Para listar as subscrições de fichas numa determinada troca de dados, use o método projects.locations.dataExchanges.listSubscriptions.

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto da troca de dados para o qual listar as subscrições.
  • LOCATION: a localização da troca de dados para a qual listar subscrições.
  • DATAEXCHANGE_ID: o ID da troca de dados para a qual listar subscrições.

Revogue uma subscrição

Quando um publicador de partilha do BigQuery revoga uma subscrição, o subscritor deixa de poder consultar o conjunto de dados associado. Uma vez que esta ação é iniciada pelo publicador num recurso pertencente ao subscritor, o conjunto de dados associado permanece no projeto do subscritor. O subscritor pode remover o conjunto de dados eliminando-o.

Se uma editora revogar uma subscrição de uma ficha multirregional (Pré-visualização), os subscritores já não podem consultar réplicas de conjuntos de dados associados primários ou secundários.

Para revogar uma subscrição, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Partilha (Analytics Hub).

    Aceda à partilha (Analytics Hub)

    A página apresenta todas as trocas de dados às quais pode aceder.

  2. Clique no nome da troca de dados onde quer revogar a ficha.

  3. Clique no separador Subscrições para ver todas as subscrições da troca de dados.

  4. Selecione as subscrições a revogar.

  5. Clique em Revogar subscrições.

API

Para revogar uma subscrição, use o método projects.locations.subscriptions.revoke.

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto da subscrição a revogar.
  • LOCATION: a localização da subscrição.
  • SUBSCRIPTION_ID: o ID da subscrição a revogar.

Limitações

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

  • Só pode usar a API para gerir subscrições criadas após 25 de julho de 2023. Os conjuntos de dados associados criados antes desta data não são suportados porque não têm o recurso de subscrição necessário.

O que se segue?