Faça a gestão das trocas de dados na partilha do BigQuery

Enquanto administrador do Analytics Hub, pode realizar as seguintes tarefas:

  • Criar, atualizar, ver, partilhar e eliminar trocas de dados.
  • Criar, atualizar, eliminar e partilhar fichas.
  • Faça a gestão dos administradores, administradores de fichas, publicadores, subscritores e visitantes do Analytics Hub.

Por predefinição, uma troca de dados é privada e apenas os utilizadores ou os grupos que têm acesso a essa troca podem ver ou subscrever os dados. No entanto, se quiser que as fichas sejam descobertas e subscritas por utilizadores (allAuthenticatedUsers), pode pedir para tornar a sua troca de dados pública.Google Cloud

Antes de começar

Para começar a usar a partilha do BigQuery (anteriormente Analytics Hub), tem de ativar a API Analytics Hub no seu Google Cloud projeto.

Autorizações necessárias

Para ativar a API Analytics Hub, precisa das seguintes autorizações de gestão de identidades e acessos (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

A seguinte função de IAM predefinida inclui as autorizações necessárias para ativar a API Analytics Hub:

  • roles/serviceusage.serviceUsageAdmin

Para mais informações sobre as funções de IAM no BigQuery, consulte o artigo Funções e autorizações predefinidas.

Ative a API Analytics Hub

Para ativar a API Analytics Hub, faça o seguinte:

Consola

Aceda à página da API Analytics Hub e ative a API Analytics Hub para o seu projeto. Google Cloud

Ative a API Analytics Hub

gcloud

Execute o comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Autorizações necessárias

Para gerir trocas de dados, tem de ter a função de administrador do Analytics Hub (roles/analyticshub.admin). Para mais informações, consulte o artigo Função de administrador do Analytics Hub. Para saber como conceder esta função a outros utilizadores, consulte o artigo Crie administradores do Analytics Hub.

Crie uma troca de dados

Para criar uma troca de dados, siga estes passos:

Consola

  1. Aceda à página Partilha (Centro de análise).

    Aceda à partilha (Analytics Hub)

  2. Clique em Criar exchange.

  3. Na caixa de diálogo Criar troca, selecione um Projeto e uma Região para a sua troca de dados. Não pode atualizar o projeto e a região depois de criar a troca de dados.

  4. Em Nome a apresentar, introduza um nome para a troca de dados.

  5. Opcional: introduza valores nos seguintes campos:

    • Contacto principal: introduza o URL ou o endereço de email do contacto principal para a troca de dados.
    • Descrição: introduza uma descrição para a troca de dados.

  6. Para registar todos os identificadores principais dos utilizadores que executam tarefas e consultas em conjuntos de dados associados, clique no botão Registo de email do subscritor (Pré-visualização). Quando ativa esta opção, todos os registos na troca de dados têm o registo de email dos subscritores ativado.

  7. Para ativar a deteção pública, clique no botão Deteção pública. Assim que uma troca for publicamente detetável, todas as fichas na troca são apresentadas e pesquisáveis no catálogo. Se ativar a visibilidade pública, tem de configurar as autorizações de troca. Devido à herança de autorizações, todas as fichas são definidas por predefinição com o mesmo tipo de capacidade de descoberta pública da troca. Por conseguinte, as trocas públicas não podem ter fichas privadas, mas as trocas privadas podem ter fichas públicas (por exemplo, pode definir o tipo de capacidade de deteção pública ao nível da ficha individual). O projeto no qual está a criar a troca de dados tem de ter uma organização e uma conta de faturação associadas.

  8. Clique em Criar troca.

  9. Opcional: na secção Autorizações de troca, siga estes passos:

    1. Introduza os endereços de email nos seguintes campos para conceder as funções de utilizador do Analytics Hub:

    2. Para guardar as autorizações, clique em Definir autorizações.

  10. Se não definiu autorizações para a troca de dados, clique em Ignorar.

API

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

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto no qual quer criar a troca de dados.
  • LOCATION: a localização da sua troca de dados. Para mais informações sobre as localizações que suportam a partilha do BigQuery (anteriormente Analytics Hub), consulte o artigo Regiões suportadas.
  • DATAEXCHANGE_ID: o ID da sua troca de dados.

No corpo do pedido, indique os detalhes da troca de dados. Se o pedido for bem-sucedido, o corpo da resposta contém os detalhes da troca de dados. Se ativou o registo de emails de subscritores (Pré-visualização), a resposta de troca de dados contém log_linked_dataset_query_user_email: true.

Para mais informações sobre as tarefas que pode realizar em trocas de dados através de APIs, consulte os métodos projects.locations.dataExchanges.

Atualize uma troca de dados

Para atualizar uma troca de dados, siga estes passos:

Consola

  1. Aceda à página Partilha (Centro de análise).

    Aceda à partilha (Analytics Hub)

  2. Na lista de trocas de dados, clique numa troca de dados que quer atualizar.

  3. Aceda ao separador Detalhes.

  4. Clique em Editar câmbio.

  5. Na caixa de diálogo Editar troca, atualize os seguintes campos:

    • Nome a apresentar
    • Contacto principal
    • Descrição
    • Visibilidade pública
      • Se ativar a capacidade de descoberta pública, conceda a função de leitor (roles/analyticshub.viewer) do centro de análise ao endereço de email allUsers ou allAuthenticatedUsers.
      • Se desativar a capacidade de descoberta pública, remova a função de leitor do Analytics Hub (roles/analyticshub.viewer) de allUsers ou allAuthenticatedUsers. As trocas públicas não podem ter fichas privadas, mas as trocas privadas podem ter fichas públicas.

    • Registo de emails de subscritores (pré-visualização)

  6. Clique em Guardar.

API

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

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

Substitua UPDATEMASK pela lista de campos que quer atualizar. Para atualizar vários valores, use uma lista separada por vírgulas. Por exemplo, para atualizar o nome a apresentar e o contacto principal de uma troca de dados, introduza displayName,primaryContact.

No corpo do pedido, especifique os valores atualizados para os seguintes campos:

  • Nome a apresentar
  • Descrição
  • Documentação
  • Ícone
  • Contacto principal
  • Deteção pública
  • Registo de emails de subscritores (pré-visualização)

Para ver detalhes sobre estes campos, consulte o recurso: DataExchange.

Para mais informações sobre as tarefas que pode realizar em trocas de dados através de APIs, consulte os métodos projects.locations.dataExchanges.

Veja as trocas de dados

Para ver as trocas de dados no seu projeto ou organização aos quais tem acesso, siga estes passos:

Consola

  1. Aceda à página Partilha (Centro de análise).

    Aceda à partilha (Analytics Hub)

  2. Veja a lista de trocas de dados no seu Google Cloud projeto. Se tiver a autorização resourcemanager.organizations.get, também pode ver a lista de trocas de dados na sua Google Cloud organização.

API

Para ver as trocas de dados no seu projeto, use o método projects.locations.dataExchanges.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto.
  • LOCATION: a localização para a qual quer listar as trocas de dados existentes.

Para ver as trocas de dados na sua organização, use o organizations.locations.dataExchanges.list método:

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

Substitua o seguinte:

  • ORGANIZATION_ID: o ID da organização. Para mais informações, consulte o artigo Obtenha o ID da sua organização.
  • LOCATION: a localização para a qual quer listar as trocas de dados existentes.

Partilhe uma troca de dados

Se o publicador do Analytics Hub pertencer a uma organização diferente da organização que contém a troca de dados, o publicador não pode ver a sua troca de dados em Partilha. Tem de partilhar um link para a troca de dados com o publicador.

  1. Aceda à página Partilha (Centro de análise).

    Aceda à partilha (Analytics Hub)

  2. Na lista de trocas de dados, clique em Mais opções.

  3. Clique em Copiar link de partilha.

Conceda aos utilizadores acesso a uma troca de dados

Para conceder aos utilizadores acesso a uma troca de dados, tem de definir a política de IAM para essa troca de dados. Para ver informações sobre as funções de utilizador do IAM predefinidas, consulte o artigo Funções de utilizador do Analytics Hub. Para o fazer, siga estes passos:

Consola

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

    Aceda à partilha (Analytics Hub)

  2. Clique no nome da troca de dados para a qual quer definir autorizações.

  3. Aceda ao separador Detalhes.

  4. Clique em Definir autorizações.

  5. Para adicionar diretores, clique em Adicionar diretor.

  6. No campo Novos responsáveis, adicione os IDs de email aos quais quer conceder acesso. Também pode usar allUsers para tornar um recurso público e acessível a todos na Internet ou allAuthenticatedUsers para o tornar acessível apenas a utilizadores do Google com sessão iniciada.

  7. No menu Selecionar uma função, selecione Analytics Hub e, de seguida, selecione uma das seguintes funções de gestão de identidades e acessos (IAM):

    • Administrador do Analytics Hub
    • Administrador da ficha do Analytics Hub
    • Editor do Analytics Hub
    • Subscritor do Analytics Hub
    • Proprietário da subscrição do Analytics Hub
    • Visualizador do Analytics Hub

  8. Clique em Guardar.

API

  1. Leia a política existente com o método getIamPolicy através do método projects.locations.dataExchanges.getIamPolicy:

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

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto, por exemplo, my-project-1.
    • LOCATION: a localização da sua troca de dados. Use letras minúsculas.
    • DATAEXCHANGE_ID: o ID da troca de dados.

    A partilha do BigQuery (anteriormente Analytics Hub) devolve a política atual.

  2. Para adicionar ou remover membros e as respetivas funções de gestão de identidade e acesso (IAM) associadas, 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 a função roles/analyticshub.subscriber a group:subscribers@example.com, adicione a seguinte associação à política:

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

  3. Escreva a política atualizada através do método projects.locations.dataExchanges.setIamPolicy. No corpo do pedido, indique a política de IAM atualizada do passo anterior.

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

    No corpo do pedido, indique os detalhes da ficha. Se o pedido for bem-sucedido, o corpo da resposta contém detalhes da ficha.

Crie administradores do Analytics Hub

Para gerir trocas de dados, tem de criar administradores do Analytics Hub. Para criar administradores de trocas, tem de conceder aos utilizadores a função de administrador do Analytics Hub (roles/analyticshub.admin) ao nível do projeto ou da troca de dados.

Se quiser que os administradores geram todas as trocas de dados num projeto, conceda a função de administrador do Analytics Hub para esse projeto. Se quiser que os administradores façam a gestão de uma troca de dados específica, conceda a função de administrador do Analytics Hub para essa troca de dados.

Torne uma troca de dados pública

Por predefinição, uma troca de dados é privada e apenas os utilizadores ou os grupos que têm acesso a essa troca podem ver ou subscrever as respetivas fichas. No entanto, pode optar por tornar uma troca de dados pública. As fichas em trocas de dados públicas podem ser descobertas e subscritas por Google Cloud utilizadores (allAuthenticatedUsers).

Para tornar uma troca de dados pública, siga estes passos:

  1. Para permitir que allAuthenticatedUsers veja fichas, tem de lhe conceder a função de leitor do Analytics Hub ao nível da troca de dados.

  2. Para permitir que allAuthenticatedUsers subscreva fichas, tem de lhe conceder a função de subscritor do Analytics Hub ao nível da troca de dados.

  3. Ative a capacidade de deteção pública quando criar ou atualizar uma troca de dados. Especifique as autorizações adequadas quando tornar uma troca de dados pública.

Elimine uma troca de dados

Quando uma troca de dados é eliminada, todas as fichas na mesma também são eliminadas. No entanto, os conjuntos de dados partilhados e os conjuntos de dados associados não são eliminados. Além disso, quando um projeto é eliminado, as trocas de dados no mesmo não são eliminadas. Tem de eliminar estas trocas de dados antes de eliminar o projeto. Se eliminar uma troca de dados, não pode anular a ação.

Antes de eliminar uma troca de dados, tem de realizar os seguintes passos com base na configuração da troca de dados:

Para eliminar uma troca de dados, siga estes passos:

Consola

  1. Aceda à página Partilha (Centro de análise).

    Aceda à partilha (Analytics Hub)

  2. Na lista de trocas de dados, clique na troca de dados que quer eliminar.

  3. Aceda ao separador Detalhes.

  4. Clique em Eliminar troca.

  5. Na caixa de diálogo Eliminar troca?, confirme a eliminação escrevendo eliminar.

  6. Clique em Eliminar.

API

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

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

Para mais informações sobre as tarefas que pode realizar em trocas de dados através de APIs, consulte os métodos projects.locations.dataExchanges.

O que se segue?