Editing data transformations

Ejecutar las consultas

Atención:

Ejecutar todo y Ejecutar archivo están limitados a una hora. Por lo tanto, 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 el portal de Process Mining para obtener más información.

Cuando estés editando transformaciones, puedes seleccionar Ejecutar todo 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 todo 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 todo: inicia una ejecución de datos, volviendo 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 todo suele ser mucho más rápido que Aplicar a paneles , que inicia una ejecución de datos completa.

Nota:

Ejecutar todo 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.

Duplicating a file

Duplicating a SQL file allows you to re-use your queries and make modifications without the need to create a complete new file. It can also help you to make modifications to your queries without changing or damaging the original queries.

Dupicating a file creates a copy of the original file in the same folder directly underneath the duplicated file.

Follow these steps to duplicate of a SQL file.

Pasos	Acción
1	Right-click on the file you want to duplicate to open the context menu.
2	Select Duplicate. The duplicated file is inserted in the same location as the original file.

Copy and paste a file

You can copy a SQL file and paste it in a different location. Copying and pasting a SQL file allows you to re-use your queries and make modifications to your queries without the need to create a complete new file.

Follow these steps to copy and paste a SQL file.

Pasos	Acción
1	Right-click on the file you want to copy to open the context menu.
2	Select Copy.
3	Navigate to the location where you want to paste the file.
4	Right-click and select Paste from the context menu. The copied file is inserted in the selected location.

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.

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.

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", #}

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.