Google BigQuery

Visão geral

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

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

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

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

  3. No Looker, configure a conexão do Looker com seu 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.

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

A maneira que o Looker pode se autenticar no seu banco de dados do BigQuery é com uma conta de serviço do BigQuery. Você cria a conta de serviço no seu banco de dados do BigQuery usando o Gerenciador de API no Console do Google Cloud. É preciso ter permissões de administrador do Google Cloud para criar a conta de serviço. O Google tem documentações sobre a criação de uma conta de serviço e a geração de uma chave privada.

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

Siga estas etapas para criar uma conta de serviço do BigQuery:

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

  2. Clique em CRIAR CREDENCIAIS e escolha Conta de serviço.

  3. Digite um nome para a nova conta de serviço, se quiser, adicione uma descrição e clique em CRIAR.

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

    • BigQuery > Editor de dados do BigQuery
    • BigQuery > BigQuery Job User (em inglês)

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

    Depois de selecionar os dois papéis, clique em CONTINUAR:

  5. Clique em CRIAR CHAVE.

  6. Selecione JSON em Tipo de chave e clique em CRIAR:

  7. A chave JSON será salva no computador. Lembre-se de lembrar onde ela está salva. NÃO É POSSÍVEL FAZER O DOWNLOAD DO TOQUE NOVAMENTE. Depois de anotar o local do download, clique em FECHAR:

  8. Clique em CONCLUÍDO:

  9. Encontre o endereço de e-mail correspondente à conta de serviço. Você precisará dele para configurar a conexão do Looker ao BigQuery.

  10. Depois de criar a conta de serviço no seu banco de dados do BigQuery, insira essas informações da conta de serviço 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 das Conexões do Looker quando você 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, o que significa que cada usuário do Looker faz a autenticação no Google com suas próprias credenciais do OAuth do Google e autoriza o Looker a acessar o banco de dados.

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

  • Auditar quais usuários do Looker estão executando consultas no banco de dados
  • Aplicar controles de acesso com base em papéis 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 o OAuth:

  • Se um administrador de banco de dados alterar as credenciais de cliente OAuth do BigQuery, as programações ou alertas de um usuário serão afetados. Os usuários precisarão fazer login novamente se o administrador alterar as credenciais do OAuth do BigQuery. Os usuários também podem acessar a página Conta do Looker na página de conta 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. Portanto, em vez de usar resultados em cache sempre que a mesma consulta for executada no período de armazenamento em cache, o Looker usará os resultados em cache somente se o mesmo usuário tiver executado a mesma consulta no período de armazenamento em cache. Para mais informações sobre armazenamento em cache, consulte a página da documentação Como armazenar em cache as consultas e recriar PDTs com grupos de dados.
  • Se você quiser usar tabelas derivadas permanentes (PDTs, na sigla em inglês) em uma conexão do BigQuery com o OAuth, crie uma conta de serviço adicional para o Looker acessar seu banco de dados para processos de PDT. Consulte a seção Tabelas derivadas permanentes em uma conexão do BigQuery nesta página para mais informações.
  • Os administradores, quando fizerem sudo como outro usuário, utilizarão o token de autorização OAuth desse usuário. Consulte a página de documentação Usuários para ver informações sobre como usar o comando sudo.

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á tiver configurado uma tela de permissão OAuth para outro aplicativo no seu projeto, não será preciso criar outro. Basta configurar uma tela de consentimento para todos os aplicativos em um projeto.

As credenciais do OAuth 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 do Console do Desenvolvedor do Google.

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 apropriado. Da mesma forma, o tipo de dados solicitados ao usuário e o grau de acesso necessário aos dados do usuário quando ele se autentica no Google para usar o Looker podem exigir verificação por parte do Google. Saiba mais sobre a verificação na seção Como gerar credenciais do Google OAuth nesta página.

Gerando credenciais do Google OAuth

  1. Acesse o Console do Google Cloud.

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

  3. No menu à esquerda, selecione a página APIs e serviços. Depois clique em Credenciais. Na página Credenciais, clique na seta para baixo no botão Criar credenciais e selecione 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 de OAuth. Para configurar a tela de permissão OAuth, consulte a seção Configurar uma tela de permissão OAuth nesta página.

    Se você já tiver configurado uma tela de permissão OAuth, o Google exibirá 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:

  5. Selecione Aplicativo da Web como o tipo de aplicativo e, quando a página se expandir, digite um nome para o aplicativo, como o Looker, no campo Nome.

  6. No campo Origens JavaScript autorizadas, insira o URL da sua instância do Looker, incluindo 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

  7. No campo URIs de redirecionamento autorizados, 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.

  8. Clique em Criar. O Google exibe seu ID do cliente e sua chave secreta do cliente.

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

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 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 permissão OAuth. Antes de configurar a tela de permissão OAuth, você precisa escolher o tipo de usuário para quem esse aplicativo será disponibilizado. Dependendo da seleção, o app pode exigir a verificação do Google.

Selecione uma opção e clique em Criar. O Google exibe a página Tela de permissão OAuth. É possível configurar essa tela para todos os aplicativos no projeto, inclusive aplicativos internos e públicos.

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

  • O app usa APIs do Google que usam escopos restritos ou sensíveis.
  • A tela de permissão 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 aplicativo, insira o nome do aplicativo ao qual o usuário está concedendo acesso (neste caso, o Looker).

  2. Insira o e-mail de suporte que os usuários precisam entrar em contato para resolver problemas de login.

  3. O Looker requer apenas os escopos padrão. Portanto, nenhuma configuração adicional de escopo é necessária.

  4. No campo Domínios autorizados, 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>.looker.com, o domínio será looker.com. Para implantações do Looker hospedadas pelo cliente, insira o domínio no qual você hospeda o Looker.

    Os campos restantes são opcionais, mas podem ser usados para personalizar ainda mais a tela de consentimento.

  5. Depois de configurar a tela de permissão OAuth, clique em Salvar. Agora é possível continuar o procedimento para gerar suas credenciais do OAuth.

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

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

Para ativar o OAuth na conexão do BigQuery, marque a caixa de seleção Usar OAuth na página Conexão do Looker quando estiver configurando a conexão do Looker com o BigQuery. Quando você clica na caixa de seleção, o Looker exibe 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 no procedimento Como gerar credenciais do Google OAuth nesta página.

Conclua o restante do procedimento conforme descrito na seção Como conectar o Looker ao BigQuery nesta página.

Como os usuários do Looker são autenticados no BigQuery com o OAuth

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

Como fazer a autenticação no Google usando uma consulta

Depois que a conexão do Looker ao BigQuery for configurada para OAuth, ele solicitará que os usuários façam login com suas Contas do Google antes de executarem consultas que usam a conexão do BigQuery. O Looker mostra essa solicitação em "explores", "painéis", "Aparências" e "SQL Runner". Veja um exemplo de uma exploração que usa uma conexão do BigQuery em que o usuário ainda não fez login:

O usuário precisa clicar em Log In e autenticar com OAuth. Depois de fazer a autenticação no BigQuery, o usuário pode clicar no botão Run em "Explorar", e o Looker carregará os dados na guia "Explorar".

Autenticação no Google pela página da conta do usuário

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

  1. No Looker, clique no ícone do perfil e selecione Conta no menu do usuário.
  2. Role para baixo até a seção Credenciais de conexão OAuth e clique no botão Fazer login para se conectar ao banco de dados do BigQuery.
  3. Selecione a conta apropriada na página Fazer login com o Google.
  4. Clique em Permitir na tela de permissão OAuth para permitir que o Looker visualize e gerencie seus dados no Google BigQuery.

Após a autenticação no Google por meio do Looker, é possível sair ou autorizar novamente suas credenciais a qualquer momento na página Conta, conforme descrito em Como personalizar sua conta de usuário. Embora os tokens do Google BigQuery não expirem, o usuário pode clicar em Reautorizar para fazer login com outra Conta do Google.

Revogação de tokens OAuth

Os usuários podem revogar o acesso de aplicativos como o Looker à Conta do Google acessando as 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 de OAuth da conexão do banco de dados de maneira que invalide as credenciais atuais, os usuários precisarão fazer login com a Conta do Google novamente antes de executar qualquer consulta que use essa conexão.

Tabelas derivadas permanentes em uma conexão do BigQuery

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

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

Para ativar as tabelas derivadas permanentes (PDT, na sigla em inglês) na conexão do BigQuery, clique na caixa de seleção Persistent Derived Tables na página Connection do Looker quando estiver configurando a conexão do Looker com o BigQuery. Ao clicar na caixa de seleção, o Looker exibirá o campo Conjunto de dados temporário. Nesse campo, você insere o nome do conjunto de dados que o Looker pode usar para criar PDTs. Você deve configurar este banco de dados ou esquema antecipadamente, com as permissões de gravação apropriadas.

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

  1. Abra o Console do BigQuery no Google Cloud e selecione seu projeto.

  2. Clique no menu de três pontos e selecione Criar conjunto de dados.

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

Agora que você criou o conjunto de dados, especifique o nome dele no campo Dataset Dataset da janela Connections do Looker quando configurar a conexão do Looker no BigQuery.

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

Em conexões do BigQuery que usam OAuth, seus usuários se autenticam no Looker com as credenciais do OAuth. O Looker oferece suporte a PDTs para conexões do BigQuery com o 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 PDT.

É possível configurar uma conta de serviço de PDT no seu 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 seu banco de dados do BigQuery, insira essas informações da conta de serviço e os detalhes do arquivo de certificado nos campos E-mail da conta de serviço de PDT, Arquivo JSON/P12 da conta de serviço de PDT e Senha das janelas Conexões do Looker quando você configurar a conexão do Looker com o BigQuery.

Como 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, clique no botão Add Connection.
  • Para editar uma conexão atual, encontre-a na tabela Databases e clique no botão Edit na listagem da conexão.

Preencha os detalhes de conexão. A maioria dessas configurações é comum para a maioria dos dialetos do 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 esclarecer como elas se aplicam especificamente às conexões do BigQuery:

  • Dialeto: selecione Google BigQuery Standard SQL ou Google BigQuery Legacy SQL.
  • ID do projeto: o ID do projeto do Google Cloud.
  • Conjunto de dados: o nome do conjunto de dados padrão que você pretende usar. Quando uma tabela não tem um conjunto de dados especificado, presume-se que ela esteja nesse conjunto de dados. Também é possível modelar outros conjuntos de dados neste projeto. Isso precisa corresponder ao nome de um conjunto de dados no banco de dados do BigQuery.
  • Usar o OAuth: marque esta caixa 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 nesta página para saber mais sobre como implementar o OAuth na conexão do BigQuery.
  • ID do cliente OAuth: o ID do cliente OAuth. Você recebe essas informações do Console do Google Cloud como uma etapa no procedimento Como gerar credenciais do OAuth do Google. O campo ID do cliente OAuth se aplica somente a conexões do BigQuery que usam OAuth para autenticação do usuário. Esse campo não se aplica às conexões do BigQuery que uma conta de serviço do BigQuery oferece.
  • Chave secreta do cliente OAuth: é a chave secreta do cliente OAuth. Você recebe essas informações do Console do Google Cloud como uma etapa no procedimento Como gerar credenciais do OAuth do Google. O campo Chave secreta do cliente OAuth se aplica somente a conexões do BigQuery que usam OAuth para autenticação do usuário. Esse campo não se aplica às conexões do BigQuery que uma conta de serviço do BigQuery oferece.
  • E-mail da conta de serviço: o endereço de e-mail da conta de serviço do BigQuery. Você recebe esse e-mail do Gerenciador de APIs do Google Cloud como uma etapa no procedimento Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON. O campo E-mail da conta de serviço se aplica somente às conexões do BigQuery que usam uma conta de serviço do BigQuery para autenticação do usuário. Nas conexões do BigQuery que usam OAuth, esse campo não se aplica.
  • Arquivo JSON/P12 da conta de serviço: o arquivo de certificado da conta de serviço do BigQuery. Você faz o download desse arquivo do Gerenciador de APIs do Google Cloud como uma etapa no procedimento Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON. O campo Arquivo JSON/P12 da conta de serviço se aplica somente a conexões do BigQuery que usam uma conta de serviço do BigQuery para autenticação do usuário. Nas conexões do BigQuery que usam OAuth, esse campo não se aplica.
  • Senha: a senha do arquivo de credenciais P12 da conta de serviço do BigQuery. O campo Senha só será aplicado se você tiver selecionado o tipo de chave P12 no procedimento Como criar uma conta de serviço e fazer o download do certificado de credenciais JSON. Se você estiver usando um arquivo de credenciais JSON, deixe o campo Password em branco. O campo Senha não está disponível para conexões do BigQuery que usam OAuth.
  • Tabelas derivadas permanentes: clique para ativar Tabelas derivadas permanentes (PDTs, na sigla em inglês) 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 permanentes nesta página para saber o procedimento.
  • E-mail da conta de serviço de PDT: este campo é exibido somente para conexões do BigQuery ativadas para OAuth e PDTs. O endereço de e-mail da conta de serviço. Esse é o endereço de e-mail criado automaticamente pelo banco de dados do BigQuery no momento da criação da conta de serviço para o Looker usar nos processos de PDT. Consulte Como ativar PDTs para conexões do Looker com o BigQuery usando o OAuth para saber mais informações.
  • Arquivo JSON/P12 da conta de serviço de PDT: este campo é exibido somente para conexões do BigQuery ativadas para OAuth e PDTs. Clique no botão Escolher arquivo para fazer o upload do arquivo de certificado da conta de serviço que o Looker usará para processos de PDT. Esse é o arquivo JSON da chave privada que você salvou como parte do procedimento para criar a conta de serviço. Consulte Como ativar PDTs para conexões do Looker com o BigQuery usando o OAuth para saber mais informações.
  • Senha (para a conta de serviço de PDT): se você optou por usar um arquivo de credenciais .p12 legado em vez de um arquivo JSON como parte do procedimento para criar a conta de serviço que o Looker deve usar para processos de PDT, digite a senha do arquivo de credenciais .p12. Se você estiver usando um arquivo de credenciais JSON, deixe esse campo em branco.
  • Parâmetros adicionais: adicione outros parâmetros JDBC, como rótulos do BigQuery. Consulte a seção Rótulos de job e comentários de contexto para conexões do BigQuery nesta página para mais informações. Estes são outros parâmetros compatíveis:
    • connectTimeout: número de milissegundos para aguardar uma conexão. O padrão é 240000.
    • readTimeout: número de milissegundos para aguardar uma leitura. O padrão é 240000.
    • rootUrl: se você tiver uma instância do BigQuery em uma rede particular, especifique um endpoint alternativo para se conectar ao BigQuery diferente do endpoint público padrão.
  • Conjunto de dados temporário: o conjunto de dados do BigQuery que você criou no Console do BigQuery no Google Cloud para permitir que o Looker grave tabelas derivadas permanentes no seu banco de dados. Consulte a seção Como criar um conjunto de dados temporário para tabelas derivadas permanentes para ver o procedimento.
  • Gigabytes de faturamento máximo: deixe em branco para não ter limite. Leia mais detalhes sobre os preços aqui.
  • Máximo de conexões: pode ser deixado no valor padrão inicialmente. Leia mais sobre essa configuração na seção Max Connections da página de documentação Como conectar o Looker ao seu banco de dados.
  • Tempo limite do pool de conexões: 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 Como conectar o Looker ao seu banco de dados.
  • Pré-cache do SQL Runner: se você quiser que o SQL Runner não pré-carregue informações de tabela e, em vez disso, carregue informações de tabela somente quando uma tabela for selecionada, desmarque essa opção. Saiba mais sobre essa configuração na seção Pré-cache do executor do SQL da página de documentação Como conectar o Looker ao seu banco de dados.
  • Desativar comentário de contexto: essa opção desativa os comentários de contexto em uma conexão do BigQuery. Os comentários do contexto são desativados por padrão nas conexões do BigQuery porque eles invalidam a capacidade do Google BigQuery de armazenar em cache e podem afetar negativamente o desempenho do cache. Para conexões do BigQuery, é recomendável usar rótulos de job em vez de comentários da consulta SQL. 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.
  • 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 do fuso horário do BigQuery.

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

Testando a conexão

  • Clique no botão Testar estas configurações na parte inferior da página Configurações de conexão, conforme descrito na página de documentação Como conectar o Looker ao seu banco de dados.
  • Clique no botão Testar ao lado da listagem de conexão na página Conexões, conforme descrito na página de documentação Conexões.

Para novas conexões, se a opção Pode se conectar aparecer, pressione Adicionar conexão. Isso executa o restante dos 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 OAuth

  1. No Looker, acesse o Modo de desenvolvimento.
  2. Para uma conexão atual do BigQuery que usa OAuth, navegue até os arquivos do projeto de um projeto do Looker que use sua conexão do BigQuery. Para novas conexões do BigQuery que usam OAuth, abra um arquivo de modelo e substitua o valor connection do modelo pelo nome da sua nova conexão do BigQuery e salve o arquivo de modelo.
  3. Abra um dos Explorars ou painéis do modelo e execute uma consulta. Quando você tenta executar uma consulta, o Looker solicita que você faça login com sua Conta do Google. Siga as instruções de login do Google OAuth.

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 na forma de rótulos de jobs 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 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 de ID da instância do Looker que emitiu a consulta. O suporte do Looker pode usar essas informações para ajudar a resolver problemas, se necessário.

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

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

O %3D é a codificação de URL para =. Portanto, os dois rótulos a seguir seriam adicionados 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 que um rótulo de contexto será ignorado.
  • Se a união de rótulos de conexão e rótulos de contexto exceder o máximo de 64 identificadores totais, 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ótulo do BigQuery, mas não verifica a validade dos rótulos de conexão. A configuração de 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 às consultas SQL para dialetos de banco de dados que não sejam o BigQuery. Para 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. É possível ativar os comentários de contexto para uma conexão do BigQuery desmarcando a configuração Desativar comentário de contexto para a conexão do BigQuery. É recomendável manter a configuração padrão em Desativar comentário de contexto para usar o cache do BigQuery. No entanto, se você desmarcar a opção Desativar comentário de contexto para uma conexão do BigQuery, o Looker enviará comentários de contexto SQL e rótulos de jobs do BigQuery para seu banco de dados. A imagem a seguir mostra uma consulta do SQL Runner em um banco de dados do BigQuery em que os comentários sobre o contexto do SQL estão ativados. Veja que o Looker envia ao banco de dados os comentários do contexto SQL e os rótulos de job do BigQuery, além de conter as mesmas informações:

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, seu dialeto do banco de dados também precisa aceitá-los.

Na versão mais recente do Looker, o SQL legado do Google BigQuery é compatível com os seguintes recursos do Looker:

Na versão mais recente do Looker, o SQL padrão do Google BigQuery é compatível com os seguintes recursos do Looker:

Próximas etapas

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