JSON. JavaScript Object Notation. Très répandu lors de l utilisation. Plus léger que XML

Transcription

1 JSON DB2 fr i

2 JSON JavaScript Object Ntatin Frmat de représentatin des dnnées Originellement amené par JavaScript Mais utilisable par ailleurs Très répandu lrs de l utilisatin Services web REST Open Data Stckage lcal pur des applicatins Plus léger que XML En nmbre de caractères Mais ne permet pas de validatin

3 Syntaxe Sus la frme Nm: valeur Les valeurs peuvent être Objet Tableau Bléen, nmbre, chaine u null Les cmmentaires ne snt pas admis Référence

4 Exemple JSON XML { "menu": { "id": "file", "value": "File", "ppup": { "menuitem": [ { "value": "New", "nclick": "CreateNewDc()" }, { "value": "Open", "nclick": "OpenDc()" }, { "value": "Clse", "nclick": "ClseDc()" } ] } } } <menu id="file" value="file"> <ppup> <menuitem value="new" nclick="createnewdc()" /> <menuitem value="open" nclick="opendc()" /> <menuitem value="clse" nclick="clsedc()" /> </ppup> </menu>

5 DB2 fr i La TR2 de la 7.2 (TR10 pur la 7.1) apprte un début de supprt de JSON dans DB2 En Technlgy Preview Le prduit «DB2 NSQL» supprte plusieurs interfaces Ligne de cmmande Java DB2 Sur l IBM i avec QSH, u sur une machine distante Via API Fnctinnalité partielle via une fnctin SQL

6 Installatin Le prduit est dispnible ici /QIBM/PrdData/OS/SQLLIB Cntient un répertire bin avec les exécutables Une installatin est nécessaire côté IBM i Sus QSH /QIBM/PrdData/OS/SQLLIB/bin/db2nsql -setup enable Le prduit ne semble pas prévu pur gérer les caractères accentués Cela créé un ensemble de fnctins dans SYSTOOLS

7 Pssibilités En ligne de cmmande Créer des cllectins JSON Une table cntenant une clnne de type BLOB Insérer une dcument JSON dans une cllectin JSON Retruver un dcument JSON Via DB2 SQL Cnvertir une dcument JSON (stcké en BLOB) en caractères Fnctin SYSTOOLS.BSON2JSON()

8 Ligne de cmmande

9 Ligne de cmmande IBM i : QSH Vus puvez aussi Cpier le répertire /QIBM/PrdData/OS/SQLLIB sur vtre pste de travail Et lancer db2nsql pur Linux et Unix db2nsql.bat pur Windws Fnctins supprtées Démarrer db2nsql db2nsql Démarrer db2nsql avec un autre prfil sur IBM i db2nsql -user utilisateur mtdepasse Démarrer db2nsql avec un autre prfil sur une autre platefrme db2nsql -hstname NmAs400 -user utilisateur passwrd mtdepasse db2nsql -url jdbc:as400:nmas400 -user utilisateur passwrd mtdepasse Aide sur la syntaxe db2nsql db2nsql -help

10 db2nsql Une fis db2nsql lancé help affiche la liste des cmmandes supprtées par l interpréteur

11 db2nsql Principales cmmandes db.sqlupdate("instructin SQL") Exécute l instructin SQL use nmbiblithèque Indique le schéma (cllectin) en curs

12 db2nsql db.createcllectin("nm") Créer une cllectin JSON C est-à-dire une table «JClient» dans la biblithèque identifiée par la bd en curs, et cntenant 3 clnnes ID : CHAR(12) fr bit data DATA : BLOB ROWCREATED : TIMESTAMP clé le dcument JSON hrdatage de créatin Remarque Nms sensibles à la casse!

13 db2nsql db.nmcllectinjson.insert(...) Insérer un dcument JSON Le dcument JSON dit être syntaxiquement valide L insertin créé un enregistrement dans la table crrespndante

14 db2nsql De nmbreuses cmmandes de manipulatin snt dispnibles Recherche ttale u partielle Liste Mdificatin, suppressin L util est dcumenté Sus qsh db2nsql puis help Référence develperwrks nsqlfrjsn2/ API Java également dispnible nsqlfrjsn3/

15 SQL

16 Fnctins dispnibles Nm BSON2JSON JSON2BSON BSON_VALIDATE JSON_BINARY JSON_LEN JSON_TABLE JSON_TABLE_BINARY JSON_TYPE JSON_VAL JSON_GET_POS_ARR_INDEX JSON_UPDATE Usage Transfrme un BLOB en string cntenant du JSON Transfrme un string cntenant du JSON en BLOB Valide des dnnées JSON Extrait un élément, y cmpris si c est un tableau Returne le nmbre de pstes du tableau JSON Extrait les dnnées du dcument JSON sus frme relatinnelle Returne le type de l élément JSON Valeur d un élément JSON Technlgy Preview Permet de truver le rang d un élément dans le tableau JSON Technlgy Preview Permet de mettre à jur une partie du dcument JSON

17 BSON2JSON Permet de cnvertir un BLOB cntenant un dcument JSON en chaine de caractères Paramètres Entrée : BLOB (16M) Srtie : CLOB (16M), encdé en UTF-8

18 BSON2JSON La valeur de retur étant un CLOB Certaines interfaces ne l affichernt pas Avec STRSQL Dans ce cas, il faut changer le type select cast( systls.bsn2jsn( data ) as varchar(1024)) frm jsntst."jclient"

19 JSON2BSON Permet de cnvertir un BLOB cntenant un dcument JSON en chaine de caractères Paramètres Entrée : CLOB (16M) Srtie : BLOB de 16M Exemple insert int jsntst."jclient" (id, data) values ('id456', systls.jsn2bsn( '{"id":456,"raisnsc":"gaia","satut":"actif","datcrt": }' ) ) ;

20 JSON2BSON C est l pératin inverse de BSON2JSON Exemple values systls.bsn2jsn( systls.jsn2bsn( '{"id":123,"raisnsc":"ibm","satut":"actif","datcrt": }' ) ) ; Prduit {"id":123,"raisnsc":"ibm","satut":"actif","datcrt": }

21 JSON2BSON En cas de valeur invalide du JSON, la fnctin returne l erreur suivante

22 BSON_VALIDATE Valide syntaxiquement un BSON Paramètres Entrée : BLOB (16M) Srtie : INT 0 invalide 1 valide Exemples values systls.bsn_validate( systls.jsn2bsn( '{"id":123,"raisnsc":"ibm","satut":"actif","datcrt": }' ) ) ; select id, systls.bsn_validate(data) as valide, systls.bsn2jsn( data ) frm jsntst."jclient" ;

23 JSON_VAL Returne la valeur d un élément JSON dans le type demandé Paramètres Entrée : Srtie : JSON Élément Type de retur Valeur BLOB (16M) VARCHAR(2048) VARCHAR(100) VARCHAR(2048) Returne NULL si l élément n est pas truvé

24 JSON_VAL Exemple select id, systls.bsn2jsn( data ), jsn_val(data, 'id', 'i') as id frm jsntst."jclient" ; Prduit

25 JSON_VAL Types de valeurs supprtés n DECFLOAT i INT l BIGINT f DOUBLE d DATE ts TIMESTAMP t TIME s:n VARCHAR(n) b:n VARCHAR(n) FOR BIT DATA u INT Suffixe ptinnel na N Array : ne returne pas la valeur si c est un tableau (NULL) Sinn, le 1 er élément est returné

26 JSON_TABLE et JSON_TABLE_BINARY Extrait le cntenu JSON sus frme d une table résultat Paramètres Entrée : JSON BLOB (16M) Élément VARCHAR(2048) Type de retur VARCHAR(100) Srtie : Type INTEGER Valeur VARCHAR(2048) Returne NULL si l élément n est pas truvé

27 JSON_TABLE et JSON_TABLE_BINARY Exemple select j.* frm jsntst."jclient", TABLE( jsn_table( data, 'id', 'i' )) as j ; Prduit

28 JSON_TABLE et JSON_TABLE_BINARY Types de valeurs supprtés 1 Chiffre 2 Chaîne 3 Objet 4 Array (tableau) 8 Bléen 10 Null 16 Integer JSON_TABLE_BINARY Idem, mais returne un BSON (binaire)

29 JSON_LEN Returne le nmbre d ccurrences d un tableau Paramètres Entrée : JSON BLOB (16M) Élément VARCHAR(2048) Srtie : Valeur INTEGER Returne NULL si l élément n est pas truvé, u si ce n est pas un tableau

30 JSON_LEN Exemple Insertin d un tableau insert int jsntst."jclient" (id, data) values ('array', jsn2bsn( '{ "menu": { "id": "file", "value": "File", "ppup": { "menuitem": [ { "value": "New", "nclick": "CreateNewDc()" }, { "value": "Open", "nclick": "OpenDc()" }, { "value": "Clse", "nclick": "ClseDc()" } ] } } } ' ) ) ;

31 JSON_LEN Cmptage select id, bsn2jsn( data ), jsn_len(data, 'menu.ppup.menuitem') as len frm jsntst."jclient" ; Ce qui crrespnd à : "menuitem": [ { "value": "New", "nclick": "CreateNewDc()" }, { "value": "Open", "nclick": "OpenDc()" }, { "value": "Clse", "nclick": "ClseDc()" } ]

32 JSON_TYPE Returne le type de l élément recherché Paramètres Entrée : JSON BLOB (16M) Élément VARCHAR(2048) Taille maxi INTEGER Srtie : Valeur INTEGER Returne NULL si l élément n est pas truvé Les types en retur snt identiques à ceux gérés par JSON_TABLE

33 JSON_TYPE Exemple select id, systls.bsn2jsn( data ), systls.jsn_type(data, 'id', 10) as len, systls.jsn_type(data, 'menu.ppup.menuitem', 1024) as len2 frm jsntst."jclient" ; Prduit

34 JSON_BINARY Returne la valeur d un élément JSON en binaire Fnctinne également avec les tableaux, cntrairement à JSON_VAL Paramètres Entrée : Srtie : JSON Élément Lngeur maxi Valeur BLOB (16M) VARCHAR(2048) INTEGER VARCHAR(2050) Returne NULL si l élément n est pas truvé

35 JSON_BINARY Exemple select id, bsn2jsn( data ), jsn_binary(data, 'id', 10) as id, jsn_binary(data, 'menu.ppup.menuitem', 512) as menuitem frm jsntst."jclient" ; Prduit

36 Usage JSON s est impsé cmme un langage d échange de dnnées, au même titre que XML Devient incnturnable dans les échanges autmatisés, cmme avec les services web par exemple Nus dispsns maintenant d un utillage SQL qui nus permet d effectuer des traitements cmparables avec le stckage XML natif Il est bien sur pssible, et frt utile, d expliter ces fnctins SQL dans les prgrammes RPG avec SQL embarqué