Running a SQL connector

Introducción

Esta página contiene instrucciones sobre cómo ejecutar un conector SQL mediante scripts.

Requisitos previos

run.ps1 y load.ps1 deben ejecutarse en el mismo servidor que la instalación de Process Mining para la producción. El script extraction_cdata.ps1 y transform.ps1 también se puede ejecutar desde otras ubicaciones.

Se asume que:

• las herramientas de desarrollo descritas en Configurar un entorno de prueba local están instaladas.
• el conector SQL se configura como se describe en Configuración de un conector SQL.
  Nota:

  El directorio scripts/ del conector contiene un conjunto de scripts estándar para ejecutar y programar la extracción, transformación y carga de datos.

Ejecutar un conector

Sigue estos pasos para ejecutar un conector, extraer, transformar y cargar los datos.

Paso	Acción
1	Inicia Windows PowerShell como administrador.
2	Vaya al directorio scripts/ .
3	Ejecutar run.ps1.

Ejecutar solo extracción

Siga estos pasos para ejecutar solo la extracción.

Paso	Acción
1	Inicia Windows PowerShell.
2	Vaya al directorio scripts/ .
3	Ejecutar extraction_cdata.ps1.

Nota:

Si tu conector no utiliza CData Sync para la extracción de datos, el nombre de extraction_ script será diferente.

Ejecutar solo transformaciones

Sigue estos pasos para ejecutar solo los pasos de transformación.

Paso	Acción
1	Inicia Windows PowerShell.
2	Vaya al directorio scripts/ .
3	Ejecutar transform.ps1.

Cada paso de transformación también se puede ejecutar individualmente.

Ejecutar solo carga

Sigue estos pasos para ejecutar solo los pasos de carga.

Paso	Acción
1	Inicia Windows PowerShell como administrador.
2	Vaya al directorio scripts/ .
3	Ejecutar load.ps1.

Errores de depuración

Se crea un archivo de registro LogFile.log cuando se ejecutan los scripts. Este archivo de registro contiene todas las etapas de la ejecución del trabajo y las marcas de tiempo asociadas. El archivo de registro también devuelve un conjunto mínimo de códigos de error, que podrían servir de guía.

Cargar

Para obtener más detalles sobre la generación de la caché, consulta cache_generation_output.log que se genera en el directorio en el que se encuentra tu script de carga.

Extracciones de CData

Para obtener más información sobre las ejecuciones de trabajos de CData Sync, ve a tu instancia de CData Sync y consulta la pestaña Registro e historial de tu trabajo. Consulta la siguiente ilustración.

Para registrar más detalles, establece Verbosidad del archivo de registro en Verbose y vuelve a ejecutar el script de extracción extraction_cdata.ps1 .

A continuación se muestra una descripción general de los códigos de retorno de un trabajo de CData Sync.

Código	Descripción del registro
0	Extracción correcta para el trabajo.
-1	Error de extracción para el trabajo.
-2	No se pudo realizar la extracción. Comprueba tu configuración o busca en la pestaña Registro e historial para tu trabajo.

Transformaciones

El archivo de registro también devuelve un conjunto de códigos de error del script de transformación. A continuación se muestra una descripción general de los códigos de error.

Código	Descripción del registro
-1	Error dbt run o dbt test general. Esto significa que hay un problema con la instalación o la configuración actual. Consulte la LogFile.log para obtener más información.
0 *	La invocación de dbt se completó sin errores.
1 *	La invocación dbt se completó con al menos un error controlado (p. ej. error de sintaxis del modelo, permisos incorrectos, etc.). La ejecución se completó, pero es posible que se hayan omitido algunos modelos. LogFile.log contiene información adicional que indica si el error se produjo en la fase dbt run o en la fase dbt test .
2 *	La invocación de dbt se completó con un error no controlado (por ejemplo, una interrupción de la red).

• 0, 1 y 2 son códigos de retorno específicos de dbt . Consulta la documentación oficial de dbt sobre los códigos de salida.

Depurar proyectos Dbt grandes

Si ejecutar la transformación lleva mucho tiempo, entonces se puede inspeccionar response.txt en el directorio scripts/ . Contiene las respuestas en tiempo real de dbt. Una vez que dbt test o dbt run se han completado, la información se anexa a LogFile.log y el archivo temporal se elimina.

Programar extracciones de datos

También es posible programar extracciones de datos a intervalos regulares. Consulta Programar la extracción de datos.