Gerir subscrições

Como subscritor do Analytics Hub, pode realizar as seguintes tarefas:

  • Subscreva uma ficha.
  • Apresentar uma lista das suas subscrições atuais num determinado projeto.
  • Elimine uma subscrição.

Enquanto publicador do Analytics Hub, pode realizar as seguintes tarefas:

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

Uma subscrição é 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.

Autorizações necessárias

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:

  • roles/serviceusage.serviceUsageAdmin

Para mais informações sobre as funções de IAM no BigQuery, consulte o artigo Funções e autorizações predefinidas.

Ative a API Analytics Hub

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

Consola

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

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.

Fluxo de trabalho de subscritores

Os subscritores podem realizar as seguintes ações com as subscrições.

Subscreva fichas

Para subscrever fichas, siga os passos em Subscreva fichas.

Liste as subscrições

Para ver 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 que contém as subscrições que quer listar.

  • LOCATION: a localização para a qual quer apresentar as subscrições existentes.

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 que contém a subscrição que quer eliminar.
  • LOCATION: a localização da subscrição que quer eliminar. Para mais informações sobre as localizações que suportam a partilha do BigQuery, consulte o artigo Regiões suportadas.
  • SUBSCRIPTION_ID: o ID da subscrição que quer eliminar.

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

Quando iniciada por um subscritor, a eliminação de uma subscrição elimina o conjunto de dados associado do projeto do subscritor.

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

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

Fluxo de trabalho do publicador

Os publicadores podem realizar as seguintes ações com 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)

    É apresentada uma página que lista todas as trocas de dados a que pode aceder.

  2. Clique no nome da troca de dados na qual 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 Data Exchange, 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 Data Exchange para o qual quer listar as subscrições que quer remover.
  • LOCATION: a localização da Data Exchange para a qual quer listar as subscrições.
  • DATAEXCHANGE_ID: o ID da Data Exchange para a qual quer listar as subscrições.

Revogue uma subscrição

Quando um publicador revoga uma subscrição, o subscritor perde a capacidade de consultar o conjunto de dados associado. Uma vez que se trata de uma ação iniciada pelo publicador num recurso pertencente ao subscritor, o conjunto de dados associado permanece pendente no projeto do subscritor. O subscritor pode optar por remover o conjunto de dados pendente eliminando-o.

Se um publicador revogar uma subscrição de uma ficha para várias regiões (pré-visualização), os subscritores deixam de poder 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)

    É apresentada uma página com todas as trocas de dados às quais pode aceder.

  2. Clique no nome da troca de dados na qual quer criar a ficha.

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

  4. Selecione a caixa de verificação junto às subscrições que quer revogar ou selecione todas as subscrições.

  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 que quer revogar.
  • LOCATION: a localização da subscrição.
  • SUBSCRIPTION_ID: o ID da subscrição que quer revogar.

Limitações

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

  • Os conjuntos de dados associados criados antes de 25 de julho de 2023 não são preenchidos retroativamente. Apenas as subscrições criadas após 25 de julho de 2023 funcionam com os métodos da API.

O que se segue?