Gerenciar listagens
Como editor do Analytics Hub, é possível realizar as seguintes tarefas:
- Criar listagens em uma troca de dados a que você tenha acesso de publicação.
- Atualizar, excluir, compartilhar e visualizar métricas de uso de listagens.
- Gerenciar papéis diferentes para suas listagens do Analytics Hub, como administradores, assinantes e leitores.
- Ver todos os inscritos que se inscreveram na sua listagem.
- Monitore o uso das suas fichas.
- Remover assinantes da sua listagem.
Uma listagem é uma referência a um conjunto de dados compartilhado que um editor lista em uma troca de dados. Uma listagem pode ser dos dois tipos a seguir com base na política de gerenciamento de identidade e acesso (IAM) definida para a listagem e o tipo de troca de dados que contém a listagem:
Listagem pública. Ela pode ser descoberta e assinada pelos usuários do Google Cloud (
allAuthenticatedUsers
). Listagens em uma troca de dados pública são listagens públicas. Essas listagens podem ser referências a um conjunto de dados público gratuito ou a um conjunto de dados comercial. Se a listagem for de um conjunto de dados comercial, os assinantes poderão solicitar acesso à listagem e o provedor de dados entrará em contato com eles.Listagem particular. Ela é compartilhada diretamente com indivíduos ou grupos. Por exemplo, uma listagem particular pode fazer referência ao conjunto de dados de métricas de marketing que você compartilha com outras equipes internas da organização. Embora seja possível permitir que
allAuthenticatedUsers
se inscrevam nas suas listagens, elas permanecerão particulares e não serão exibidas como uma lista pública na página do Analytics Hub. Para compartilhar essas listagens com os usuários, compartilhe o URL com eles. Para tornar detectável uma listagem particular, é necessário tornar a troca pública.
Antes de começar
Para começar a usar o Analytics Hub, você precisa ativar a API Analytics Hub no projeto do Google Cloud.
Permissões necessárias
Para ativar a API Analytics Hub, você precisa das seguintes permissões de gerenciamento de identidade e acesso (IAM):
serviceUsage.services.get
serviceUsage.services.list
serviceUsage.services.enable
O papel predefinido do IAM a seguir inclui as permissões necessárias para ativar a API Analytics Hub:
roles/serviceusage.serviceUsageAdmin
Para mais informações sobre os papéis do IAM no BigQuery, consulte Papéis e permissões predefinidos.
Ativar a API Analytics Hub
Para ativar a API Analytics Hub, faça o seguinte:
Console
Acesse a API Analytics Hub para seu projeto do Google Cloud e ative-o.
gcloud
Execute o comando gcloud services enable:
gcloud services enable analyticshub.googleapis.com
Permissões necessárias
Para gerenciar listagens e assinaturas, é preciso ter um dos seguintes papéis do Analytics Hub:
Papel de Editor do Analytics Hub (
roles/analyticshub.publisher
), que permite criar, atualizar, excluir e definir políticas do IAM nas listagens.O papel de Administrador de listagens do Google Analytics (
roles/analyticshub.listingAdmin
), que permite atualizar, excluir e definir políticas do IAM nas suas listagens.Papel de Administrador do Analytics Hub (
roles/analyticshub.Admin
), que permite criar, atualizar, excluir e definir políticas do IAM em todas as listagens na sua troca de dados.
Para mais informações, consulte as funções do usuário do Analytics Hub. Para saber como conceder esses papéis a outros usuários, consulte Criar um administrador de listagens.
Além disso, para criar listagens, você também precisa ter a
permissões bigquery.datasets.get
e bigquery.datasets.update
nos conjuntos de dados para os quais quer
criar listagens. Os papéis predefinidos do BigQuery
a seguir têm a
permissão bigquery.datasets.update
.
- Papel de Proprietário de dados do BigQuery (
roles/bigquery.dataOwner
) - Papel de administrador do BigQuery (
roles/bigquery.admin
)
Para ver todas as trocas de dados nos projetos em uma organização a que você tem acesso, é preciso ter a permissão resourcemanager.organizations.get
. Não há papéis predefinidos do BigQuery que contenham essa permissão. Por isso, você precisará usar um papel personalizado do IAM.
Ver trocas de dados
Para ver a lista de trocas de dados na organização a que você tem acesso, consulte Ver trocas de dados. Se a troca de dados estiver em outra organização, o administrador do Analytics Hub precisará compartilhar um link para essa troca de dados com você.
Criar uma listagem
Uma listagem é uma referência a um conjunto de dados compartilhado que um editor lista em uma troca de dados.
Para criar uma listagem, siga estas etapas:
Console
Acesse a página do Analytics Hub.
Será exibida uma página que lista todas as trocas de dados que é possível acessar.
Clique no nome da troca de dados na qual você quer criar a listagem.
Clique em
Criar listagem.Na página Criar listagem, em Nome de exibição, insira o nome da listagem.
Se você estiver criando uma listagem 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ê.
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.
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.
Em Saída de dados, 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.
- Para aplicar restrições de saída de cópia e exportação de API de dados ao seu conjunto de dados compartilhado, selecione Desativar cópia e exportação de tabelas por meio de APIs. Isso também vai definir automaticamente Desativar cópia e exportação de dados compartilhados.
Opcional: na seção Detalhes da página, clique no botão Detecção pública para ativar a detecção pública. É necessário conceder o papel de Leitor do Analytics Hub (
roles/analyticshub.viewer
) paraallUsers
ouallAuthenticatedUsers
. Para mais informações, consulte Conceder o papel de uma listagem. Se a troca já for pública, as permissões de listagem já serão herdadas e nenhuma outra ação será necessária.As trocas detectáveis publicamente não podem ter listagens particulares devido à herança de permissão, mas as trocas particulares podem ter listagens públicas. Para que as listagens públicas sejam criadas, o projeto em que a listagem de dados está precisa ter uma organização e uma conta de faturamento associadas.
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.
Clique em Salvar.
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
.
Criar uma listagem com base em um conjunto de dados
Também é possível criar uma listagem usando um conjunto de dados:
No Console do Google Cloud, acesse a página BigQuery.
Clique em um conjunto de dados para conferir os detalhes.
Clique em > Publicar como listagem.
CompartilhamentoA caixa de diálogo Criar listagem é aberta.
Selecione uma troca de dados para publicar essa listagem. A troca de dados precisa estar na mesma região que o conjunto de dados. Para mais informações sobre como criar uma troca de dados, consulte Criar uma troca e definir permissões.
Em Saída de dados, 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.
- Para aplicar restrições de saída de cópia e exportação de API de dados ao seu conjunto de dados compartilhado, selecione Desativar cópia e exportação de tabelas por meio de APIs. Isso também vai definir automaticamente Desativar cópia e exportação de dados compartilhados.
Insira os detalhes da listagem.
Nome de exibição é o nome da listagem e é obrigatório. Outros campos são opcionais.
Opcional: clique no botão Detecção pública para ativar a detecção pública. É necessário conceder o papel de Leitor do Analytics Hub (
roles/analyticshub.viewer
) paraallUsers
ouallAuthenticatedUsers
. Para mais informações, consulte Conceder o papel de uma listagem. Se a troca já for pública, as permissões de listagem já serão herdadas e nenhuma outra ação será necessária.As trocas detectáveis publicamente não podem ter listagens particulares devido à herança de permissão, mas as trocas particulares podem ter listagens públicas. Para que as listagens públicas sejam criadas, o projeto em que a listagem de dados está precisa ter uma organização e uma conta de faturamento associadas.
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.
Clique em Publicar.
Conceder aos usuários acesso a uma listagem
Se você quiser permitir que os usuários acessem uma listagem particular,
defina a política do IAM para um indivíduo ou um grupo para essa listagem. No caso
de uma listagem comercial, sua troca de dados precisa ser pública.
As listagens em uma troca de dados pública aparecem no Analytics Hub para
todos os usuários do Google Cloud (allAuthenticatedUsers
). Para permitir que os usuários solicitem acesso a listagens comerciais, conceda a eles
o Papel de Leitor do Analytics Hub.
Se você quiser tornar sua listagem acessível a todos, incluindo pessoas que
não usam o Google Cloud, conceda a allUsers
o papel de leitor do Analytics Hub (roles/analyticshub.viewer
).
Para conceder aos usuários acesso para ver ou se inscrever na sua listagem, siga estas etapas:
Console
Acesse a página do Analytics Hub.
Clique no nome da troca de dados que contém a ficha da empresa.
Clique na ficha que você quer adicionar inscritos.
Clique em
Definir permissões.Para adicionar participantes, clique em
Adicionar participante.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
.Para uma listagem pública que pode ser encontrada por todos, incluindo usuários que não são do Google Cloud, adicione
allUsers
.
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.
Clique em Salvar.
API
Leia a política atual com o método
getIamPolicy
da listagem usando o métodoprojects.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.
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
agroup:subscribers@example.com
, adicione a seguinte vinculação à política:{ "members": [ "group:subscribers@example.com" ], "role":"roles/analyticshub.subscriber" }
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
.
Criar um URL não autenticado para a listagem pública
Para criar um URL de listagem do Analytics Hub não autenticado que possa ser visualizado até mesmo por usuários que não são do Google Cloud, faça o seguinte:
Acesse a página do Analytics Hub.
Será exibida uma página que lista todas as trocas de dados que é possível acessar.
Clique no nome da troca de dados que contém a ficha da empresa.
Clique no nome de exibição para conferir os detalhes da listagem. A página de detalhes precisa ter a detecção pública ativada.
Clique em Copiar link público para gerar um URL de listagem não autenticado. Verifique se essa listagem concede a
allUsers
o papel de leitor do Analytics Hub (roles/analyticshub.viewer
).
Criar um administrador da listagem
Para permitir que os usuários gerenciem as listagens, você precisa criar administradores de fichas do Analytics Hub. Para criar administradores de listagens, você precisa conceder aos usuários o papel de editor do Analytics Hub ou administrador da listagem do Analytics Hub no nível da listagem. Para mais informações sobre como conceder esses papéis a uma listagem, consulte este link.
Ver todas as assinaturas
Para ver todas as assinaturas atuais da sua listagem da empresa, selecione uma das seguintes opções:
Console
Acesse a página do Analytics Hub.
Clique no nome da troca de dados que contém a listagem para que você quer gerenciar as assinaturas.
Clique na listagem para que você quer listar todos os assinantes.
Para ver todos os assinantes da sua listagem, clique em Gerenciar assinaturas.
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:
Acessar a página do BigQuery.
No painel do Explorer, expanda seu projeto e selecione o conjunto de dados compartilhado.
Na
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.
Remover uma inscrição
Quando você remove uma assinatura criada antes de 25 de julho de 2023 das suas fichas, o conjunto de dados vinculado é desvinculado do conjunto de dados compartilhado. Os assinantes ainda podem ver os conjuntos de dados nos projetos deles, mas eles não estão mais vinculados ao conjunto de dados compartilhado.
Para remover uma assinatura criada antes de 25 de julho de 2023 das suas informações do produto, siga estas etapas:
Para relacionar todos os assinantes de uma listagem, siga as instruções do console do Google Cloud em Ver todas as assinaturas.
Para remover um assinante de uma listagem, clique em
Excluir. Se você quiser remover todas as assinaturas, clique em Remover todas as assinaturas.Na caixa de diálogo Remover assinatura?, insira
remove
para confirmar.Clique em Remover.
Para remover assinaturas criadas após 25 de julho de 2023, siga estas etapas:
Console
Para relacionar todos os assinantes de uma listagem, siga as instruções do console do Google Cloud em Ver todas as assinaturas.
Clique na guia Assinaturas.
Para remover um assinante de uma ficha, selecione as assinaturas que você quer remover e clique em
Remover assinaturas.Na caixa de diálogo Remover assinatura?, insira
remove
para confirmar.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.
Atualizar uma listagem
Para isso, siga estas etapas:
Console
Acesse a página do Analytics Hub.
Clique no nome da troca de dados que contém a ficha da empresa.
Clique na listagem que você quer atualizar.
Clique em
Editar listagem.Modifique os valores nos campos. É possível modificar todos os valores, exceto o conjunto de dados de origem da listagem.
Opcional:
- Se você ativar a descoberta pública, conceda a
allUsers
ouallAuthenticatedUsers
o papel de Leitor do Analytics Hub (roles/analyticshub.viewer
). Para mais informações, consulte Conceder o papel de uma listagem. - Se você desativar a descoberta pública,
remova o papel de Leitor do Analytics Hub de
allUsers
eallAuthenticatedUsers
. As trocas públicas não podem ter listagens privadas, mas trocas privadas podem ter listagens públicas.
- Se você ativar a descoberta pública, conceda a
Para visualizar as alterações, clique em Visualizar.
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
.
Excluir uma listagem
Quando você exclui uma ficha, os assinantes não podem mais visualizá-la. Excluir uma listagem também exclui todos os conjuntos de dados vinculados (remove todas as assinaturas) dos projetos dos assinantes.
Se você excluir uma listagem, não poderá desfazer essa ação. Para excluir uma listagem, siga estas etapas:
Console
Acesse a página do Analytics Hub.
Clique no nome da troca de dados que contém a ficha da empresa.
Clique na listagem que você quer excluir.
Clique em
Excluir.Na caixa de diálogo Excluir lista?, confirme a exclusão digitando Excluir.
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
.
Mostrar um anúncio na seção de destaques
Para aumentar a visibilidade e o reconhecimento da sua listagem no catálogo do Analytics Hub, ela pode ser exibida na seção Destaque. As listagens em destaque são regidas pelo Contrato do Partner Advantage do Google Cloud.
Os parceiros que querem que as listagens deles apareçam na seção Destaque do catálogo do Analytics Hub precisam atender aos seguintes critérios:
Os dados compartilhados precisam estar no BigQuery.
Eles precisam estar inscritos no Programa Partner Advantage com a designação Build.
A listagem precisa ser criada e ter a detecção pública ativada.
Para solicitar que sua listagem apareça na seção Destaque, preencha e envie o formulário de solicitação. Para solicitar a remoção da sua listagem da seção, envie o mesmo formulário de solicitação.
A seguir
- Saiba mais sobre a arquitetura do Analytics Hub.
- Saiba como ver e assinar listagens.
- Saiba mais sobre as funções dos usuários do Analytics Hub.
- Saiba mais sobre como criar conjuntos de dados.
- Saiba mais sobre a geração de registros de auditoria do Analytics Hub.
- Saiba como monitorar fichas.