Configuración del administrador: Conexiones

Para acceder a la página Conexiones, abre el menú Administrador y, en Base de datos, elige Conexiones.

Visualiza conexiones

En la página Conexiones, puedes ver las conexiones de tu base de datos y las direcciones IP que se necesitan para permitir el tráfico de red. Si se habilitó la capacidad de crear una base de datos nueva para tu instancia, también puedes agregar una conexión nueva.

Pestaña Bases de datos

En la pestaña Bases de datos, se muestra información básica sobre las conexiones de base de datos que definiste. También muestra las conexiones administradas por Looker que creaste, si se habilitó la capacidad de crear una base de datos nueva para tu instancia. También puedes probar el estado de esas conexiones y editar su configuración desde la pestaña Bases de datos.

Puedes hacer clic en Direcciones IP públicas para ver la lista de direcciones IP que se necesitan para permitir el tráfico de red desde tu instancia de Looker. Todo el tráfico de red de Looker provendrá de una de las direcciones IP de la lista, según la región en la que se aloje tu instancia de Looker. Prohibir el tráfico a tu base de datos, excepto desde estas y otras direcciones IP de confianza, es una forma de limitar el acceso a los datos.

Si tienes el rol de administrador, puedes hacer clic en el botón Probar accesibilidad en la parte superior de la página Conexiones de Looker para verificar si Looker puede acceder a un nombre de host y un puerto a través de la red. Para obtener más información, consulta Diagnóstico de accesibilidad de la red.

En la siguiente tabla, se describen los elementos de la pestaña Bases de datos:

Columna Descripción
Nombre Es el nombre de la conexión, que tú eliges, que se usa en el parámetro de LookML connection. Cuando pruebas la conexión, Looker muestra la lista de verificaciones de estado debajo del nombre de la conexión.
Base de datos Es el nombre de la base de datos que Looker consultará cuando use esta conexión.
Alcance Si la conexión se puede usar con todos los proyectos o solo con uno específico.
Servidor SSH Es el nombre de la configuración del servidor SSH que se usa para crear un túnel SSH a tu base de datos. Esta columna solo se muestra si la pestaña Servidores SSH está habilitada en tu instancia de Looker.
SSL Si usas o no la encriptación SSL para proteger los datos que viajan entre Looker y tu base de datos (hay otras opciones seguras además de SSL).
Tipo Es el dialecto de SQL de la conexión de la base de datos.
Acciones Acciones que puedes realizar para una conexión: probar una conexión, editar una conexión, ver otra información sobre una conexión, saltar a una lista de vínculos a las exploraciones de la conexión o borrar una conexión. Si se habilitó la capacidad de crear una base de datos nueva para tu instancia, también puedes agregar datos de una fuente de datos adicional a cualquier conexión administrada por Looker.

Pestaña Servidores SSH

La pestaña Servidores SSH no está disponible para las instancias de Looker (Google Cloud Core).

La opción Servidor SSH está disponible si se implementa una instancia de Looker (original) en la infraestructura de Kubernetes y solo si se habilitó la capacidad de agregar información de configuración del servidor SSH a tu instancia de Looker. Si esta opción no está habilitada en tu instancia de Looker y deseas habilitarla, comunícate con un especialista en ventas de Google Cloud o abre una solicitud de asistencia.

Looker elige automáticamente el puerto de localhost cuando creas túneles SSH; no puedes especificar el puerto de localhost.

Las conexiones SSH a bases de datos de PrestoDB o Trino pueden requerir una configuración adicional de la base de datos. Cuando se habilita SSL, la base de datos de PrestoDB o Trino escucha de forma predeterminada en el puerto 443. Para establecer el túnel SSH, Looker debe configurar el puerto de localhost en 443, que ya está en uso por Looker. Esto hará que falle la configuración del túnel SSH. Para corregir el problema, configura tu base de datos de PrestoDB o Trino para que escuche en un puerto que no sea el 443 cuando SSL esté habilitado.

En la pestaña Servidores SSH, se enumeran las configuraciones de servidores SSH que agregaste, se indica el estado de las conexiones a los servidores SSH y se enumeran las conexiones de base de datos que usan cada servidor SSH. En la pestaña Servidores SSH, también puedes probar una conexión a un servidor SSH y agregar o editar configuraciones de servidores SSH.

En la siguiente tabla, se describen los elementos de la pestaña Servidores SSH:

Columna Descripción
Nombre del servidor Es el nombre de la configuración del servidor SSH, que tú eliges, que se usa para conectarse a tu base de datos.
Conexiones Es una lista de las conexiones de base de datos que se conectan al servidor SSH. Si haces clic en una conexión de base de datos, se abrirá la página Editar conexión para esa conexión de base de datos.
Menú de opciones de tres puntos Acciones que puedes realizar para una configuración de servidor SSH: probar conexiones a un servidor SSH, agregar una conexión de base de datos a un servidor SSH, editar una configuración de servidor SSH o borrar una configuración de servidor SSH.

Agrega o edita una configuración de servidor SSH

Para agregar una nueva configuración del servidor SSH, sigue estos pasos:

  1. En la pestaña Servidor SSH, haz clic en Agregar servidor.
  2. En el campo Unnamed Server de la esquina superior derecha, ingresa un nombre para la configuración del servidor SSH.
  3. Haz clic en Descargar clave para descargar la clave pública en un archivo de texto. Asegúrate de guardar este archivo para usarlo más adelante.
  4. En el campo Nombre de usuario del servidor, ingresa el nombre de usuario que Looker usará para conectarse al servidor SSH.
  5. En el campo Dirección IP o nombre de host del servidor, ingresa la dirección IP o el nombre de host del servidor SSH.
  6. En el campo Puerto del servidor, ingresa el número de puerto que se usa para conectarse al servidor SSH.
  7. Agrega la clave pública descargada al archivo de claves autorizadas en tu servidor SSH. Consulta la página de documentación Usa un servidor SSH para obtener más información y un ejemplo.
  8. Asegúrate de que se agreguen las direcciones IP de Looker adecuadas a la lista de entidades permitidas en tu servidor SSH para que Looker pueda conectarse al servidor SSH.
  9. Haz clic en Probar y solicitar huella digital para verificar tu conexión al servidor SSH.
  10. Visualiza la nueva configuración de SSH. En esta pantalla, también puedes descargar o ver la clave pública y ver la huella digital única de la configuración del servidor SSH.

Para editar la configuración de un servidor SSH existente, haz clic en el menú de tres puntos Opciones en la fila del servidor SSH seleccionado y elige Detalles del servidor.

Prueba las conexiones a un servidor SSH

Para probar todas las conexiones de la base de datos a un servidor SSH, haz lo siguiente:

  1. Haz clic en el menú de tres puntos Opciones en la fila del servidor SSH elegido.
  2. Elige Probar conexiones.

Looker probará todas las conexiones de la base de datos con ese servidor SSH y mostrará una marca de verificación verde junto al nombre del servidor y todas las conexiones en las que se apruebe la prueba de conexión. Un ícono de signo de exclamación rojo indica que la conexión no pasó la prueba.

Agrega una conexión de base de datos a un servidor SSH

Para agregar una conexión de base de datos nueva con un servidor SSH, sigue estos pasos:

  1. Haz clic en el menú de tres puntos Opciones en la fila del servidor SSH elegido.
  2. Elige Agregar conexión.

Looker muestra la página Configuración de conexión, con el servidor SSH que aparece en el campo Servidor SSH.

Borra una configuración del servidor SSH

Para borrar una configuración de servidor SSH, sigue estos pasos:

  1. Haz clic en el menú de tres puntos Opciones en la fila del servidor SSH que deseas borrar.
  2. Selecciona Borrar servidor.

Prueba las conexiones

Looker te permite probar tus conexiones existentes para asegurarte de que funcionen correctamente. También puedes probar las conexiones a medida que las agregas, como se describe en la página de documentación Conecta Looker a tu base de datos.

Cada prueba de conexión incluye una lista de verificaciones de estado para indicarte si Looker puede usar correctamente la conexión de la base de datos.

Los problemas potenciales se muestran en amarillo, y los errores, en rojo. Si una conexión "pasa", aparece en verde.

Puedes verificar el estado de los siguientes elementos:

  • Una sola conexión haciendo clic en Probar en el extremo derecho de esa conexión
  • Todas las conexiones haciendo clic en el botón Probar todas las conexiones en la parte superior de la página

Hay dos verificaciones que suelen causar confusión:

  • Se puede encontrar el esquema temporal
  • Puede usar tablas derivadas persistentes

No es necesario que se aprueben estas verificaciones para que Looker funcione. Sin embargo, sí necesitas que se aprueben para usar tablas derivadas persistentes, que son una función de modelado muy valiosa.

Diagnósticos de red

Looker proporciona dos herramientas que te ayudan a determinar si un problema de conexión se debe a la red, como una regla de firewall o una ruta faltante, o a la base de datos, como credenciales incorrectas:

Ambas herramientas buscan el nombre de host en el DNS y, luego, intentan abrir una conexión TCP a cada dirección IP que devuelve la búsqueda. Debido a que usan conexiones TCP en lugar de solicitudes de ping de ICMP, un host que bloquea las solicitudes de ping puede mostrarse como accesible.

Diagnóstico de red en los resultados de la prueba de conexión

Cuando una prueba de conexión no puede conectarse a la base de datos, Looker prueba los siguientes extremos y agrega los resultados al final del mensaje de error, en Network Diagnostics::

  • Para todas las conexiones, el host y el puerto que se configuran para la conexión.
  • Para las conexiones de Amazon Athena, el extremo de AWS Glue para la región de AWS de la conexión, en el puerto 443, como glue.us-east-1.amazonaws.com.
  • Para las conexiones de Cloud SQL cuyo campo Host contiene un nombre de conexión de instancia, como my-project:us-central1:my-instance, el extremo sqladmin.googleapis.com en el puerto 443. El conector de Cloud SQL usa este extremo para obtener información y certificados de la instancia.

Looker prueba hasta tres direcciones IP para cada extremo, y el diagnóstico tarda como máximo 3 segundos. Looker no ejecuta diagnósticos de red para las conexiones que usan un túnel SSH.

Por ejemplo, los siguientes diagnósticos muestran que Looker puede llegar al extremo de Athena, pero las conexiones al extremo de AWS Glue se agotan:

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

Cada dirección IP muestra uno de los siguientes resultados:

  • success: Looker abrió una conexión TCP a la dirección IP y al puerto. Si cada dirección IP muestra success, pero la prueba sigue fallando, verifica la configuración de la conexión, como las credenciales, la configuración de SSL y los permisos del usuario de la base de datos.
  • timeout (3000ms): Looker no obtuvo respuesta en un plazo de 3 segundos. Este resultado suele significar que una regla de firewall, un grupo de seguridad o una ruta de red faltante descartan el tráfico.
  • failed: seguido de un motivo: se rechazó la conexión o no se pudo acceder a la red. Por ejemplo, Connection refused significa que no hay nada escuchando en el puerto o que un firewall rechazó la conexión.
  • blocked (sensitive IP): Looker no probó la dirección IP porque se encuentra en un rango restringido.

Si la búsqueda de DNS falla, el extremo muestra DNS resolution failed: seguido del motivo. Verifica que el nombre de host no tenga errores tipográficos. Si la base de datos usa un nombre de host privado, asegúrate de que Looker pueda resolverlo.

Diagnóstico de accesibilidad de la red

Si tienes el rol de administrador de Looker, puedes probar un host de base de datos antes de agregar una conexión o probar un extremo del que dependa una conexión, como sqladmin.googleapis.com en el puerto 443.

Para probar la accesibilidad de la red, sigue estos pasos:

  1. En la página Conexiones, haz clic en el botón Probar accesibilidad en la parte superior de la página.
  2. En el cuadro de diálogo Diagnóstico de accesibilidad de la red, en el campo Nombre de host o dominio, ingresa un nombre de host o una dirección IP.
  3. En el campo Puerto, ingresa el puerto que deseas probar. El valor predeterminado es 443.
  4. Haz clic en Probar.

Looker prueba hasta cinco direcciones IP para el nombre de host, y la prueba tarda como máximo 3 segundos. Este es un ejemplo de un diálogo de Diagnóstico de accesibilidad de la red que muestra los resultados de la prueba para un nombre de host y un puerto:

Cuadro de diálogo Diagnóstico de accesibilidad de la red que muestra los resultados de la prueba para un nombre de host y un puerto.

Para cada dirección IP, el diálogo muestra un mensaje, el tiempo que tardó la conexión en milisegundos si se realizó correctamente y uno de los siguientes estados:

  • Conectado: Looker abrió una conexión TCP a la dirección IP y al puerto.
  • Se agotó el tiempo de espera: Looker no obtuvo respuesta en un plazo de 3 segundos.
  • Error: Se rechazó la conexión o no se pudo acceder a la red. En el mensaje, se muestra el motivo.
  • SSRF bloqueada: Looker no probó la dirección IP porque se encuentra en un rango restringido. Estas restricciones protegen contra la falsificación de solicitudes del servidor (SSRF).

Si Looker no puede resolver el nombre de host o si el puerto está restringido, el diálogo mostrará un mensaje de error en lugar de los resultados.

Direcciones y puertos restringidos

Para proteger tu instancia, el diagnóstico de red de Looker no prueba las direcciones IP en los siguientes rangos:

  • Rangos de direcciones de bucle invertido, de vínculo local, de multidifusión y otros rangos de direcciones restringidos, incluida la dirección del servidor de metadatos 169.254.169.254.
  • Rangos de direcciones privadas (10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16) en instancias de Looker (Google Cloud Core) que solo usan conexiones seguras públicas.

Además, la función Probar accesibilidad no prueba algunos puertos que están restringidos por motivos de seguridad, como el puerto 22. Si ingresas uno de estos puertos, el diálogo mostrará un mensaje como Port 22 is restricted from diagnostic probing for security reasons.

Agrega contactos

Para agregar una conexión de base de datos nueva, sigue los pasos que se describen en la página de documentación Conecta Looker a tu base de datos.

Edita conexiones

Para editar una conexión existente, abre la página Conexiones. Para ello, selecciona el menú Administrador y, luego, en Base de datos, elige Conexiones. Haz clic en el botón Editar de la conexión. Aparecerá la misma página que usas para crear una conexión (descrita en la página de documentación Conecta Looker a tu base de datos), pero con la información pertinente ya completada. Realiza los cambios necesarios y, luego, haz clic en Actualizar conexión.

Acciones disponibles para todas las conexiones

Todas las conexiones ofrecen estas opciones en el menú desplegable de ajustes que se encuentra en el extremo derecho de cada conexión:

Opción Descripción
Ejecutor de SQL Esta opción te lleva al Ejecutor de SQL de Looker, con la conexión y el esquema adecuados ya seleccionados.
Explorar Esta opción te lleva a una lista de opciones básicas de exploración generadas automáticamente para tu conexión. No se basan en tus modelos de datos personalizados, pero permiten generar informes rápidos sobre los datos sin procesar de las tablas de tu conexión. Por lo general, esto solo es útil para tener una idea del contenido de la tabla antes de modelar, en lugar de para realizar un análisis de datos real.
Borrar Para borrar una conexión existente, haz clic en el menú desplegable de ajustes que se encuentra en el extremo derecho de una conexión y selecciona Borrar. Tendrás la oportunidad de confirmar la eliminación, pero, una vez que lo hagas, no se podrá deshacer. Si borras una conexión por accidente, se inhabilitarán todas las consultas que la usen y se pueden producir errores de validación de LookML para los desarrolladores. Sin embargo, si vuelves a crear una conexión nueva con el mismo nombre, se restablecerá la funcionalidad.

Acciones disponibles para algunas conexiones

Según el dialecto de la conexión, el menú desplegable de ajustes que se encuentra a la derecha de la conexión puede ofrecer las siguientes opciones adicionales:

Opción Descripción
Mostrar tablas Esta opción te lleva a una página de Explorar de Looker que te permite crear consultas de Explorar de Looker basadas en los metadatos de tu conexión. Aunque esta opción comienza con el nombre del esquema, el nombre de la tabla y el recuento de columnas seleccionados, puedes manipularla como cualquier otra exploración de Looker.
Mostrar bases de datos Esta opción te lleva a una página de Explorar de Looker que te permite crear consultas de Explorar de Looker basadas en los metadatos de tu conexión. Aunque esta opción comienza con el nombre del esquema, el nombre del catálogo, el recuento de tablas y el recuento de columnas seleccionados, puedes manipularla como cualquier otra exploración de Looker.
Mostrar procesos Esta opción te lleva a una página de exploración de Looker que te permite crear consultas de exploración de Looker basadas en los procesos que se ejecutan en esta conexión, el estado en el que se encuentran, el tiempo que llevan ejecutándose y otra información. Esto puede ser útil para determinar la causa si Looker se ejecuta con lentitud o si una consulta no se ejecuta en absoluto.
Mostrar registro de eventos de PDT Esta opción te lleva a una página de exploración de Looker que te permite crear consultas de exploración de Looker basadas en la actividad de la tabla derivada para esta conexión. Los campos disponibles se describen con más detalle en nuestra página de documentación Tablas derivadas persistentes.

Borra una conexión de base de datos de forma segura

Borrar una conexión de base de datos a la que aún hacen referencia los modelos de LookML provoca errores de validación que pueden impedir que los desarrolladores confirmen o combinen ramas. Para borrar una conexión de forma segura, sigue estos pasos:

  1. Identifica las dependencias: En el Modo de desarrollo, usa la búsqueda de proyectos para connection: CONNECTION_NAME para encontrar todos los archivos de modelos de LookML que hacen referencia a la conexión.
  2. Quita las dependencias: Actualiza el parámetro connection en esos archivos de modelo para que apunten a una conexión válida o borra los modelos dependientes si ya no son necesarios.
  3. Valida el contenido: Ejecuta el Validador de contenido para identificar y corregir las vistas o los paneles que dependían de los modelos que usaban la conexión.
  4. Implementa los cambios: Confirma y implementa estos cambios de LookML en la rama de producción.
  5. Borra la conexión: Una vez que se quiten todas las referencias de la rama de producción, navega a Administrador > Base de datos > Conexiones y borra la conexión.