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 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 o banco de dados do BigQuery. O Looker é compatível com as seguintes opções de autenticação no BigQuery:

  2. No banco de dados do BigQuery, se você quiser usar tabelas derivadas persistentes (TDPs) na conexão, crie um conjunto de dados temporário que o Looker possa usar para criar TDPs 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 conhecer o procedimento.

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

  4. Teste a conexão entre o Looker e seu banco de dados do BigQuery. Consulte a seção Como testar a conexão desta página para saber 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

O Looker pode se autenticar no banco de dados do BigQuery usando uma conta de serviço. Crie a conta de serviço no banco de dados do BigQuery usando 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 do console do Google Cloud e selecione seu projeto.

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

  3. Insira um nome para a nova conta de serviço, adicione uma descrição (se desejado) e selecione CRIAR E CONTINUAR.

  4. Sua 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 de selecionar as duas funções, clique em CONTINUAR e depois em CONCLUÍDO.

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

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

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

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

    Depois de anotar 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 desse 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 a conexões OAuth para Google BigQuery, o que significa que cada usuário do Looker faz a autenticação no Google com as próprias credenciais OAuth do Google e autoriza o Looker a acessar o banco de dados.

O OAuth permite que os administradores de banco 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 lugares.

Para conexões do BigQuery com OAuth, observe o seguinte:

  • Se um administrador de banco de dados alterar as credenciais do cliente OAuth do BigQuery, todas 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 OAuth do BigQuery. Os usuários também podem acessar a página Conta do Looker na página do perfil do 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, o Looker só vai usá-los se o mesmo usuário tiver feito a mesma consulta nesse período. Para mais informações sobre armazenamento em cache, consulte a página de documentação Consultas em cache.
  • Se você quiser usar tabelas derivadas persistentes (TDPs) em uma conexão do BigQuery com o OAuth, crie outra conta de serviço para o Looker acessar seu banco de dados para processos de TDP. Para mais informações, consulte a seção Tabelas derivadas persistentes em uma conexão do BigQuery nesta página.
  • Os administradores, ao executarem o sudo como outro usuário, vão usar 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 seu projeto, não será necessário criar outra. Você configura apenas uma tela de consentimento para todos os aplicativos de 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 Google Dev Console.

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 privados, o OAuth pode não ser o método de autenticação mais adequado. Da mesma forma, o tipo de dados solicitados do usuário e o grau de acesso necessário aos dados desse usuário para fazer a autenticação no Google para usar o Looker podem exigir verificação do Google. Saiba mais sobre a verificação na seção Como gerar credenciais do Google OAuth nesta página.

Gerar credenciais do Google OAuth

  1. Acesse o Console do Google Cloud.

  2. Na lista suspensa Selecionar um projeto, navegue até seu 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 você gerar suas credenciais OAuth. Para configurar a tela de permissão OAuth, consulte a seção Como 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 uma chave secreta 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 vai ser expandida e mostrar mais opções:

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

  7. Na seção Origens JavaScript autorizadas, selecione + ADICIONAR URI para exibir o campo URIs 1. No campo URIs 1, insira o URL da sua 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 seu ID do cliente e sua Chave secreta do cliente.

  10. Copie os valores do ID e 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, que permite que os usuários escolham como conceder acesso aos dados particulares e fornece um link para os Termos de Serviço e a Política de Privacidade da organização.

No menu à esquerda, selecione a página Tela de permissão OAuth. Antes de configurar sua tela de permissão OAuth, escolha para que tipo de usuários você está disponibilizando esse aplicativo. Dependendo da opção, talvez o app precise ser verificado pelo Google.

Escolha uma opção e clique em Criar. O Google vai mostrar a página Tela de consentimento OAuth. É possível configurar essa tela para todos os aplicativos no seu projeto, incluindo aplicativos internos e públicos.

O Google realiza uma verificação de aplicativos públicos se algum dos itens a seguir for verdadeiro:

  • O aplicativo usa APIs do Google com escopos restritos ou confidenciais.
  • A tela de consentimento do OAuth inclui um logotipo de 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, digite o nome do aplicativo a que o usuário está concedendo acesso, neste caso, o Looker.

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

  3. Selecione ADICIONAR DOMÍNIO para exibir o campo Domínio autorizado 1. Neste campo, insira o domínio do URL da sua instância do Looker. Por exemplo, se o Looker hospedar sua instância em https://<instance_name>.cloud.looker.com, o domínio será cloud.looker.com. Para implantações 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, onde é possível configurar escopos. O Looker exige apenas os escopos padrão, portanto, não é necessária nenhuma outra configuração de escopo. Selecione SALVAR E CONTINUAR.

  7. Na página Resumo, selecione VOLTAR PARA O PAINEL.

Agora você pode continuar o procedimento para gerar suas credenciais do OAuth.

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

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

Para ativar o OAuth na sua conexão com o BigQuery, selecione a opção OAuth na página Conexão do Looker ao configurar 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 como etapa do procedimento Como gerar credenciais do Google OAuth nesta página.

Como os usuários do Looker fazem a autenticação 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 fazer a autenticação no Google a partir de uma consulta

Depois que a conexão do Looker com o BigQuery estiver configurada para OAuth, o Looker 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, painéis, Looks e SQL Runner.

O usuário precisa selecionar Fazer login e autenticar com o OAuth. Após a autenticação no BigQuery, o usuário pode selecionar o botão Executar em "Explorar", e o Looker vai carregar os dados nela.

Como fazer a autenticação no Google pela página da conta de usuário

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

  1. No Looker, selecione o ícone de 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 para a conexão do banco de dados do BigQuery apropriado.
  3. Selecione a conta apropriada na página Fazer login com o Google.
  4. Selecione Permitir na tela de permissão OAuth para que o Looker acesse e gerencie seus dados no Google BigQuery.

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

Como revogar tokens OAuth

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

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

Tabelas derivadas persistentes em uma conexão do BigQuery

Se você quiser usar tabelas derivadas persistentes (TDPs) na sua conexão com o BigQuery, talvez seja necessário fazer o seguinte, dependendo da configuração da sua conexão:

  • Use o console do Google Cloud para criar um conjunto de dados temporário no banco de dados do BigQuery que o Looker possa usar para gravar TDPs. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas persistentes nesta página para conhecer 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 saber o procedimento. O tipo de autenticação na sua conexão afeta a exigência de uma conta de serviço de TDP e também o local onde você insere as informações da conta de serviço da TDP 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, crie uma conta de serviço separada para processos de TDP. Você insere as informações da conta de serviço e os detalhes do arquivo de certificado na seção Substituições de TDP da janela Conexões do Looker. A janela Conexões do Looker mostra a seção Substituições de TDP automaticamente quando você ativa a opção Ativar TDPs em uma conexão que também está configurada com a opção OAuth no campo Autenticação. Consulte a seção Como ativar TDPs para conexões do Looker com o BigQuery com o OAuth para mais informações.
    • Se sua conexão usa contas de serviço para autenticação do usuário, você terá a opção de criar uma conta de serviço separada para processos de TDP. Se você quiser ter uma conta de serviço de TDP separada, digite as informações dela na seção Substituições de TDP 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. A seção Substituições de TDP aparece quando você ativa a opção Ativar TDPs em uma conexão do Looker com o BigQuery usando a autenticação de conta de serviço.

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

Para ativar as tabelas derivadas persistentes (TDPs) na sua conexão do BigQuery, ative a opção Ativar TDPs na página Conexão do Looker quando configurar a conexão do Looker com o BigQuery. Quando você ativa TDPs, o Looker mostra o campo Conjunto de dados temporários. Neste campo, você insere o nome do conjunto de dados que o Looker pode usar para criar TDPs. Configure esse banco de dados ou esquema antecipadamente, com as permissões de gravação adequadas.

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

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

  2. Selecione o menu de três pontos e depois clique em Criar conjunto de dados.

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

Agora que você criou o conjunto de dados, é possível especificar o nome dele no campo Temp Dataset da janela Conexões do Looker ao configurar a conexão do Looker com o BigQuery.

Como ativar TDPs nas conexões do Looker ao BigQuery com o OAuth

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

É possível configurar uma conta de serviço de TDPs 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 da conta de serviço e os detalhes do arquivo de certificado na seção Substituições de TDP 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ções de TDP automaticamente quando você ativa a opção Ativar TDPs em uma conexão que também está configurada com a opção OAuth no campo Autenticação. Use os seguintes campos na seção Substituições de TDP para inserir as informações da conta de serviço que o Looker pode usar para processos de TDP no seu banco de dados:

  • Fazer upload do p12 ou json: use o botão Fazer upload do arquivo para enviar o arquivo de certificado da conta de serviço do BigQuery que você quer usar para processos de TDP na conexão. É possível conseguir esse arquivo do 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 será aplicado somente se você fizer upload de um arquivo P12 no campo Fazer upload de p12 ou json da seção Substituições de TDP. Insira o endereço de e-mail da conta de serviço do BigQuery que você quer usar para processos de TDP na conexão. É possível conseguir 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 será aplicado somente se você fizer upload de um arquivo P12 no campo Fazer upload de p12 ou json da seção Substituições de TDP. Digite a senha do arquivo de credenciais .p12 referente à conta de serviço do BigQuery que você quer usar para processos de TDP na conexão.

Conectar o Looker ao BigQuery

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

  • Para criar uma nova conexão, selecione o botão Adicionar conexão.
  • Para editar uma conexão existente, encontre-a na tabela Bancos de dados e, em seguida, selecione o botão Editar na listagem da conexão.

Preencher os detalhes de conexão. A maioria dessas configurações é comum à maioria dos dialetos de banco de dados. Elas estão descritas 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 você ainda pode 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 mesclas do LookML. Para o BigQuery, um nome de tabela com escopo completo usa o formato <project_name>.<dataset_name>.<table_name>. Sem uma referência com escopo completo, o BigQuery procura a tabela no projeto e no conjunto de dados de faturamento 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 no BigQuery.

  • 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 localizado no projeto de faturamento especificado para a conexão. Não é possível inserir um valor como project_name.dataset_name no campo Banco de dados para especificar um conjunto de dados em um projeto diferente.

    O projeto do LookML poderá acessar tabelas em outros conjuntos de dados (incluindo aquelas em conjuntos públicos) se os desenvolvedores do LookML especificarem os nomes de tabela com escopo completo no parâmetro sql_table_name das visualizações, Análises ou mesclagens do LookML. Para o 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 estar acessível pela conta de serviço (para conexões que usam autenticação de 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 LookML não especificar nomes de tabela com escopo completo, o BigQuery vai procurar a tabela no conjunto de dados especificado no campo Conjunto de dados da conexão do BigQuery.

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

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

    • Conta de serviço: selecione essa opção para usar uma conta de serviço do BigQuery para o Looker fazer 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 é selecionada, os seguintes campos aparecem:
    • 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 BigQuery do usuário. Consulte a seção Autenticação com OAuths desta página para mais informações sobre a implementação do OAuth na sua conexão do BigQuery. Ao selecionar OAuth, você verá os seguintes campos:

  • Ativar TDPs: ative essa opção para permitir tabelas derivadas persistentes (TDPs) na conexão. Será necessário especificar o conjunto de dados temporário no banco de dados que o Looker usará para gravar TDPs. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas persistentes nesta página para conhecer o procedimento. Observação: se a conexão estiver configurada para OAuth, você vai precisar 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 sua conexão do BigQuery. Consulte a seção Como ativar TDPs para conexões do Looker com o BigQuery com o OAuth para mais detalhes.

  • Conjunto de dados temporários: 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 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 ao 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 saber mais.

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

  • Parâmetros JDBC adicionais: adicione outros parâmetros do JDBC, como os 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 de espera por 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 que não seja o endpoint público padrão.

  • Máximo de gigabytes de faturamento: nas conexões do BigQuery, você é cobrado por cada consulta com base no tamanho dela. Para evitar que os usuários executem acidentalmente uma consulta muito cara, você pode definir um número máximo de gigabytes que um usuário pode extrair em uma única consulta. Você pode deixar o campo Max Billing Gigabytes em branco se não estiver limitando o tamanho da consulta. Leia mais sobre os preços 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 inicialmente com o valor padrão. 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 eles invalidam a capacidade do Google BigQuery de fazer o armazenamento 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. Para mais informações, consulte a seção Rótulos de jobs e comentários de contexto para conexões do BigQuery.

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

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

Para salvar as 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ão, conforme descrito na página de documentação Como conectar o Looker ao banco de dados.
  • Selecione o botão Testar ao lado da 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 mostrar 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 em Modo de desenvolvimento.
  2. Em uma conexão atual do BigQuery que usa OAuth, navegue até os arquivos de um projeto do Looker que use sua conexão do BigQuery. Para novas conexões do BigQuery que usam OAuth, abra um arquivo modelo, substitua o valor connection do modelo pelo nome da nova conexão do BigQuery e salve o arquivo.
  3. Abra uma das Análises ou dashboards do modelo e execute uma consulta. Quando você tentar executar uma consulta, o Looker vai solicitar que você faça login com sua Conta do Google. Siga as solicitações de login do Google OAuth.

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

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

  • looker-context-user_id: o identificador exclusivo de cada usuário na instância do Looker. É possível fazer a correspondência desse ID de usuário com os IDs de usuário na página Usuários do 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.

É possível configurar rótulos de job extras para o Looker enviar com todas as consultas na conexão do BigQuery usando o campo de texto Parâmetros JDBC adicionais da página Conexões. No campo Parâmetros JDBC adicionais, adicione outro parâmetro JDBC, labels, e forneça uma lista separada por vírgulas de pares key=value codificados em URL. Por exemplo, se você incluir isso no campo Parâmetros JDBC adicionais:

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

O %3D é a codificação de URL para =. Isso adicionaria os dois rótulos a seguir a cada consulta 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 de rótulos de conexão e de contexto exceder o máximo de 64 rótulos, os rótulos de contexto serão os primeiros a serem descartados, seguidos pelos rótulos 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 deles. A configuração de rótulos de conexão inválidos pode fazer com que as consultas falhem.

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 às consultas SQL para dialetos de banco de dados diferentes do BigQuery. Para as conexões do BigQuery, os comentários de contexto estão desativados por padrão porque invalidam a capacidade do BigQuery de armazenar em cache e podem afetar negativamente o desempenho do cache. É possível ativar comentários de contexto em uma conexão do BigQuery desativando a opção Desativar contexto nessa conexão. Recomendamos manter a configuração padrão para Desativar comentários 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 jobs do BigQuery ao seu banco de dados.

Os comentários de contexto SQL e os rótulos de jobs 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"}'

O Looker geraria 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 seu banco de dados também precisa oferecer suporte a eles.

SQL padrão do Google BigQuery

A partir do Looker 24.6, o SQL padrão do Google BigQuery oferece suporte aos seguintes recursos:

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 permanentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Encerramento da consulta
Sim
Tabelas 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 da exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Índices de exibição 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 do contexto
Sim
Pooling de conexão
No
Esboços do HLL
Sim
Reconhecimento agregado
Sim
TDPs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
Sim
Contagem aproximada distinta
Sim

SQL legado do Google BigQuery

O SQL legado do Google BigQuery oferece suporte aos seguintes recursos a partir do Looker 24.6:

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 permanentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
No
Encerramento da consulta
Sim
Tabelas 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 da exibição do SQL Runner
No
Tabela de descrição do executor do SQL
No
Índices de exibição 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 do contexto
Sim
Pooling de conexão
No
Esboços do HLL
No
Reconhecimento agregado
Sim
TDPs incrementais
No
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
No
Contagem aproximada distinta
Sim

Próximas etapas

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