Ver e assinar listagens

Como assinante do Analytics Hub, você pode ver e se inscrever nas listagens a que tem acesso. A inscrição em uma listagem cria um conjunto de dados vinculado no projeto.

Funções exigidas

Para ter as permissões necessárias para usar as listagens, peça ao administrador para conceder a você os seguintes papéis de gerenciamento de identidade e acesso (IAM):

Para fazer a assinatura de fichas de empresa, você também precisa pedir ao editor da ficha que conceda a você o papel de Assinante do Analytics Hub (roles/analyticshub.subscriber) na listagem, troca ou projeto dele, o que for mais apropriado para para seu caso de uso.

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esses papéis predefinidos contêm as permissões necessárias para executar as tarefas neste documento. Para acessar as permissões exatas necessárias para criar e consultar conjuntos de dados, expanda a seção Permissões necessárias:

Permissões necessárias

  • bigquery.datasets.create para criar novos conjuntos de dados ou bigquery.datasets.* para executar outras ações nos conjuntos de dados.
  • bigquery.jobs.create para consultar conjuntos de dados ou bigquery.jobs.* para executar outras ações nos jobs.

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Descobrir fichas

Para encontrar listagens públicas e privadas, siga estas etapas:

  1. No Console do Google Cloud, acesse a página BigQuery.

    Ir para o BigQuery

  2. No painel Explorer, clique em Adicionar dados.

  3. Na caixa de diálogo Adicionar dados, clique em Analytics Hub. A caixa de diálogo Analytics Hub contém listagens que você pode acessar. Para as listagens do Salesforce Data Cloud, há um botão no painel Explorer que filtra automaticamente as listagens relacionadas.

    Como alternativa, para abrir a caixa de diálogo do Analytics Hub, acesse o Analytics Hub e clique em Pesquisar listagens.

  4. Para filtrar listagens por nome ou descrição, insira o nome ou a descrição delas no campo Pesquisar listagens.

  5. Na seção Filtro, é possível filtrar listagens com base nos seguintes campos:

    • Listagens: selecione se você quer ver listagens particulares, listagens públicas ou listagensna sua organização.

    • Categorias: selecione as categorias desejadas.

    • Local: selecione o local desejado. Veja mais informações nas regiões compatíveis.

    • Provedor: selecione o provedor de dados. Alguns provedores de dados exigem que você solicite acesso aos conjuntos de dados comerciais. Depois de solicitar acesso, o provedor de dados entrará em contato com você para compartilhar os conjuntos de dados.

  6. Navegue pelas listagens filtradas.

Assinar listagens

Assinar uma listagem oferece acesso somente leitura aos dados da listagem criando um conjunto de dados vinculado no seu projeto.

Para se inscrever em uma listagem, siga estas etapas:

Console

  1. Para ver uma lista de listagens às quais você tem acesso, siga as etapas em Ver listagens.

  2. Navegue pelas listagens e clique naquela que você quer assinar. Uma caixa de diálogo com os detalhes da listagem será exibida.

  3. Se você não tiver acesso para se inscrever em uma listagem, como uma lista que faz referência a um conjunto de dados comercial, clique em Solicitar acesso. Ao clicar em um conjunto de dados em que você pode se inscrever, clique em Adicionar conjunto de dados ao projeto para abrir a caixa de diálogo Criar conjunto de dados vinculado.

  4. Se a API Analytics Hub não estiver ativada no projeto, uma mensagem de erro será exibida com um link para ativar a API. Clique em Ativar API Analytics Hub.

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

    • Projeto: especifique o nome do projeto em que você quer adicionar o conjunto de dados.
    • Nome do conjunto de dados vinculado: especifique o nome do conjunto de dados vinculado.

  6. Para salvar as alterações, clique em Save. O conjunto de dados vinculado é listado no 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:

  • PROJECT_ID: o ID do projeto da ficha da empresa em que você quer se inscrever.
  • LOCATION: o local da ficha em que você quer se inscrever.
  • DATAEXCHANGE_ID: o ID da troca de dados da ficha da empresa em que você quer se inscrever.
  • LISTING_ID: o ID da ficha da empresa em que você quer se inscrever.

No corpo da solicitação, especifique o conjunto de dados em que você quer criar o conjunto de dados vinculado. Se a solicitação for concluída, o corpo da resposta estará vazio.

Acessar conjuntos de dados vinculados

Os conjuntos de dados vinculados são exibidos com outros conjuntos de dados no console do Google Cloud.

Para acessar os conjuntos de dados vinculados ao projeto, siga estas etapas:

Console

  1. No Console do Google Cloud, acesse a página BigQuery.

    Ir para o BigQuery

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

Como alternativa, também é possível usar o Data Catalog para pesquisar e visualizar conjuntos de dados vinculados. Para corresponder a todos os conjuntos de dados vinculados do Analytics Hub, use o predicado type=dataset.linked. Para mais informações, consulte Sintaxe de pesquisa do Data Catalog.

Cloud Shell

Execute este 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

Consultar conjuntos de dados vinculados

É possível consultar tabelas e visualizações nos conjuntos de dados vinculados da mesma forma que você consultaria qualquer outra tabela do BigQuery.

Atualizar conjuntos de dados vinculados

Os recursos em um conjunto de dados vinculado são somente leitura. Não é possível editar os dados ou metadados de recursos em conjuntos de dados vinculados nem especificar permissões para recursos individuais.

Só é possível atualizar a descrição e os rótulos dos conjuntos de dados vinculados. As alterações em um conjunto de dados vinculado não afetam os conjuntos de dados de origem ou compartilhados.

Para atualizar a descrição e os rótulos de um conjunto de dados vinculado, siga estas etapas:

  1. No Console do Google Cloud, acesse a página BigQuery.

    Ir para o BigQuery

  2. No painel Explorer, clique no nome do seu projeto e, em seguida, clique no conjunto de dados vinculado.

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

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

    1. Para adicionar rótulos, consulte Como adicionar um rótulo a um conjunto de dados.

    2. Para ativar a ordenação, expanda a seção Opções avançadas e siga estas etapas:

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

  5. Clique em Save.

Ver metadados da tabela

Para ver os metadados da tabela subjacente, consulte a visualização INFORMATION_SCHEMA.TABLES:

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

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

Excluir conjuntos de dados vinculados

Caso sua assinatura seja removida por um editor do Analytics Hub, o seu conjunto de dados vinculado será desvinculado do conjunto de dados compartilhado. É possível excluir um conjunto de dados desvinculado porque você não pode consultar um conjunto de dados desvinculado.

A exclusão de um conjunto de dados vinculado não remove o conjunto de origem. Não é possível recuperar um conjunto de dados vinculado que foi excluído. No entanto, é possível recriá-lo assinando a listagem novamente e adicionando o conjunto de dados ao seu projeto.

Para excluir um conjunto de dados vinculado, faça o seguinte:

  1. No Console do Google Cloud, acesse a página BigQuery.

    Ir para o BigQuery

  2. No painel Explorer, clique no nome do seu projeto e, em seguida, clique no conjunto de dados vinculado.

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

  4. Na caixa de diálogo Excluir conjunto de dados vinculado?, confirme a exclusão digitando excluir.

  5. Clique em Excluir.

A seguir