Le SGBD NoSQL Marklogic 8 dispose d’une API Node.js, qui permet de d\u00e9velopper rapidement de petites (ou puissantes ?) applications Web.<\/p>\n
Partons du principe que vous avez install\u00e9 Node.js (version 0.12.7) le jour o\u00f9 j’\u00e9cris ces lignes, et que vous commencez \u00e0 savoir vous en servir.\u00a0Vous trouverez sur le What’s new<\/a> de Marklogic 8 une introduction sur l’int\u00e9gration de Node.js dans ce produit.<\/p>\n Sur npm, vous trouverez un client marklogic officiel, que vous installerez via la commande<\/p>\n Vous obtiendrez\u00a0un warning lors de l’installation :<\/p>\n Mais vous trouverez sur stackoverflow<\/a> et sur le github marklogic<\/a> de quoi vous\u00a0rassurer.<\/p>\n Vos\u00a0premiers essais seront bas\u00e9s sur le document \u00ab\u00a0Getting Started with the Node Client API<\/a>\u00a0\u00bb du site Marklogic.<\/p>\n Le code est simple, lisible. Il suffit de charger le client marklogic, la configuration de connexion plac\u00e9e dans un fichier js, et d’appeler une m\u00e9thode de connexion.<\/p>\n Ensuite, on ins\u00e8re un ou plusieurs documents dans la base via :<\/p>\n La seule chose qui me g\u00e8ne un peu est la syntaxe utilis\u00e9e pour la r\u00e9cup\u00e9ration des r\u00e9sultats :\u00a0<\/span><\/p>\n L\u00e0 o\u00f9 l’impl\u00e9mentation monk\/mongoDB propose une syntaxe qui me semble plus classique pour node.js (mais je suis nouveau dans ce domaine) :<\/p>\n Voici le code qui me sert \u00e0 faire ing\u00e9rer \u00e0 Marklogic des lots de documents stock\u00e9s dans des fichiers JSON dont le chemin est pass\u00e9 en param\u00e8tre du script. Chaque fichier contient un array d’objets.<\/p>\n L’uri de chaque item est ici le contenu de le la propri\u00e9t\u00e9 uuid de l’objet fr. A vous d’adapter \u00e0 votre format d’import.<\/p>\n Dans un browser, ouvrez http:\/\/localhost:8000\/qconsole et entrez comme query :<\/p>\n Dans mon cas, j’obtiens une liste de titres de films, ce qui illustre la possibilit\u00e9 de requ\u00eater des documents JSON avec des requ\u00eates XQuery (ici une simple expression XPath). Sympa, non ? Vous trouverez plus de d\u00e9tails sur le maniement de JSON dans Marklogic sur la page Working with JSON<\/a>\u00a0de la documentation Marklogic.<\/p>\n A vous d’adapter le chemin XPath \u00e0 votre format de document.<\/p>\nInstallation du client<\/h1>\n
$ npm install marklogic<\/pre>\n
npm WARN engine marklogic@1.0.1: wanted: {\"node\":\">=0.10.26 <0.11\"}\r\n(current: {\"node\":\"0.12.0\",\"npm\":\"2.5.1\"})<\/pre>\nPremiers essais<\/h1>\n
var marklogic = require(\"marklogic\");\r\nvar conn = require(\".\/env.js\").connection;\r\n\r\nvar db = marklogic.createDatabaseClient(conn);<\/pre>\n
db.documents.write(object(s))<\/pre>\n
db.documents.write(object(s)).result(callback-ok, callback-err);<\/pre>\n
collection.insert(object, callback);<\/pre>\n
Ingestion de documents JSON dans la base<\/h1>\n
var marklogic = require(\"marklogic\");\r\nvar conn = require(\".\/env.js\").connection;\r\nvar fs = require('fs');\r\n\r\n\/\/ r\u00e9cup\u00e8re le param\u00e8tre = chemin du fichier json contenant les documents\r\nif (process.argv.length < 3)\r\nreturn console.log(\"missing file path\")\r\nfile = process.argv[2];\r\n\r\n\/\/ lit le ficher enti\u00e8rement.\r\n\/\/ pas de stream pour pouvoir facilement d\u00e9composer l'array\r\nfs.readFile(file, 'utf8', function(err, jsondata){\r\nif (err) {\r\nreturn console.log(err);\r\n}\r\n\/\/ cr\u00e9e la connexion MArklogic\r\nvar db = marklogic.createDatabaseClient(conn);\r\n\/\/ transforme les donn\u00e9es du ficher en array\r\ndata = JSON.parse(jsondata)\r\n\/\/ sauve chaque \u00e9l\u00e9ment de l'array, avec ses m\u00e9tadonn\u00e9es\r\ndb.documents.write(\r\ndata.map(function(item) {\r\nreturn {\r\nuri: \"\/\" + item.fr.uuid + \".json\",\r\ncontentType: \"application\/json\",\r\ncollections: [\"uc-films\"],\r\ncontent: item\r\n}\r\n})\r\n)\r\n\/\/ message d'erreur\r\n.result(null, function(error) {\r\nconsole.log(JSON.stringify(error));\r\n});\r\n});<\/pre>\nTest avec qconsole<\/h1>\n
xquery version \"1.0-ml\";\r\ncts:search(\/fr\/name,cts:collection-query(\"uc-films\"))<\/pre>\n
R\u00e9f\u00e9rence<\/h3>\n