Ligação predefinida do BigQuery para o Looker (Google Cloud Core)

O Looker (Google Cloud core) tem de estar ligado a uma base de dados para permitir a exploração de dados. Pode criar uma ligação predefinida a uma base de dados SQL padrão do BigQuery através da ligação de início rápido do BigQuery.

O mosaico Início rápido do BigQuery numa página inicial.

Antes de começar

A configuração de uma ligação de início rápido do BigQuery requer as seguintes autorizações.

Autorizações do Looker

Pode ver e editar a página Associação de início rápido do BigQuery na página Início da instância do Looker (Google Cloud core) se tiver uma das seguintes autorizações do Looker:

Autorizações de IAM

As instâncias do Looker (Google Cloud core) podem usar as credenciais predefinidas da aplicação (ADC) para autenticar quando configura uma ligação ao BigQuery. Quando usa o ADC, a ligação é autenticada na base de dados através das credenciais da conta de serviço do Looker (essencial para o Google Cloud). A conta de serviço tem de ter as seguintes autorizações de IAM para aceder ao conjunto de dados do BigQuery:

Se a conta de serviço do Looker (Google Cloud core) ainda não tiver as funções do IAM necessárias, use o endereço de email da conta de serviço ao conceder funções nesse projeto. Para encontrar o endereço de email da conta de serviço, aceda à página IAM na Google Cloud consola e selecione a caixa de verificação Incluir concessões de funções fornecidas pela Google. O email tem o formato service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Use esse email para conceder as funções adequadas à conta de serviço.

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

A ligação de início rápido do BigQuery pode ser vista e editada por utilizadores que tenham as autorizações corretas na página Início ou na página Ligações no painel Administração. Na página Ligações, a ligação de início rápido do BigQuery aparece com o nome Ligação predefinida do BigQuery. Numa nova instância, os campos ID do projeto de armazenamento e ID do projeto de faturação têm como predefinição Nenhum.

Na página Casa, clique no botão Rever associação para gerir a associação. Pode ignorar o mosaico da página Início clicando no x ou ativando/desativando a opção Início rápido do BigQuery na barra lateral Descobrir.

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

ID do projeto de faturação

O ID do projeto funciona como um identificador exclusivo do Google Cloud projeto de faturação. O projeto de faturação é o Google Cloud projeto que é faturado pela utilização do BigQuery, mas ainda pode consultar conjuntos de dados num Google Cloud projeto diferente se os programadores do LookML especificarem nomes de tabelas totalmente abrangentes no parâmetro sql_table_name das suas visualizações, Explores ou junções do LookML. Este é um campo obrigatório.

Para autenticar numa base de dados do BigQuery através do OAuth: para ligações do BigQuery, o Looker (Google Cloud core) pode usar automaticamente as credenciais da aplicação OAuth que o administrador do Looker (Google Cloud core) usou quando criou a instância. Consulte a página Crie credenciais de autorização OAuth para uma instância do Looker (Google Cloud core) para mais informações.

Expanda a secção Detalhes do estado para testar as definições da sua associação.

Conjunto de dados principal

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

ID do projeto de armazenamento

No campo ID do projeto de armazenamento, introduza o ID do projeto do projeto que contém o conjunto de dados do BigQuery ao qual quer estabelecer ligação, mesmo que seja o mesmo projeto que contém a instância do Looker (Google Cloud core). Este é um campo obrigatório.

Conjunto de dados principal

O conjunto de dados principal é onde o BigQuery procura tabelas se a respetiva localização não for especificada no texto da consulta SQL. Tenha em atenção que as consultas do Looker (Google Cloud core) podem referenciar tabelas em qualquer projeto ou conjunto de dados, desde que as consultas usem nomes de tabelas totalmente abrangentes com o formato project_id.dataset_name.table_name. A conta de serviço do Looker (essencial para o Google Cloud) também precisa das autorizações da IAM adequadas para aceder às tabelas nessa localização. Este é um campo obrigatório.

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

Expanda a secção Detalhes do estado para testar as definições da sua associação.

Definições opcionais

A secção Definições opcionais contém as seguintes opções:

  • Máximo de ligações por nó: o número máximo de ligações à base de dados permitidas em simultâneo. Nota: esta definição é por cada nó na implementação do Looker (Google Cloud core). O valor tem de estar entre 5 e 100 e pode ser deixado no valor predefinido inicialmente. Leia mais acerca desta definição na secção Máximo de associações por nó da página de documentação Associar o Looker à sua base de dados.

  • Limite de tempo do conjunto de ligações: o número de segundos que uma consulta aguarda antes de expirar quando o conjunto de ligações está cheio. Pode ser deixado no valor predefinido inicialmente. Leia mais acerca desta definição na secção Tempo limite do conjunto de ligações da página de documentação Associar o Looker à sua base de dados.

  • Parâmetros JDBC adicionais: adicione quaisquer parâmetros JDBC adicionais, como etiquetas do BigQuery (consulte a secção Etiquetas de tarefas e comentários de contexto para associações do BigQuery nesta página para mais informações).

  • Agendamento de manutenção: expressão cron que indica a frequência máxima de verificações de acionadores de grupos de dados e manutenção de PDTs. Leia mais acerca desta definição na documentação do cronograma de manutenção.

  • SSL: escolha se quer usar a encriptação SSL para proteger os dados à medida que são transmitidos entre o Looker (Google Cloud core) e a sua base de dados. O SSL é apenas uma opção que pode ser usada para proteger os seus dados. Outras opções seguras são descritas na página de documentação Ativar o acesso seguro à base de dados.

  • Validar SSL: escolha se quer exigir a validação do certificado SSL usado pela ligação. Leia mais acerca desta definição na secção Validar SSL da página de documentação Associar o Looker à sua base de dados.

  • Coloque tabelas e colunas em pré-cache: no SQL Runner, todas as informações das tabelas são pré-carregadas assim que seleciona uma associação e um esquema. Isto permite que o SQL Runner apresente rapidamente as colunas da tabela assim que clicar no nome de uma tabela. No entanto, para associações e esquemas com muitas tabelas ou tabelas muito grandes, pode não querer que o SQL Runner pré-carregue todas as informações.

  • Obtenha e coloque em cache o esquema: para algumas funcionalidades de escrita SQL, como o reconhecimento de agregados, o Looker (Google Cloud core) usa o esquema de informações da sua base de dados para otimizar a escrita SQL. Leia mais acerca desta definição na secção Obter esquema de informações para escrita SQL da página de documentação Associar o Looker à sua base de dados.

  • Ativar PDTs: ative o botão Ativar PDTs para ativar as tabelas derivadas persistentes. Quando os PDTs estão ativados, a janela Definições opcionais revela campos de PDT adicionais e a secção Substituições de PDTs.

  • Base de dados temporária: introduza o conjunto de dados no BigQuery onde o Looker (Google Cloud core) vai criar tabelas derivadas persistentes. Deve configurar este conjunto de dados antecipadamente com as autorizações de gravação adequadas. Este campo é obrigatório para usar PDTs.

  • Número máximo de ligações do compilador de PDTs: a definição Número máximo de ligações do compilador de PDTs tem o valor predefinido de 1, mas pode ser definida até 10. No entanto, o valor não pode ser superior ao valor definido em Ligações máximas por nó. Leia mais acerca desta definição na secção Número máximo de ligações do compilador de PDT da página de documentação Associar o Looker à sua base de dados. Defina este valor com cuidado. Se o valor for demasiado elevado, pode sobrecarregar a base de dados. Se o valor for baixo, as PDTs de execução prolongada ou as tabelas agregadas podem atrasar a criação de outras tabelas persistentes ou tornar outras consultas na ligação mais lentas.

  • Repetir compilações de PDTs falhadas: o botão Repetir compilações de PDTs falhadas configura a forma como o regenerador do Looker (Google Cloud core) tenta recompilar tabelas persistentes acionadas que falharam no ciclo do regenerador anterior. Leia mais acerca desta definição na secção Repetir compilações de PDTs falhadas da página de documentação Ligar o Looker à sua base de dados.

  • Controlo da API PDT: o botão Controlo da API PDT determina se as chamadas da API start_pdt_build, check_pdt_build e stop_pdt_build podem ser usadas para esta associação. Quando o botão Controlo da API PDT está desativado, estas chamadas API falham quando fazem referência a PDTs nesta ligação.

  • Substituições de PDTs: se a sua base de dados suportar tabelas derivadas persistentes e tiver ativado o botão Ativar PDTs nas definições de ligação, o Looker (Google Cloud core) apresenta a secção Substituições de PDTs. Na secção Substituições de PDT, pode introduzir parâmetros JDBC separados (anfitrião, porta, base de dados, nome de utilizador, palavra-passe, esquema, parâmetros adicionais e declarações após a associação) específicos dos processos de PDT. Leia mais acerca desta definição na secção Substituições de PDT da página de documentação Associar o Looker à sua base de dados.

  • Fuso horário da base de dados: o fuso horário no qual a base de dados armazena informações baseadas no tempo. O Looker (Google Cloud core) precisa de saber isto para poder converter valores de tempo para os utilizadores, o que facilita a compreensão e a utilização de dados baseados no tempo. Consulte a página de documentação Usar definições de fuso horário para mais informações.

  • Fuso horário da consulta: a opção Fuso horário da consulta só é visível se tiver desativado os fusos horários específicos do utilizador. Consulte a página de documentação Usar definições de fuso horário para mais informações.

Expanda a secção Detalhes do estado para testar as definições da sua associação.

Reveja

Reveja e modifique os detalhes da associação que introduziu nas secções anteriores na secção Rever.

Expanda a secção Detalhes do estado para testar as definições da sua associação. Clique no ícone de edição junto a cada secção para voltar a essa secção e alterar as definições.

A guardar e testar a ligação

Para guardar as alterações feitas à ligação de início rápido do BigQuery, clique em Guardar.

Pode testar as definições de ligação a partir de alguns locais na IU do Looker (essencial para o Google Cloud):

  • Expanda a secção Detalhes do estado na parte inferior de qualquer uma das páginas de ligação de início rápido e clique em Testar ligação.
  • Na página Início, expanda a secção Detalhes do estado na parte inferior do mosaico Ligação de início rápido e clique em Testar ligação.
  • Na página de administração Associações, selecione o botão Testar junto à ficha da associação, conforme descrito na página de documentação Associações.

Depois de introduzir as definições de associação, clique em Testar para verificar se as informações estão corretas e se a base de dados consegue estabelecer ligação.

Se a sua ligação não passar num ou mais testes, seguem-se algumas opções de resolução de problemas:

O que se segue?