MySQL, MariaDB y SingleStore

Dialectos que usan estas instrucciones

MySQL, MariaDB y SingleStore (anteriormente 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

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 necesario 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 las bases de datos de MySQL a través del controlador JDBC. Para que esta versión de MySQL funcione correctamente, debes seguir los siguientes pasos adicionales:

  1. 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.

    • Establece 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, configura el parámetro default_authentication_plugin a través de un grupo de parámetros de RDS que se aplique a esta instancia de base de datos.
  2. 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, por lo que te recomendamos que la habilites siempre que sea posible.

Para habilitar los 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 crees la conexión a la base de datos. Si no especificas un nombre de base de datos temporal, Looker genera una base de datos de prueba llamada looker_tmp. Los siguientes comandos usan looker_tmp, pero si especificaste un nombre de base de datos temporal diferente, usa ese nombre en lugar de looker_tmp.

CREATE SCHEMA looker_tmp;
GRANT
  SELECT,
  INDEX,
  INSERT,
  UPDATE,
  DELETE,
  CREATE,
  DROP,
  ALTER,
  CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';

En el caso de 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 PDT, ya que GTID no admite instrucciones CREATE TABLE AS SELECT.

Configuración alternativa para tablas derivadas normales

Si no quieres permitir la creación de tablas derivadas persistentes, puedes usar tablas derivadas normales. Para usar tablas derivadas normales, aún debes agregar ciertos permisos a un esquema llamado looker_tmp. Sin embargo, el esquema looker_tmp no es necesario que 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

Para MySQL, establece la variable max_allowed_packet de MySQL en su valor máximo, 1073741824, para evitar errores de "SQLException: Packet for query is too large".

Cómo crear 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:

  1. En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
  2. En el menú desplegable Dialect, selecciona el nombre del dialecto de tu base de datos: MySQL, MySQL 8.0.12 y versiones posteriores, MariaDB, SingleStore o SingleStore 7 y versiones posteriores.

  3. 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 Cómo conectar Looker a tu base de datos para obtener información.

  4. Para verificar que la conexión se haya establecido correctamente, haz clic en Probar. Consulta la página de documentación Cómo probar la conectividad de la base de datos para obtener información sobre la solución de problemas.

  5. Para guardar esta configuración, haz clic en Conectar.

Compatibilidad de características

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 24.20:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistentes
Tablas derivadas persistentes nativas
Vistas estables
Eliminación de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
No
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Cómo mostrar procesos en el Ejecutor de SQL
Tabla de descripción de SQL Runner
Índices de Show de SQL Runner
SQL Runner Select 10
Cantidad de Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios contextuales
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
No
Distinción de recuento aproximado
No

MySQL 8.0.12 y versiones posteriores admiten las siguientes funciones a partir de Looker 24.20:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistentes
Tablas derivadas persistentes nativas
Vistas estables
Eliminación de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
No
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Cómo mostrar procesos en el Ejecutor de SQL
Tabla de descripción de SQL Runner
Índices de Show de SQL Runner
SQL Runner Select 10
Cantidad de Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios contextuales
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
No
Distinción de recuento aproximado
No

A partir de la versión 24.20 de Looker, MariaDB admite las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistentes
Tablas derivadas persistentes nativas
Vistas estables
Eliminación de consultas
Pivotes basados en SQL
No
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
No
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Cómo mostrar procesos en el Ejecutor de SQL
Tabla de descripción de SQL Runner
Índices de Show de SQL Runner
SQL Runner Select 10
Cantidad de Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios contextuales
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
PDT incrementales
No
Milisegundos
Microsegundos
Vistas materializadas
No
Distinción de recuento aproximado
No

SingleStore admite las siguientes funciones a partir de Looker 24.20:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistentes
Tablas derivadas persistentes nativas
Vistas estables
Eliminación de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
No
Tipo de ubicación
Tipo de lista
Percentil
No
Percentil de valores distintos
No
Cómo mostrar procesos en el Ejecutor de SQL
Tabla de descripción de SQL Runner
Índices de Show de SQL Runner
SQL Runner Select 10
Cantidad de Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios contextuales
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
PDT incrementales
No
Milisegundos
Microsegundos
Vistas materializadas
No
Distinción de recuento aproximado
No

SingleStore 7 y versiones posteriores admiten las siguientes funciones a partir de Looker 24.20:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistentes
Tablas derivadas persistentes nativas
Vistas estables
Eliminación de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
No
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
No
Cómo mostrar procesos en el Ejecutor de SQL
Tabla de descripción de SQL Runner
Índices de Show de SQL Runner
SQL Runner Select 10
Cantidad de Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios contextuales
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
PDT incrementales
No
Milisegundos
Microsegundos
Vistas materializadas
No
Distinción de recuento aproximado
No