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:

estén instaladas las herramientas de desarrollo descritas en Configuración de un entorno de prueba local .
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	Inicie Windows PowerShell.
2	Vaya al directorio `scripts/` .
3	Ejecutar `extraction_cdata.ps1`.

Nota: si su 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	Inicie 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 detalles sobre las ejecuciones del trabajo de CData Sync, dirígete a tu instancia de CData Sync y comprueba la pestaña Registro e historial de tu trabajo. Consulta la siguiente ilustración.

Para registrar más detalles, establece el nivel de detalle 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 EXITOSA para el trabajo.
-1	Error de extracción para el trabajo.
-2	Error al realizar la extracción. Verifique su configuración o busque en la pestaña Registro e historial de su 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 de `dbt` se completó con al menos un error manejado (p. Ej. error de sintaxis del modelo, permisos incorrectos, etc.). Se ha completado la ejecución, 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 tarda mucho tiempo, se puede inspeccionar response.txt en el directorio scripts/ . Este contiene las respuestas en tiempo real de dbt. Una vez que se han completado dbt test o dbt run , la información se adjunta al LogFile.log y se elimina el archivo temporal.