Editar y probar transformaciones de datos

Editing transformations

Consulta las páginas enumeradas a continuación para obtener más información sobre la edición de las transformaciones de datos.

• Estructura de las transformaciones
• Diseñar un registro de eventos
• Consejos para escribir SQL

Ejecutar las consultas

Nota:

Para versiones anteriores a 2023.10.7, Ejecutar todo y Ejecutar archivo están limitados a 10 minutos. A partir de la versión 2023.10.7, Ejecutar todo y Ejecutar archivo están limitados a 1 hora. Se recomienda encarecidamente utilizar un pequeño conjunto de datos para el desarrollo y las pruebas de las transformaciones de datos, para asegurarse de que tus transformaciones no superen este límite de tiempo. Consulta elportal de Process Mining para obtener más información sobre la carga de un conjunto de datos de desarrollo.

Al editar transformaciones, puedes seleccionar Ejecutar consultas para probar tus cambios y ver una vista previa. Ejecuta las consultas que fueron consultas modificadas y todas las consultas relacionadas. Por ejemplo, si se ha modificado cases_input.sql . El comando Ejecutar consultas ejecutaría cases_input.sql y cases.sql, que utiliza los resultados de cases_input.sql.

Los datos resultantes solo estarán disponibles en el editor Transformaciones de datos, no en el editor del panel.

Hay dos tipos de ejecuciones:

• Ejecutar consultas: inicia una ejecución de datos, volviendo a calcular todas las consultas modificadas y sus dependencias.
• Ejecutar archivo: inicia una ejecución para volver a calcular solo el archivo SQL seleccionado actualmente y sus consultas principales. Esta opción te permite probar y depurar personalizaciones en archivos SQL específicos.
  Consejo:

  Puedes seleccionar Cancelar ejecución en cualquier momento para cancelar la ejecución de transformaciones.

Los resultados se muestran en el panel Vista previa.

Nota:

Ejecutar consultas suele ser mucho más rápido que Aplicar a paneles , que inicia una ejecución de datos completa.

Nota:

Ejecutar consultas no afecta a los datos de la aplicación de proceso publicada.

Añadir carpetas y archivos

Puedes crear nuevas carpetas y añadir nuevos archivos en tus transformaciones.

Convenciones de nombres

• Para nombres de archivos, carpetas, campos y tablas:
  • solo puedes utilizar caracteres en minúsculas (az), caracteres en mayúsculas (AZ) y números (0-9);
  • no se pueden utilizar caracteres especiales |*:?"<>\/ para nombres de archivos, carpetas, campos y tablas.
• Para los nombres de archivo, solo puedes utilizar _:. como caracteres especiales.
• Un nombre de archivo no puede comenzar con un _ (guion bajo).

Crear una nueva carpeta o archivo desde el menú de transformaciones

Sigue estos pasos para crear una nueva carpeta o archivo.

Pasos	Acción
1	Navega hasta la ubicación en las transformaciones donde quieres añadir un nuevo archivo o carpeta.
2	Ve al panel Transformaciones y selecciona el icono de menú para abrir el menú de transformaciones.
3	Selecciona la opción aplicable en el menú.
4	Introduce un nombre descriptivo para la nueva carpeta o archivo y selecciona Intro.

La nueva carpeta o archivo se crea en la carpeta seleccionada.

Crear una nueva carpeta o archivo desde el menú contextual

Sigue estos pasos para crear una nueva carpeta o archivo desde el menú contextual.

Pasos	Acción
1	Haz clic con el botón derecho en la carpeta de las transformaciones donde quieres añadir un nuevo archivo o carpeta.
2	Selecciona la opción aplicable en el menú.
3	Introduce un nombre descriptivo para la nueva carpeta o archivo y selecciona Intro.

La nueva carpeta o archivo se crea en la carpeta seleccionada.

Cambios no guardados en archivos

Al editar un archivo .sql , un punto azul indica en la estructura de carpetas de Transformaciones que hay cambios sin guardar.

Cambiar el nombre de una carpeta o archivo

Sigue estos pasos para crear una nueva carpeta o archivo.

Pasos	Acción
1	Haz clic con el botón derecho en la carpeta o el archivo cuyo nombre deseas cambiar para abrir el menú contextual.
2	Selecciona Cambiar nombre.
3	Edita el nombre como desees y selecciona Intro.

Se ha cambiado el nombre de la carpeta o el archivo.

Eliminar una carpeta o un archivo

Sigue estos pasos para crear una nueva carpeta o archivo.

Pasos	Acción
1	Haz clic derecho en la carpeta o archivo que deseas eliminar para abrir el menú contextual.
2	Selecciona Eliminar. Se mostrará un mensaje de confirmación.
3	Selecciona Eliminar para confirmar la eliminación.

La carpeta o el archivo se elimina.

Cómo añadir comentarios en los archivos

Si quieres incluir comentarios en tus archivos de transformaciones SQL o comentar partes del archivo, recomendamos encarecidamente que utilices la sintaxis de comentarios Jinja, que está establecida de forma predeterminada como {# ... #}. Esto también te permite comentar macros.

Sql

{# {{ pm_utils.optional(ref('Cases_base'), '"Case_status"') }} as "Case_status", #}

{# case
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 1000000 
      then {{ pm_utils.as_varchar('>= 1M') }}
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 0 
     then {{ pm_utils.as_varchar('0 - 1M') }}
   when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} is not null
     then {{ pm_utils.as_varchar('< 0') }}
  end as "Case_value_group", #}

Buscar / reemplazar en archivos

En el editor Transformaciones de datos , puedes buscar y reemplazar textos dentro de un único archivo.

Buscar texto

Para buscar un texto en el editor de transformación de datos:

1. Haz clic en un lugar aleatorio en el editor de código, o selecciona el texto en el que deseas buscar otras ocurrencias.
2. Pulsa CTRL+F.
3. Introduce la prueba que quieres buscar en el campo Buscar. Se resaltan todas las apariciones del texto en el archivo actual.
4. Selecciona ENTER para pasar a la siguiente repetición.

Buscar y reemplazar

Para buscar un texto en el editor de transformación de datos:

1. Haz clic en un lugar aleatorio en el editor de código, o selecciona el texto en el que deseas buscar otras ocurrencias.
2. Pulsa CTRL+H.
3. Introduce la prueba que deseas buscar en el campo Buscar e introduce la nueva prueba en el campo Reemplazar. Se resaltan todas las apariciones del texto en el archivo actual.
4. Selecciona ENTER para reemplazar el texto y pasar a la siguiente aparición.

Para buscar un texto en el editor de transformación de datos:

1. Haz clic en el editor de código.
2. Pulsa CTRL+H.
3. Introduce la prueba que deseas buscar en el campo Buscar e introduce la nueva prueba en el campo Reemplazar. Se resaltan todas las apariciones del texto en el archivo actual.
4. Pulsa Crtl+Alt+Enter.
   Consejo:

   También puedes utilizar los iconos Reemplazar o Reemplazar todo.

Buscar/reemplazar en varios archivos

Si quieres Buscar/reemplazar textos en varios archivos, solo puedes hacerlo en un editor externo.

Sigue estos pasos para buscar/reemplazar textos en varios archivos:

1. Exporte transformaciones desde su aplicación de proceso.
   Nota:

   Si tienes cambios pendientes en el editor Transformaciones de datos, utiliza primero Aplicar a los paneles y exporta las transformaciones una vez finalizada la ejecución de datos.

2. Descomprime las transformaciones.
3. Abre las transformaciones en tu editor de código favorito, por ejemplo, Notepad++ o Visual Studio Code.
4. Usar la funcionalidad de esas herramientas para buscar o reemplazar textos en varios archivos.
5. Guarda los archivos.
6. Añadir los archivos de transformación a un archivo .zip archivo.
7. Importe las transformaciones en su aplicación de proceso.
   Nota:

   Cuando se te pregunte qué datos utilizar para una ejecución de datos, selecciona Cancelar si quieres seguir editando las transformaciones antes de realizar una nueva ejecución de datos.

Editar archivos de configuración del proyecto dbt

También puedes abrir los archivos de configuración del proyecto dbt en el editor de Transformaciones de datos , por ejemplo dbt_project.yml.

ADVERTENCIA:

Recomendamos editar la sección vars solo si es necesario. Las otras partes del dbt_project.yml no deben modificarse para garantizar que las transformaciones sigan funcionando correctamente.

Para obtener información detallada sobre dbt, consulta la documentación oficial de dbt.

Hacer que las transformaciones estén disponibles en los paneles

Para que los cambios estén disponibles en los paneles, debes ejecutar una ejecución de datos completa para cargar los datos y ejecutar las transformaciones. Selecciona el botón Aplicar a los paneles para iniciar una ejecución de datos.

Nota:

Dependiendo del tamaño del conjunto de datos, esto puede llevar algo de tiempo.

Tras una ejecución de datos exitosa, las nuevas transformaciones estarán disponibles en el editor del panel y se pueden utilizar para ajustar los paneles.

Nota:

Si tienes una versión publicada de la aplicación de proceso, los usuarios empresariales verán instantáneamente los nuevos datos. Si quieres asegurarte de que tu aplicación publicada sigue funcionando correctamente mientras editas las transformaciones, se recomienda encarecidamente utilizar una aplicación de desarrollo. Sigue estos pasos.

1. Clona tu aplicación para crear una aplicación de desarrollo.
2. Edita y prueba las transformaciones.
3. Exporta las transformaciones desde la aplicación de desarrollo.
4. Importa las transformaciones en tu aplicación de proceso publicada.