Reconhe\u00e7o que, ao responder com \"Couchbase pode<\/em> seja seu banco de dados XML\" \u00e9 bastante ousado, especialmente para um banco de dados de documentos orientado para JSON. Algumas pessoas da comunidade do Couchbase podem at\u00e9 mesmo pensar duas vezes, mas espero que voc\u00ea entenda o que quero dizer at\u00e9 o final desta publica\u00e7\u00e3o.<\/p>\n \u00c9 um fato que muitos aplicativos legados ainda dependem de XML, mas ser\u00e1 que o Couchbase \u00e9 realmente a solu\u00e7\u00e3o certa para armazenar e processar seus dados XML? N\u00e3o se preocupe: com rela\u00e7\u00e3o ao Couchbase e ao XML, voc\u00ea pode ter seu bolo e com\u00ea-lo tamb\u00e9m.<\/p>\n Depois de apresentar alguns conceitos, este artigo mostra como converter autom\u00e1tica e instantaneamente XML em equivalentes JSON no Couchbase com quase nenhum esfor\u00e7o - tudo por meio de uma fun\u00e7\u00e3o Eventing. Se voc\u00ea pensar em JSON como o formato intermedi\u00e1rio de computador usado para armazenar seu XML, talvez j\u00e1 tenha percebido onde quero chegar.<\/p>\n Ao transformar seus dados XML em uma representa\u00e7\u00e3o JSON nativa, voc\u00ea aproveita o rico ecossistema de servi\u00e7os do Couchbase, incluindo N1QL<\/a>, Indexa\u00e7\u00e3o, Pesquisa de texto completo<\/a>, Eventos<\/a>e An\u00e1lises<\/a>.<\/p>\n Couchbase<\/a> \u00e9 um banco de dados criado especificamente para ser montado de acordo com suas necessidades. Precisa apenas de um cache r\u00e1pido? Voc\u00ea s\u00f3 precisa do Data Service ou do armazenamento de valores-chave. Deseja acesso semelhante ao SQL? Adicione os servi\u00e7os Query e Index. Ou talvez voc\u00ea precise de Analytics ou Full-Text Search? Basta adicionar alguns n\u00f3s do tipo adequado.<\/p>\n Cada um dos servi\u00e7os acima \u00e9 dimensionado de forma independente para que voc\u00ea acabe construindo - e, o que \u00e9 mais importante, construindo, pagando por<\/em> - apenas o que voc\u00ea precisa. No artigo abaixo, uso o Eventing para transformar o Couchbase em um banco de dados compat\u00edvel com XML. Sei que isso parece bom demais para ser verdade, mas acredite, realmente funciona.<\/p>\n Se voc\u00ea estiver familiarizado com Couchbase, XML e JSON, sinta-se \u00e0 vontade para V\u00e1 para a se\u00e7\u00e3o Pr\u00e9-requisitos<\/a>.<\/em><\/p>\n Servidor Couchbase<\/a> \u00e9 uma plataforma de dados distribu\u00edda e de c\u00f3digo aberto. Ela armazena dados como itens<\/em>cada um dos quais tem um chave<\/em> e um valor<\/em>. As opera\u00e7\u00f5es de dados em menos de um milissegundo s\u00e3o fornecidas por servi\u00e7os avan\u00e7ados de consulta e indexa\u00e7\u00e3o, al\u00e9m de uma linguagem de consulta rica em recursos e orientada a documentos, N1QL<\/em>. V\u00e1rias inst\u00e2ncias do Couchbase Server podem ser combinadas em uma \u00fanica agrupamento<\/em>.<\/p>\n Cada valor (bin\u00e1rio ou JSON) \u00e9 identificado por uma chave exclusiva, definida pelo usu\u00e1rio ou aplicativo quando o item \u00e9 salvo. A chave \u00e9 imut\u00e1vel: depois que o item \u00e9 salvo, a chave n\u00e3o pode ser alterada. Observe que o Couchbase tamb\u00e9m se refere \u00e0 chave de um item como seu id<\/em>.<\/p>\n Cada chave:<\/p>\n O tamanho m\u00e1ximo de um valor \u00e9 de 20 MiB. Um valor pode ser:<\/p>\n Vamos falar mais sobre JSON. Voc\u00ea pode analisar, indexar, consultar e manipular documentos JSON. De fato, o Couchbase introduziu a linguagem de consulta N1QL (pronuncia-se \"nickel\") para atender \u00e0s necessidades de consulta de bancos de dados distribu\u00eddos orientados a documentos. A N1QL \u00e9 usada para manipular os dados JSON no Couchbase, assim como o SQL manipula os dados em um banco de dados relacional (RDBMS). Ele tem Voc\u00ea poderia armazenar XML como uma string ou apenas um blob bin\u00e1rio, mas onde est\u00e1 a divers\u00e3o - ou a utilidade - nisso? Por que n\u00e3o converter automaticamente seu XML em JSON? Ainda bem que voc\u00ea perguntou.<\/p>\n XML \u00e9 uma linguagem de marca\u00e7\u00e3o introduzida em 1996 que define um conjunto de regras para a codifica\u00e7\u00e3o de documentos em um formato que pode ser lido por humanos e por m\u00e1quinas. \u00c9 uma recomenda\u00e7\u00e3o do World Wide Web Consortium (W3C).<\/p>\n As metas de design do XML enfatizam a simplicidade, a generalidade e a facilidade de uso na Internet. \u00c9 um formato de dados textuais com forte suporte via Unicode para diferentes idiomas humanos. Embora o design do XML se concentre em documentos, a linguagem \u00e9 amplamente usada para a representa\u00e7\u00e3o de estruturas de dados arbitr\u00e1rias, como as usadas em servi\u00e7os da Web.<\/p>\n Aqui est\u00e1 um exemplo de XML:<\/p>\n Criado por volta de 2001, o JSON \u00e9 um formato de arquivo padr\u00e3o aberto bastante leve e um formato de interc\u00e2mbio de dados que usa texto leg\u00edvel por humanos para armazenar e transmitir objetos de dados que consistem em pares atributo-valor e matrizes (ou outros valores serializ\u00e1veis).<\/p>\n O JSON \u00e9 um formato de dados muito comum, com uma grande variedade de aplica\u00e7\u00f5es, como, por exemplo, aplicativos da Web que se comunicam com um servidor.<\/p>\n Aqui est\u00e1 um exemplo de JSON:<\/p>\n Atualmente, quando dois aplicativos se comunicam entre si pela Internet, \u00e9 prov\u00e1vel que o fa\u00e7am usando JSON, especialmente se se comunicarem em texto leg\u00edvel por humanos.<\/p>\n Se voc\u00ea \u00e9 um f\u00e3 de XML, n\u00e3o atire no mensageiro aqui. Tenho certeza de que o XML nunca desaparecer\u00e1, assim como o HTML como linguagem de marca\u00e7\u00e3o, mas gosto de pensar que as estat\u00edsticas n\u00e3o mentem quando se trata de desenvolver aplicativos da Internet que precisam se comunicar uns com os outros.<\/p>\n Neste artigo, usaremos a vers\u00e3o mais recente do Couchbase - vers\u00e3o 6.6.2 -, mas ela tamb\u00e9m deve funcionar bem em vers\u00f5es anteriores.<\/p>\n Se voc\u00ea n\u00e3o estiver familiarizado com o Couchbase ou com o servi\u00e7o Eventing, consulte os recursos a seguir, incluindo pelo menos um exemplo de Eventing:<\/p>\n Agora voc\u00ea deve ter um aplicativo que carrega dados, ou pode ter usado No c\u00f3digo abaixo, carrego meu primeiro documento com um chave<\/em> N\u00e3o podemos fazer muita coisa com a string XML acima. Claro, poder\u00edamos indexar a propriedade Poder\u00edamos pass\u00e1-lo para o produto Full-Text Search (FTS). Nesse caso, voc\u00ea obteria mais utilidade, mas teria que indexar toda a carga \u00fatil do XML (n\u00e3o apenas algo importante).<\/p>\n O que realmente queremos \u00e9 a representa\u00e7\u00e3o JSON da propriedade de string XML Usando a nova propriedade Com essas etapas preliminares conclu\u00eddas, voc\u00ea pode pensar em analisar seus dados e transform\u00e1-los em JSON antes de coloc\u00e1-los no Couchbase. Mas a desvantagem \u00e9 que agora temos mais bagagem para carregar e mais infraestrutura (fora do Couchbase) para implantar \u00e0 medida que aumentamos a escala adicionando mais n\u00f3s.<\/p>\n Se pudermos evitar, n\u00e3o queremos escrever um analisador personalizado. Isso n\u00e3o \u00e9 divertido e \u00e9 dif\u00edcil de manter, pois seus requisitos e formatos de dados mudam com o tempo.<\/p>\n O ideal \u00e9 que voc\u00ea queira uma solu\u00e7\u00e3o no servidor que converta genericamente XML em JSON em tempo real, sem impacto nos carregadores de dados.<\/p>\n Entre no Eventing Service do Couchbase.<\/p>\n Pense em Eventing como um \"gatilho posterior\" em um documento que responde a cada altera\u00e7\u00e3o (ou muta\u00e7\u00e3o) em seus dados. A ideia principal \u00e9 que sempre que voc\u00ea inserir ou atualizar seu documento (consulte Nesse caso, queremos converter um documento como o que est\u00e1 abaixo:<\/p>\n Em tempo real, queremos converter o documento acima em um documento enriquecido como o abaixo:<\/p>\n O documento enriquecido mostrado acima pode ser pesquisado por meio de valor-chave ou por meio de um \u00edndice em qualquer campo espec\u00edfico usando N1QL.<\/p>\n Como antes, vemos propriedades JSON individuais em uma estrutura adequada, mas sob o O Eventing permite que voc\u00ea escreva l\u00f3gica comercial pura, e o servi\u00e7o Eventing cuida de toda a infraestrutura necess\u00e1ria para gerenciar e dimensionar sua fun\u00e7\u00e3o (horizontal e verticalmente) em v\u00e1rios n\u00f3s de forma confi\u00e1vel e eficiente.<\/p>\n Todas as fun\u00e7\u00f5es do Eventing t\u00eam dois pontos de entrada Quando um documento \u00e9 alterado ou sofre muta\u00e7\u00e3o (inser\u00e7\u00e3o, reinser\u00e7\u00e3o, substitui\u00e7\u00e3o, etc.), uma c\u00f3pia do documento e alguns metadados sobre o documento s\u00e3o passados para um pequeno ponto de entrada JavaScript O Esta \u00e9 a l\u00f3gica central da convers\u00e3o de XML para JSON:<\/p>\n Agradecimentos ao usu\u00e1rio O modelo de dados do Couchbase<\/h2>\n
Chaves<\/h3>\n
\n
\n
(<\/code>, %<\/code>, \/<\/code>, \"<\/code> e _<\/code> s\u00e3o aceit\u00e1veis.<\/li>\nValores<\/h3>\n
\n
\n
JSON \u00e9 o banco de dados<\/h3>\n
SELECIONAR<\/code>, INSERIR<\/code>, ATUALIZA\u00c7\u00c3O<\/code>, DELETE<\/code> e MERGE<\/code> para operar em dados JSON.<\/p>\nXML: Extensible Markup Language (Linguagem de Marca\u00e7\u00e3o Extens\u00edvel)<\/h3>\n
<CD>\r\n <TITLE>EmpireBurlesque<\/TITLE>\r\n <ARTIST>BobDylan<\/ARTIST>\r\n <COUNTRY>USA<\/COUNTRY>\r\n <COMPANY>Columbia<\/COMPANY>\r\n <PRICE>10.90<\/PRICE>\r\n <YEAR>1985<\/YEAR>\r\n<\/CD>\r\n<\/pre>\n
JSON: Nota\u00e7\u00e3o de objeto JavaScript<\/h3>\n
{\r\n \"email\": \"testme@example.org\",\r\n \"friends\": [\r\n {\"name\": \"rick\"},\r\n {\"name\": \"cate\"}\r\n ]\r\n}\r\n<\/pre>\nO JSON dominou o mundo<\/h3>\n
![\"JSON](\"https:\/\/twobithistory.org\/images\/json.svg\" "\\"Ado\u00e7\u00e3o")
<\/p>\nPr\u00e9-requisitos: Aprendendo sobre eventos<\/h2>\n
\n
\n
Inser\u00e7\u00e3o de XML no Couchbase<\/h2>\n
cbimport<\/code> para carregar seus dados XML em seu cluster do Couchbase.<\/p>\nxml::1<\/code> e um corpo<\/em> consistindo em um tipo<\/code> e o id<\/code> usado na chave (esses valores s\u00e3o opcionais, mas \u00fateis) e, por fim, uma propriedade in_xml<\/code> que cont\u00e9m a pr\u00f3pria string XML.<\/p>\n{\r\n \"type\": \"xml\",\r\n \"id\": 1,\r\n \"in_xml\": \"<CD><TITLE>EmpireBurlesque<\/TITLE><ARTIST>BobDylan<\/ARTIST><COUNTRY>USA<\/COUNTRY><COMPANY>Columbia<\/COMPANY><PRICE>10.90<\/PRICE><YEAR>1985<\/YEAR><\/CD>\"\r\n}\r\n<\/pre>\nin_xml<\/code> como uma cadeia de caracteres, mas n\u00e3o obteremos muito desempenho ao fazer isso, a menos que usemos uma pesquisa de prefixo, que, na minha humilde opini\u00e3o, provavelmente n\u00e3o vale a pena.<\/p>\nin_xml<\/code>Talvez algo como:<\/p>\n\"out_json\": {\r\n \"CD\": {\r\n \"TITLE\": \"EmpireBurlesque\",\r\n \"ARTIST\": \"BobDylan\",\r\n \"COUNTRY\": \"USA\",\r\n \"COMPANY\": \"Columbia\",\r\n \"PRICE\": \"10.90\",\r\n \"YEAR\": \"1985\"\r\n }\r\n}\r\n<\/pre>\nout_json<\/code>Agora, vemos propriedades JSON individuais em uma estrutura adequada: algo com o qual N1QL, indexa\u00e7\u00e3o, FTS (Full-Text Search), Eventing e Analytics trabalham de forma nativa e eficiente.<\/p>\nConvers\u00e3o de XML para JSON em tempo real<\/h2>\n
xml::1<\/code> acima), um pequeno fragmento de JavaScript, ou lambda, \u00e9 executado no documento e encapsula a l\u00f3gica comercial necess\u00e1ria para manipular o documento e garantir que ele esteja no formato desejado.<\/p>\n{\r\n \"type\": \"xml\",\r\n \"id\": 1,\r\n \"in_xml\": \"<CD><TITLE>EmpireBurlesque<\/TITLE><ARTIST>BobDylan<\/ARTIST><COUNTRY>USA<\/COUNTRY><COMPANY>Columbia<\/COMPANY><PRICE>10.90<\/PRICE><YEAR>1985<\/YEAR><\/CD>\"\r\n}\r\n<\/pre>\n{\r\n \"type\": \"xml\",\r\n \"id\": 2,\r\n \"in_xml\": \"<CD><TITLE>EmpireBurlesque<\/TITLE><ARTIST>BobDylan<\/ARTIST><COUNTRY>USA<\/COUNTRY><COMPANY>Columbia<\/COMPANY><PRICE>10.90<\/PRICE><YEAR>1985<\/YEAR><\/CD>\",\r\n \"out_json\": {\r\n \"CD\": {\r\n \"TITLE\": \"EmpireBurlesque\",\r\n \"ARTIST\": \"BobDylan\",\r\n \"COUNTRY\": \"USA\",\r\n \"COMPANY\": \"Columbia\",\r\n \"PRICE\": \"10.90\",\r\n \"YEAR\": \"1985\"\r\n }\r\n }\r\n}\r\n<\/pre>\nout_json<\/code> que permite o uso eficiente de FTS (Full-Text Search), Analytics e at\u00e9 mesmo outras fun\u00e7\u00f5es de Eventing.<\/p>\nFun\u00e7\u00e3o de evento: convertXMLtoJSON<\/h3>\n
OnUpdate(doc,meta)<\/code> e OnDelete(meta,options)<\/code>. Observe que, neste exemplo, n\u00e3o estamos preocupados com o \u00faltimo ponto de entrada.<\/p>\nOnUpdate(doc,meta)<\/code>:<\/p>\nfunction OnUpdate(doc, meta) {\r\n \/\/ filter out non XML\r\n if (!meta.id.startsWith(\"xml:\")) return;\r\n \/\/ The KEY started with \"xml\" try to process it\r\n \/\/ ===========================================================\r\n \/\/ *** Do other work required here on non .in_xml changes ***\r\n \/\/ ===========================================================\r\n var jsonDoc = parseXmlToJson(doc.in_xml);\r\n log(meta.id, \"1. INPUT xml doc.in_xml :\", doc.in_xml);\r\n log(meta.id, \"2. OUTPUT doc.out_json :\", jsonDoc);\r\n doc.out_json = jsonDoc;\r\n \/\/ ===========================================================\r\n \/\/ enrich the source bucket with .out_json\r\n src_bkt[meta.id] = doc;\r\n}\r\n<\/pre>\nOnUpdate(doc,meta)<\/code> A l\u00f3gica acima executa quatro etapas em qualquer muta\u00e7\u00e3o.<\/p>\n\n
\n
xml:<\/code>n\u00e3o fazemos mais nada. Observe que meta.id<\/code> \u00e9 o chave<\/em> do documento.<\/li>\nparseXmlToJson(doc.in_xml)<\/code> em que apenas passamos a string XML para a fun\u00e7\u00e3o.<\/li>\nout_json<\/code>.<\/li>\nA l\u00f3gica principal de convers\u00e3o de XML para JSON<\/h3>\n
\/\/ 6.6.0 version no String.matchAll need our own MatchAll function\r\nfunction* MatchAll(str, regExp) {\r\n if (!regExp.global) {\r\n throw new TypeError('Flag \/g must be set!');\r\n }\r\n const localCopy = new RegExp(regExp, regExp.flags);\r\n let match;\r\n while (match = localCopy.exec(str)) {\r\n yield match;\r\n }\r\n}\r\n\r\n\/\/ A simple XML to JSON parser\r\nfunction parseXmlToJson(xml) {\r\n const json = {};\r\n for (const res of MatchAll(xml,\/(?:<(\\w*)(?:\\s[^>]*)*>)((?:(?!<\\1).)*)(?:<\\\/\\1>)|<(\\w*)(?:\\s*)*\\\/>\/gm)) {\r\n const key = res[1] || res[3];\r\n const value = res[2] && parseXmlToJson(res[2]);\r\n json[key] = ((value && Object.keys(value).length) ? value : res[2]) || null;\r\n }\r\n return json;\r\n}\r\n<\/pre>\nMasterPiece<\/code> no Stack Overflow por compartilhar o m\u00e9todo parseXmlToJson(xml)<\/code> com o mundo<\/a>. O m\u00e9todo usa uma express\u00e3o regular interessante<\/a> na string XML e retorna um objeto JSON de primeira classe. (Sim, ele funciona e \u00e9 elegante e compacto<\/em>.)<\/p>\n
![\"The](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2021\/06\/XML2JSON_1_buckets-2-1024x290.png\")
<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n![\"Couchbase](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2021\/06\/XML2JSON_2_addfunc-1011x1024.png\")
<\/li>\n![\"convert](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2021\/06\/XML2JSON_3_addfunc-1024x297.png\")
<\/li>\n![\"The](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2021\/06\/XML2JSON_4_addfunc-1.png\")
<\/li>\n![\"Eventing](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2021\/06\/XML2JSON_5_deploy-1024x288.png\")
<\/li>\n![\"Confirm](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2021\/06\/XML2JSON_6_deployconf.png\")
<\/li>\n