XML fa rima con SQL

Visita il nuovo sito: https://www.markonetools.it/xml-fa-rima-con-sql/

Dalla versione IBM i 7.1 l'integrazione tra XML e DB2 è completa. Il prodotto DB2 XML extender (5761DE1 a pagamento) presente nelle precedenti release è sostituito dalle funzionalità presenti nel sistema operativo release 7.1.

In breve le principali caratteristiche:

• registrazione nel DB2 di XML Schemas
• immagazzinamento di documenti XML in colonne di tabelle relazionali con validazione a fronte degli XML Schemas registrati
• generazione di documenti XML da tabelle relazionali (SQL XML Publishing Functions)
• inserimento righe di tabelle relazionali a partire da dati ricavati da documenti XML (Annotated XML Document Decomposition)
• Possibilità di query sui dati di documenti XML immagazzinati in colonne di tabelle relazionali via OmniFind Text Search (prodotto OMF)

In questo articolo parleremo delle SQL XML Publishing Functions ovvero come ottenere un file XML well-formed solo tramite le funzioni SQL messe a disposizione nel DB2.

Per giungere al risultato finale, ossia un documento XML well-formed, è necessario combinare l'utilizzo di diverse funzioni SQL. Operazione non del tutto intuitiva se ci si limita a leggere il manuale del reference SQL dove per ogni funzione viene descritta l'operatività in dettaglio.

In questo articolo perciò preferisco adottare un approccio "per esempi", partendo da un semplicissimo file XML e via via aggiungendo complessità alla struttura.

In allegato trovate i file XML ottenuti, gli script SQL e il programma RPG illustrati negli esempi.

Riepilogo SQL XML Publishing Funcions

Prima di cominciare con gli esempi elenchiamo le funzioni SQL più importanti.

Funzioni di aggregazione

XMLAGG: restituisce un XML che è un aggregazione di ogni valore non nullo in un set di valori XML

XMLGROUP: restituisce un elemento XML complesso: ogni record della tabella è mappato con un sottoelemento dell'elemento principale ed ogni colonna è a sua volta un sottoelemento dell'elemento che rappresenta il record

Funzioni scalari

XMLATTRIBUTES: restituisce una porzione XML di tipo attributo

XMLCOMMENT: restituisce un valore XML di tipo commento (p.es. <!-- ... -->)

XMLCONCAT: restituisce la concatenazione degli elementi XML in input

XMLDOCUMENT: restituisce un valore XML che è un documento XML well-formed. N.B. ogni valore XML che si desidera memorizzare in una tabella del DB2 deve essere un documento XML.

XMLELEMENT: restituisce un valore XML che rappresenta un elemento

XMLFOREST: restituisce un valore XML che è una sequenza di elementi XML

XMLPI: restituisce un valore XML di "processing instructions" (p.es. <? ... ?>)

XMLROW: restituisce una sequenza di elementi XML

XMLSERIALIZE: restituisce un documento XML well-formed comprensivo di intestazione

Dichiarazioni

XMLNAMESPACES: restituisce la dichiarazione del namespace. Può essere usata nella funzione XMLELEMENT o XMLFOREST

Esempi

Gli esempi seguenti sono basati sulle tabelle del database di esempio fornito da IBM. Per creare il database di esempio eseguire la procedura:

call CREATE_SQL_SAMPLE('DB2SAMPLE');

Quindi l'istruzione seguente per impostarlo come schema predefinito:

set current schema = 'DB2SAMPLE';

Esempio n. 1

Nel primo esempio creiamo un semplicissimo file XML composto da un solo tag. Ovvero il risultato di una select su una tabella estraendo 1 solo record e 1 sola colonna.

L'XML che desideriamo creare ha un solo tag lastname. Lo otteniamo utilizzando la funzione XMLELEMENT (porzione evidenziata in verde). La funzione XMLELEMENT definisce nel primo parametro il nome del tag (N.B. è bene ricordarsi che i tag sono case-sensitive) e nel secondo il suo valore.

Il contenuto dell'XML è completo. Rimane solo da utilizzare la funzione XMLDOCUMENT per trasformare la stringa di caratteri in un "documento" XML (porzione evidenziata in marrone). Ed infine con la funzione XMLSERIALIZE (evidenziata in violetto) aggiungiamo l'intestazione del file XML ottenendo così un documento "well-formed".

Da notare che la funzione XMLSERIALIZE definisce il tipo di dati restituito (nell'esempio un CLOB di 500 byte). Bisogna porre attenzione alla dimensione definita affinché sia sufficientemente "grande" da contenere tutta la stringa del documento XML.

Come potete vedere dall'esempio anche solo per creare un semplicissimo file XML è necessario utilizzare 3 funzioni XML nidificate.

Esempio n. 2

Nel secondo esempio creiamo un file XML leggermente più complesso estraendo diverse colonne di 1 solo record per ottenere l'anagrafica di un impiegato.

L'XML di questo esempio contiene dei tag (p.es. firstname e fastname) nidificati nel tag di livello superiore name.

Si può ottenere il tag "complesso" name utilizzando la funzione XMLROW che elenca nei suoi argomenti i vari tag nidificati all'interno di name; il tag name è definito tramite la keyword option row.

Il tag employee in questo esempio ha due attributi id e job. Li possiamo ottenere con la funzione XMLATTRIBUTES (parte evidenziata in rosso).

A questo punto abbiamo ottenuto gli attributi del tag employee con XMLATTRIBUTES, i tag complessi name e contract con XMLROW e il tag semplice department con la già nota XMLELEMENT.

Tutti questi elementi vanno nidificati all'interno del tag principale employee. Quindi la funzione XMLELEMENT più esterna (parte evidenziata in giallo) definisce un elemento employee il cui contenuto è la sequenza degli elementi ottenuti in precedenza.

Come negli esempi precedenti una volta ottenuta la stringa corretta con i dati XML necessari nidifichiamo il tutto nelle funzioni XMLDOCUMENT e XMLSERIALIZE per ottenere un documento XML well-formed.

Esempio n. 3

Nel terzo esempio desideriamo ottenere un file XML simile al secondo esempio, ma estraendo l'anagrafica di più di un impiegato. Quindi nel file XML al di sotto del tag principale employees ci saranno tante ripetizioni del tag employee tanti quanti sono i record letti dalla tabella.

In questo esempio desideriamo ottenere le stesse informazioni come nell'esempio 2, non più per un singolo impiegato, bensì per un elenco di impiegati. Ovverosia il tag employee sarà ripetuto n volte (tanti quanti sono i record restituiti dalla select) all'interno del tag principale employees (ricordiamoci che un documento XML well-formed ha sempre bisogno di un solo root element).

A questo punto si pone un problema: finora le select esaminate restituivano un solo record dalla tabella letta. In questo esempio invece i record restituiti sarebbero due; ma noi desideriamo creare un solo file XML con il contenuto di entrambi i record.

Per fare ciò - dopo aver ottenuto il tag employee come in precedenza (parte evidenziata in giallo) - è necessario utilizzare una funzione XML di aggregazione XMLAGG (parte evidenziata in fucsia). Una funzione di aggregazione senza nessuna clausola group by implica che la select debba restituire 1 solo record. Questo record nel nostro caso contiene la concatenazione dei vari tag employee.

Aggregare non è sufficiente, perché il risultato aggregato deve essere contenuto nel tag principale employees. Non resta quindi che utilizzare la già nota funziona XMLELEMENT per crearlo.

Esempio n. 4

Nel quarto esempio desideriamo creare un file XML estraendo i dati da più di una tabella del DB2. Ovvero l'elenco degli impiegati con i loro dati anagrafici e per ogni impiegato le attività svolte nel progetto.