Configurar Spool: particionado. 

Nombres y columnas del particionado

Con la función de Spool de Vor-Tex , se pueden segmentar los resultados de un origen de datos, es decir, se puede particionar el resultado. Este particionado puede realizarse sobre una o más columnas de respuesta del origen de datos. Sobre cada columna que aplicará como particionado deberá definirse un nombre y sobre qué columna aplicará:

• Nombre: se utilizará como nombre del parámetro de la vista de datos, que podrá ser modificado posteriormente en la vista de datos.

• Columna: puede indicarse por posición [column0] o por nombre, por ejemplo, “account_id”.

En Vor-Tex, el particionado se realiza mediante corte de control, por tanto es importante que los datos estén ordenados por las columnas que se utilizarán para generar el particionado.

Ejemplo

A continuación se presenta un ejemplo sobre una base de datos de 8 columnas que contiene un total de nueve registros. 

Particionado por una columna.

Si se define el particionado según la columna “account_id”,  se particionará el resultado según los valores únicos de esa columna. En el caso de esta tabla, habiendo tres ID (100, 101 y 102), se generarían 3 grupos:

Grupo 1. account_id=100

Grupo 2. account_id=101

Grupo 3. account_id=102

Particionado por más de una columna.

Si define particionar el resultado por mas de una columna, por ejemplo según la columna “account_id” y la columna “country”, se particionará según los valores únicos de la combinación de esas columnas. Siguiendo el ejemplo, en este caso se generarían 5 grupos:

Grupo 1. account_id = 100 y country = ARG

Grupo 2. account_id = 101 y country = ARG

Grupo 3. account_id = 101 y country = USA

Grupo 4. account_id = 102 y country = ARG

Grupo 5. account_id = 102 y country = USA

Configurar Spool en Workspace de VOR-TEX

La configuración de Spool se realiza durante la conexión a un origen de datos. Una vez configurado el origen de datos, en el segundo paso puede activar la funcionalidad de Spool y aplicar configuraciones adicionales.

Las configuraciones del Spool son las siguientes: 

• Usar atributos como cabeceras: si está activado se utilizará la primera fila, los atributos o nombres de las columnas como cabeceras del archivo generado.

• Valores con comillas: permite configurar comillas dobles para encerrar el texto o los valores.

• Carácter de delimitador: permite definir el carácter que separará los valores. Si no selecciona ninguno, por defecto se utilizará la coma.

• Carácter de final de línea: permite definir la cadena de caracteres usada para terminar las líneas producidas. Por defecto es '\r\n' .

Realizadas estas configuraciones, se debe proceder con el guardado de las mismas y avanzar hacia la creación de la vista de datos. Al crear la vista de datos no habrá selección y previsualización de los datos. De todas formas, puede configurar los parámetros, metadatos y multientorno.

Para agregar un método seleccione en su API la vista creada. Una vez seleccionada la vista podrá configurar el método como en el resto de los casos, con la diferencia de que en este caso no deberá configurar plantillas de salida. Una vez que haya guardado su método, puede publicar la API.

Ejecutar método spool

Dado que la ejecución de los métodos de tipo Spool es asincrónica, su ejecución implica dos solicitudes:

• Obtener identificador “uuid”: En caso que la ejecución sea exitosa, la primera solicitud entregará un identificador de tarea en el atributo “uuid”. 

{

  "message": "Response is not ready call later with uuid >> 6a2f32af-a54c-4640-9a23-ea974a9c90c0",

  "code": 409,

  "uuid": "6a2f32af-a54c-4640-9a23-ea974a9c90c0"

}

• Obtención del resultado: para obtener el resultado, deberá ejecutar una segunda solicitud al mismo método, aunque agregando la cabecera X-UUID con el valor obtenido en la solicitud anterior.

curl 'example.com/accounts/v1/accounts' \

--header 'Authorization: ************' \

--header 'X-UUID: 302d9bbf-f789-4d46-9dba-c0210f3d7c98'

Repaso

El Spool es un concepto que viene del trabajo con bases de datos y es incorporado para lograr particionar resultados cuando se trabaja con grandes volúmenes, en busca de tener mas eficiencia y escalabilidad. 

VOR-TEX cuenta con esta funcionalidad, la cual se configura al momento de conectarse a los orígenes de datos con los que se desee trabajar, pudiendo ser de distintos tipos como bases de datos, servicios web, planillas, documentos, entre otros. El particionado de los resultados de un origen de datos, se puede realizar a partir de alguna columna de datos o a partir de distintos valores o categorías, permitiendo trabajar con resultados segmentados a partir de dichos criterios. 

Al configurar spool en la plataforma de VOR.TEX , los usuarios logran: 

• Optimización del rendimiento: Reduce el tiempo de procesamiento y el uso de recursos al manejar los datos por partes.

• Escalabilidad: Soporta operaciones en arquitecturas distribuidas, como microservicios.

• Mejor experiencia del usuario: Facilitar respuestas rápidas y gestionables, mejorando la interacción con APIs.

De esta manera, con VOR-TEX platform, no solo se pueden construir y gestionar APIs en minutos, sino que se pueden construir y gestionar APIs conectadas a grandes volúmenes de datos, garantizando eficiencia, seguridad, escalabilidad y una buena experiencia para los usuarios finales que consuman las APIs.