Setting up a SQL connector

Introducción

Esta página contiene las instrucciones sobre cómo crear un nuevo conector SQL y conectarlo a tus sistemas de origen.

Requisitos previos

Se supone que las herramientas de desarrollo descritas en Configurar un entorno de prueba local están instaladas.

Crear un nuevo conector SQL

Si desea crear un nuevo conector SQL, puede descargar el conector de plantilla que contiene la configuración básica para un conector SQL.

Iniciar repositorio

Se recomienda almacenar su conector en un sistema de control de versiones, por ejemplo, GitHub.

Paso	Acción
1	Crea un nuevo repositorio que contenga el directorio del conector completo. Este directorio debe tener la misma estructura que el conector descargado (plantilla).

Configurar extracción

Primero, se deben establecer los ajustes de extracción para que apunten al sistema de origen y a la base de datos de ensayo deseados. Estos pasos de configuración deben realizarse una vez para cada entorno de desarrollador y para el entorno de producción.

Paso 1: elija el método de extracción

Cada conector viene con un conjunto de métodos de extracción específicos. Se debe configurar uno de los métodos de extracción para extraer los datos de origen.

Método de extracción	Descripción
Load-from-file	• Configurar un trabajo CData para el extractor Cargar desde archivo . Consulta Extractores: cargar desde archivo. • Use una consulta personalizada específica para este conector, que se proporciona en extractors/load-from-file/instructions.md.
Cargar desde el origen	Para cargar datos de entrada desde un sistema de origen, siga las instrucciones específicas que se encuentran en extractors/load-from-source/instructions.md. El extractor de carga desde el origen solo está disponible en conectores creados para sistemas de origen específicos, por ejemplo, un conector Purchase-to-Pay para SAP.

Paso 2: limitar los datos de origen

Asegúrese de configurar los filtros apropiados para su extractor, para cargar solo los datos necesarios para su análisis. Por ejemplo, limite los datos a los últimos 6 meses, o solo a un departamento específico que sea de interés.

Se pueden encontrar instrucciones específicas sobre el filtrado de los datos de entrada en instructions.md del extractor.

Paso 3: Configurar script de extracción

Si el conector utiliza CData Sync para la extracción de datos, el script extract_cdata.ps1 debe apuntar al trabajo correcto. Sigue estos pasos para configurar el script de extracción.

Paso	Acción
1	En el directorio scripts/ , cambia el nombre config_template.json a config.json. Git ignoraconfig.json , de modo que los entornos de desarrollo y producción pueden usar diferentes configuraciones de extracción.
2	En config.json, cambia el texto JOB_NAME_CREATED_IN_CDATA al trabajo CData que se acaba de crear.

Si el conector no utiliza CData Sync para extraer datos, utilice las instrucciones específicas que se proporcionan en instructions.md.

Configurar transformación

Para realizar la transformación en la base de datos de ensayo correcta, profiles.yml debe tener una referencia a tu base de datos de ensayo para este conector. Estos pasos de configuración deben realizarse una vez para cada entorno de desarrollador y para el entorno de producción. Sigue estos pasos para configurar la transformación.

Paso	Acción
1	Copie el contenido de transformations/profiles.yml de su conector.
2	Pegue los contenidos en su profiles.yml personal para añadirlos. El profiles.yml personal debe ubicarse fuera del directorio del conector.
3	Cambie el contenido para que apunte a su base de datos de ensayo.

Configurar carga

Para realizar la generación de caché mediante el script load.ps1, debe apuntar al entorno de Process Mining en el que está activa la versión de la aplicación correspondiente. Sigue estos pasos para configurar el script de extracción.

Elpaso 1 se puede omitir si ya se realizó durante la configuración de la extracción.

Paso	Acción
1	En el directorio scripts/ , cambia el nombre config_template.json a config.json. Git ignoraconfig.json , de modo que los entornos de desarrollo y producción pueden usar diferentes configuraciones de extracción.
2	En config.json, cambia el texto PROCESS_MINING_ENVIRONMENT al entorno en el que está activa la versión.

Próximos pasos

Cuando el conector SQL está configurado correctamente, se puede ejecutar. Consulta Ejecutar un conector SQL.