Gerenciar listagens

Como editor de dados no BigQuery Sharing (antigo Analytics Hub), é possível criar e gerenciar listagens para compartilhar conjuntos de dados com segurança com assinantes de várias organizações sem copiar dados.

Ao gerenciar listagens, você pode realizar as seguintes tarefas:

  • Criar, atualizar, compartilhar e excluir listagens em qualquer troca de dados em que você tenha acesso de publicação.
  • Gerencie o acesso atribuindo papéis de compartilhamento do BigQuery a administradores, assinantes e leitores.
  • Ver, monitorar e remover assinantes das suas listagens.
  • Monitorar as métricas de uso da assinatura.

Uma listagem é uma referência a um conjunto de dados compartilhado que um editor lista em uma troca de dados. Dependendo da política do Identity and Access Management (IAM) definida para a listagem e do tipo de troca de dados que contém a listagem, uma listagem pode ser de um dos dois tipos a seguir:

Antes de começar

Para começar a usar o BigQuery Sharing (antigo Analytics Hub), é necessário ativar a API Analytics Hub no projeto do Google Cloud .

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:

Para ativar a API Analytics Hub, selecione uma das seguintes opções:

Console

Acesse a página da API Analytics Hub e ative-a para seu projeto do Google Cloud .

Ativar a API Analytics Hub

gcloud

Execute o comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Funções exigidas

Para gerenciar listagens e assinaturas, é preciso ter um dos seguintes papéis de Identity and Access Management (IAM) de BigQuery Sharing:

Para mais informações, consulte Papéis do IAM de BigQuery Sharing. Para saber como conceder esses papéis a outros usuários, consulte Criar um administrador de listagens.

Para criar listagens ou atualizar regiões de réplica de uma listagem, você precisa ter as permissões bigquery.datasets.get e bigquery.datasets.update nos conjuntos de dados de origem. Os seguintes papéis predefinidos do BigQuery incluem a permissão bigquery.datasets.update:

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ê precisa 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 de compartilhamento do BigQuery precisará compartilhar um link de troca de dados com você.

Criar uma listagem

Uma listagem é uma referência a um conjunto de dados compartilhado que um editor de compartilhamento do BigQuery lista em uma troca de dados.

Para criar uma listagem, siga estas etapas:

Console

  1. Acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (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 em que você quer criar a listagem.

  3. Clique em Criar listagem.

  4. Na seção Configurar dados, no menu Tipo de recurso, selecione Conjunto de dados do BigQuery ou Tópico do Pub/Sub.

    • Se você selecionar Conjunto de dados do BigQuery, faça o seguinte:

      1. No menu Conjunto de dados compartilhado, selecione um conjunto de dados ou clique em Criar um conjunto de dados. O conjunto de dados precisa estar na mesma região que a troca de dados. Não é possível mudar o conjunto de dados compartilhado depois de criar a listagem. Quando os assinantes visualizam os metadados do conjunto de dados vinculado, o compartilhamento do BigQuery retorna o nome do conjunto de dados de origem e o ID do projeto que contém o conjunto de dados.
      2. Opcional: para permitir que os assinantes compartilhem um procedimento armazenado em SQL entre listagens, selecione Permitir compartilhamento de procedimento armazenado (pré-lançamento).
      3. Para disponibilizar o conjunto de dados compartilhado em outras regiões, abra o menu Disponibilidade de dados da região. O menu mostra as regiões que têm réplicas de conjuntos de dados rotuladas como Prontas para uso. Antes de configurar a listagem para várias regiões, verifique se você ativou a replicação de conjunto de dados entre regiões no conjunto de dados compartilhado. Só é possível selecionar regiões em que a replicação de conjuntos de dados entre regiões está ativada. Todas as outras regiões são rotuladas como Indisponíveis. Se você não selecionar nenhuma região adicional, a listagem vai usar como padrão a região principal do conjunto de dados compartilhado, que é rotulada como Principal do provedor.

      4. Em Controles de saída de dados, selecione a opção de saída de dados adequada:

        • Para restringir a cópia e a exportação de dados pessoais compartilhados no conjunto de dados compartilhado, mas permitir exportações de resultados de consulta, selecione Desativar cópia e exportação de dados pessoais compartilhados.
        • Para restringir a cópia e a exportação de dados no conjunto de dados compartilhado e nos resultados da consulta, selecione Desativar cópia e exportação dos resultados da consulta. Essa opção também seleciona Desativar cópia e exportação de dados pessoais compartilhados.
        • Para restringir a cópia e a exportação de tabelas por meio de APIs no conjunto de dados compartilhado, selecione Desativar cópia e exportação de tabelas por meio de APIs. Essa opção também seleciona Desativar cópia e exportação de dados pessoais compartilhados.

        Para mais informações sobre os controles de saída de dados, incluindo restrições, consulte Opções de saída de dados (somente conjuntos de dados compartilhados do BigQuery).

    • Se você selecionar Tópico do Pub/Sub, no menu Tópico compartilhado, selecione um tópico do Pub/Sub ou clique em Criar um tópico para criar um tópico.

  5. Na seção Detalhes da listagem, em Nome de exibição, insira um nome para a listagem.

  6. Insira os seguintes detalhes opcionais:

    • Categoria: selecione até cinco categorias que melhor representam sua listagem. Os assinantes podem filtrar as listagens usando as categorias selecionadas.
    • Afinidade de dados: especifique as regiões que você usa para publicar dados. Essa configuração de local ajuda os assinantes a minimizar ou evitar custos de saída de rede do Pub/Sub lendo dados da mesma região. Para mais informações sobre custos de saída, consulte Custos de transferência de dados.
    • Ícone: faça upload de um ícone para a listagem. Os formatos de arquivo PNG e JPEG são compatíveis. Os ícones precisam ser menores que 512 KiB, com dimensões máximas de 512 x 512 pixels.
    • Descrição: insira uma breve descrição da sua página de detalhes. Os assinantes podem pesquisar listagens pelo texto de descrição.

    • Facilidade de descoberta pública: ative essa configuração para que sua listagem seja descoberta publicamente no catálogo do BigQuery Sharing. Se você ativar essa opção, conceda o papel de Leitor do Analytics Hub (roles/analyticshub.viewer) a allUsers ou allAuthenticatedUsers. Para mais informações, consulte Conceder o papel de uma listagem. Se a troca já for pública, a listagem herdará essas permissões e não exigirá mais nenhuma ação.

      As trocas detectáveis publicamente não podem ter listagens privadas devido à herança de permissões, mas as trocas privadas podem ter listagens públicas. Para criar uma listagem pública, o projeto que contém a listagem precisa ter uma organização e uma conta de faturamento associadas. Se você criar uma listagem comercial integrada ao Cloud Marketplace, recomendamos que ative a descoberta pública.

    • Registro de e-mails de assinantes: ative essa configuração para registrar os identificadores principais de todos os usuários que executam jobs e consultas em conjuntos de dados vinculados. Se você ativar essa opção, todas as assinaturas futuras criadas com base nessa listagem vão ativar a geração de registros de e-mails de assinantes. Os dados registrados estão disponíveis na coluna job_principal_subject da visualização INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

    • Documentação > Markdown: insira documentação de suporte, links ou instruções no formato Markdown para ajudar os assinantes a usar seu conjunto de dados.

  7. Na seção Informações de contato da listagem, insira os seguintes detalhes opcionais:

    • Contato principal: insira o endereço de e-mail ou URL do contato principal da listagem.
    • Contato para pedir acesso: insira o endereço de e-mail ou o URL do seu formulário de entrada para que os assinantes possam entrar em contato com você e pedir acesso.

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

      • Nome do provedor: nome do provedor de dados.
      • Contato principal do provedor: o endereço de e-mail ou URL do contato principal do provedor de dados.

      Os assinantes podem filtrar listagens por provedor de dados.

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

      • Nome do editor: nome do editor que está criando a listagem.
      • Contato principal do editor: o endereço de e-mail ou URL do contato principal do editor.

  8. Revise a seção Prévia da página de detalhes.

  9. Para publicar a página de detalhes, clique em Publicar.

API

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

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/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 listagem.
  • LOCATION: o local da troca de dados. Para mais informações sobre locais que aceitam o BigQuery Sharing, 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.

Para criar uma listagem em várias regiões, especifique essas regiões no campo bigqueryDataset.replicaLocations do corpo da solicitação. Antes de configurar a listagem para várias regiões, verifique se você ativou a replicação de conjunto de dados entre regiões no conjunto de dados compartilhado. Só é possível selecionar regiões em que a replicação de conjunto de dados entre regiões está ativada. Se você omitir esse campo opcional, a listagem usará a região principal do conjunto de dados compartilhado.

Se a solicitação for bem-sucedida, o corpo da resposta vai retornar os detalhes da listagem. Se você ativar o registro de e-mail do assinante definindo o campo logLinkedDatasetQueryUserEmail como true, a resposta da listagem vai retornar log_linked_dataset_query_user_email: true. Os dados registrados estão disponíveis na coluna job_principal_subject da visualização INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

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

Para criar uma listagem diretamente de um conjunto de dados, siga estas etapas:

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

    Acessar o BigQuery

  2. Para conferir os detalhes do conjunto de dados, clique no nome dele.

  3. Clique em Compartilhamento > Publicar como listagem.

    A caixa de diálogo Criar listagem é aberta.

  4. Selecione uma troca de dados em que você quer publicar a 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.

  5. No menu Conjunto de dados compartilhado, selecione um conjunto de dados ou clique em Criar um conjunto de dados. O conjunto de dados precisa estar na mesma região que a troca de dados. Não é possível mudar essa seleção depois de criar a página de detalhes.

    Quando os assinantes visualizam os metadados do conjunto de dados vinculado, o compartilhamento do BigQuery retorna o nome do conjunto de dados de origem e o ID do projeto que contém o conjunto de dados.

  6. Opcional: para permitir que os assinantes compartilhem um procedimento armazenado em SQL entre listagens, selecione Permitir compartilhamento de procedimento armazenado (pré-lançamento).

  7. Para disponibilizar o conjunto de dados compartilhado em outras regiões, abra o menu Disponibilidade de dados da região. O menu mostra regiões com réplicas de conjuntos de dados rotuladas como Prontas para uso. Antes de configurar a listagem para várias regiões, verifique se você ativou a replicação de conjunto de dados entre regiões no conjunto de dados compartilhado. Só é possível selecionar regiões em que a replicação de conjunto de dados entre regiões está ativada. Todas as outras regiões são rotuladas como Indisponíveis. Se você não selecionar outra região, a listagem vai usar como padrão a região principal do conjunto de dados compartilhado, que é rotulada como Principal do provedor.

  8. Em Controles de saída de dados, selecione a opção adequada:

    • Para restringir a cópia e a exportação no conjunto de dados compartilhado, mas permitir as exportações dos resultados da consulta, selecione Desativar cópia e exportação de dados compartilhados.
    • Para restringir a cópia e a exportação no conjunto de dados compartilhado e nos resultados da consulta, selecione Desativar cópia e exportação dos resultados da consulta. Essa opção também seleciona Desativar cópia e exportação de dados compartilhados.
    • Para restringir a cópia e a exportação de tabelas por meio de APIs no conjunto de dados compartilhado, selecione Desativar cópia e exportação de tabelas por meio de APIs. Essa opção também seleciona Desativar cópia e exportação de dados pessoais compartilhados.

    Para informações sobre controles e restrições de saída de dados, consulte Opções de saída de dados (somente conjuntos de dados compartilhados do BigQuery).

  9. Na seção Detalhes da listagem, em Nome de exibição, insira um nome para a listagem.

  10. Insira os seguintes detalhes opcionais:

    • Categoria: selecione até cinco categorias que melhor representam sua listagem. Os assinantes podem filtrar as listagens usando as categorias selecionadas.

    • Afinidade de dados: especifique as regiões que você usa para publicar dados. Essa configuração de local ajuda os assinantes a minimizar ou evitar custos de saída de rede do Pub/Sub lendo dados da mesma região. Para mais informações sobre custos de saída, consulte Custos de transferência de dados.

    • Ícone: faça upload de um ícone para a listagem. Os formatos de arquivo PNG e JPEG são compatíveis. Os ícones precisam ter menos de 512 KiB e dimensões máximas de 512 x 512 pixels.

    • Descrição: insira uma breve descrição da sua página de detalhes. Os assinantes podem pesquisar listagens pelo texto de descrição.

    • Facilidade de descoberta pública: ative essa configuração para que sua listagem seja descoberta publicamente no catálogo do BigQuery Sharing. Se você ativar essa opção, conceda a allUsers ou allAuthenticatedUsers o papel de Leitor do Analytics Hub (roles/analyticshub.viewer). Para mais informações, consulte Conceder o papel de uma listagem. Se a troca já for pública, a listagem herdará essas permissões e não exigirá mais nenhuma ação.

      As trocas detectáveis publicamente não podem ter listagens privadas devido à herança de permissões, mas as trocas privadas podem ter listagens públicas. Para criar uma listagem pública, o projeto que contém a listagem precisa ter uma organização e uma conta de faturamento associadas. Se você criar uma listagem comercial integrada ao Cloud Marketplace, recomendamos ativar a facilidade de descoberta pública.

    • Registro de e-mail do assinante: ative para registrar os identificadores principais de assinantes que executam jobs e consultas no conjunto de dados vinculado desta listagem para todas as assinaturas futuras. Quando você ativa essa opção, apenas as assinaturas recém-criadas registram identificadores de principal. Os dados registrados estão disponíveis na coluna job_principal_subject da visualização INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

    • Documentação > Markdown: insira documentação de suporte, links ou instruções para ajudar os assinantes a usar seu conjunto de dados.

  11. Na seção Informações de contato da listagem, insira os seguintes detalhes opcionais:

    • Contato principal: insira o endereço de e-mail ou URL do contato principal da listagem.

    • Contato para pedir acesso: insira o endereço de e-mail ou o URL do formulário de entrada para que os assinantes possam entrar em contato com você e pedir acesso.

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

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

      Os assinantes podem filtrar listagens por provedor de dados.

    • Editor: expanda a seção Editor e insira os detalhes nos seguintes campos:

      • Nome do editor: nome do editor que está criando a listagem.
      • Contato principal do editor: o endereço de e-mail ou URL do contato principal do editor.

  12. Revise a seção Prévia da página de detalhes.

  13. Para publicar a página de detalhes, clique em Publicar.

Compartilhar um procedimento armazenado em SQL entre listagens

É possível compartilhar procedimentos armazenados em SQL ao criar listagens com conjuntos de dados do BigQuery. Como os procedimentos armazenados podem criar, eliminar e manipular tabelas, além de invocar outros procedimentos armazenados, o compartilhamento deles exige autorização adicional.

Autorização do assinante

Depois que um assinante assina uma listagem, os procedimentos armazenados vinculados podem não ser executados imediatamente. Para garantir que os procedimentos armazenados vinculados possam ser executados, o assinante precisa enviar o nome do conjunto de dados vinculado ao provedor para que o provedor autorize o procedimento armazenado vinculado nos recursos do provedor. Além disso, o assinante precisa autorizar o procedimento armazenado compartilhado vinculado e anexar um papel do IAM aos recursos do assinante para permitir a leitura e a gravação neles.

Autorização do provedor

Quando um provedor cria uma listagem com um procedimento armazenado, ele precisa permitir que o assinante leia e grave nas tabelas do provedor usando o procedimento armazenado vinculado. Para garantir o acesso, o provedor precisa fazer o seguinte:

  • Para operações que não sejam de leitura, autorize o procedimento armazenado compartilhado vinculado e anexe um papel do IAM a qualquer recurso do provedor acessado pelo procedimento armazenado vinculado.

  • Para operações de leitura, autorize o procedimento armazenado compartilhado vinculado (no conjunto de dados vinculado do assinante) ou o procedimento armazenado compartilhado original (no conjunto de dados do provedor) e anexe um papel do IAM a qualquer recurso do provedor acessado pelo procedimento.

Conceder aos usuários acesso a uma listagem

Para conceder acesso a uma listagem particular, é preciso definir a política do IAM para que essa listagem inclua indivíduos ou grupos específicos. 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 compartilhamento do BigQuery para todos os usuários doGoogle Cloud (allAuthenticatedUsers). Para permitir que os usuários naveguem e solicitem acesso a listagens comerciais, conceda a eles o papel de Leitor do Analytics Hub (roles/analyticshub.viewer). Para permitir que os usuários se inscrevam em listagens comerciais, conceda a eles o papel de Assinante do Analytics Hub (roles/analyticshub.subscriber). Para listagens comerciais integradas ao Cloud Marketplace, o compartilhamento do BigQuery concede automaticamente o papel de Assinante do Analytics Hub com base nos pedidos do Cloud Marketplace.

Para tornar sua listagem acessível a todos, incluindo pessoas sem uma conta doGoogle 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

  1. Acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (Analytics Hub)

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

  3. Clique na listagem que você quer compartilhar.

  4. Clique em Definir permissões.

  5. Para adicionar principais, clique em Adicionar principal.

  6. No campo Novos participantes, insira os participantes com base no tipo de listagem:

    • Para uma listagem particular, insira os endereços de e-mail das identidades a quem você quer conceder acesso.

    • Para uma listagem pública, insira allAuthenticatedUsers.

    • Para uma listagem pública detectável por todos, incluindo usuários que não são doGoogle Cloud, insira allUsers.

  7. No menu Selecionar um papel, aponte para Analytics Hub e selecione um papel com base no tipo de listagem:

    • Para uma listagem comercial (incluindo listagens integradas ao Cloud Marketplace), selecione 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 Assinante do Analytics Hub. Com esse papel, os usuários podem fazer inscrição na listagem.

    • Para listagens integradas ao Cloud Marketplace, não é necessário conceder o papel de assinante do Analytics Hub (roles/analyticshub.subscriber). As assinaturas são gerenciadas automaticamente com base no pedido do Cloud Marketplace.

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

  8. Para salvar as permissões, clique em Salvar.

API

  1. Leia a política atual chamando 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 compartilhamento retorna a política atual na resposta.

  2. Para adicionar ou remover membros e os papéis associados, edite o JSON da política usando um editor de texto. Especifique os membros usando os seguintes formatos:

    • 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. Atualize a política chamando o método projects.locations.dataExchanges.listings.setIamPolicy. No corpo da solicitação, transmita a política do IAM atualizada da etapa anterior.

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

    No corpo da solicitação, transmita os detalhes da listagem. Se a solicitação for bem-sucedida, o corpo da resposta retornará os detalhes da listagem com a política atualizada.

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 uma listagem pública

Para criar um URL de listagem de compartilhamento do BigQuery não autenticado que os usuários sem uma conta do Google Cloud possam acessar, siga estas etapas:

  1. Acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (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 que contém a ficha da empresa.

  3. Para conferir os detalhes da listagem, clique no nome de exibição dela. As informações do produto precisam ter a facilidade de descoberta pública ativada.

  4. Clique em Copiar link público. Para garantir que os usuários externos possam visualizar a listagem, verifique se ela 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 listagens, crie administradores de listagens concedendo a eles o papel de editor do Analytics Hub ou de administrador de listagens do Analytics Hub na listagem. Para instruções sobre como conceder papéis em uma listagem, consulte Conceder o papel de uma listagem.

Ver todas as assinaturas

Para ver todas as assinaturas atuais da sua listagem, selecione uma das seguintes opções:

Console

  1. Acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (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:

    A opção "Gerenciar assinaturas" em destaque para uma listagem de BigQuery Sharing.

  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.

    Acessar o BigQuery

  2. No painel à esquerda, clique em Explorer:

    Botão destacado para o painel "Explorer".

    Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

  3. No painel Explorer, expanda o nome do projeto, clique em Conjuntos de dados e, em seguida, clique no nome do conjunto de dados compartilhado.

  4. Na lista de Compartilhamento, selecione Gerenciar assinaturas.

SQL

O exemplo a seguir usa a visualização INFORMATION_SCHEMA.SCHEMATA_LINKS para listar todos os conjuntos de dados vinculados a um conjunto de dados compartilhado em myproject que estão 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 o resultado.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  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                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

Para uma listagem com várias regiões, é possível ver as assinaturas em diferentes regiões substituindo a região us pelo local da réplica pretendido. Por exemplo, para ver os conjuntos de dados vinculados a um conjunto de dados compartilhado em myproject que estão na região eu, use a seguinte consulta:

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

API

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

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/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 da sua listagem, o conjunto de dados vinculado é desvinculado do conjunto de dados compartilhado. Os assinantes ainda podem ver o conjunto de dados nos projetos deles, mas ele não está mais vinculado ao seu 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:

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

  2. Para remover um assinante de uma listagem, clique em Excluir. Para remover todas as assinaturas, clique em Remover todas as assinaturas.

  3. Na caixa de diálogo Remover assinatura?, confirme a exclusão digitando remove.

  4. Clique em Remover.

Para remover uma assinatura criada após 25 de julho de 2023, siga estas etapas:

Console

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

  2. Clique em Assinaturas.

  3. Para selecionar as assinaturas que você quer remover, marque as caixas de seleção ao lado delas e clique em Remover assinaturas.

  4. Na caixa de diálogo Remover assinatura?, confirme a remoção digitando remove.

  5. Clique em Remover.

API

Chame o método projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/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_ID: o ID da assinatura que você quer remover.

Atualizar uma listagem

À medida que seus requisitos de troca de dados evoluem, é possível atualizar os metadados, as categorias, as configurações de facilidade de descoberta e a disponibilidade de região de uma listagem sem modificar o conjunto de dados compartilhado.

Se o projeto do Google Cloud usar um perímetro de serviço do VPC Service Controls, talvez seja necessário configurar outras regras de entrada e saída para permitir que a sincronização em segundo plano atualize os conjuntos de dados vinculados associados.

Para isso, siga estas etapas:

Console

  1. Acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (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 Editar listagem.

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

  6. Opcional: atualize as configurações e a disponibilidade da listagem:

    • Para ativar a facilidade de descoberta pública, conceda o papel de Leitor do Analytics Hub (roles/analyticshub.viewer) a allUsers ou allAuthenticatedUsers. Para instruções sobre como conceder papéis em uma listagem, consulte Conceder o papel de uma listagem.
    • Para desativar a facilidade de descoberta pública de uma listagem em uma troca privada, remova o papel de Leitor do Analytics Hub (roles/analyticshub.viewer) de allUsers e allAuthenticatedUsers. Se a troca já for pública, as permissões de listagem já serão herdadas e nenhuma outra ação será necessária.
    • Depois de ativar e salvar a geração de registros de e-mails de assinantes, não será possível editar essa configuração. Para desativar o registro de e-mails, exclua a listagem e recrie-a sem selecionar Registro de e-mails do assinante.
    • Para adicionar ou remover regiões, atualize sua seleção. Antes de adicionar várias regiões, verifique se você ativou a replicação de conjuntos de dados entre regiões no conjunto de dados compartilhado. Antes de remover uma região, exclua a réplica do conjunto de dados compartilhado nela.

  7. Revise a prévia da página de detalhes.

  8. Para salvar as alterações, clique em Salvar. Se você atualizar uma ficha integrada ao Cloud Marketplace, uma notificação vai solicitar que você também atualize a ficha do produto de dados do Cloud Marketplace.

API

Chame o método projects.locations.dataExchanges.listings.patch:

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

Substitua:

  • PROJECT_ID: o ID do projeto que contém a troca de dados em que você quer criar a listagem.
  • LOCATION: o local da troca de dados.
  • DATAEXCHANGE_ID: o ID da troca de dados.
  • LISTING_ID: o ID da listagem a ser atualizada.
  • UPDATEMASK: a lista de campos que você quer atualizar. Para atualizar vários valores, use uma lista separada por vírgulas. Por exemplo, para atualizar o nome de exibição e o contato principal de uma troca de dados, insira displayName,primaryContact.

No corpo da solicitação, especifique os valores atualizados para os campos na máscara de atualização:

  • displayName
  • description
  • primaryContact
  • documentation
  • icon
  • categories[]
  • discoveryType
  • logLinkedDatasetQueryUserEmail
  • bigqueryDataset.replicaLocations

Para detalhes sobre esses campos, consulte Recurso: listagem.

Ao atualizar as regiões de réplica da listagem, especifique todas as regiões aplicáveis. Antes de atualizar a listagem, verifique se você ativou a replicação de conjunto de dados entre regiões no conjunto de dados compartilhado. Só é possível adicionar regiões em que o conjunto de dados compartilhado tem uma réplica. Antes de remover uma região da listagem, exclua a réplica do conjunto de dados compartilhado nessa região. Também é possível converter listagens de região única em listagens multirregionais.

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

Para aumentar a visibilidade da sua listagem no catálogo do BigQuery Sharing, você pode exibi-la na seção Destaque. As listagens em destaque são regidas pelo Google Cloud Contrato do Programa de Parceiros.

Para solicitar que sua listagem apareça na seção Destaque, você precisa atender aos seguintes critérios:

Para solicitar a adição ou remoção da sua listagem da seção Destaque, envie o formulário de solicitação de listagem em destaque.

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 e remove todas as assinaturas dos projetos dos assinantes. Se um conjunto de dados permanecer vinculado, remova-o manualmente clicando em Compartilhamento > Gerenciar assinatura. Na página Assinaturas, remova conjuntos de dados de assinante específicos ou todos de uma só vez.

Não é possível excluir listagens integradas ao Cloud Marketplace que tenham assinaturas comerciais ativas. É necessário revogar todas as assinaturas comerciais antes de excluir a listagem.

A exclusão de uma listagem multirregional não exclui as réplicas do conjunto de dados compartilhado. Depois que você exclui uma listagem multirregional, os assinantes não podem mais visualizá-la ou consultar os conjuntos de dados vinculados. Se nenhuma outra listagem fizer referência às réplicas do conjunto de dados compartilhado, exclua essas réplicas.

Antes de excluir uma listagem multirregional, verifique se ela não tem assinaturas ativas. Se houver assinaturas ativas, revogue-as chamando o método projects.locations.subscriptions.revoke. Depois que todas as assinaturas ativas forem removidas, exclua a listagem multirregional.

Para excluir uma listagem, siga estas etapas:

Console

  1. Acesse a página Compartilhamento (Analytics Hub).

    Acessar o compartilhamento (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 Excluir.

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

  6. Clique em Excluir.

API

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

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

Substitua:

  • PROJECT_ID: o ID do projeto que contém a troca de dados.
  • LOCATION: o local da troca de dados.
  • DATAEXCHANGE_ID: o ID da troca de dados.
  • LISTING_ID: o ID da listagem a ser excluída.

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

A seguir