Ten en cuenta que estás viendo la documentación de Looker. Para obtener la documentación de Looker Studio, visita https://support.google.com/looker-studio.

Se usó la API de Cloud Translation para traducir esta página.

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

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 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 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 autenticar las bases de datos de MySQL a través del controlador de JDBC. Para que esta versión de MySQL funcione de forma correcta, 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 la base de datos de MySQL 8 y del tipo de acceso que tengas a la configuración:
- Comienza 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 la instancia de tu base de datos está alojada 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 aplique 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, por lo que 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 looker.

Puedes especificar el nombre de la base de datos temporal en el campo Base de datos temporal cuando creas tu conexión de base de datos. Si no especificas un nombre para la base de datos temporal, Looker generará una base de datos temporal llamada looker_tmp. Los siguientes comandos usan looker_tmp, pero si especificaste un nombre de base de datos temporal diferente, usa el nombre de tu base de datos temporal 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 las PDT, ya que GTID no admite las declaraciones CREATE TABLE AS SELECT.

Configuración alternativa para las tablas derivadas regulares

Si no deseas permitir la creación de tablas derivadas persistentes, puedes usar tablas derivadas regulares. 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, configura la variable max_allowed_packet de MySQL en su valor máximo, 1073741824, para evitar los errores “SQLException: Packet for query is Too large”.

Creando 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 Dialect, selecciona el nombre del dialecto de la base de datos: MySQL, MySQL 8.0.12+, MariaDB, SingleStore o SingleStore 7+.

Nota: Si estás en una instancia de Looker (Google Cloud Core) y no ves tu dialecto en el menú desplegable Dialecto, consulta la documentación de Looker (Google Cloud Core) para verificar que el dialecto sea compatible con las instancias de Looker (Google Cloud Core).
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 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.

A partir de Looker 24.8, MySQL 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í
Finalización 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 distinto	Sí
Procesos de presentación del ejecutor de SQL	Sí
Tabla de descripción del ejecutor de SQL	Sí
Mostrar índices del ejecutor de SQL	Sí
Selector de SQL 10 Select	Sí
Recuento de ejecutores de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios de contexto	Sí
Agrupación de conexiones	No
Bocetos 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.8, MySQL 8.0.12 y versiones posteriores son compatibles con 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í
Finalización 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 distinto	Sí
Procesos de presentación del ejecutor de SQL	Sí
Tabla de descripción del ejecutor de SQL	Sí
Mostrar índices del ejecutor de SQL	Sí
Selector de SQL 10 Select	Sí
Recuento de ejecutores de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios de contexto	Sí
Agrupación de conexiones	No
Bocetos HLL	No
Reconocimiento agregado	Sí
PDT incrementales	Sí
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Recuento aproximado de valores distintos	No

MariaDB es compatible con las siguientes funciones a partir de Looker 24.8:

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í
Finalización 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 distinto	Sí
Procesos de presentación del ejecutor de SQL	Sí
Tabla de descripción del ejecutor de SQL	Sí
Mostrar índices del ejecutor de SQL	Sí
Selector de SQL 10 Select	Sí
Recuento de ejecutores de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios de contexto	Sí
Agrupación de conexiones	No
Bocetos HLL	No
Reconocimiento agregado	Sí
PDT incrementales	No
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Recuento aproximado de valores distintos	No

A partir de Looker 24.8, SingleStore admite las siguientes funciones:

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í
Finalización 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 distinto	No
Procesos de presentación del ejecutor de SQL	Sí
Tabla de descripción del ejecutor de SQL	Sí
Mostrar índices del ejecutor de SQL	Sí
Selector de SQL 10 Select	Sí
Recuento de ejecutores de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios de contexto	Sí
Agrupación de conexiones	No
Bocetos HLL	No
Reconocimiento agregado	Sí
PDT incrementales	No
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Recuento aproximado de valores distintos	No

A partir de Looker 24.8, SingleStore 7+ 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í
Finalización 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 distinto	No
Procesos de presentación del ejecutor de SQL	Sí
Tabla de descripción del ejecutor de SQL	Sí
Mostrar índices del ejecutor de SQL	Sí
Selector de SQL 10 Select	Sí
Recuento de ejecutores de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios de contexto	Sí
Agrupación de conexiones	No
Bocetos HLL	No
Reconocimiento agregado	Sí
PDT incrementales	No
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Recuento aproximado de valores distintos	No