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.
Encripta el tráfico de red
Una práctica recomendada es 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 bases 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.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 intentar autenticarse en bases de datos MySQL a través del controlador JDBC. Para que esta versión de MySQL funcione correctamente,
debes realizar los siguientes pasos adicionales:
Configura la base de datos de MySQL para usar 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_password
.Configura 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 del RDS de AWS, configura el parámetro
default_authentication_plugin
a través de un grupo de parámetros de RDS que se aplica a esta instancia de base de datos.
Ejecuta los siguientes comandos y reemplaza
some_password_here
por una contraseña única y segura:CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'some_password_here'; GRANT SELECT ON database_name.* TO 'looker'@'%';
MySQL 5.7.X y versiones anteriores, MariaDB y SingleStore:
Ejecuta los siguientes comandos y reemplaza some_password_here
por una contraseña única y segura:
CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('some_password_here');
GRANT SELECT ON database_name.* TO 'looker'@'%';
Configuración del esquema temporal para tablas derivadas persistentes
Estos dialectos de bases de datos admiten la creación de tablas derivadas persistentes (PDT). Esta función puede ser muy útil, y te recomendamos habilitarla siempre que sea posible.
Para habilitar las PDT, debes configurar un esquema temporal. Los siguientes comandos muestran un ejemplo de cómo crear una base de datos temporal y otorgar los privilegios necesarios al usuario de looker
.
Puedes especificar el nombre de la base de datos temporal en el campo Temp Database cuando crees la conexión de la base de datos. Si no especificas un nombre de base de datos temporal, Looker generará una base de datos temporal llamada
looker_tmp
. Los siguientes comandos usanlooker_tmp
, pero si especificaste un nombre de base de datos temporal diferente, usa el nombre de tu base de datos temporal 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'@'%';
En SingleStore, o si tu base de datos usa la replicación basada en GTID, debes usar el parámetro create_process
de LookML para usar las PDT, ya que GTID no admite declaraciones CREATE TABLE AS SELECT
.
Configuración alternativa para tablas derivadas regulares
Aunque no quieras permitir la creación de tablas derivadas persistentes, aún puedes usar tablas derivadas regulares. Para usar tablas derivadas regulares, 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 el caso de MySQL, configura la variable max_allowed_packet
de MySQL en su valor máximo, 1073741824, para evitar que “SQLException: El paquete para la consulta es demasiado grande” errores.
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 de dialecto de tu base de datos: MySQL, MySQL 8.0.12+, MariaDB, SingleStore o SingleStore 7+.
Completa los detalles de la conexión. La mayoría de los parámetros de configuración son comunes a 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 más información.
Para verificar que la conexión se haya realizado correctamente, haz clic en Probar. Consulta la página de documentación Prueba la conectividad de la base de datos para obtener información sobre la solución de problemas.
Para guardar esta configuración, haz clic en Conectar.
Compatibilidad de características
Para que Looker admita algunas funciones, el dialecto de la base de datos también debe admitirlas.
MySQL admite las siguientes funciones a partir de Looker 24.12:
Atributo | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | No |
Agregados simétricos | Sí |
Tablas derivadas | Sí |
Tablas derivadas de SQL persistentes | Sí |
Tablas derivadas persistentes nativas | Sí |
Vistas estables | Sí |
Cierre de consultas | Sí |
Tablas dinámicas basadas en SQL | Sí |
Zonas horarias | Sí |
SSL | Sí |
Subtotales | Sí |
Parámetros adicionales de JDBC | Sí |
Distingue mayúsculas de minúsculas | No |
Tipo de ubicación | Sí |
Tipo de lista | Sí |
Percentil | Sí |
Percentil distintivo | Sí |
Procesos de presentación del ejecutor de SQL | Sí |
Tabla de descripción del ejecutor de SQL | Sí |
Índices de programas del ejecutor de SQL | Sí |
Selección del ejecutor de SQL 10 | Sí |
Recuento de ejecutores de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Bocetos de HLL | No |
Reconocimiento agregado | Sí |
PDT incrementales | Sí |
Milisegundos | Sí |
Microsegundos | Sí |
Vistas materializadas | No |
Recuento aproximado de valores distintos | No |
MySQL 8.0.12 y versiones posteriores admiten las siguientes funciones a partir de Looker 24.12:
Atributo | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | Sí |
Agregados simétricos | Sí |
Tablas derivadas | Sí |
Tablas derivadas de SQL persistentes | Sí |
Tablas derivadas persistentes nativas | Sí |
Vistas estables | Sí |
Cierre de consultas | Sí |
Tablas dinámicas basadas en SQL | Sí |
Zonas horarias | Sí |
SSL | Sí |
Subtotales | Sí |
Parámetros adicionales de JDBC | Sí |
Distingue mayúsculas de minúsculas | No |
Tipo de ubicación | Sí |
Tipo de lista | Sí |
Percentil | Sí |
Percentil distintivo | Sí |
Procesos de presentación del ejecutor de SQL | Sí |
Tabla de descripción del ejecutor de SQL | Sí |
Índices de programas del ejecutor de SQL | Sí |
Selección del ejecutor de SQL 10 | Sí |
Recuento de ejecutores de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Bocetos de HLL | No |
Reconocimiento agregado | Sí |
PDT incrementales | Sí |
Milisegundos | Sí |
Microsegundos | Sí |
Vistas materializadas | No |
Recuento aproximado de valores distintos | No |
A partir de Looker 24.12, MariaDB admite las siguientes funciones:
Atributo | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | Sí |
Agregados simétricos | Sí |
Tablas derivadas | Sí |
Tablas derivadas de SQL persistentes | Sí |
Tablas derivadas persistentes nativas | Sí |
Vistas estables | Sí |
Cierre de consultas | Sí |
Tablas dinámicas basadas en SQL | No |
Zonas horarias | Sí |
SSL | Sí |
Subtotales | Sí |
Parámetros adicionales de JDBC | Sí |
Distingue mayúsculas de minúsculas | No |
Tipo de ubicación | Sí |
Tipo de lista | Sí |
Percentil | Sí |
Percentil distintivo | Sí |
Procesos de presentación del ejecutor de SQL | Sí |
Tabla de descripción del ejecutor de SQL | Sí |
Índices de programas del ejecutor de SQL | Sí |
Selección del ejecutor de SQL 10 | Sí |
Recuento de ejecutores de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Bocetos de HLL | No |
Reconocimiento agregado | Sí |
PDT incrementales | No |
Milisegundos | Sí |
Microsegundos | Sí |
Vistas materializadas | No |
Recuento aproximado de valores distintos | No |
SingleStore admite las siguientes funciones a partir de Looker 24.12:
Atributo | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | No |
Agregados simétricos | Sí |
Tablas derivadas | Sí |
Tablas derivadas de SQL persistentes | Sí |
Tablas derivadas persistentes nativas | Sí |
Vistas estables | Sí |
Cierre de consultas | Sí |
Tablas dinámicas basadas en SQL | Sí |
Zonas horarias | Sí |
SSL | Sí |
Subtotales | Sí |
Parámetros adicionales de JDBC | Sí |
Distingue mayúsculas de minúsculas | No |
Tipo de ubicación | Sí |
Tipo de lista | Sí |
Percentil | No |
Percentil distintivo | No |
Procesos de presentación del ejecutor de SQL | Sí |
Tabla de descripción del ejecutor de SQL | Sí |
Índices de programas del ejecutor de SQL | Sí |
Selección del ejecutor de SQL 10 | Sí |
Recuento de ejecutores de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Bocetos de HLL | No |
Reconocimiento agregado | Sí |
PDT incrementales | No |
Milisegundos | Sí |
Microsegundos | Sí |
Vistas materializadas | No |
Recuento aproximado de valores distintos | No |
SingleStore 7 y versiones posteriores admiten las siguientes funciones a partir de Looker 24.12:
Atributo | ¿Es compatible? |
---|---|
Nivel de asistencia | Admitido |
Looker (Google Cloud Core) | Sí |
Agregados simétricos | Sí |
Tablas derivadas | Sí |
Tablas derivadas de SQL persistentes | Sí |
Tablas derivadas persistentes nativas | Sí |
Vistas estables | Sí |
Cierre de consultas | Sí |
Tablas dinámicas basadas en SQL | Sí |
Zonas horarias | Sí |
SSL | Sí |
Subtotales | Sí |
Parámetros adicionales de JDBC | Sí |
Distingue mayúsculas de minúsculas | No |
Tipo de ubicación | Sí |
Tipo de lista | Sí |
Percentil | Sí |
Percentil distintivo | No |
Procesos de presentación del ejecutor de SQL | Sí |
Tabla de descripción del ejecutor de SQL | Sí |
Índices de programas del ejecutor de SQL | Sí |
Selección del ejecutor de SQL 10 | Sí |
Recuento de ejecutores de SQL | Sí |
Explicación de SQL | Sí |
Credenciales de OAuth | No |
Comentarios contextuales | Sí |
Agrupación de conexiones | No |
Bocetos de HLL | No |
Reconocimiento agregado | Sí |
PDT incrementales | No |
Milisegundos | Sí |
Microsegundos | Sí |
Vistas materializadas | No |
Recuento aproximado de valores distintos | No |