Conexão padrão do BigQuery para o Looker (núcleo do Google Cloud)

O Looker (Google Cloud Core) precisa estar conectado a um banco de dados para permitir a exploração de dados. Uma conexão padrão com um banco de dados do BigQuery SQL padrão pode ser criada usando a Conexão de início rápido do BigQuery.

O bloco de início rápido do BigQuery em uma página inicial.

Antes de começar

A configuração de uma Conexão de início rápido do BigQuery exige as seguintes permissões.

Permissões do Looker

É possível visualizar e editar a página Conexão de início rápido do BigQuery na página Inicial da instância do Looker (Google Cloud Core) se você tiver uma das seguintes permissões do Looker:

Permissões do IAM

As instâncias do Looker (Google Cloud Core) podem usar Application Default Credentials (ADC) para autenticar ao configurar uma conexão com o BigQuery. Quando você usa o ADC, a conexão é autenticada no banco de dados usando as credenciais da conta de serviço do Looker (Google Cloud Core). A conta de serviço precisa ter as seguintes permissões do IAM para acessar o conjunto de dados do BigQuery:

Se a conta de serviço do Looker (Google Cloud Core) ainda não tiver os papéis do IAM necessários, use o endereço de e-mail da conta de serviço ao conceder papéis nesse projeto. Para encontrar o endereço de e-mail da conta de serviço, acesse a página IAM no Google Cloud console e marque a caixa de seleção Incluir concessões de papel fornecidas pelo Google. O e-mail terá o formato service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Use esse e-mail para conceder os papéis adequados à conta de serviço.

Configurar uma Conexão de início rápido do BigQuery

A Conexão de início rápido do BigQuery pode ser visualizada e editada por usuários que têm as permissões corretas na página Inicial ou na página Conexões no painel Administrador. Na página Conexões, a Conexão de início rápido do BigQuery aparece com o nome Conexão padrão do BigQuery. Em uma nova instância, os campos ID do projeto de armazenamento e ID do projeto de faturamento serão definidos como Nenhum por padrão.

Na página Inicial, clique no botão Analisar conexão para gerenciar a conexão. É possível dispensar o bloco da página Inicial clicando no x ou ativando a opção Início rápido do BigQuery na barra lateral Descobrir.

A Conexão de início rápido do BigQuery contém as seguintes seções:

ID do projeto de faturamento

O ID do projeto serve como um identificador exclusivo para o Google Cloud projeto de faturamento. O projeto de faturamento é o Google Cloud projeto que recebe a cobrança pelo uso do BigQuery, mas ainda é possível consultar conjuntos de dados em um projeto diferente se os desenvolvedores do LookML especificarem nomes de tabelas com escopo completo no sql_table_name parâmetro das visualizações, explorações ou junções do LookML. Google Cloud Este campo é obrigatório.

Para autenticar em um banco de dados do BigQuery usando o OAuth: para conexões do BigQuery, o Looker (Google Cloud Core) pode usar automaticamente as credenciais do aplicativo OAuth que o administrador do Looker (Google Cloud Core) usou ao criar a instância. Consulte a página Criar um cliente e credenciais OAuth para uma instância do Looker (Google Cloud Core) para mais informações.

Expanda a seção Detalhes do status para testar as configurações da conexão.

Conjunto de dados principal

A página Conjunto de dados principal contém as seguintes configurações.

ID do projeto de armazenamento

No campo ID do projeto de armazenamento, insira o ID do projeto que contém o conjunto de dados do BigQuery a que você quer se conectar, mesmo que seja o mesmo projeto que contém a instância do Looker (Google Cloud Core). Este campo é obrigatório.

Conjunto de dados principal

O conjunto de dados principal é onde o BigQuery vai procurar tabelas se o local delas não estiver especificado no texto da consulta SQL. As consultas do Looker (Google Cloud Core) podem se referir a tabelas em qualquer projeto ou conjunto de dados, desde que usem nomes de tabelas com escopo completo no formato project_id.dataset_name.table_name. A conta de serviço do Looker (Google Cloud Core) também vai precisar das permissões apropriadas do IAM para acessar as tabelas nesse local. Este campo é obrigatório.

Para saber mais sobre conjuntos de dados, consulte a página de documentação Conectar o Looker ao BigQuery.

Expanda a seção Detalhes do status para testar as configurações da conexão.

Configurar configurações opcionais para a conexão do BigQuery

A seção Configurações opcionais contém as seguintes opções:

  • Máximo de conexões por nó: o número máximo de conexões com o banco de dados permitidas ao mesmo tempo. Observação: essa configuração é para cada nó na implantação do Looker (Google Cloud Core). O valor precisa estar entre 5 e 100 e pode ser deixado no valor padrão inicialmente. Saiba mais sobre essa configuração na seção Máximo de conexões por nó da página de documentação Conectar o Looker ao banco de dados.

  • Tempo limite do pool de conexões: o número de segundos que uma consulta vai aguardar antes de atingir o tempo limite quando o pool de conexões estiver cheio. Pode ser deixado no valor padrão inicialmente. Saiba mais sobre essa configuração na seção Tempo limite do pool de conexões da página de documentação Conectar o Looker ao banco de dados.

  • Parâmetros JDBC adicionais: adicione outros parâmetros 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.

  • Programação de manutenção: expressão Cron que indica a frequência máxima de verificações de gatilhos do grupo de dados e manutenção da TDP. Saiba mais sobre essa configuração na documentação da Programação de manutenção.

  • SSL: escolha se você quer usar a criptografia SSL para proteger os dados à medida que eles passam entre o Looker (Google Cloud Core) e o banco de dados. O SSL é apenas uma opção que pode ser usada para proteger seus dados. Outras opções seguras são descritas na página de documentação Ativar acesso seguro ao banco de dados.

  • Verificar SSL: escolha se você quer exigir a verificação do certificado SSL usado pela conexão. Saiba mais sobre essa configuração na seção Verificar SSL da página de documentação Conectar o Looker ao banco de dados.

  • Pré-armazenar tabelas e colunas em cache: no SQL Runner, todas as informações da tabela são pré-carregadas assim que você seleciona uma conexão e um esquema. Isso permite que o SQL Runner mostre rapidamente as colunas da tabela assim que você clicar em um nome de tabela. No entanto, para conexões e esquemas com muitas tabelas ou com tabelas muito grandes, talvez você não queira que o SQL Runner pré-carregue todas as informações.

  • Buscar e armazenar esquema em cache: para alguns recursos de gravação de SQL, como o reconhecimento de agregados, o Looker (Google Cloud Core) usa o esquema de informações do banco de dados para otimizar a gravação de SQL. Saiba mais sobre essa configuração na seção Buscar esquema de informações para gravação de SQL da página de documentação Conectar o Looker ao banco de dados.

  • Ativar TDPs: ative a opção Ativar TDPs para ativar tabelas derivadas persistentes. Quando as TDPs estão ativadas, a janela Configurações opcionais revela outros campos de TDP e a seção Substituições de TDP.

  • Banco de dados temporário: insira o conjunto de dados no BigQuery em que o Looker (Google Cloud Core) vai criar tabelas derivadas persistentes. Você precisa configurar esse conjunto de dados com antecedência, com as permissões de gravação adequadas. Esse campo é obrigatório para usar TDPs.

  • Número máximo de conexões do builder da TDP: a configuração Número máximo de conexões do builder da TDP é definida como 1 por padrão, mas pode ser definida como 100. No entanto, o valor não pode ser maior que o valor definido em Máximo de conexões por nó. Saiba mais sobre essa configuração na seção Número máximo de conexões do builder da TDP da página de documentação Conectar o Looker ao banco de dados. Defina esse valor com cuidado. Se o valor for muito alto, você poderá sobrecarregar o banco de dados. Se o valor for baixo, as TDPs de longa duração ou as tabelas agregadas poderão atrasar a criação de outras tabelas persistentes ou diminuir a velocidade de outras consultas na conexão.

  • Repetir builds de TDP com falha: a opção Repetir builds de TDP com falha configura como o regenerador do Looker (Google Cloud Core) tenta recriar tabelas persistentes de gatilho que falharam no ciclo anterior do regenerador. Saiba mais sobre essa configuração na seção Repetir builds de TDP com falha da página de documentação Conectar o Looker ao banco de dados.

  • Controle da API de TDPs: a opção Controle da API de TDPs determina se as chamadas de API start_pdt_build, check_pdt_build e stop_pdt_build podem ser usadas para essa conexão. Quando a opção Controle da API de TDPs está desativada, essas chamadas de API falham quando fazem referência a TDPs nessa conexão.

  • Substituições de TDP: se o banco de dados oferece suporte a tabelas derivadas persistentes e você ativou a opção Ativar TDPs nas configurações de conexão, o Looker (Google Cloud Core) mostra a seção Substituições de TDP. Na seção Substituições de TDP , é possível inserir parâmetros JDBC separados (host, porta, banco de dados, nome de usuário, senha, esquema, parâmetros adicionais e instruções após a conexão) que são específicos para processos de TDP. Saiba mais sobre essa configuração na seção Substituições de TDP da página de documentação Conectar o Looker ao banco de dados.

  • Fuso horário do banco de dados: o fuso horário em que o banco de dados armazena informações baseadas no tempo. O Looker (Google Cloud Core) precisa saber isso para converter valores de tempo para os usuários, facilitando a compreensão e o uso de dados baseados no tempo. Consulte a página de documentação Usar configurações de fuso horário para mais informações.

  • Fuso horário de consultas: a opção Fuso horário de consultas só fica visível se você tiver desativado os Fusos horários específicos dos usuários. Consulte a página de documentação Usar configurações de fuso horário para mais informações.

Expanda a seção Detalhes do status para testar as configurações da conexão.

Revisão

Analise e modifique os detalhes da conexão inseridos nas seções anteriores na seção Revisão.

Expanda a seção Detalhes do status para testar as configurações da conexão. Clique no ícone de edição ao lado de cada seção para voltar a ela e mudar as configurações.

Salvar e testar a conexão

Para salvar as mudanças feitas na Conexão de início rápido do BigQuery, clique em Salvar.

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

  • Expanda a seção Detalhes do status na parte de baixo de qualquer uma das páginas de Conexão de início rápido e clique em Testar conexão.
  • Na página Inicial , expanda a seção Detalhes do status na parte de baixo do bloco Conexão de início rápido e clique em Testar conexão.
  • Na página Conexões do administrador, selecione o botão Testar ao lado da listagem da conexão, conforme descrito na página de documentação Conexões.

Depois de inserir as configurações de conexão, clique em Testar para verificar se as informações estão corretas e se o banco de dados pode se conectar.

Se a conexão não passar em um ou mais testes, confira algumas opções de solução de problemas:

A seguir