Partilhar via

Google BigQuery (ID do Microsoft Entra)

  • Artigo

Resumo

Item Description
Estado de Lançamento Disponibilidade Geral
Produtos suportados Power BI (modelos semânticos)
Power BI (Fluxos de Dados)
Malha (Dataflow Gen2)
Power Apps (Fluxos de Dados)
Tipos de autenticação suportados Conta Institucional

Nota

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Pré-requisitos

Você precisa de uma conta do Microsoft Entra ID para fazer login no Google BigQuery (Microsoft Entra ID).

Capacidades suportadas

  • Importar
  • DirectQuery (modelos semânticos do Power BI)

Ligar a dados do Google BigQuery (Microsoft Entra ID) a partir do Power Query Desktop

Para ligar ao Google BigQuery (Microsoft Entra ID) a partir do Power Query Desktop, siga os seguintes passos:

  1. Na experiência Obter dados, pesquise e selecione Google BigQuery (Microsoft Entra ID). Para obter mais informações: Onde obter dados

    Captura de tela com a caixa de diálogo Obter dados, com ênfase no conector do Google BigQuery (Microsoft Entra ID).

  2. Especifique uma ID de projeto de faturamento, que é necessária para o uso desse conector. Se quiser usar opções avançadas, selecione Opções avançadas. Caso contrário, selecione Importar ou DirectQuery e, em seguida, selecione OK para continuar. Para obter mais informações: Conectar-se usando opções avançadas

    Captura de ecrã da caixa de diálogo Google BigQuery (Microsoft Entra ID), onde introduz o ID do seu projeto de faturação, seleciona Importar ou DirectQuery e, opcionalmente, seleciona opções avançadas.

  3. O conector do Google BigQuery (Microsoft Entra ID) suporta a conexão por meio de uma conta do Microsoft Entra ID. Selecione Entrar para continuar.

    Captura de ecrã da caixa de diálogo de autenticação, indicando que não tem sessão iniciada no momento.

  4. Depois de entrar, selecione Conectar para continuar.

    Captura de ecrã da caixa de diálogo de autenticação depois de iniciar sessão.

  5. Depois de se conectar com êxito, uma janela Navegador aparece e exibe os dados disponíveis no servidor. Selecione os seus dados no navegador. Em seguida, selecione Transformar Dados para transformar os dados no Power Query ou Carregar para carregar os dados no Power BI Desktop.

Ligar a dados do Google BigQuery (Microsoft Entra ID) a partir do Power Query Online

Para ligar ao Google BigQuery (Microsoft Entra ID) a partir do Power Query Online, siga os seguintes passos:

  1. Na experiência Obter dados, faça uma pesquisa pelo Google e selecione Google BigQuery (ID do Microsoft Entra). Para obter mais informações: Onde obter dados

    Captura de tela da caixa de diálogo Escolher fonte de dados com o conector do Google BigQuery (Microsoft Entra ID) enfatizado.

  2. Na caixa de diálogo Google BigQuery (Microsoft Entra ID), talvez seja necessário criar uma nova conexão ou selecionar uma conexão existente. Se estiver a criar uma nova ligação, introduza o ID do Projeto de Faturação. Se você estiver usando dados locais, selecione um gateway de dados local.

    Captura de tela da caixa de diálogo Conectar à fonte de dados onde você insere suas configurações de conexão e credenciais do Google BigQuery (Microsoft Entra ID).

  3. Se quiser usar opções avançadas, selecione Opções avançadas. Para obter mais informações: Conectar-se usando opções avançadas

  4. Depois de entrar, selecione Avançar para continuar.

  5. Depois de se conectar com êxito, uma janela Navegador aparece e exibe os dados disponíveis no servidor. Selecione os seus dados no navegador. Em seguida, selecione Seguinte para transformar os dados no Power Query.

Conecte-se usando opções avançadas

Tanto o Power Query Desktop como o Power Query Online fornecem um conjunto de opções avançadas que pode adicionar à sua consulta, se necessário.

A tabela seguinte lista todas as opções avançadas que pode definir no Power Query Desktop e no Power Query Online.

Opção avançada Description
Usar a API de armazenamento Um sinalizador que permite usar a API de armazenamento do Google BigQuery. Esta opção é verdadeira por padrão. Essa opção pode ser definida como false para não usar a API de armazenamento e usar APIs REST.
Duração do tempo limite de conexão A definição de ligação padrão (em segundos) que controla quanto tempo o Power Query aguarda pela conclusão de uma ligação. Você pode alterar esse valor se a conexão não for concluída antes de 15 segundos (o valor padrão).
Duração do tempo limite do comando Quanto tempo o Power Query aguarda para que uma consulta seja concluída e devolva resultados. O padrão depende do padrão do driver. Você pode inserir outro valor em minutos para manter a conexão aberta por mais tempo.
Público Uri O URI que contém o ID> do <pool de força de trabalho que deve ser alterado para o nome do pool de força de trabalho usado ao configurar a configuração do OIDC. O formato para o valor Uri de audiência é //iam.googleapis.com/locations/global/workforcePools/<workforce pool ID>/providers/azuread. O valor padrão para a ID> do pool de força de trabalho é powerquery-<TenantId>, onde <TenantId> é sua ID de locatário atual do <Power BI. Se você atualizar o Uri de audiência, a cadeia de caracteres inserida será usada como está.
ID do Projeto O projeto no qual você deseja executar consultas nativas. Esta opção só está disponível no Power Query Desktop.
Consulta nativa Para obter informações, vá para Importar dados de um banco de dados usando consulta de banco de dados nativa. Nesta versão da funcionalidade de consulta de banco de dados nativo, você precisa usar nomes de tabela totalmente qualificados no formato Database.Schema.Table, por exemplo SELECT * FROM DEMO_DB.PUBLIC.DEMO_TABLE. Esta opção só está disponível no Power Query Desktop.

Depois de selecionar as opções avançadas necessárias, selecione OK no Power Query Desktop ou Avançar no Power Query Online para se conectar aos seus dados do Google BigQuery.

Limitações e considerações

Esta seção descreve quaisquer limitações ou considerações do conector do Google BigQuery (Microsoft Entra ID).

Configurações OIDC

O conector Google BigQuery (Microsoft Entra ID) utiliza tokens JWT do Microsoft Entra ID para conectar a autenticação baseada no Microsoft Entra ID com o recurso Workforce Federation do Google. Portanto, a configuração no lado da autenticação deve ser uma configuração baseada em OIDC para se alinhar com os tokens JWT do Microsoft Entra ID. Entre em contato com seu ponto de contato do Google BigQuery para obter mais informações sobre autenticação, configuração e suporte no lado do Google.

Ligar ao Google BigQuery (ID do Microsoft Entra) no Power BI Desktop

Há alguns limites e considerações a ter em mente ao usar o conector do Google BigQuery com o Power BI.

Campos aninhados

Para otimizar as considerações de desempenho, o Google BigQuery se sai bem com grandes conjuntos de dados quando desnormalizados, nivelados e aninhados.

O conector do Google BigQuery (Microsoft Entra ID) suporta campos aninhados, que são carregados como colunas de texto no formato JSON.

Captura de ecrã do suporte de campos aninhados do Google BigQuery.

Os utilizadores devem selecionar Transformar Dados e, em seguida, utilizar as capacidades de análise JSON no editor do Power Query para extrair os dados.

  1. Na guia da faixa de opções Transforma, a categoria Coluna de Texto, selecione Analisar e, em seguida, JSON.
  2. Extraia os campos de registro JSON usando a opção Expandir coluna .

Não é possível autenticar com a API de armazenamento do Google BigQuery

O conector do Google BigQuery (Microsoft Entra ID) usa a API de armazenamento do Google BigQuery por padrão. Esse recurso é controlado pela opção avançada chamada UseStorageApi. Você pode encontrar problemas com esse recurso se usar permissões granulares. Nesse cenário, você pode ver a seguinte mensagem de erro ou não conseguir obter quaisquer dados da sua consulta:

ERROR [HY000] [Microsoft][BigQuery] (131) Unable to authenticate with Google BigQuery Storage API. Check your account permissions

Você pode resolver esse problema ajustando as permissões de usuário para a API de armazenamento do BigQuery corretamente. Essas permissões de API de armazenamento são necessárias para acessar os dados corretamente com a API do BigQueryStorage:

  • bigquery.readsessions.create: Cria uma nova sessão de leitura por meio da API de armazenamento do BigQuery.
  • bigquery.readsessions.getData: Lê dados de uma sessão de leitura por meio da API de armazenamento do BigQuery.
  • bigquery.readsessions.update: Atualiza uma sessão de leitura por meio da API de armazenamento do BigQuery.

Essas permissões normalmente são fornecidas na BigQuery.User função. Para obter mais informações, Funções e permissões predefinidas do Google BigQuery

Se as etapas acima não resolverem o problema, você poderá desabilitar a API de armazenamento do BigQuery.

Não é possível usar dados do tipo DateTime no modo DirectQuery

Há um problema conhecido em que o tipo DateTime não é suportado pelo DirectQuery. Selecionar uma coluna com o tipo DateTime causa um erro "Consulta inválida" ou um erro visual.

Ativar o logon único (SSO) do Microsoft Entra ID para o Google BigQuery

Suportamos o SSO do Microsoft Entra ID através do Serviço Power BI (nuvem) e também através do gateway de dados local. Para obter mais informações sobre como habilitar o SSO do Microsoft Entra ID para todos os conectores, vá para Visão geral do logon único (SSO) para gateways de dados locais no Power BI. Confirme diretamente com seu contato do Google se seu sistema e contas estão configurados corretamente para o SSO do Microsoft Entra ID antes de tentar se conectar no Power BI.

Logon único (SSO) do Microsoft Entra ID por meio do serviço Power BI

Para configurar uma nova conexão no serviço do Power BI:

  1. No serviço Power BI, selecione Portal de administração na lista de configurações.

    Captura de tela do menu de configurações aberto, com o portal de administração enfatizado.

  2. Ative a opção SSO do Google BigQuery.

    Captura de ecrã da opção SSO do Google BigQuery com o botão Ativado ativado.

Logon único (SSO) do Microsoft Entra ID para o Google BigQuery com um gateway de dados local

Antes de habilitar o SSO do ID do Microsoft Entra para o Google BigQuery, você deve primeiro habilitar o SSO do ID do Microsoft Entra para todas as fontes de dados que suportam o SSO do ID do Microsoft Entra com um gateway de dados local. Além disso, certifique-se de ter atualizado para pelo menos a versão de dezembro de 2022 do gateway de dados local:

  1. No serviço Power BI, selecione Portal de administração na lista de configurações.

    Outra captura de tela do menu Configurações com o portal de administração enfatizado.

  2. Em Configurações de integração, habilite o logon único (SSO) do Azure AD para Gateway.

Depois de ativar o SSO do Microsoft Entra ID para todas as fontes de dados, habilite o SSO do Microsoft Entra ID para o Google BigQuery:

  1. Ative a opção SSO do Google BigQuery.

  2. Selecione Gerenciar gateways na lista de configurações.

    Captura de tela do menu Configurações com Gerenciar gateways enfatizado.

  3. Selecione um gateway e, em seguida, selecione Escolher fonte de dados.

  4. Na guia Configurações da Fonte de Dados, insira um valor em ID do Projeto de Faturamento. O parâmetro Billing Project ID é necessário ao usar o Microsoft Entra ID e precisa ser especificado em Configurações avançadas. Além disso, selecione Usar SSO via Azure AD para consultas DirectQuery.