Dialetos que usam essas instruções
O MySQL, o MariaDB e o SingleStore (antigo MemSQL) compartilham os requisitos de configuração do banco de dados descritos nesta página para conectar o Looker ao seu banco de dados de análise. Para configurar o MySQL como o banco de dados de back-end interno de uma instância do Looker hospedada pelo cliente, consulte Como migrar o banco de dados de back-end do Looker para o MySQL.
Criptografar o tráfego de rede
É uma prática recomendada criptografar o tráfego de rede entre o aplicativo do 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.
Se você quiser usar a criptografia SSL, consulte esta página de documentação do MySQL.
Usuários e segurança
Para criar e conceder o acesso necessário ao usuário do Looker, siga as instruções na seção referente ao dialeto e à versão do seu banco de dados.
MySQL 8.4.X
No MySQL 8.4.X, o plug-in de autenticação padrão é caching_sha2_password, e o plug-in mysql_native_password é desativado por padrão. Escolha um dos seguintes métodos de autenticação, dependendo se o SSL está ativado para sua conexão do Looker:
Ao se conectar com o SSL ativado (recomendado): o driver JDBC do Looker é compatível com
caching_sha2_passwordem conexões SSL sem ativarmysql_native_password. Selecione SSL ao criar a conexão do Looker e execute os seguintes comandos para criar o usuário e conceder privilégios deSELECT:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';Ao se conectar sem o SSL ativado: como o Looker não ativa a recuperação automática de chave pública RSA (
allowPublicKeyRetrieval) em conexões de banco de dados de clientes não criptografadas, é necessário autenticar commysql_native_password:Configure o servidor MySQL 8.4.X para ativar o plug-in
mysql_native_passwordusando um dos seguintes métodos, dependendo da implantação:- Inicie o servidor MySQL com a flag
--mysql-native-password=ON. Defina a propriedade no arquivo de configuração
my.cnf:[mysqld] mysql_native_password=ONPara instâncias do MySQL 8.4.X hospedadas na nuvem no Google Cloud, na AWS ou no Azure, ative a flag de banco de dados ou o parâmetro
mysql_native_passwordna configuração da instância ou no grupo de parâmetros, se não estiver ativado por padrão, e reinicie a instância do banco de dados, se necessário. Consulte a documentação do seu provedor de nuvem para ver detalhes de configuração.
- Inicie o servidor MySQL com a flag
Crie o usuário do banco de dados com
mysql_native_passworde conceda privilégios deSELECT:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
Substitua os seguintes marcadores de posição nos comandos anteriores:
- DB_USERNAME: o nome de usuário do banco de dados do Looker, como
looker - PASSWORD: uma senha exclusiva e segura.
- DATABASE_NAME: o nome do banco de dados.
MySQL 8.0.X
No MySQL 8.0.X, o plug-in de autenticação padrão é caching_sha2_password. O Looker usa o plug-in mysql_native_password para autenticar bancos de dados do MySQL 8.0.X pelo driver JDBC. Para que o MySQL 8.0.X funcione corretamente, siga estas etapas:
Configure o banco de dados MySQL para usar o plug-in
mysql_native_password. Isso pode ser feito de várias maneiras e depende de como o banco de dados MySQL 8 é implantado e do tipo de acesso que você tem à configuração:Inicie o processo com a flag
--default-auth=mysql_native_password.Defina a propriedade no arquivo de configuração
my.cnf:
[mysqld] default-authentication-plugin=mysql_native_password- Se a instância do banco de dados estiver hospedada no AWS RDS, defina o parâmetro
default_authentication_pluginusando um grupo de parâmetros do RDS aplicado a essa instância.
Execute os comandos a seguir, substituindo
PASSWORDpor uma senha exclusiva e segura:CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON database_name.* TO 'looker'@'%';
MySQL 5.7.X e anteriores, MariaDB e SingleStore:
Execute os comandos a seguir, substituindo PASSWORD por uma senha exclusiva e segura:
CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';
Configuração de esquema temporário para tabelas derivadas persistentes
Esses dialetos de banco de dados são compatíveis com a criação de tabelas derivadas persistentes (PDTs). Esse recurso pode ser muito útil, e recomendamos que você o ative sempre que possível.
Para ativar as TDPs, é preciso configurar um esquema temporário. Os comandos a seguir mostram um exemplo de como criar um banco de dados temporário e conceder os privilégios necessários ao usuário looker.
É possível especificar o nome do banco de dados temporário no campo Banco de dados temporário ao criar a conexão do banco de dados. Se você não especificar um nome de banco de dados temporário, o Looker vai gerar um banco de dados de rascunho chamado
looker_tmp. Os comandos a seguir usamlooker_tmp, mas, se você especificou um nome de banco de dados temporário diferente, use esse nome em vez delooker_tmp.
CREATE SCHEMA looker_tmp;
GRANT
SELECT,
INDEX,
INSERT,
UPDATE,
DELETE,
CREATE,
DROP,
ALTER,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
Para o SingleStore, ou se o banco de dados usar replicação baseada em GTID, use o parâmetro LookML create_process para usar TDPs, porque o GTID não é compatível com instruções CREATE TABLE AS SELECT.
Configuração alternativa para tabelas derivadas regulares
Se você não quiser permitir a criação de tabelas derivadas persistentes, ainda poderá usar tabelas derivadas regulares. Para usar tabelas derivadas regulares, você ainda precisa adicionar determinadas permissões a um esquema chamado looker_tmp. No entanto, o esquema looker_tmp não precisa existir no banco de dados.
GRANT
SELECT,
INDEX,
INSERT,
DROP,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
-- Note that the looker_tmp schema does not need to actually exist,
-- even though these permission grants are still needed
Como definir a variável max_allowed_packet
Para o MySQL, defina a variável max_allowed_packet como o valor máximo, 1073741824, para evitar erros "SQLException: Packet for query is too large".
Criar a conexão do Looker com seu banco de dados
Depois de concluir a configuração do banco de dados, você poderá se conectar a ele pelo Looker. Siga estas etapas para criar a conexão do Looker com seu banco de dados:
- Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.
No menu suspenso Dialeto, selecione o nome do dialeto do banco de dados: MySQL, MySQL 8.0.12+ (para MySQL 8.0.12 e versões 8.X mais recentes, incluindo MySQL 8.4.X), MariaDB, SingleStore ou SingleStore 7+.
Preencher os detalhes de 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.
Parâmetros JDBC compatíveis
Para MySQL, MariaDB e SingleStore, o Looker aceita os seguintes parâmetros JDBC no campo Parâmetros JDBC adicionais da conexão. Consulte a documentação do seu banco de dados para mais informações sobre esses parâmetros.
allowMultiQueriesautocommitcharacterSetResultsclientCertificateKeyStorePasswordclientCertificateKeyStoreUrlconnectionAttributesconnectionCollationconnectionTimeZoneconnectTimeoutdefaultAuthenticationPlugindisableSslHostnameVerificationdisconnectOnExpiredPasswordsenabledSslCipherSuitesfailOverReadOnlyfallbackToSystemTrustStoreforceConnectionTimeZoneToSessioninteractiveClientlookerFailovermaxIdleTimemaxQuerySizeToLogoldModeNoPrecisionTimestamppasswordpasswordCharacterEncodingpermitMysqlSchemepinGlobalTxToPhysicalConnectionpreserveInstantsqueryInterceptorsrestrictedAuthrewriteBatchedStatementssocketTimeoutsslModetcpKeepAlivetrustCertificateKeyStorePasswordtrustCertificateKeyStoreUrluseCompressionusePipelineAuthuseruseServerPrepStmtsverifyServerCertificateyearIsDateType
Suporte a recursos
Para que o Looker seja compatível com alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.
O MySQL é compatível com os seguintes recursos a partir do Looker 26.22:
| Recurso | Compatível? |
|---|---|
| Looker (Google Cloud Core) | |
| Conjuntos simétricos | |
| Tabelas derivadas | |
| Tabelas derivadas persistentes em SQL | |
| Tabelas derivadas nativas persistentes | |
| Visualizações estáveis | |
| Encerramento de consultas | |
| Tabelas dinâmicas baseadas em SQL | |
| Fusos horários | |
| SSL | |
| Subtotais | |
| Parâmetros adicionais da JDBC | |
| Diferencia maiúsculas de minúsculas | |
| Tipo de local | |
| Tipo de lista | |
| Percentil | |
| Percentil distinto | |
| Mostrar processos do SQL Runner | |
| Tabela de descrição do SQL Runner | |
| Mostrar índices do SQL Runner | |
| SQL Runner Select 10 | |
| Contagem do SQL Runner | |
| Explicação do SQL | |
| Credenciais do OAuth 2.0 | |
| Comentários de contexto | |
| Pooling de conexão | |
| Esboços HLL | |
| Reconhecimento agregado | |
| TDPs incrementais | |
| Milissegundos | |
| Microssegundos | |
| Visualizações materializadas | |
| Medidas de comparação de períodos | |
| Contagem aproximada aproximada | |
| Modelos analíticos no banco de dados | |
| Agendas personalizadas |
O MySQL 8.0.12+ é compatível com os seguintes recursos a partir do Looker 26.22:
| Recurso | Compatível? |
|---|---|
| Looker (Google Cloud Core) | |
| Conjuntos simétricos | |
| Tabelas derivadas | |
| Tabelas derivadas persistentes em SQL | |
| Tabelas derivadas nativas persistentes | |
| Visualizações estáveis | |
| Encerramento de consultas | |
| Tabelas dinâmicas baseadas em SQL | |
| Fusos horários | |
| SSL | |
| Subtotais | |
| Parâmetros adicionais da JDBC | |
| Diferencia maiúsculas de minúsculas | |
| Tipo de local | |
| Tipo de lista | |
| Percentil | |
| Percentil distinto | |
| Mostrar processos do SQL Runner | |
| Tabela de descrição do SQL Runner | |
| Mostrar índices do SQL Runner | |
| SQL Runner Select 10 | |
| Contagem do SQL Runner | |
| Explicação do SQL | |
| Credenciais do OAuth 2.0 | |
| Comentários de contexto | |
| Pooling de conexão | |
| Esboços HLL | |
| Reconhecimento agregado | |
| TDPs incrementais | |
| Milissegundos | |
| Microssegundos | |
| Visualizações materializadas | |
| Medidas de comparação de períodos | |
| Contagem aproximada aproximada | |
| Modelos analíticos no banco de dados | |
| Agendas personalizadas |
O MariaDB é compatível com os seguintes recursos a partir do Looker 26.22:
| Recurso | Compatível? |
|---|---|
| Looker (Google Cloud Core) | |
| Conjuntos simétricos | |
| Tabelas derivadas | |
| Tabelas derivadas persistentes em SQL | |
| Tabelas derivadas nativas persistentes | |
| Visualizações estáveis | |
| Encerramento de consultas | |
| Tabelas dinâmicas baseadas em SQL | |
| Fusos horários | |
| SSL | |
| Subtotais | |
| Parâmetros adicionais da JDBC | |
| Diferencia maiúsculas de minúsculas | |
| Tipo de local | |
| Tipo de lista | |
| Percentil | |
| Percentil distinto | |
| Mostrar processos do SQL Runner | |
| Tabela de descrição do SQL Runner | |
| Mostrar índices do SQL Runner | |
| SQL Runner Select 10 | |
| Contagem do SQL Runner | |
| Explicação do SQL | |
| Credenciais do OAuth 2.0 | |
| Comentários de contexto | |
| Pooling de conexão | |
| Esboços HLL | |
| Reconhecimento agregado | |
| TDPs incrementais | |
| Milissegundos | |
| Microssegundos | |
| Visualizações materializadas | |
| Medidas de comparação de períodos | |
| Contagem aproximada aproximada | |
| Modelos analíticos no banco de dados | |
| Agendas personalizadas |
O SingleStore é compatível com os seguintes recursos a partir do Looker 26.22:
| Recurso | Compatível? |
|---|---|
| Looker (Google Cloud Core) | |
| Conjuntos simétricos | |
| Tabelas derivadas | |
| Tabelas derivadas persistentes em SQL | |
| Tabelas derivadas nativas persistentes | |
| Visualizações estáveis | |
| Encerramento de consultas | |
| Tabelas dinâmicas baseadas em SQL | |
| Fusos horários | |
| SSL | |
| Subtotais | |
| Parâmetros adicionais da JDBC | |
| Diferencia maiúsculas de minúsculas | |
| Tipo de local | |
| Tipo de lista | |
| Percentil | |
| Percentil distinto | |
| Mostrar processos do SQL Runner | |
| Tabela de descrição do SQL Runner | |
| Mostrar índices do SQL Runner | |
| SQL Runner Select 10 | |
| Contagem do SQL Runner | |
| Explicação do SQL | |
| Credenciais do OAuth 2.0 | |
| Comentários de contexto | |
| Pooling de conexão | |
| Esboços HLL | |
| Reconhecimento agregado | |
| TDPs incrementais | |
| Milissegundos | |
| Microssegundos | |
| Visualizações materializadas | |
| Medidas de comparação de períodos | |
| Contagem aproximada aproximada | |
| Modelos analíticos no banco de dados | |
| Agendas personalizadas |
O SingleStore 7+ é compatível com os seguintes recursos a partir do Looker 26.22:
| Recurso | Compatível? |
|---|---|
| Looker (Google Cloud Core) | |
| Conjuntos simétricos | |
| Tabelas derivadas | |
| Tabelas derivadas persistentes em SQL | |
| Tabelas derivadas nativas persistentes | |
| Visualizações estáveis | |
| Encerramento de consultas | |
| Tabelas dinâmicas baseadas em SQL | |
| Fusos horários | |
| SSL | |
| Subtotais | |
| Parâmetros adicionais da JDBC | |
| Diferencia maiúsculas de minúsculas | |
| Tipo de local | |
| Tipo de lista | |
| Percentil | |
| Percentil distinto | |
| Mostrar processos do SQL Runner | |
| Tabela de descrição do SQL Runner | |
| Mostrar índices do SQL Runner | |
| SQL Runner Select 10 | |
| Contagem do SQL Runner | |
| Explicação do SQL | |
| Credenciais do OAuth 2.0 | |
| Comentários de contexto | |
| Pooling de conexão | |
| Esboços HLL | |
| Reconhecimento agregado | |
| TDPs incrementais | |
| Milissegundos | |
| Microssegundos | |
| Visualizações materializadas | |
| Medidas de comparação de períodos | |
| Contagem aproximada aproximada | |
| Modelos analíticos no banco de dados | |
| Agendas personalizadas |