Google BigQuery

Visão geral

Nesta página, explicamos como configurar uma conexão no Looker com o SQL padrão do Google BigQuery ou o SQL legado do Google BigQuery.

As etapas gerais para configurar uma conexão do SQL padrão do Google BigQuery ou do SQL legado do Google BigQuery são as seguintes:

  1. No banco de dados do BigQuery, configure a autenticação que o Looker vai usar para acessar esse banco de dados. O Looker oferece suporte às seguintes opções de autenticação para BigQuery:

  2. No banco de dados do BigQuery, se você quiser usar tabelas derivadas persistentes (PDTs) na conexão, crie um conjunto de dados temporário que o Looker possa usar para gerar PDTs no seu banco de dados. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas persistentes nesta página para saber o procedimento.

  3. No Looker, configure a conexão do Looker com o banco de dados do BigQuery. Consulte a seção Como conectar o Looker ao BigQuery nesta página para ver o procedimento.

  4. No Looker, teste a conexão entre o Looker e seu banco de dados do BigQuery. Consulte a seção Como testar a conexão nesta página para ver o procedimento.

Como criptografar o tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo Looker e seu banco de dados. Considere uma das opções descritas na página de documentação Como ativar o acesso seguro ao banco de dados.

Autenticação com contas de serviço do BigQuery

Uma maneira de autenticar o Looker no banco de dados do BigQuery é com uma conta de serviço do BigQuery. Para criar a conta de serviço no banco de dados do BigQuery, use o Gerenciador de APIs no console do Google Cloud. Você precisa ter permissões de administrador do Google Cloud para criar a conta de serviço. Consulte a documentação sobre como criar uma conta de serviço e gerar uma chave privada.

Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON

Para criar uma conta de serviço do BigQuery, siga estas etapas:

  1. Abra a página de credenciais no Gerenciador de APIs no console do Google Cloud e selecione seu projeto.

  2. Selecione CRIAR CREDENCIAIS e escolha Conta de serviço.

  3. Digite um nome para a nova conta de serviço e, se quiser, adicione uma descrição. Depois, selecione CRIAR E CONTINUAR.

  4. A conta de serviço requer dois papéis predefinidos do Google BigQuery:

    • BigQuery > Editor de dados do BigQuery
    • BigQuery > Usuário de jobs do BigQuery

    Selecione o primeiro papel no campo Selecionar um papel, clique em ADICIONAR OUTRO PAPEL e selecione o segundo papel.

    Depois, selecione CONTINUAR e depois CONCLUÍDO.

  5. Na página Credenciais, selecione a nova conta de serviço:

  6. Selecione CHAVES e ADICIONAR CHAVE. Em seguida, no menu suspenso, selecione Criar nova chave:

  7. Selecione JSON em Tipo de chave e depois CRIAR:

  8. A chave JSON será salva no seu computador.

    Depois de observar o local do download, selecione FECHAR:

  9. Selecione CONCLUÍDO.

  10. Encontre o endereço de e-mail que corresponde à conta de serviço. Você vai precisar deste endereço para configurar a conexão do Looker com o BigQuery:

  11. Depois de criar a conta de serviço no banco de dados do BigQuery, insira as informações dela e os detalhes do arquivo de certificado nos campos E-mail da conta de serviço, Arquivo JSON/P12 da conta de serviço e Senha da janela Conexões do Looker ao configurar a conexão do Looker com o BigQuery.

Autenticação com OAuth

O Looker oferece suporte ao OAuth para conexões do Google BigQuery. Isso significa que cada usuário do Looker se autentica no Google com as próprias credenciais do OAuth e autoriza o acesso ao banco de dados.

O OAuth permite que os administradores de bancos de dados executem as seguintes funções:

  • Audite quais usuários do Looker estão executando consultas no banco de dados.
  • Aplique controles de acesso com base em funções usando as permissões do Google.
  • Use tokens OAuth para todos os processos e ações que acessam o Google BigQuery, em vez de incorporar IDs e senhas do BigQuery em vários locais.

Observe o seguinte para conexões do BigQuery com o OAuth:

  • Se um administrador de banco de dados alterar as credenciais do cliente OAuth do BigQuery, as programações ou os alertas de um usuário serão afetados. Os usuários precisarão fazer login novamente se o administrador alterar as credenciais de OAuth do BigQuery. Os usuários também podem acessar a página Conta do Looker na página do perfil de usuário para fazer login no Google.
  • Como as conexões do BigQuery que usam OAuth são "por usuário", as políticas de armazenamento em cache também são por usuário e não apenas por consulta. Isso significa que, em vez de usar resultados armazenados em cache sempre que a mesma consulta for executada no período de armazenamento em cache, o Looker usará os resultados armazenados em cache somente se o mesmo usuário tiver executado a mesma consulta nesse período. Para mais informações sobre o armazenamento em cache, consulte a página de documentação Consultas de armazenamento em cache.
  • Se você quiser usar tabelas derivadas persistentes (PDTs, na sigla em inglês) em uma conexão do BigQuery com o OAuth, crie outra conta de serviço para que o Looker acesse o banco de dados para processos de TDP. Consulte a seção Tabelas derivadas persistentes em uma conexão do BigQuery nesta página para mais informações.
  • Ao executar o sudo como outro usuário, os administradores usam o token de autorização OAuth desse usuário. Consulte a página de documentação Usuários para informações sobre como usar o comando sudo.

Como configurar um projeto de banco de dados do BigQuery para OAuth

As seções a seguir descrevem como gerar credenciais do OAuth e como configurar uma tela de permissão OAuth. Se você já configurou uma tela de permissão OAuth para outro aplicativo no projeto, não será necessário criar outra. Configure apenas uma tela de consentimento para todos os aplicativos em um projeto.

As credenciais e a tela de permissão OAuth precisam ser configuradas no console do Google Cloud. A descrição genérica do Google está no site de suporte do Google Cloud e no site do console do Google Dev.

Dependendo do tipo de usuário que acessa os dados do BigQuery no Looker e se os dados do BigQuery são públicos ou particulares, o OAuth pode não ser o método de autenticação mais adequado. Da mesma forma, o tipo de dados solicitados pelo usuário e o grau de acesso necessário aos dados dele durante a autenticação no Google para usar o Looker também podem exigir uma verificação do Google. Saiba mais sobre a verificação na seção Como gerar credenciais do Google OAuth nesta página.

Como gerar credenciais do Google OAuth

  1. Acesse o Console do Google Cloud.

  2. No menu suspenso Selecionar um projeto, navegue até o projeto do BigQuery. Isso levará você ao painel do projeto.

  3. No menu à esquerda, selecione a página APIs e serviços. Em seguida, selecione Credenciais. Na página Credenciais, selecione a seta para baixo no botão Criar credenciais e escolha ID do cliente OAuth no menu suspenso:

  4. O Google exige que você configure uma tela de permissão OAuth, que permite que os usuários escolham como conceder acesso aos dados particulares deles antes de gerar suas credenciais do OAuth. Para configurar sua tela de permissão OAuth, consulte a seção Configurar uma tela de permissão OAuth nesta página.

  5. Se você já tiver configurado uma tela de permissão OAuth, o Google vai mostrar a página Criar ID do cliente OAuth, que permite criar um ID e um secret do cliente OAuth para usar na conexão do BigQuery com o Looker. Na lista suspensa Tipo de aplicativo, selecione Aplicativo da Web. A página será expandida e exibirá mais opções:

  6. No campo Nome, insira um nome para o app, como Looker.

  7. Na seção Origens JavaScript autorizadas, selecione + ADICIONAR URI para mostrar o campo URIs 1. No campo URIs 1, insira o URL da instância do Looker, incluindo o https://. Exemplo:

    • Se o Looker hospedar sua instância: https://<instancename>.looker.com
    • Se você tiver uma instância do Looker hospedada pelo cliente: https://looker.<mycompany>.com
    • Se a instância do Looker exigir um número de porta: https://looker.<mycompany>.com:9999

  8. Na seção URIs de redirecionamento autorizados, selecione + ADICIONAR URI para exibir o campo URIs 1. No campo URIs 1, insira o URL da sua instância do Looker seguido de /external_oauth/redirect. Por exemplo: https://<instancename>.looker.com/external_oauth/redirect ou https://looker.<mycompany>.com:9999/external_oauth/redirect.

  9. Selecione Criar. O Google exibe o ID do cliente e a chave secreta do cliente.

  10. Copie o ID e os valores da chave secreta do cliente. Você vai precisar deles para configurar o OAuth para a conexão do BigQuery no Looker.

O Google exige que você configure uma tela de consentimento OAuth. Ela permite que os usuários escolham como conceder acesso aos dados particulares deles e fornece um link para os Termos de Serviço e a Política de Privacidade da sua organização.

No menu à esquerda, selecione a página Tela de consentimento OAuth. Antes de configurar sua tela de permissão OAuth, escolha o tipo de usuário para quem o aplicativo será disponibilizado. Dependendo da sua seleção, o app pode exigir uma verificação do Google.

Escolha uma opção e clique em Criar. O Google exibirá a página Tela de consentimento OAuth. Você pode configurar essa tela para todos os aplicativos no seu projeto, inclusive os internos e públicos.

O Google verificará os aplicativos públicos se uma das seguintes condições for verdadeira:

  • O aplicativo usa APIs do Google com escopos restritos ou confidenciais.
  • A tela de consentimento do OAuth inclui um logotipo do aplicativo.
  • O projeto excedeu o limite de domínio.

Faça o seguinte para configurar a tela de permissão OAuth:

  1. No campo Nome do app, insira o nome do aplicativo que vai receber o acesso do usuário (neste caso, o Looker).

  2. No campo E-mail para suporte do usuário, insira o e-mail de suporte com o qual os usuários devem entrar em contato em caso de problemas de login ou consentimento.

  3. Selecione ADICIONAR DOMÍNIO para exibir o campo Domínio autorizado 1. Nesse campo, insira o domínio do URL da sua instância do Looker. Por exemplo, se o Looker hospeda a instância em https://<instance_name>.cloud.looker.com, o domínio é cloud.looker.com. Para implantações do Looker hospedadas pelo cliente, insira o domínio em que você hospeda o Looker.

  4. Na seção Dados de contato do desenvolvedor, insira um ou mais endereços de e-mail que o Google possa usar para entrar em contato com você sobre seu projeto.

    Os campos restantes são opcionais, mas você pode usá-los para personalizar ainda mais sua tela de consentimento.

  5. Selecione SALVAR E CONTINUAR.

  6. O Google exibe a página Escopos, em que é possível configurar escopos. O Looker exige apenas os escopos padrão, portanto, nenhuma outra configuração de escopo é necessária. Selecione SALVAR E CONTINUAR.

  7. Na página Resumo, selecione VOLTAR AO PAINEL.

Agora é possível continuar o procedimento para gerar suas credenciais do OAuth.

Para mais informações sobre como configurar a tela de consentimento do OAuth do Google, consulte a documentação de suporte do Google.

Como configurar a conexão do Looker para BigQuery com o OAuth

Para ativar o OAuth na sua conexão do BigQuery, selecione a opção OAuth na página Conexão do Looker quando estiver configurando a conexão do Looker com o BigQuery. Quando você ativa a opção OAuth, o Looker mostra os campos ID do cliente OAuth e Chave secreta do cliente OAuth. Cole os valores de ID do cliente e Chave secreta do cliente que você recebeu em uma etapa do procedimento Como gerar credenciais do Google OAuth nesta página.

Como os usuários do Looker se autenticam no BigQuery com o OAuth

Depois que a conexão do Looker com o BigQuery estiver configurada para OAuth, os usuários poderão usar o Looker para fazer a autenticação inicial no banco de dados do BigQuery seguindo um destes procedimentos:

Como autenticar uma consulta no Google

Depois que a conexão do Looker com o BigQuery for configurada para OAuth, o Looker vai solicitar que os usuários façam login com a Conta do Google antes de executar consultas que usam a conexão do BigQuery. O Looker mostra esse comando de Análises, dashboards, Looks e SQL Runner.

O usuário precisa selecionar Fazer login e autenticar com OAuth. Depois de se autenticar no BigQuery, o usuário pode selecionar o botão Executar em "Análise", e o Looker vai carregar os dados nela.

Como autenticar no Google usando a página da conta de usuário

Depois que a conexão do Looker com o BigQuery estiver configurada para OAuth, um usuário poderá fazer a autenticação na Conta do Google pela página da conta de usuário do Looker:

  1. No Looker, selecione o ícone do perfil e escolha Conta no menu do usuário.
  2. Acesse a seção Credenciais de conexão OAuth e selecione o botão Fazer login na conexão adequada do banco de dados do BigQuery.
  3. Selecione a conta apropriada na página Fazer login com o Google.
  4. Selecione Permitir na tela de consentimento do OAuth para que o Looker acesse e gerencie seus dados no Google BigQuery.

Depois de fazer login no Google com o Looker, você pode sair ou autorizar novamente suas credenciais a qualquer momento na página Conta, conforme descrito na página de documentação Como personalizar sua conta de usuário. Embora os tokens do Google BigQuery não expirem, um usuário pode selecionar Reautorizar para fazer login com uma Conta do Google diferente.

Revogação de tokens OAuth

Os usuários podem revoke o acesso de aplicativos como o Looker à Conta do Google nas configurações da conta.

Os tokens do Google BigQuery não expiram. No entanto, se um administrador de banco de dados alterar as credenciais OAuth da conexão do banco de dados de forma a invalidar as credenciais existentes, os usuários terão que fazer login com a Conta do Google novamente antes de executar consultas que usem essa conexão.

Tabelas derivadas persistentes em uma conexão do BigQuery

Se você quiser usar tabelas derivadas persistentes (PDTs, na sigla em inglês) para sua conexão com o BigQuery, talvez seja necessário fazer o seguinte, dependendo da sua configuração de conexão:

  • Use o console do Google Cloud para criar um conjunto de dados temporário no seu banco de dados do BigQuery que o Looker possa usar para gravar PDTs. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas persistentes nesta página para ver o procedimento. Essa etapa é necessária para TDPs, independentemente das outras opções de configuração na conexão.
  • Use o Gerenciador de APIs no console do Google Cloud para criar uma conta de serviço separada para os processos de TDP do Looker. Consulte a seção Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON nesta página para ver o procedimento. O tipo de autenticação na sua conexão afeta a necessidade de uma conta de serviço de PDT e também onde você insere as informações da conta de serviço de PDT na janela Conexões do Looker ao configurar a conexão do Looker com o BigQuery:
    • Se a conexão usa o OAuth para a autenticação do usuário, é preciso criar uma conta de serviço separada para os processos de TDP. Insira as informações da conta de serviço e os detalhes do arquivo de certificado na seção Substituição de PDT da janela Conexões do Looker. A janela Conexões do Looker mostra a seção Substituição de PDT automaticamente quando você ativa a opção Ativar PDTs para uma conexão que também está configurada com a opção OAuth no campo Autenticação. Consulte a seção Como ativar PDTs para conexões do Looker com o BigQuery com o OAuth para mais informações.
    • Se a conexão usar contas de serviço para autenticação de usuários, você terá a opção de criar uma conta de serviço separada para os processos de TDP. Se você tiver uma conta de serviço de PDT separada, insira as informações dela na seção Substituições de PDT dos campos E-mail da conta de serviço, Arquivo JSON/P12 da conta de serviço e Senha da janela Conexões do Looker. A seção Substituições de TDP aparece quando você ativa o botão Ativar PDTs para uma conexão do Looker com o BigQuery usando a autenticação da conta de serviço.

Como criar um conjunto de dados temporário para tabelas derivadas persistentes

Para ativar as tabelas derivadas permanentes (PDTs) na sua conexão do BigQuery, ative a opção Ativar PDTs na página Conexão do Looker ao configurar a conexão do Looker com o BigQuery. Quando você ativa as PDTs, o Looker mostra o campo Conjunto de dados temporários. Nesse campo, insira o nome do conjunto de dados que o Looker pode usar para criar PDTs. Você precisa configurar esse banco de dados ou esquema com antecedência, com as permissões de gravação apropriadas.

É possível configurar um conjunto de dados temporário usando o console do Google Cloud:

  1. Abra o console do Google Cloud e selecione seu projeto.

  2. Selecione o menu de três pontos e, em seguida, Criar conjunto de dados.

  3. Digite o ID do conjunto de dados (normalmente looker_scratch) e selecione a solução de gerenciamento de chaves de criptografia, como Local dos dados (opcional), Expiração da tabela padrão. Selecione CRIAR CONJUNTO DE DADOS para concluir.

Agora que você criou o conjunto de dados, especifique o nome dele no campo Conjunto de dados temporário da janela Conexões do Looker ao configurar a conexão do Looker com o BigQuery.

Como ativar TDPs para conexões do Looker com o BigQuery usando o OAuth

Nas conexões do BigQuery que usam o OAuth, os usuários fazem a autenticação no Looker com as credenciais do OAuth. O Looker oferece suporte a TDPs para conexões do BigQuery com OAuth, mas o próprio Looker não pode usar OAuth. Portanto, é necessário configurar uma conta de serviço do BigQuery especificamente para permitir que o Looker acesse seu banco de dados para processos de TDP.

Configure uma conta de serviço de TDP no banco de dados do BigQuery usando o Gerenciador de APIs do Google Cloud. Consulte a seção Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON nesta página.

Depois de criar a conta de serviço no banco de dados do BigQuery, insira as informações dela e os detalhes do arquivo de certificado na seção Substituições de PDT da janela Conexões do Looker ao configurar a conexão do Looker com o BigQuery. A janela Conexões do Looker mostra a seção Substituição de PDT automaticamente quando você ativa a opção Ativar PDTs para uma conexão que também está configurada com a opção OAuth no campo Autenticação. Na seção Substituições de TDP, use os seguintes campos para inserir as informações da conta de serviço que o Looker pode usar para processos de TDP no banco de dados:

  • Upload de p12 ou json: use o botão Fazer upload de arquivo para fazer upload do arquivo de certificado da conta de serviço do BigQuery que você quer usar para os processos de PDT na conexão. É possível acessar esse arquivo no Gerenciador de APIs do Google Cloud como uma etapa do procedimento Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON.
  • : esse campo se aplica somente se você fizer upload de um arquivo P12 no campo Upload de p12 ou json da seção Substituições de PDT. Insira o endereço de e-mail da conta de serviço do BigQuery que você quer usar para os processos de TDP na conexão. É possível gerar esse endereço de e-mail no Gerenciador de APIs do Google Cloud como uma etapa do procedimento Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON.
  • : esse campo se aplica somente se você fizer upload de um arquivo P12 no campo Fazer upload de p12 ou json da seção Substituições de PDT. Digite a senha do arquivo de credenciais .p12 da conta de serviço do BigQuery que você quer usar para os processos de TDP na conexão.

Como conectar o Looker ao BigQuery

Na seção Administrador do Looker, selecione Conexões para abrir a página Conexões. Em seguida, siga um destes procedimentos:

  • Para criar uma nova conexão, selecione o botão Adicionar conexão.
  • Para editar uma conexão, localize-a na tabela Bancos de dados e selecione o botão Editar na lista da conexão.

Preencher os detalhes de conexão. A maioria dessas configurações é comum à maioria dos dialetos de banco de dados e está descrita na página de documentação Como conectar o Looker ao banco de dados. As configurações abaixo são mencionadas para destacá-las ou para esclarecer como elas se aplicam especificamente às conexões do BigQuery:

  • Dialeto: selecione SQL padrão do Google BigQuery ou SQL legado do Google BigQuery.

  • ID do projeto de faturamento: o nome do projeto de faturamento do Google Cloud. O projeto de faturamento é o projeto do Google Cloud que é faturado, mas ainda é possível consultar conjuntos de dados em outro projeto do Google Cloud se os desenvolvedores do LookML especificarem nomes de tabelas com escopo completo no parâmetro sql_table_name das visualizações, Análises ou mesclagens do LookML. No BigQuery, um nome de tabela com escopo completo usa o formato <project_name>.<dataset_name>.<table_name>. Sem uma referência de escopo completo, o BigQuery procura a tabela no projeto de faturamento e no conjunto de dados especificados na página Conexões do Looker para a conexão do BigQuery com o Looker. Consulte a documentação do BigQuery para uma explicação sobre a hierarquia de recursos nesse produto.

  • o nome do conjunto de dados que você quer que o Looker use como padrão ao consultar seu banco de dados. O conjunto de dados padrão precisa estar no projeto de faturamento especificado para a conexão. Não é possível inserir um valor como project_name.dataset_name no campo Database para especificar um conjunto de dados em um projeto diferente.

    Seu projeto do LookML pode acessar tabelas em outros conjuntos de dados, incluindo tabelas em conjuntos de dados públicos, se os desenvolvedores do LookML especificarem nomes de tabelas com escopo completo no parâmetro sql_table_name das visualizações, Análises ou mesclagens do LookML. No BigQuery, um nome de tabela com escopo completo usa o formato <project_name>.<dataset_name>.<table_name>. Para consultar uma tabela em outro conjunto de dados, ela precisa ser acessível pela conta de serviço (para conexões que usam a autenticação da conta de serviço) ou pelo usuário que executa a consulta (para conexões que usam a autenticação OAuth). Se o código do LookML não especificar nomes de tabelas com escopo completo, o BigQuery vai pesquisar a tabela no conjunto de dados que você especificar no campo Conjunto de dados da conexão do BigQuery.

    Se o projeto não tiver conjuntos de dados (o que pode ser o caso se você separar a computação e o armazenamento em projetos separados), forneça um valor arbitrário de Dataset, mas use sempre nomes de tabelas com escopo completo no LookML.

  • : o tipo de autenticação que o Looker usará para acessar seu banco de dados, seja Conta de serviço ou OAuth:

    • Conta de serviço: selecione essa opção para usar uma conta de serviço do BigQuery para que o Looker faça a autenticação no seu banco de dados. Consulte Autenticação com contas de serviço do BigQuery para mais informações. Quando a opção Conta de serviço for selecionada, você verá os seguintes campos:
    • OAuth: selecione essa opção para permitir que cada usuário do Looker faça a autenticação no Google BigQuery e autorize o Looker a acessar o banco de dados com a conta do usuário do BigQuery. Consulte a seção Autenticação com OAuth nesta página para mais informações sobre como implementar o OAuth para sua conexão do BigQuery. Quando OAuth for selecionado, você verá os seguintes campos:

  • Ativar TDPs: ative essa opção para permitir tabelas derivadas persistentes (PDTs) na conexão. Você precisará especificar o conjunto de dados temporário no seu banco de dados que o Looker usará para gravar PDTs. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas persistentes nesta página para ver o procedimento. Observação: se a conexão estiver configurada para OAuth, será necessário usar a seção Substituições de TDP para especificar uma conta de serviço que o Looker possa usar para processos de TDP na conexão do BigQuery. Para mais detalhes, consulte a seção Como ativar PDTs para conexões do Looker com o BigQuery com o OAuth.

  • Conjunto de dados temporário: o conjunto de dados do BigQuery que você criou no console do Google Cloud para permitir que o Looker grave tabelas derivadas permanentes no banco de dados. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas persistentes para saber mais sobre o procedimento.

  • Fuso horário do banco de dados: o fuso horário padrão do BigQuery é UTC. A configuração de fuso horário especificada aqui precisa corresponder à configuração de fuso horário do BigQuery. Consulte a seção Fuso horário do banco de dados da página Como conectar o Looker ao banco de dados para mais informações.

  • Fuso horário da consulta: consulte a seção Fuso horário da consulta da página Como conectar o Looker ao seu banco de dados para mais informações.

  • Outros parâmetros do JDBC: adicione outros parâmetros do JDBC, como rótulos do BigQuery. Consulte a seção Rótulos de jobs e comentários de contexto para conexões do BigQuery nesta página para mais informações. Estes são alguns dos outros parâmetros compatíveis:

    • connectTimeout: número de milissegundos para aguardar uma conexão. O padrão é 240.000.
    • readTimeout: número de milissegundos para aguardar uma leitura. O padrão é 240.000.
    • rootUrl: se você tiver uma instância do BigQuery em uma rede privada, especifique um endpoint alternativo para se conectar ao BigQuery diferente do endpoint público padrão.

  • Máximo de gigabytes de faturamento: nas conexões do BigQuery, cada consulta recebe uma cobrança com base no tamanho dela. Para evitar que os usuários executem acidentalmente uma consulta muito cara, defina um número máximo de gigabytes que o usuário pode extrair em uma única consulta. Deixe o campo Máximo de gigabytes de faturamento em branco se não estiver limitando o tamanho da consulta. Saiba mais detalhes na página de preços do BigQuery.

  • Máximo de conexões por nó: pode ser deixado com o valor padrão inicialmente. Leia mais sobre essa configuração na seção Máximo de conexões por nó da página de documentação Como conectar o Looker ao banco de dados.

  • Tempo limite do pool de conexão: pode ser deixado com o valor padrão inicialmente. Leia mais sobre essa configuração na seção Tempo limite do pool de conexão da página de documentação Como conectar o Looker ao banco de dados.

  • Desativar contexto: desativa os comentários de contexto em uma conexão do BigQuery. Os comentários de contexto nas conexões do Google BigQuery ficam desativados por padrão porque invalidam a capacidade do Google BigQuery de armazenar em cache e podem afetar negativamente o desempenho dele. Você pode ativar comentários de contexto para uma conexão do BigQuery desabilitando a opção Desativar contexto. Consulte a seção Rótulos de jobs e comentários de contexto para conexões do BigQuery para mais informações.

  • Pré-cache do SQL Runner: se você quiser que o SQL Runner não pré-carregue as informações da tabela e, em vez disso, carregue as informações da tabela apenas quando uma tabela for selecionada, desmarque esta opção. Consulte a seção Pré-cache do SQL Runner da página Como conectar o Looker ao banco de dados para mais informações.

Depois de preencher todos os campos aplicáveis à conexão, teste-a conforme necessário.

Para salvar essas configurações, clique em Conectar.

Testando a conexão

É possível testar as configurações de conexão em alguns lugares na interface do Looker:

  • Selecione o botão Testar na parte de baixo da página Configurações de conexões, conforme descrito na página de documentação Como conectar o Looker ao banco de dados.
  • Selecione o botão Testar na listagem da conexão na página do administrador Conexões, conforme descrito na página de documentação Conexões.

Para novas conexões, se o Looker exibir Pode se conectar, selecione Adicionar conexão. O Looker vai executar os outros testes de conexão para verificar se a conta de serviço foi configurada corretamente e com os papéis adequados.

Como testar uma conexão que usa o OAuth

  1. No Looker, entre no Modo de Desenvolvimento.
  2. Para uma conexão do BigQuery que usa o OAuth, acesse os arquivos de um projeto do Looker que usa sua conexão do BigQuery. Para novas conexões do BigQuery que usam o OAuth, abra um arquivo de modelo, substitua o valor connection do modelo pelo nome da nova conexão do BigQuery e salve o arquivo de modelo.
  3. Abra uma das Análises ou painéis do modelo e execute uma consulta. Quando você tenta fazer uma consulta, o Looker solicita que você faça login com sua Conta do Google. Siga as solicitações de login do OAuth do Google.

Rótulos de job e comentários de contexto para conexões do BigQuery

Para conexões do BigQuery, o Looker envia o contexto da consulta como rótulos de job do BigQuery. Por padrão, o Looker envia as seguintes chaves de rótulo de contexto para conexões do BigQuery:

  • looker-context-user_id: o identificador exclusivo de cada usuário na instância do Looker. Você pode associar esse ID do usuário aos IDs do usuário na página Usuários no menu Administrador.

  • looker-context-history_slug: o identificador exclusivo de cada consulta executada no banco de dados pela instância do Looker.

  • looker-context-instance_slug: o número do ID da instância do Looker que emitiu a consulta. O suporte do Looker pode usar essas informações para ajudar na solução de problemas, se necessário.

Para configurar outros rótulos de job para o Looker enviar com cada consulta na conexão do BigQuery, use o campo de texto Parâmetros JDBC adicionais da página Conexões. No campo Outros parâmetros do JDBC, adicione mais um parâmetro JDBC, labels, e forneça uma lista separada por vírgulas de pares de key=value codificados em URL. Por exemplo, se você incluir isso no campo Parâmetros adicionais do JDBC:

labels=this%3Dconnection-label,that%3Danother-connection-label

%3D é a codificação por URL do =. Isso adiciona os dois rótulos a seguir a todas as consultas que o Looker envia ao banco de dados do BigQuery, além dos rótulos de contexto padrão do Looker:

  • this: connection-label
  • that: another-connection-label

O BigQuery tem restrições nos rótulos de jobs:

  • Qualquer rótulo de conexão que tenha a mesma chave de um rótulo de contexto será ignorado.
  • Se a união dos rótulos de conexão e de contexto exceder o máximo de 64 rótulos totais, os rótulos de contexto serão os primeiros a serem descartados, seguidos pelos de conexão, até que o número total de rótulos seja no máximo 64.

O Looker garante que os rótulos de contexto estejam em conformidade com todos os requisitos de validade de rótulos do BigQuery, mas não verifica a validade dos rótulos de conexão. Configurar rótulos de conexão inválidos pode causar falhas nas consultas.

Os rótulos de job do BigQuery que o Looker envia por padrão (looker-context-user_id, looker-context-history_id e looker-context-instance_slug) correspondem aos comentários de contexto SQL que o Looker anexa a consultas SQL para dialetos de banco de dados diferentes do BigQuery. Nas conexões do BigQuery, os comentários de contexto são desativados por padrão porque invalidam a capacidade do BigQuery de armazenar em cache e podem afetar negativamente o desempenho do cache. Para ativar comentários de contexto em uma conexão do BigQuery, desative a opção Desativar contexto. Recomendamos que você mantenha a configuração padrão Desativar comentário de contexto para poder usar o cache do BigQuery. No entanto, se você desmarcar a opção Desativar comentário de contexto em uma conexão do BigQuery, o Looker vai enviar comentários de contexto SQL e rótulos de job do BigQuery para o banco de dados.

Os comentários de contexto do SQL e os rótulos de job do BigQuery transmitem as mesmas informações. Por exemplo, o Looker pode gerar os seguintes comentários de contexto SQL para uma consulta:

-- Looker Query Context

'{"user_id":1,"history_id":4757,"instance_slug":"ec2804ddef74c466f2a43e0afaa3ff6b"}'

Em seguida, o Looker gera os seguintes rótulos de job do BigQuery para a mesma consulta:

[{"value":"1","key":"looker-context-user_id"},

 {"value":"4757","key":"looker-context-history_id"},

 {"value":"ec2804ddef74c466f2a43e0afaa3ff6b","key":"looker-context-instance_slug"}]

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

SQL padrão do Google BigQuery

O SQL padrão do Google BigQuery é compatível com os seguintes recursos a partir do Looker 24.10:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
Sim
Tabelas derivadas
Sim
Tabelas derivadas de SQL persistentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Eliminação de consultas
Sim
Dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos de exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Mostrar índices do SQL Runner
No
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
No
Credenciais OAuth
Sim
Comentários de contexto
Sim
Pool de conexão
No
Esboços do HLL
Sim
Agregar reconhecimento
Sim
TDPs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
Sim
Contagem aproximada diferente
Sim

SQL legado do Google BigQuery

O SQL legado do Google BigQuery é compatível com os seguintes recursos a partir do Looker 24.10:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
No
Agregações simétricas
Sim
Tabelas derivadas
Sim
Tabelas derivadas de SQL persistentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
No
Eliminação de consultas
Sim
Dinâmicas baseadas em SQL
Sim
Fusos horários
No
SSL
Sim
Subtotais
No
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos de exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Mostrar índices do SQL Runner
No
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
No
Credenciais OAuth
Sim
Comentários de contexto
Sim
Pool de conexão
No
Esboços do HLL
No
Agregar reconhecimento
Sim
TDPs incrementais
No
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
No
Contagem aproximada diferente
Sim

Próximas etapas

Depois de conectar seu banco de dados ao Looker, configure as opções de login para os usuários.