Skip to main content

Table Structure

Table Structure | Sybot Documentation

Table Structure

La Table Structure è una funzionalità trasversale del sistema che permette di definire, salvare e riutilizzare la mappatura dei campi (alias, tipi e precisione) all'interno di diversi task di processamento dati. Questa astrazione garantisce la coerenza dei dati lungo il workflow e riduce drasticamente gli errori di configurazione manuale.

Task Compatibili​

La gestione della Table Structure è disponibile nei seguenti task:

Funzionalità Principali

1. Mappatura dei Campi​

tablestructure_01.png

All'interno dei task compatibili è presente una tabella di configurazione per definire la struttura dei dati in uscita:

  • Tipo: Definisce la natura del campo (es. NUMERICO).
  • Alias / Nome Campo: Il nome che verrà assegnato alla colonna nel dataset risultante.
  • Espressione / Valore: La sorgente originale del dato (es. il nome della colonna nel DB o il path nel file sorgente).
  • Precisione Alias: Valore numerico per la lunghezza massima del campo (es. 1000).

2. Persistenza e Riuso​

tablestructure_02.png

Il sistema permette di non dover riscrivere la mappatura per ogni task:

  • Salvataggio: La struttura corrente viene salvata nel sistema con un nome univoco (es. test_structure).
  • Importazione: E' possibile richiamare una struttura precedentemente salvata nel sistema. L'azione apre un menu dropdown che elenca esclusivamente le Table Structure create dall'utente corrente. Se un altro utente accede allo stesso workflow, non visualizzerà nel proprio elenco le strutture salvate da altri.
  • Esportazione: Permette il download locale del file JSON della struttura.
tablestructure_03.png

Vantaggi Tecnici

  • Modularità: Una struttura definita in un task DB Connector può essere importata e applicata istantaneamente in un task CSV to Table o JSON to Table.
  • Standardizzazione: Assicura che i nomi dei campi e i tipi di dato siano identici in tutte le fasi di trasformazione del workflow.
  • Manutenibilità: Eventuali modifiche alla precisione o ai nomi dei campi possono essere centralizzate ricaricando la struttura aggiornata.

Esempio di Formato JSON (Table Structure)​

Il sistema genera e gestisce internamente la struttura secondo questo schema:

[
 {
 "field_name": "name",
 "field_value": "name",
 "field_type": "expression",
 "field_precision": "1000",
 "field_format": "",
 "field_nullable": "Y"
 },
 {
 "field_name": "start_datetime",
 "field_value": "start_datetime",
 "field_type": "expression",
 "field_precision": "1000",
 "field_format": "",
 "field_nullable": "Y"
 }
]