Veja e subscreva fichas

Enquanto subscritor do Analytics Hub, pode ver e subscrever fichas para as quais tem acesso. A subscrição de uma ficha cria um conjunto de dados associado no seu projeto.

Funções necessárias

Para receber as autorizações necessárias para usar fichas, peça ao administrador para lhe conceder as seguintes funções de gestão de identidades e acessos (IAM) no projeto de subscrição:

Para mais informações sobre a concessão de funções, consulte o artigo Gerir acesso.

Estas funções predefinidas contêm as autorizações necessárias para realizar as tarefas descritas neste documento. Para ver as autorizações exatas necessárias para criar e consultar conjuntos de dados, expanda a secção Autorizações necessárias:

Autorizações necessárias

  • Criar novos conjuntos de dados: bigquery.datasets.create ou bigquery.datasets.* para realizar ações adicionais em conjuntos de dados.
  • Consultar conjuntos de dados: bigquery.jobs.create ou bigquery.jobs.* para realizar ações adicionais em tarefas.

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Descubra fichas

Para descobrir fichas públicas e privadas, siga estes passos:

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

    Aceda à partilha (Analytics Hub)

  2. Clique em Pesquisar fichas. É apresentada uma caixa de diálogo com fichas que pode aceder.

  3. Para filtrar fichas pelo respetivo nome ou descrição, introduza o nome ou a descrição da ficha no campo Pesquisar fichas.

  4. Na secção Filtros, pode filtrar fichas com base nos seguintes campos:

    • Fichas: selecione se quer ver fichas privadas, fichas públicas ou fichas na sua organização.

    • Categorias: selecione uma ou mais categorias.

    • Localização: selecione uma localização. Só pode pesquisar por localização de troca de dados. Para mais informações, consulte o artigo Regiões suportadas.

    • Fornecedor: selecione o fornecedor de dados. Alguns fornecedores de dados requerem que peça acesso aos respetivos conjuntos de dados comerciais. Depois de pedir acesso, o fornecedor de dados entra em contacto consigo para partilhar os respetivos conjuntos de dados.

  5. Navegue pelas fichas filtradas.

Subscreva fichas

A subscrição de uma ficha dá-lhe acesso só de leitura aos dados na ficha através da criação de um conjunto de dados associado no seu projeto.

Para subscrever uma ficha, siga estes passos:

Consola

  1. Para ver uma lista das fichas às quais tem acesso, siga os passos descritos no artigo Descubra fichas.

  2. Procure as fichas e clique numa ficha à qual quer subscrever. É apresentada uma caixa de diálogo com os detalhes da ficha. Na secção Detalhes adicionais, pode ver em que regiões o fornecedor disponibilizou a ficha.

  3. Se não tiver acesso para subscrever uma ficha, como uma ficha que faça referência a um conjunto de dados comerciais, clique em Pedir acesso ou Comprar através do Marketplace. Se clicar num conjunto de dados ao qual se pode subscrever, clique em Subscrever para abrir a caixa de diálogo Criar conjunto de dados associado.

  4. Se não tiver a API Analytics Hub ativada no seu projeto, é apresentada uma mensagem de erro com um link para ativar a API. Clique em Ativar API Analytics Hub.

  5. Na caixa de diálogo Criar conjunto de dados associado, especifique os seguintes detalhes:

    • Projeto: especifique o nome do projeto no qual quer adicionar o conjunto de dados.
    • Nome do conjunto de dados associado: especifique o nome do conjunto de dados associado.

    • Região principal: selecione a região onde quer criar o conjunto de dados associado.

    • Opcional: Regiões de réplica (Pré-visualização): selecione a região ou regiões onde quer criar réplicas secundárias adicionais do conjunto de dados associado. Pode optar por colocar o conjunto de dados associado na mesma região que os outros dados para minimizar a saída e facilitar as junções entre conjuntos de dados. Para criar réplicas de conjuntos de dados associados, tem de ter a autorização bigquery.datasets.update.

  6. Para guardar as alterações, clique em Guardar. O conjunto de dados associado é apresentado no seu projeto.

API

Use o método projects.locations.dataExchanges.listings.subscribe.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto da ficha à qual quer subscrever.
  • LOCATION: a localização da sua ficha à qual quer subscrever.
  • DATAEXCHANGE_ID: o ID da troca de dados da ficha que quer subscrever.
  • LISTING_ID: o ID da ficha que quer subscrever.

No corpo do pedido, especifique o conjunto de dados onde quer criar o conjunto de dados associado.

Para criar uma subscrição com réplicas de conjuntos de dados associados disponíveis em várias regiões (pré-visualização), especifique a região principal do conjunto de dados associado através do campo location no corpo do pedido. Para as regiões secundárias onde quer criar réplicas de conjuntos de dados associados, pode usar opcionalmente o campo destinationDataset.replica_locations no corpo do pedido e listar todas as regiões de réplicas secundárias pretendidas. Certifique-se de que as regiões especificadas na propriedade location e no campo destinationDataset.replica_locations são regiões onde a ficha associada está disponível.

Se o pedido for bem-sucedido, o corpo da resposta contém o objeto de subscrição. Se ativou o registo de emails de subscritores (Pré-visualização) para a troca de dados ou a ficha, a resposta de subscrição contém log_linked_dataset_query_user_email: true.

Veja conjuntos de dados associados

Os conjuntos de dados associados são apresentados juntamente com outros conjuntos de dados na consolaGoogle Cloud .

Para ver os conjuntos de dados associados no seu projeto, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel Explorador, clique no nome do projeto que contém o conjunto de dados associado.

Em alternativa, também pode usar o Data Catalog (descontinuado) ou o Dataplex Universal Catalog para pesquisar e ver conjuntos de dados associados. Para fazer corresponder todos os conjuntos de dados associados partilhados do BigQuery, use o predicado type=dataset.linked. Para mais informações, consulte a sintaxe de pesquisa do Data Catalog ou a sintaxe de pesquisa do catálogo universal do Dataplex.

Cloud Shell

Execute o seguinte comando:

PROJECT=<your project ID> \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

Consulte conjuntos de dados associados

Pode consultar tabelas e vistas nos seus conjuntos de dados associados da mesma forma que consultaria qualquer outra tabela do BigQuery.

Atualize conjuntos de dados associados

Os recursos num conjunto de dados associado são só de leitura. Não pode editar os dados nem os metadados dos recursos em conjuntos de dados associados, nem especificar autorizações para recursos individuais.

Só pode atualizar a descrição e as etiquetas dos conjuntos de dados associados. As alterações a um conjunto de dados associado não afetam os conjuntos de dados de origem nem os conjuntos de dados partilhados.

Para atualizar a descrição e as etiquetas de um conjunto de dados associado, siga estes passos:

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel Explorador, clique no nome do projeto e, de seguida, clique no conjunto de dados associado.

  3. Expanda a opção Ações e clique em Abrir.

  4. No painel Detalhes, clique em Editar detalhes e, de seguida, especifique os seguintes detalhes:

    1. Para adicionar etiquetas, consulte o artigo Adicionar uma etiqueta a um conjunto de dados.

    2. Para ativar a intercalação, expanda a secção Opções avançadas e siga estes passos:

      1. Selecione Ativar ordenação predefinida.
      2. Na lista Ordenação predefinida, selecione uma opção.

  5. Clique em Guardar.

Veja os metadados da tabela

Para ver os metadados da tabela subjacente, consulte a vista INFORMATION_SCHEMA.TABLES:

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

Substitua LINKED-DATASET pelo nome do conjunto de dados associado.

Anule a subscrição ou elimine conjuntos de dados associados

Para anular a subscrição de um conjunto de dados, tem de eliminar o conjunto de dados associado. A eliminação de um conjunto de dados associado não elimina o conjunto de dados de origem.

Não pode recuperar um conjunto de dados associado depois de o eliminar. No entanto, pode recriar o conjunto de dados associado eliminado subscrevendo novamente a ficha e adicionando o conjunto de dados e os conjuntos de dados associados criados a partir de fichas integradas no Google Cloud Marketplace ao seu projeto.

Se a sua subscrição for removida por um publicador do Analytics Hub, o seu conjunto de dados associado é desassociado do conjunto de dados partilhado. 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 remover o conjunto de dados pendente eliminando-o.

Para eliminar um conjunto de dados associado, faça o seguinte:

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel Explorador, clique no nome do projeto e, de seguida, clique no conjunto de dados associado.

  3. Expanda a opção Ações e clique em Eliminar.

  4. Na caixa de diálogo Eliminar conjunto de dados associado?, confirme a eliminação escrevendo eliminar.

  5. Clique em Eliminar.

O que se segue?