Gerenciar listagens

Console

Acesse a API Analytics Hub para seu projeto do Google Cloud e ative-o.

Ativar a API Analytics Hub

gcloud

Execute o comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Console

1. Acesse a página do Analytics Hub.

   Acessar o 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 em add_box Criar listagem.

4. Na página Criar listagem, em Nome de exibição, insira o nome da listagem.

5. Se você estiver criando um conjunto de dados comercial, precisará preencher o campo Solicitar contato de acesso. Insira um e-mail ou URL do formulário de entrada para que os assinantes possam entrar em contato com você.

6. Opcional: digite os seguintes detalhes:

   • Contato principal: insira um e-mail ou um URL do contato principal da listagem.

   • Categoria: selecione até duas categorias que melhor representam sua listagem. Os assinantes podem filtrar as listagens com base nessas categorias.

   • Provedor: expanda a seção Provedor e especifique os detalhes nos seguintes campos:

     • Nome do provedor: nome do provedor do conjunto de dados.
     • Contato principal do provedor: um e-mail ou um URL do contato principal do provedor do conjunto de dados.

     Os assinantes podem filtrar listagens com base nos provedores de dados.

   • Editor: expanda a seção Editor e especifique os detalhes nos campos a seguir:

     • Nome do editor: nome do editor que está criando a listagem.
     • Contato principal do editor: um e-mail ou um URL do contato principal do editor do conjunto de dados.

   • Ícone: um ícone para a listagem. Os formatos de arquivo PNG e JPEG são compatíveis. O tamanho do arquivo dos ícones precisa ser inferior a 512 KiB e dimensões de no máximo 512 x 512 pixels.

   • Descrição: uma breve descrição sobre sua listagem. Os assinantes podem pesquisar listagens com base na descrição.

7. Em Conjunto de dados de origem, selecione o conjunto de dados que você quer listar na troca de dados. O conjunto de dados de origem precisa estar na mesma região que a troca de dados. Não é possível atualizar este campo após a criação da listagem.

8. Em Saída de dados (visualização), selecione a opção de saída de dados adequada. Somente assinantes com produtos sem edição ou Enterprise Plus podem consultar dados com restrições de saída.

   • Para aplicar restrições de saída de dados ao conjunto de dados compartilhado, mas não aos resultados da consulta desse conjunto, selecione Desativar cópia e exportação de dados compartilhados.
   • Para aplicar restrições de saída de dados ao conjunto de dados compartilhado e aos resultados da consulta desse conjunto, selecione Desativar cópia e exportação dos resultados da consulta. Isso definirá automaticamente a opção Desativar. copiar e exportar dados compartilhados.

9. Opcional: na seção Documentação > seção Markdown, é possível inserir informações adicionais, como exemplos de consultas que podem ser executadas no conjunto de dados, bem como links para qualquer documento relevante e qualquer informação adicional que possa ajudar os assinantes a usar seu conjunto de dados.

10. Clique em Save.

API

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

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

Substitua:

• PROJECT_ID: o ID do projeto que contém a troca de dados em que você quer criar a ficha da empresa.
• LOCATION: o local da troca de dados. Para mais informações sobre locais que aceitam o Analytics Hub, consulte Regiões compatíveis.
• DATAEXCHANGE_ID: o ID da troca de dados.
• LISTING_ID: o ID da ficha da empresa.

No corpo da solicitação, forneça os detalhes da listagem. Se a solicitação for bem-sucedida, o corpo da resposta conterá detalhes da listagem.

Para mais informações sobre as tarefas que podem ser executadas em fichas de empresa usando APIs, consulte Métodos projects.locations.dataExchanges.listings.

Console

1. Acesse a página do Analytics Hub.

   Acessar o Analytics Hub

2. Clique no nome da troca de dados que contém a ficha da empresa.

3. Clique na ficha que você quer adicionar inscritos.

4. Clique em person Definir permissões.

5. Para adicionar participantes, clique em person_add Adicionar participante.

6. No campo Novos participantes, adicione os seguintes detalhes com base no tipo da listagem:

   • Para uma listagem particular, insira e-mails da identidade a quem você quer conceder acesso.

   • Para uma ficha pública, adicione allAuthenticatedUsers.

7. Em Selecionar papel, mantenha o ponteiro sobre o Analytics Hub e, com base o tipo de ficha, selecione um dos seguintes papéis:

   • Para uma listagem comercial, selecione a função Leitor do Analytics Hub. Com esse papel, os usuários podem ver a listagem e solicitar acesso.

   • Para uma listagem particular ou pública não comercial, selecione o papel de Assinante do Analytics Hub. Com esse papel, os usuários podem fazer inscrição na listagem.

   Para mais informações, consulte os papéis de Assinante e Leitor do Analytics Hub.

8. Clique em Save.

API

1. Leia a política atual com o método getIamPolicy da listagem usando o método projects.locations.dataExchanges.listings.getIamPolicy:

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

   Substitua:

   • PROJECT_ID: o ID do projeto, por exemplo, my-project-1
   • LOCATION: a localização da troca de dados que contém a listagem.
   • DATAEXCHANGE_ID: o ID da troca de dados.
   • LISTING_ID: o ID da ficha da empresa.

   O Analytics Hub retorna a política atual na resposta.

2. Para adicionar ou remover membros e os papéis associados, edite a política com um editor de texto. Use o seguinte formato para adicionar membros:

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   Por exemplo, para conceder o papel roles/analyticshub.subscriber a group:subscribers@example.com, adicione a seguinte vinculação à política:

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Grave a política atualizada usando o método projects.locations.dataExchanges.listings.setIamPolicy. No corpo da solicitação, forneça a política de IAM atualizada da etapa anterior.

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

   No corpo da solicitação, forneça os detalhes da ficha. Se a solicitação for bem-sucedida, o corpo da resposta conterá detalhes da ficha.

Para mais informações sobre as tarefas que podem ser executadas em fichas de empresa usando APIs, consulte Métodos projects.locations.dataExchanges.listings.

Console

1. Acesse a página do Analytics Hub.

   Acessar o Analytics Hub

2. Clique no nome da troca de dados que contém a listagem para que você quer gerenciar as assinaturas.

3. Clique na listagem para que você quer listar todos os assinantes.

4. Para ver todos os assinantes da sua listagem, clique em Gerenciar assinaturas.

   

5. Opcional: você pode filtrar os resultados por detalhes do assinante.

Como alternativa, se você tiver acesso ao conjunto de dados compartilhado, siga estas etapas para listar os assinantes:

1. Acessar a página do BigQuery.

   Ir para o BigQuery

2. No painel do Explorer, expanda seu projeto e selecione o conjunto de dados compartilhado.

3. Na person_add lista de Compartilhamento, selecione Gerenciar assinaturas.

SQL

O exemplo a seguir usa a INFORMATION_SCHEMA.SCHEMATA_LINKS visualização para relacionar todos os conjuntos de dados vinculados a um conjunto de dados compartilhado no myproject que estejam na região us:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

A resposta será semelhante a esta: Algumas colunas são omitidas para simplificar a saída.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

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

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

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 que contém a ficha em que você quer se inscrever.
• LISTING_ID: o ID da ficha da empresa em que você quer se inscrever.

Console

1. Para relacionar todos os assinantes de uma listagem, siga as instruções do console do Google Cloud em Ver todas as assinaturas.

2. Clique na guia Assinaturas.

3. Para remover um assinante de uma ficha, selecione as assinaturas que você quer remover e clique em delete Remover assinaturas.

4. Na caixa de diálogo Remover assinatura?, insira remove para confirmar.

5. Clique em Remover.

API

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

Console

1. Acesse a página do Analytics Hub.

   Acessar o Analytics Hub

2. Clique no nome da troca de dados que contém a ficha da empresa.

3. Clique na listagem que você quer atualizar.

4. Clique em mode_edit Editar listagem.

5. Modifique os valores nos campos. É possível modificar todos os valores, exceto o conjunto de dados de origem da listagem.

6. Para visualizar as alterações, clique em Visualizar.

7. Para salvar as alterações, clique em Salvar.

API

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

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

Substitua UPDATEMASK pela lista de campos que você quer atualizar. Para atualizar vários valores, use uma lista separada por vírgulas. No corpo da solicitação, especifique os valores atualizados.

Para mais informações sobre as tarefas que podem ser executadas em fichas de empresa usando APIs, consulte Métodos projects.locations.dataExchanges.listings.

Console

1. Acesse a página do Analytics Hub.

   Acessar o Analytics Hub

2. Clique no nome da troca de dados que contém a ficha da empresa.

3. Clique na listagem que você quer excluir.

4. Clique em deleteExcluir.

5. Na caixa de diálogo Excluir lista?, confirme a exclusão digitando Excluir.

6. Clique em Excluir.

API

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

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

Para mais informações sobre as tarefas que podem ser executadas em fichas de empresa usando APIs, consulte Métodos projects.locations.dataExchanges.listings.