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.

• Structure of transformations

• Designing an event log

• Tips for writing SQL

Ejecutar las consultas

Atención:

Para versiones anteriores a 2023.10.7, Ejecutar todo y Ejecutar archivo están limitados a 10 minutos. A partir de 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 sus 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 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 y vuelve a calcular todas las consultas modificadas y sus dependencias.

• Archivo de ejecución: 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:

Puede 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 los 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

Cuando editas un archivo .sql , se indica en la estructura de carpetas de Transformaciones que hay cambios sin guardar.

En el ejemplo anterior, hay cambios sin guardar en el archivo Tags.sql que se encuentra en la carpeta models -> 5_business_logic .

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 de Transformaciones de datos , puedes buscar y reemplazar textos dentro de un solo 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 deseas buscar en el campo Buscar.

   Se resaltan todas las ocurrencias 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 ocurrencias 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 ocurrencias 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 usar 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 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.

Atención:

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 de la aplicación de desarrollo.

4. Importa las transformaciones en tu aplicación de proceso publicada.