Looker-Conector de Tableau (versión preliminar pública)

El conector de Looker y Tableau te permite usar Tableau Desktop para conectarte a datos desde una exploración de Looker. El conector de Looker a Tableau se basa en la interfaz de Open SQL de Looker, que permite acceder a modelos y exploraciones de LookML para aplicaciones que usan JDBC con el objetivo de conectarse a fuentes de datos. Consulta la documentación de Open SQL Interface para obtener más detalles.

Esta guía es para la versión preliminar pública del conector Looker-Tableau. Para hacer preguntas o compartir comentarios, envía un correo electrónico a tableau-looker@google.com.

Requisitos

Los siguientes componentes son necesarios para usar el conector Looker-Tableau:

Además, debes completar los siguientes pasos antes de configurar el conector Looker-Tableau:

Configurar Tableau Desktop para que se conecte a Looker

Para usar el conector Looker-Tableau en la versión preliminar pública, deberás hacer lo siguiente:

  1. Agrega la app de OAuth de Tableau a tu instancia de Looker: Un administrador de Looker debe usar la API de Looker para registrar la app de OAuth de Tableau para el conector de Looker-Tableau en tu instancia de Looker. La aplicación de OAuth para Tableau debe registrarse solo una vez por cada instancia de Looker y se aplica a todos los usuarios de la instancia de Looker.
  2. Descarga y guarda el archivo del Conector de Tableau y el archivo del controlador de JDBC: Cada usuario que quiera acceder al conector de Looker a Tableau debe descargar el archivo avatica-<release_number>-looker.jar y el archivo del conector de Tableau empaquetado (.taco), y luego guardar los archivos en directorios específicos en su computadora.

En las siguientes secciones, se describen estos pasos en detalle.

Agregar la app de OAuth de Tableau a tu instancia de Looker

El conector de Looker-Tableau requiere que tengas la app OAuth de Tableau en tu instancia de Looker. La forma más fácil de registrar la app de OAuth de Tableau en tu instancia de Looker es a través del Explorador de APIs de Looker.

Si tu instancia de Looker ya tiene instalado el Explorador de APIs, puedes acceder a ella con este formato de URL:

https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/

Si tu instancia de Looker no tiene el Explorador de APIs, puedes instalarlo desde Looker Marketplace. Consulta la página Cómo usar el Explorador de APIs para obtener más información.

Usa el Explorador de APIs para registrar la app de OAuth de Tableau en tu instancia de Looker, como se describe en los siguientes pasos:

  1. Abre el Explorador de APIs de Looker (consulta la página Usa el Explorador de APIs para obtener más información).
  2. En el campo Buscar del Explorador de API, ingresa Registrar app de OAuth.
  3. En los resultados de la búsqueda, haz clic en Registrar app de OAuth.
  4. En la página Registrar app de OAuth, haz clic en el botón Ejecutar.
  5. En la pestaña Request del diálogo Run It, ingresa la siguiente información en los campos correspondientes:

    • client_guid:

      35FBB268-0CB0-4822-AFE3-28638C1C6269
      
    • body:

      {
      "redirect_uri": "http://localhost:55556/Callback",
      "display_name": "Tableau Desktop",
      "description": "Tableau Desktop client for JDBC Server",
      "enabled": true,
      "group_id": ""
      }
      
  6. Selecciona la casilla de verificación Entiendo que este extremo de API cambiará los datos.

  7. Haz clic en Ejecutar.

  8. Puedes verificar que registraste correctamente la app de OAuth de Tableau mediante el método Get OAuth Client App en el Explorador de API:

    • En el campo Buscar del Explorador de API, ingresa Obtener app cliente de OAuth.
    • Haz clic en Ejecutar.
    • En el campo client_guid, ingresa el valor de la aplicación Tableau OAuth:

      35FBB268-0CB0-4822-AFE3-28638C1C6269
      

    Si registraste correctamente la aplicación Tableau OAuth, la pestaña Respuesta devolverá los valores que ingresaste cuando registraste la aplicación.

Este paso no es obligatorio; sin embargo, si en el futuro ya no usarás el conector Looker-Tableau y deseas eliminar la aplicación Tableau OAuth, consulta Cómo eliminar la aplicación OAuth.

Descarga y guarda los archivos del conector

Para usar el conector Looker-Tableau, cada usuario de Tableau debe descargar estos dos archivos:

En las siguientes secciones, se proporcionan instrucciones para descargar estos archivos y dónde colocarlos en tu computadora.

Archivo del conector de Tableau (.taco)

El archivo del conector de Tableau se llama looker-jdbc-v0.2.0.taco. Cada usuario debe descargar el archivo .taco y guardarlo en su computadora siguiendo estos pasos:

  1. Para descargar el archivo del conector de Tableau, haz clic en el siguiente enlace: looker-jdbc-v0.2.0.taco.
  2. Cuando se complete la descarga, mueve el archivo looker-jdbc-v0.2.0.taco al subdirectorio Connectors del directorio My Tableau Repository. Estas son las rutas de acceso predeterminadas a los directorios:

    • Windows: C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors
    • MacOS: /Users/[user]/Documents/My Tableau Repository/Connectors

Archivo de controlador de JDBC (looker.jar)

El controlador de JDBC se llama avatica-<release_number>-looker.jar. Cada usuario debe descargar el archivo looker.jar desde GitHub y guardarlo en su computadora siguiendo estos pasos:

  1. Ve a https://github.com/looker-open-source/calcite-avatica/releases.
  2. Descarga la versión más reciente del archivo avatica-<release_number>-looker.jar.
  3. Guarda el archivo avatica-<release_number>-looker.jar en la computadora de cada usuario en la siguiente ubicación:

    • Windows: C:\Program Files\Tableau\Drivers
    • MacOS: /Library/JDBC o ~/Library/JDBC

Conéctate a los datos de Looker desde Tableau Desktop

Después de agregar la app de OAuth de Tableau a tu instancia de Looker y descargar los archivos looker-jdbc-v0.2.0.taco y avatica-<release_number>-looker.jar, puedes usar Tableau Desktop para conectarte a los datos de tu instancia de Looker siguiendo estos pasos:

  1. En Tableau Desktop, en el panel Conectar de la izquierda, en la sección A un servidor, selecciona la opción Más....
  2. En el cuadro de búsqueda, ingresa Looker JDBC de Google.
  3. Selecciona la opción JDBC de Looker de Google.
  4. En la ventana de diálogo, ingresa estos parámetros:
    • Servidor: Ingresa la URL de la instancia de Looker sin https://. Por ejemplo: example.cloud.looker.com
    • Puerto: 443
    • Autenticación: OAuth
    • URL de instancia de OAuth: Ingresa la URL completa de la instancia de Looker con el https://. Por ejemplo: https://example.cloud.looker.com
  5. Selecciona Acceder. Tableau abrirá una ventana del navegador para conectarte a tu instancia de Looker y autenticar tu cuenta con OAuth.
  6. Si se te solicita, ingresa tus credenciales de OAuth. Si ya accediste, verás un mensaje en la ventana del navegador que indica que Tableau usó la ventana del navegador para autenticarse en Looker y que ahora puedes cerrar la ventana del navegador.
  7. Una vez que te hayas autenticado en Looker, Tableau abrirá una página Fuente de datos con una conexión a tu instancia de Looker.
  8. Usa el menú desplegable Esquema para seleccionar un model de Looker con los datos que quieres ver en Tableau Desktop. Tableau propagará la lista de la Tabla con las Exploraciones de Looker del modelo de Looker que seleccionaste.
  9. Para comenzar a explorar los datos, selecciona y arrastra un objeto de la lista Tablas al lienzo.

Identifica las consultas de Looker a Tableau Connector en la IU de Looker

Las consultas de Tableau se realizan a través de la interfaz de SQL abierto. Los administradores de Looker pueden usar la IU de Looker para identificar qué consultas se originaron en la interfaz de SQL abierta, como se describe en la documentación de Interfaz de SQL abierta.

Las consultas del conector Looker-Tableau tienen un valor de Fuente de “sql_interface” o “Interfaz SQL”.

Aspectos para tener en cuenta

Cuando explores los datos de Looker con Tableau Desktop, ten en cuenta las siguientes consideraciones:

  • El conector de Looker a Tableau se basa en la interfaz de Open SQL de Looker y tiene las mismas limitaciones de LookML que la interfaz de SQL abierta. Consulta la documentación de Open SQL Interface para obtener más detalles.
  • Tableau consulta automáticamente la base de datos cada vez que se realiza un cambio en la consulta, incluso cuando se agregan y eliminan campos mediante el conector Looker-Tableau. Puedes desactivar las actualizaciones automáticas en Tableau: Consulta la documentación de Tableau para obtener más información.
  • No puedes usar Tableau para unir dos exploraciones de Looker. Si quieres unirte a Explorar, usa Looker para crear las uniones en tu modelo de Looker. Consulta las páginas de documentación de Looker Trabaja con uniones en LookML y Parámetros de unión para obtener información sobre el uso de uniones en Looker.

Cómo informar un error

Para informar un error, envía un correo electrónico a tableau-looker@google.com e incluye la siguiente información:

  • Una lista detallada de los pasos que seguiste
  • El comportamiento esperado
  • El comportamiento real (con una captura de pantalla, si es posible)

Eliminar la aplicación Tableau OAuth (opcional)

Este paso no es obligatorio. Sin embargo, si en el futuro ya no usas el conector de Looker-Tableau y quieres quitar la app de OAuth de Tableau de tu instancia de Looker, puedes hacerlo con el Explorador de APIs siguiendo estos pasos:

  1. Abre el Explorador de APIs de Looker (consulta la página Usa el Explorador de APIs para obtener más información).
  2. En el campo Búsqueda del Explorador de API, ingresa Borrar la aplicación cliente de OAuth.
  3. En los resultados de la búsqueda, haz clic en Borrar la app cliente de OAuth.
  4. En la página Borrar la app cliente de OAuth, haz clic en el botón Ejecutar.
  5. En la pestaña Request del diálogo Run It, ingresa el valor client_guid de la app de OAuth de Tableau:

    35FBB268-0CB0-4822-AFE3-28638C1C6269
    
  6. Selecciona la casilla de verificación Entiendo que este extremo de API cambiará los datos.

  7. Puedes verificar que quitaste con éxito la app de OAuth de Tableau mediante el método Get OAuth Client App en el Explorador de API:

    • En el campo Buscar del Explorador de API, ingresa Obtener app cliente de OAuth.
    • Haz clic en Ejecutar.
    • En el campo client_guid, ingresa el valor de la aplicación Tableau OAuth:

      35FBB268-0CB0-4822-AFE3-28638C1C6269
      

    Si quitaste correctamente la app de OAuth de Tableau, la pestaña Respuesta mostrará valores de cuerpo vacíos.