Extensiones de tabla

Las extensiones de tabla le permiten crear tablas de datos con un script de extensiones de análisis. Puede escribir un script TabPy o Rserve personalizado y, opcionalmente, agregar una o más tablas de entrada. Las extensiones de tabla son compatibles con Tableau Cloud, Tableau Server y Tableau Desktop. Este documento se centra en Tableau Cloud.

Nota: De forma similar a una conexión en tiempo real, la extensión de tabla se actualiza cada vez que abre un libro de trabajo o actualiza una fuente de datos.

Ventajas

Las extensiones de tabla tienen los siguientes beneficios tanto para usuarios nuevos como experimentados.

  • Integre fácilmente scripts o funciones avanzadas en Tableau

  • Arrastre fácilmente los datos de las conexiones de datos de Tableau como entrada a los scripts

  • El editor de código bajo facilita la adición de código a las fuentes de datos

  • Se integra con Guía de datos y Explique los datos
  • Se integra con TabPy, Rserve y otras extensiones de análisis

  • Los resultados se pueden utilizar para construir dashboards o visualizaciones

Requisitos previos

Antes de poder usar extensiones de tabla, debe completar la siguiente lista.

Crear una extensión de tablas

Para crear una extensión de tabla, complete los siguientes pasos.

  1. Abra un libro de trabajo publicado.
  2. Abra una fuente de datos o cree una.
  3. En Conexiones, seleccione Nueva extensión de tabla.

    menú de conexiones

  4. Arrástrela al modelo de datos.
  5. (Opcional) Arrastre las tablas desde la conexión de datos al panel de extensión de la tabla para utilizarlas como entrada en su script o función de extensiones de análisis.

    • De forma predeterminada, los datos de Tableau se transfieren a la extensión de análisis y se definen como variable _arg1, una estructura similar a un diccionario como: {‘colum_name’: [1,2,3], ‘column_name_2’: [3,4,5]

      Ejemplo de Python: Los datos de entrada se pueden convertir en un marco de datos de pandas usando lo siguiente.

      import pandas as pddf = (pd.DataFrame(_arg1))

    • Al usar RServe, los datos de entrada se definen como la variable .arg1 y el tipo de datos es una lista de listas con nombre.

    • Para las fuentes de datos relacionales admitidas, puede usar SQL personalizado como entrada en una extensión de tabla. Cuando se utilizan parámetros en la consulta SQL personalizada, cambiar el parámetro hace que la consulta se vuelva a ejecutar y el script se vuelva a calcular. Esto crea una ruta para actualizar dinámicamente los parámetros en un dashboard y filtrar o pasar valores al script de extensión de la tabla.

      fuentes de datos relacionales

  6. En el área Script, escriba su script o llamada de función. El script debe devolver un diccionario o una lista de listas, esencialmente un objeto JSON. Un script para RServe debe devolver un marco de datos o una lista de listas con nombre, mientras que el script para Python debe devolver un diccionario.

    Ejemplo de Python: Usamos el siguiente comando de retorno explícito.

    return df.to_dict(orient='list')

  7. Nota: Las extensiones de tabla no admiten llamar directamente a los extremos de TabPy si TABPY_EVALUATE_ENABLE está deshabilitado en TabPy.

  8. Seleccione Aplicar para ejecutar el script.
  9. (Opcional) Si está relacionando la extensión de la tabla con otra tabla en el modelo de datos, defina la relación entre al menos un campo en cada tabla. Si los campos tienen el mismo nombre, esto puede suceder automáticamente.

  10. Seleccione Actualizar ahora y los resultados aparecerán en la pestaña Tabla de salida.

    tabla de resultados de salida

Nota: Si no define una relación con una tabla en el modelo de datos, la pestaña Tabla de entrada está vacía y mostrará el mensaje "Vista previa de datos no disponible".

  1. (Opcional) En el campo Nombre, escriba un nombre único para la extensión de tabla.
  2. Vaya a la pestaña Hoja para comenzar a explorar y visualizar los datos. Los resultados de una extensión de tabla funcionan como cualquier otro dato en Tableau consultado desde un archivo sin formato o una fuente relacional.
  3. Publique el libro de trabajo para compartirlo. El destino de publicación, Server o Tableau Cloud, debe tener una extensión de análisis del tipo apropiado habilitada y configurada.

Sugerencia para la solución de problemas: Los errores de las extensiones de análisis aparecerán en un mensaje de error de Tableau si hay un problema al ejecutar el script. Si la extensión de su tabla tiene un error, asegúrese de que todo el código y el formato sean correctos e intente usar el botón circular Actualizar fuente de datos, ubicado junto al botón Guardar, o haga clic en Aplicar de nuevo.

Extensiones de tabla frente a extensiones de análisis

Si bien algunos de estos productos no están relacionados, las extensiones de tabla y las extensiones de análisis comparten algunas funcionalidades. La funcionalidad de extensiones de tabla se basa en una conexión con extensiones de análisis para funcionar. Analicemos cada característica.

Extensiones de dashboard

Las extensiones de dashboard permiten que se agreguen aplicaciones web personalizadas a los dashboards mediante el SDK de la extensión del dashboard; sin embargo, este tipo de extensión no está relacionado con las extensiones de tabla.

Extensiones de tabla

La función de extensiones de tabla le permite crear una tabla en una fuente de datos que puede enviar datos y un script a su extensión de análisis y devolver una tabla completa de forma arbitraria como resultado. Los resultados devueltos se muestran como una tabla en el modelo de datos de la pestaña Fuente de datos y como medidas y dimensiones en el libro de trabajo.

Extensiones de análisis

La función de extensiones de análisis le permite ampliar los cálculos de Tableau con lenguajes de programación como Python, herramientas externas y plataformas externas. Después de crear una conexión a una extensión de análisis, puede comunicarse con su servidor externo a través de campos calculados llamados SCRIPT_X o MODEL_EXTERNAL_X, donde X es el tipo de datos de los valores de retorno esperados. Para obtener más información, consulte Pasar expresiones con extensiones de análisis.