Dialectos que usan estas instrucciones
MySQL, MariaDB y SingleStore (antes MemSQL) comparten los requisitos de configuración de la base de datos que se describen en esta página para conectar Looker a tu base de datos de estadísticas. Para configurar MySQL como la base de datos de backend interna de una instancia de Looker alojada por el cliente, consulta Migra la base de datos de backend de Looker a MySQL.
Encripta el tráfico de red
Se recomienda encriptar el tráfico de red entre la aplicación de Looker y tu base de datos. Considera una de las opciones que se describen en la página de documentación Habilita el acceso seguro a la base de datos.
Si te interesa usar la encriptación SSL, consulta esta página de documentación de MySQL.
Usuarios y seguridad
Para crear y otorgar el acceso requerido al usuario de Looker, sigue las instrucciones de la sección correspondiente al dialecto y la versión de tu base de datos.
MySQL 8.4.X
En MySQL 8.4.X, el complemento de autenticación predeterminado es caching_sha2_password, y el complemento mysql_native_password está desactivado de forma predeterminada. Elige uno de los siguientes métodos de autenticación según si SSL está habilitado para tu conexión de Looker:
Cuando te conectas con SSL habilitado (recomendado): El controlador JDBC de Looker admite
caching_sha2_passworden conexiones SSL sin habilitarmysql_native_password. Selecciona SSL cuando crees la conexión de Looker y ejecuta los siguientes comandos para crear el usuario y otorgar privilegios deSELECT:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';Cuando te conectas sin SSL habilitado: Debido a que Looker no habilita la recuperación automática de la clave pública RSA (
allowPublicKeyRetrieval) en las conexiones de bases de datos de clientes sin encriptar, debes autenticarte conmysql_native_password:Configura el servidor de MySQL 8.4.X para habilitar el complemento
mysql_native_passwordcon uno de los siguientes métodos, según tu implementación:- Inicia el servidor de MySQL con la marca
--mysql-native-password=ON. Establece la propiedad en el archivo de configuración
my.cnf:[mysqld] mysql_native_password=ONPara las instancias de MySQL 8.4.X alojadas en la nube en Google Cloud, AWS o Azure, habilita la marca o el parámetro de base de datos
mysql_native_passworden la configuración o el grupo de parámetros de tu instancia si no está habilitado de forma predeterminada y reinicia la instancia de base de datos si es necesario. Consulta la documentación de tu proveedor de servicios en la nube para obtener detalles de configuración.
- Inicia el servidor de MySQL con la marca
Crea el usuario de la base de datos con
mysql_native_passwordy otorga privilegios deSELECT:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
Reemplaza los siguientes marcadores de posición en los comandos anteriores:
- DB_USERNAME: Es el nombre de usuario de la base de datos de Looker, como
looker. - PASSWORD: una contraseña única y segura
- DATABASE_NAME: el nombre de tu base de datos
MySQL 8.0.X
En MySQL 8.0.X, el complemento de autenticación predeterminado es caching_sha2_password. Looker usa el complemento mysql_native_password para autenticarse en las bases de datos de MySQL 8.0.X a través del controlador JDBC. Para que MySQL 8.0.X funcione correctamente, completa los siguientes pasos:
Configura la base de datos de MySQL para que use el complemento
mysql_native_password. Esto se puede hacer de varias maneras y dependerá de cómo se implemente tu base de datos de MySQL 8 y del tipo de acceso que tengas a la configuración:Inicia el proceso con la marca
--default-auth=mysql_native_passwordEstablece la propiedad en el archivo de configuración
my.cnf:
[mysqld] default-authentication-plugin=mysql_native_password- Si tu instancia de base de datos se aloja a través de AWS RDS, establece el parámetro
default_authentication_plugincon un grupo de parámetros de RDS que se aplique a esta instancia de base de datos.
Ejecuta los siguientes comandos y reemplaza
PASSWORDpor una contraseña única y segura:CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON database_name.* TO 'looker'@'%';
MySQL 5.7.X y versiones anteriores, MariaDB y SingleStore:
Ejecuta los siguientes comandos y reemplaza PASSWORD por una contraseña única y segura:
CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';
Configuración del esquema temporal para tablas derivadas persistentes
Estos dialectos de base de datos admiten la creación de tablas derivadas persistentes (PDT). Esta función puede ser muy útil, por lo que te recomendamos que la habilites cuando sea posible.
Para habilitar las PDT, debes configurar un esquema temporal. En los siguientes comandos, se muestra un ejemplo de cómo crear una base de datos temporal y otorgar los privilegios necesarios al usuario looker.
Puedes especificar el nombre de la base de datos temporal en el campo Base de datos temporal cuando creas la conexión de la base de datos. Si no especificas un nombre de base de datos temporal, Looker genera una base de datos temporal llamada
looker_tmp. En los siguientes comandos, se usalooker_tmp, pero si especificaste un nombre de base de datos temporal diferente, usa ese nombre en lugar delooker_tmp.
CREATE SCHEMA looker_tmp;
GRANT
SELECT,
INDEX,
INSERT,
UPDATE,
DELETE,
CREATE,
DROP,
ALTER,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
Para SingleStore, o si tu base de datos usa la replicación basada en GTID, debes usar el parámetro de LookML create_process para usar PDT, ya que GTID no admite sentencias CREATE TABLE AS SELECT.
Configuración alternativa para tablas derivadas normales
Si no quieres permitir la creación de tablas derivadas persistentes, puedes seguir usando tablas derivadas normales. Para usar tablas derivadas normales, debes agregar ciertos permisos a un esquema llamado looker_tmp. Sin embargo, no es necesario que el esquema looker_tmp exista en tu base de datos.
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
Configura la variable max_allowed_packet
En MySQL, establece la variable max_allowed_packet de MySQL en su valor máximo, 1073741824, para evitar errores del tipo "SQLException: Packet for query is too large".
Crea la conexión de Looker a tu base de datos
Después de completar la configuración de la base de datos, puedes conectarte a ella desde Looker. Sigue estos pasos para crear la conexión de Looker a tu base de datos:
- En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
En el menú desplegable Dialecto, selecciona el nombre del dialecto de tu base de datos: MySQL, MySQL 8.0.12+ (para MySQL 8.0.12 y versiones posteriores de 8.X, incluido MySQL 8.4.X), MariaDB, SingleStore o SingleStore 7+.
Completa los detalles de la conexión. La mayoría de los parámetros de configuración son comunes en la mayoría de los dialectos de bases de datos. Consulta la página de documentación Conecta Looker a tu base de datos para obtener información.
Para verificar que la conexión se haya establecido correctamente, haz clic en el botón Probar conexión en la sección Detalles del estado, en la parte inferior de la página Configuración de la conexión.
Si Looker muestra Can Connect, presiona Connect para crear la conexión.
Luego, la conexión de tu base de datos se agrega a la lista de la página Conexiones de Administrador de Looker.
Parámetros de JDBC admitidos
Para MySQL, MariaDB y SingleStore, Looker admite los siguientes parámetros de JDBC en el campo Parámetros de JDBC adicionales de la conexión. Consulta la documentación de tu base de datos para obtener información sobre estos parámetros.
allowMultiQueriesautocommitcharacterSetResultsclientCertificateKeyStorePasswordclientCertificateKeyStoreUrlconnectionAttributesconnectionCollationconnectionTimeZoneconnectTimeoutdefaultAuthenticationPlugindisableSslHostnameVerificationdisconnectOnExpiredPasswordsenabledSslCipherSuitesfailOverReadOnlyfallbackToSystemTrustStoreforceConnectionTimeZoneToSessioninteractiveClientlookerFailovermaxIdleTimemaxQuerySizeToLogoldModeNoPrecisionTimestamppasswordpasswordCharacterEncodingpermitMysqlSchemepinGlobalTxToPhysicalConnectionpreserveInstantsqueryInterceptorsrestrictedAuthrewriteBatchedStatementssocketTimeoutsslModetcpKeepAlivetrustCertificateKeyStorePasswordtrustCertificateKeyStoreUrluseCompressionusePipelineAuthuseruseServerPrepStmtsverifyServerCertificateyearIsDateType
Compatibilidad de funciones
Para que Looker admita algunas funciones, el dialecto de tu base de datos también debe admitirlas.
MySQL admite las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Tabla de descripción del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
MySQL 8.0.12 y versiones posteriores admiten las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Tabla de descripción del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
MariaDB admite las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Tabla de descripción del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
SingleStore admite las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Tabla de descripción del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
SingleStore 7 y versiones posteriores admiten las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Tabla de descripción del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |