Para consultar seus dados, conecte sua instância do Looker (Google Cloud Core) a um banco de dados. Neste guia, descrevemos como usar dialetos compatíveis e configurar opções de conexão específicas.
Para instâncias que usam conexões particulares, talvez seja necessário concluir outras configurações para acessar bancos de dados. A configuração específica depende da configuração de rede da instância do Looker (Google Cloud Core) com que você está trabalhando.
Configurar uma conexão de banco de dados
O Looker (Google Cloud Core) precisa estar conectado a um banco de dados para permitir a análise de dados. Consulte a lista de dialetos compatíveis para saber quais dialetos são compatíveis com o Looker (Google Cloud Core).
É possível criar uma conexão de banco de dados em uma instância do Looker (Google Cloud Core) se você tiver uma das seguintes permissões:
Siga o guia Configurar o Looker que aparece dinamicamente na instância do Looker (Google Cloud Core) para conectar seu banco de dados ou siga as etapas listadas nas páginas de documentação específicas do dialeto. Grande parte das configurações é comum para a maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao seu banco de dados para mais informações sobre os campos comuns na janela de configuração da conexão do Looker.
Há outras etapas se você quiser configurar a conexão do Looker (Google Cloud Core) com qualquer uma das seguintes opções:
Conexões particulares: se a instância do Looker (Google Cloud Core) usar conexões particulares, será necessário configurar o Private Service Connect ou o acesso a serviços particulares (dependendo do tipo de conexão que a instância usa) para conectá-la a qualquer um dos seguintes tipos de bancos de dados:
- Um banco de dados em uma rede diferente no Google Cloud
- Um banco de dados hospedado por outro provedor de serviços de nuvem
- Um banco de dados local
Para configurar uma conexão particular com bancos de dados hospedados por outros provedores de serviços de nuvem, verifique se o projeto do Google Cloud está configurado para rotear o tráfego para esses provedores de serviços de nuvem para permitir a troca de dados. Saiba mais sobre como conectar ambientes de nuvem na página de documentação Padrões para conectar outros provedores de serviços de nuvem ao Google Cloud.
Autenticar com o Application Default Credentials para bancos de dados do BigQuery e do Cloud SQL: as instâncias do Looker (Google Cloud Core) podem usar o Application Default Credentials (ADC) para autenticar no banco de dados, conforme descrito nas seções a seguir:
- Como usar o Application Default Credentials para se conectar a um banco de dados do BigQuery
- Tags de política do BigQuery e mascaramento de dados dinâmico
- Como usar o Application Default Credentials com um banco de dados do BigQuery em um projeto do Google Cloud diferente
- Como usar o Application Default Credentials para se conectar a um banco de dados do Cloud SQL
Autenticar em um banco de dados do BigQuery usando o OAuth: para conexões do BigQuery, o Looker (Google Cloud Core) pode usar as credenciais de aplicativo OAuth que o administrador do Looker usou ao criar a instância do Looker (Google Cloud Core). Consulte a seção Como configurar a autenticação OAuth com o BigQuery nesta página para mais informações.
Como usar o Application Default Credentials para se conectar a um banco de dados do BigQuery
As instâncias do Looker (Google Cloud Core) podem usar o Application Default Credentials (ADC) para autenticação ao configurar uma conexão com um banco de dados SQL padrão do BigQuery. Quando você usa o ADC, a conexão é autenticada no banco de dados usando as credenciais da conta de serviço do projeto do Looker (Google Cloud Core).
Para usar o ADC com um banco de dados do BigQuery, selecione Application Default Credentials no campo Autenticação da página Configurações de conexão da instância do Looker. Para ver o procedimento completo, consulte a documentação sobre como conectar o Looker a um banco de dados do BigQuery.
Se a instância do Looker (Google Cloud Core) usar tabelas derivadas persistentes com um conjunto de dados do BigQuery, você também precisará conceder à conta de serviço do Looker o papel Identity and Access Management (IAM) de Editor de dados do BigQuery.
Se você estiver se conectando a um banco de dados do BigQuery que está em um projeto diferente da sua instância do Looker (Google Cloud Core), será necessário fazer uma configuração adicional. Consulte a seção Como usar o Application Default Credentials com um banco de dados do BigQuery em um projeto Google Cloud diferente.
Identidade temporária de conta de serviço
Se você quiser autenticar no banco de dados do BigQuery usando uma conta de serviço diferente da conta de serviço do projeto do Looker (Google Cloud Core), crie um fluxo de solicitação delegado inserindo outra conta de serviço ou uma cadeia de contas de serviço separadas por vírgulas no campo Conta de serviço personificada. A conta de serviço do Looker (Google Cloud Core) é usada automaticamente como a primeira conta de serviço na cadeia e não precisa ser adicionada ao campo. A última conta de serviço na cadeia (também conhecida como conta de serviço personificada) é a que se autentica no banco de dados.
Ao usar a identidade temporária de conta de serviço, faça o seguinte:
- Ative a API Service Consumer Management.
- Verifique se todas as contas de serviço na cadeia, incluindo a do projeto do Looker (Google Cloud Core), têm as permissões do IAM adequadas.
- Verifique se a conta de serviço representada tem os papéis de Usuário de jobs do BigQuery e de Leitor de dados do BigQuery. Se você precisar inspecionar estados e operações de serviço ou usar a cota e o faturamento de um projeto de consumidor, o papel de consumidor do Service Usage também será necessário.
- Se você tiver ativado as tabelas derivadas persistentes (PDTs) para sua conexão, também será necessário inserir o endereço de e-mail da conta de serviço representada no campo Endereço de e-mail da conta de serviço na seção Substituições de PDT. Isso garante que os processos de TDP usem a conta de serviço representada. Consulte a seção Ativar substituições de TDP na página de documentação Como conectar o Looker ao seu banco de dados para mais informações.
Tags de política do BigQuery e mascaramento dinâmico de dados
Quando o Looker (Google Cloud Core) se conecta ao BigQuery usando o ADC ou uma conta de serviço, o BigQuery não recebe credenciais individuais de usuário do Looker. Como o BigQuery vê apenas uma identidade para todas as consultas, a segurança integrada no nível da coluna do BigQuery (tags de política e mascaramento de dados) não pode aplicar regras diferentes de acesso ou mascaramento a cada usuário do Looker.
Para implementar o mascaramento dinâmico de dados com o Looker (Google Cloud Core) e o BigQuery, considere uma das seguintes opções de arquitetura:
- Mascaramento da camada do aplicativo (compatível com ADC e contas de serviço):
mantenha uma única conexão de banco de dados que use o ADC ou uma conta de serviço e
aplique a lógica de mascaramento de dados na camada semântica do LookML usando instruções
CASE WHENdo LookML orientadas por atributos do usuário mapeados do seu provedor de identidade. - Mascaramento da camada de banco de dados (requer OAuth): configure a conexão do Looker com o BigQuery para usar o OAuth em vez do ADC. O OAuth transmite as credenciais individuais de cada usuário final diretamente para o BigQuery, o que permite que o BigQuery avalie e aplique de forma nativa as tags de política e as regras de mascaramento de dados por usuário.
Como usar o Application Default Credentials com um banco de dados do BigQuery em um projeto Google Cloud diferente
As etapas para usar o ADC em um banco de dados SQL padrão do BigQuery que está fora do projeto que hospeda sua instância do Looker (Google Cloud Core) são as mesmas para configurar uma conexão no mesmo projeto. No entanto, antes de configurar a conexão na instância do Looker (Google Cloud Core), a conta de serviço do projeto do Looker (Google Cloud Core) precisa ter os seguintes papéis do IAM:
- Papel de Visualizador de Dados do BigQuery para o projeto que contém o conjunto de dados do BigQuery.
- Papel de usuário de jobs do BigQuery e papel de consumidor do Service Usage no projeto de faturamento listado na página Configurações de conexão.
- Se a instância do Looker (Google Cloud Core) usar tabelas derivadas persistentes com um conjunto de dados do BigQuery, a conta de serviço também precisará ter o papel de Editor de dados do BigQuery para o projeto que contém o conjunto de dados do BigQuery.
Se a conta de serviço do Looker (Google Cloud Core) ainda não tiver papéis do IAM no projeto que contém o conjunto de dados do BigQuery, 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 console do Google Cloud e marque a caixa de seleção Incluir concessões de papéis 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.
Depois que os papéis adequados forem concedidos, siga as etapas para usar o ADC.
Agora é possível usar o ADC com esse banco de dados SQL padrão do BigQuery. O projeto anexado à conta de serviço especificada na página Configurações de conexão será usado para faturamento e também vai atuar como o projeto padrão.
Como usar o Application Default Credentials para se conectar a um banco de dados do Cloud SQL
As instâncias do Looker (Google Cloud Core) podem usar o ADC para autenticar uma conexão com um banco de dados do Cloud SQL (Cloud SQL para PostgreSQL ou Cloud SQL para MySQL). Quando você usa o ADC para autenticar no banco de dados do Cloud SQL, o projeto do Google Cloud em que o banco de dados do Cloud SQL está em execução é o projeto que é faturado pelas consultas do Looker.
Para conexões do Looker com o Cloud SQL que usam o ADC, o ADC representa uma conta de serviço ou uma cadeia de contas de serviço para acessar seu banco de dados. Ao criar a conexão do Looker com o banco de dados, use o campo Nomes de usuário do banco de dados do IAM para especificar a conta de serviço ou a cadeia de contas de serviço que o ADC vai personificar. A conta de serviço do Looker que foi criada automaticamente quando você criou a instância do Looker (Google Cloud Core) é usada automaticamente como a primeira conta de serviço na cadeia e não precisa ser adicionada ao campo.
Se você quiser autenticar seu banco de dados do Cloud SQL usando uma conta de serviço diferente da do Looker, crie um fluxo de solicitação delegado inserindo outra conta de serviço ou uma cadeia de contas de serviço separadas por vírgulas no campo Nomes de usuário do banco de dados do IAM.
A última conta de serviço na cadeia (também conhecida como conta de serviço representada) é aquela que se autentica no banco de dados. Essa conta precisa ser adicionada como um usuário no banco de dados do Cloud SQL. Se você estiver usando a conta de serviço do Looker como a última conta de serviço na cadeia (deixando o campo Nomes de usuário do banco de dados do IAM em branco), adicione a conta de serviço do Looker como um usuário no banco de dados do Cloud SQL.
Confira a seguir as etapas gerais para conectar um banco de dados do Cloud SQL para PostgreSQL ou do Cloud SQL para MySQL ao Looker usando o ADC:
- Adicione a conta de serviço representada ao banco de dados do Cloud SQL.
- Configure a identidade temporária de conta de serviço no banco de dados do Cloud SQL.
- Conecte-se ao banco de dados para executar outros comandos de configuração do Cloud SQL para PostgreSQL ou do Cloud SQL para MySQL.
- Crie a conexão do Looker com seu banco de dados.
Adicionar a conta de serviço representada ao banco de dados do Cloud SQL
Ao criar a conexão do Looker com o banco de dados, use o campo Nomes de usuário do banco de dados do IAM para especificar a conta de serviço ou a cadeia de contas de serviço que o ADC vai personificar para realizar ações no banco de dados. A última conta de serviço na cadeia de representação é considerada a conta de serviço representada.
Para usar o ADC com o Cloud SQL, adicione a conta de serviço de identidade temporária ao banco de dados do Cloud SQL:
- No caso padrão, se você deixar o campo Nomes de usuário do banco de dados do IAM em branco, o ADC vai personificar a conta de serviço do Looker. Nesse caso, a conta de serviço do Looker é a conta de serviço personificada. Portanto, é necessário adicionar a conta de serviço do Looker ao banco de dados do Cloud SQL. Consulte a página de documentação Criar uma instância do Looker (Google Cloud Core) para mais informações sobre a conta de serviço do Looker e o procedimento para visualizar o endereço de e-mail dela.
- Se você especificar uma conta de serviço diferente da conta de serviço do Looker ou se especificar uma cadeia de contas de serviço no campo Nomes de usuário do banco de dados do IAM, adicione a última conta de serviço na cadeia de personificação ao banco de dados do Cloud SQL.
Para adicionar uma conta de serviço ao banco de dados do Cloud SQL, é preciso ter o papel do IAM de administrador do Cloud SQL.
Siga o procedimento "Adicionar um usuário do IAM ou uma conta de serviço à instância de banco de dados" para que o dialeto do banco de dados adicione a conta de serviço personificada ao banco de dados do Cloud SQL:
Configurar a identidade temporária de conta de serviço no banco de dados do Cloud SQL
Depois de criar o usuário do Cloud SQL no banco de dados, configure o banco de dados do Cloud SQL para personificação de serviço seguindo estas etapas:
- Siga o procedimento para ativar a API Cloud SQL Admin.
- Verifique se todas as contas de serviço na cadeia, incluindo a do Looker, têm as permissões do IAM adequadas.
Siga o procedimento para conceder um único papel no console do Google Cloud . Conceda os seguintes papéis do Cloud SQL à conta de serviço de identidade temporária que você adicionou ao banco de dados do Cloud SQL:
Se você especificar uma conta de serviço diferente da conta de serviço do Looker ou se especificar uma cadeia de contas de serviço no campo Nomes de usuário do banco de dados do IAM, conceda a cada conta de serviço na cadeia a seguinte permissão:
Comandos de configuração adicionais para o Cloud SQL para MySQL
No Cloud SQL para MySQL, conecte-se à instância do banco de dados e execute o seguinte comando no banco de dados do Cloud SQL para MySQL:
GRANT ALL on DATABASE_NAME.* to 'DATABASE_USER'@'%'
Substitua:
- DATABASE_NAME: o nome do banco de dados.
- DATABASE_USER: o nome de usuário da conta de serviço truncado para a conta de serviço representada que você adicionou ao banco de dados do Cloud SQL. A conta de serviço terá o formato
service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Remova o@e tudo o que vem depois dele para truncar o nome de usuário. Após o truncamento, o nome de usuário vai ficar assim:service-<project number>.
Por exemplo, se o nome de usuário da conta de serviço for service-12345678901@gcp-sa-looker.iam.gserviceaccount.com e o nome do banco de dados for looker-test, o comando será o seguinte:
GRANT ALL on looker-test.* to 'service-12345678901'@'%'
Outros comandos de configuração do Cloud SQL para PostgreSQL
No Cloud SQL para PostgreSQL, é preciso se conectar à instância do banco de dados e executar alguns comandos de configuração no banco de dados do Cloud SQL para PostgreSQL:
- Conceda as permissões de usuário no banco de dados, conforme descrito na seção Usuários e segurança da página de documentação do PostgreSQL.
- Defina o caminho de pesquisa que o SQL Runner do Looker vai usar para recuperar metadados do seu banco de dados, conforme descrito na seção Como definir o
search_pathda página do PostgreSQL na documentação do Looker.
Criar a conexão do Looker (Google Cloud Core) com o banco de dados do Cloud SQL
Para criar a conexão do Looker com seu banco de dados, siga estas etapas:
- Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.
- No menu suspenso Dialeto, selecione Google Cloud PostgreSQL ou, para o Cloud SQL para MySQL, selecione Google Cloud SQL.
- Na seção Autenticação, clique na opção Application Default Credentials.
No campo Nomes de usuário do banco de dados do IAM, especifique a conta de serviço ou a cadeia de contas de serviço que você quer que o ADC personifique para realizar ações no banco de dados:
- Se você quiser que o Looker faça a autenticação no banco de dados do Cloud SQL usando a conta de serviço do projeto do Looker (Google Cloud Core), deixe esse campo em branco.
- Se você quiser que o Looker faça a autenticação no banco de dados do Cloud SQL usando uma conta de serviço diferente da conta de serviço do projeto do Looker (Google Cloud Core), crie um fluxo de solicitação delegado inserindo outra conta de serviço ou uma cadeia de contas de serviço separadas por vírgulas.
Preencha o restante dos detalhes da conexão. Grande parte das configurações é comum para a maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao seu banco de dados para mais informações.
Para verificar se a conexão foi bem-sucedida, clique no botão Testar conexão na seção Detalhes do status na parte de baixo da página Configurações de conexões.
Se o Looker exibir Pode se conectar, pressione Conectar para criar a conexão.
A conexão do banco de dados é adicionada à lista na página Administrador de Conexões do Looker.
Depois de configurar uma conexão de banco de dados, você pode configurar um projeto do LookML.
Como configurar a autenticação OAuth com o BigQuery
Para configurar a autenticação OAuth para conexões com um banco de dados do BigQuery em uma instância do Looker (Google Cloud Core), siga estas etapas:
- Em Autenticação, selecione OAuth. Por padrão, o Looker (Google Cloud Core) usa as credenciais de aplicativo OAuth que o administrador do Looker usou ao criar a instância do Looker (Google Cloud Core). Não é necessário criar ou inserir manualmente um ID do cliente e uma chave secreta.
- Adicione outro URI de redirecionamento ao campo URIs de redirecionamento autorizados no cliente OAuth da instância (ou crie um novo cliente OAuth com as credenciais e adicione um URI de redirecionamento). O URI de redirecionamento precisa usar o URL da instância do Looker seguido por
/external_oauth/redirect. Para mais informações, consulte a documentação sobre como gerar credenciais do OAuth para o BigQuery.
Se você quiser inserir manualmente outras credenciais de OAuth para esta conexão, ative a opção Configurar manualmente as credenciais de OAuth e preencha os campos ID do cliente OAuth e Chave secreta do cliente OAuth. Se você inserir as credenciais OAuth manualmente, isso não vai mudar nem atualizar as credenciais usadas quando a instância do Looker (Google Cloud Core) foi criada. Siga as etapas na documentação Configurar um projeto de banco de dados do BigQuery para OAuth para criar e usar credenciais diferentes.
Dialetos compatíveis com o Looker (Google Cloud Core)
A tabela a seguir mostra a compatibilidade do Looker (Google Cloud Core) com dialetos de banco de dados:
| Dialeto | Compatível? |
|---|---|
| Actian Avalanche | |
| Amazon Athena | |
| Amazon Aurora MySQL | |
| Amazon Redshift | |
| Amazon Redshift 2.1+ | |
| Amazon Redshift Serverless 2.1+ | |
| Apache Druid | |
| Apache Druid 0.13.x - 0.17.x | |
| Apache Druid 0.18+ | |
| Apache Hive 2.3+ | |
| Apache Hive 3.1.2+ | |
| Apache Spark 3+ | |
| ClickHouse | |
| ClickHouse 26+ | |
| Cloudera Impala 3.1+ | |
| Cloudera Impala 3.1+ with Native Driver | |
| Cloudera Impala with Native Driver | |
| DataVirtuality | |
| Databricks | |
| Denodo 7 | |
| Denodo 8 & 9 | |
| Dremio | |
| Dremio 11+ | |
| Dremio 26+ with Arrow Flight SQL | |
| Exasol | |
| Google BigQuery Legacy SQL | |
| Google BigQuery Standard SQL | |
| Google Cloud AlloyDB for PostgreSQL | |
| Google Cloud PostgreSQL | |
| Google Cloud SQL | |
| Google Spanner | |
| Greenplum | |
| HyperSQL | |
| IBM Netezza | |
| MariaDB | |
| Microsoft Azure PostgreSQL | |
| Microsoft Azure SQL Database | |
| Microsoft Azure Synapse Analytics | |
| Microsoft SQL Server 2008+ | |
| Microsoft SQL Server 2012+ | |
| Microsoft SQL Server 2016 | |
| Microsoft SQL Server 2017+ | |
| MongoBI | |
| MongoSQL | |
| MySQL | |
| MySQL 8.0.12+ | |
| Oracle | |
| Oracle ADWC | |
| PostgreSQL 9.5+ | |
| PostgreSQL pre-9.5 | |
| PrestoDB | |
| PrestoSQL | |
| SAP HANA | |
| SAP HANA 2+ | |
| SingleStore | |
| SingleStore 7+ | |
| Snowflake | |
| Teradata | |
| Trino | |
| Vector | |
| Vertica |
Instruções de configuração do banco de dados
As instruções estão disponíveis para estes dialetos SQL:
A seguir
- Configurar uma instância do Looker (Google Cloud Core)
- Gerenciar usuários no Looker (Google Cloud Core)
- Administrar uma instância do Looker (Google Cloud Core) no console do Google Cloud
- Configurações de administrador do Looker (Google Cloud Core)
- Usar o exemplo de projeto do LookML em uma instância do Looker (Google Cloud Core)