MarkLogic सर्वर में XQuery एन्हांसमेंट

MarkLogic Server XQuery 1.0-ml नामक अपनी स्वयं की XQuery बोली को लागू करता है। यह अनुमान लगाना मुश्किल नहीं है कि यह वही XQuery 1.0 है जो डेवलपर के जीवन को बेहतर बनाने के लिए डिज़ाइन किए गए MarkLogic के कुछ ऐड-ऑन के साथ है। विनिर्देश बताता है कि ये परिवर्तन XQuery को अनुप्रयोग प्रोग्रामिंग के लिए अधिक उपयुक्त बनाते हैं। आइए MarkLogic Server 6.0 विनिर्देशन (http://docs.marklogic.com/6.0/guide/xquery.pdf) में वर्णित XQuery के ऐड-ऑन देखें।
प्रयुक्त बोली निम्नलिखित निर्देश द्वारा घोषित की जाती है।

xquery version "1.0-ml"; 

डिफ़ॉल्ट रूप से इसका उपयोग किया जाता है, लेकिन मॉड्यूल की शुरुआत में निम्नलिखित निर्देश रखकर XQuery 1.0 का उपयोग करना भी संभव है

 xquery version "1.0"; 

MarkLogic द्वारा XQuery 1.0-मिलीलीटर सुधार की सूची
1. कोशिश / पकड़ भाव
2. फंक्शन मैपिंग
3. लेन-देन विभाजक के रूप में अर्धविराम
4. निजी कार्य और चर
5. साइड इफेक्ट के साथ कार्य "साइड इफेक्ट"
6. संक्षिप्त भविष्यवाणी स्थिति
7. बाइनरी ऑब्जेक्ट्स का कंस्ट्रक्टर
8. अभिव्यक्ति के रूप में मान्य है
9. सरलीकरण विकल्प
10. एक XQuery मॉडल में XSLT स्टाइल आयात करें
11. कार्यान्वयन-परिभाषित शब्दार्थ

आइए प्रत्येक आइटम पर थोड़ा और विस्तार से विचार करें

1. कोशिश / पकड़ भाव
यह अभिव्यक्ति रनटाइम XQuery के अपवादों को पकड़ना और उन्हें पर्याप्त रूप से प्रतिक्रिया देना संभव बनाती है

 try {    } catch ($exception) {    } 

MarkLogic Server में सब कुछ की तरह $ अपवाद चर, XML एक अपवाद का वर्णन करता है जिसके लिए आप सेट कर सकते हैं, उदाहरण के लिए XPath, और ब्याज के डेटा को बाहर निकाल सकते हैं, या वह सब कुछ कर सकते हैं जो MarkLogic Server के अंदर XML के साथ किया जा सकता है।
और केवल तीन "विशेष" अपवादों को इस तरह से नहीं पकड़ा जा सकता है - XDMP-CANCELED, SVC-CENCELER XDMP-DISABLED ।

2. फंक्शन मैपिंग
"फंक्शन मैपिंग" एक अभिव्यक्ति है जो आपको तत्वों के क्रमिक सेट को फ़ंक्शन पैरामीटर के रूप में पारित करने की अनुमति देता है, लेकिन! अनुक्रम में प्रत्येक तत्व को अलग से संसाधित किया जाता है। इसका मतलब है कि अनुक्रम के प्रत्येक तत्व के लिए एक हैंडलर फ़ंक्शन को बुलाया जाएगा, और एक तत्व को पैरामीटर के रूप में इसे पारित किया जाएगा।
"फंक्शन मैपिंग" एक लूप के लिए तत्वों की एक सरणी को पुनरावृत्त करने का एक एनालॉग है। स्वाभाविक रूप से कुछ अपवादों के साथ

 xquery version "1.0-ml"; declare function local:print-word ($word as xs:string) { $word }; local:print-word( ("hello", "world") ) 

यह कोड "helloworld" टेक्स्ट को प्रिंट करता है। स्थानीय: प्रिंट-वर्ड फ़ंक्शन को प्रत्येक तत्व के लिए दो बार बुलाया जाएगा।
निम्नलिखित अभिव्यक्ति में हमें एक दिलचस्प परिणाम मिलता है

 xquery version "1.0-ml"; (1,2) * (3,4) 

परिणाम (3, 4, 6, 8)। इस मामले में, "फंक्शन मैपिंग" भी काम करता है, और परिणाम संख्याओं के अनुक्रमिक गुणन का परिणाम है।
ऐसे कार्यों को कॉल करने के परिणामों पर विशेष ध्यान दिया जाना चाहिए, जो प्रत्येक तत्व के लिए फ़ंक्शन को कॉल करने के परिणामों का एक क्रम बन जाता है। यह ध्यान दिया जाना चाहिए कि एक खाली अनुक्रम के साथ एक फ़ंक्शन को कॉल करते समय

 local:print-word( () ) 

फ़ंक्शन का परिणाम होगा - (), जैसा कि आप उम्मीद करेंगे, लेकिन एक ही समय में, फ़ंक्शन खुद को एक बार भी नहीं बुलाया जाएगा। यह याद रखने योग्य है।
"फंक्शन मैपिंग" डिफ़ॉल्ट रूप से मार्कलोगिक सर्वर में उपलब्ध है, लेकिन इसे अक्षम या सक्षम करने का विकल्प है। यह निम्नानुसार किया जाता है
शामिल किए जाने:

 declare namespace xdmp="http://marklogic.com/xdmp"; declare option xdmp:mapping "true"; 

बंद करने से:

 declare namespace xdmp="http://marklogic.com/xdmp"; declare option xdmp:mapping "false"; 

3. अर्धविराम - एक लेनदेन विभाजक के रूप में
Xquery 1.0-मिलीलीटर में, आप ";" जोड़ सकते हैं एक या अधिक XQuery अभिव्यक्तियों के बाद, और इसका अर्थ यह होगा कि इस प्रतीक से पहले स्थित कोड को एक लेनदेन में निष्पादित किया जाएगा, और इस प्रतीक के बाद स्थित सभी निर्देश दूसरे (अगले) लेनदेन में निष्पादित होंगे। डिफ़ॉल्ट रूप से, MarkLogic Server के संपूर्ण अनुरोध को एक लेनदेन में निष्पादित किया जाता है, और रोलबैक पर, इस अनुरोध में परिवर्तित सभी डेटा को पुनर्स्थापित किया जाता है। लेन-देन स्प्लिटर आपको मार्कलोगिक सर्वर के अनुरोध को भागों में विभाजित करने की अनुमति देता है, अगर यह बहुत जटिल है।
यह भी याद रखना चाहिए कि दस्तावेज़ का नया संस्करण उस लेनदेन से उपलब्ध नहीं है जिससे इसे बदला गया था।

4. निजी कार्य और चर की परिभाषा
पुस्तकालयों को लागू करते समय, आप मॉड्यूल के अंदर कुछ कार्यों या चर को लॉक कर सकते हैं, जिससे वे निजी हो सकते हैं और अन्य पुस्तकालयों से सुलभ नहीं हो सकते हैं। यह निम्नानुसार किया जाता है

 declare private function .... declare private variable .... 

यह ध्यान देने योग्य है कि "मुख्य" मॉड्यूल से फ़ंक्शन और चर परिभाषा के अनुसार, निजी हैं, इसलिए "निजी" केवल पुस्तकालय मॉड्यूल के लिए मान्य है।

5. साइड इफेक्ट के साथ कार्य "साइड इफेक्ट"
XQuery विनिर्देशन कहता है कि फ़ंक्शन कॉल के बजाय केवल एक मान लौटा सकते हैं, और डेटा में फ़ंक्शन बॉडी से कोई साइड बदलाव की अनुमति नहीं है। MarkLogic Server में कई संवर्द्धन हैं जो XQuery विनिर्देशन के विपरीत हैं और कार्यों के परिणाम से परे डेटा परिवर्तन का कारण बनते हैं। इस तरह के प्रभाव का एक उदाहरण डेटाबेस में एक दस्तावेज़ परिवर्तन है, जो न केवल परिणाम देता है, बल्कि डेटा भी बदलता है।
"साइड इफ़ेक्ट" का उपयोग अनुप्रयोगों को बनाते समय बहुत बार किया जाता है, यही कारण है कि MarkLogic Server में कई कार्य होते हैं जो "साइड इफ़ेक्ट" बनाते हैं।
इस तरह के कार्यों का एक उदाहरण
• xdmp: सेट
• अद्यतन कार्य (xdmp: दस्तावेज़-लोड, xdmp: नोड-डालें, आदि)
• प्रबंधन कार्य (xdmp: मर्ज, व्यवस्थापक लाइब्रेरी, xdmp: शटडाउन, आदि)

6. संक्षिप्त भविष्यवाणी स्थिति
MarkLogic Server में एक अनुक्रम में तत्वों की पहचान करने के लिए संक्षिप्त संक्षिप्त विवरण है। तो, XQuery 1.0-ml में एक अनुक्रम के पहले तीन तत्वों को प्राप्त करने के लिए आपको क्या करने की आवश्यकता है

 xquery version "1.0-ml"; (1, 2, 3, 4, 5, 5)[1 to 3] 

और XQuery 1.0 में

 xquery version "1.0"; (1, 2, 3, 4, 5, 5)[fn:position() = (1 to 3)] 

7. बाइनरी ऑब्जेक्ट्स का कंस्ट्रक्टर
XQuery 1.0-मिलीलीटर विस्तार द्विआधारी डेटा को बचाने के लिए उपयोग किए जाने वाले द्विआधारी डेटा के प्रकार को पेश करके XQuery 1.0 का विस्तार करता है। नए प्रकार का समर्थन करने के लिए, बाइनरी डेटा कंस्ट्रक्टर "बाइनरी" और टाइप बाइनरी () की जांच करने का कार्य शुरू किया जाता है, जिसका उपयोग "टाइपस्विच" के निर्माण में किया जा सकता है।

8. अभिव्यक्ति के रूप में मान्य है
एक अन्य नवाचार अभिव्यक्ति "के रूप में मान्य" है, जिसका उपयोग अभिव्यक्ति "मान्य" में प्रकार को इंगित करने के लिए किया जा सकता है।

 xquery version "1.0-ml"; validate as xs:boolean { <foo>{fn:true()}</foo> } 

मूल रूप से, यह XQuery 1.0-ml का ऐसा कोई नवाचार नहीं है। XQuery 1.0 में इसी तरह की जाँच निम्नानुसार की जा सकती है

 xquery version "1.0"; declare namespace xdmp="http://marklogic.com/xdmp"; (# xdmp:validate-type xs:boolean #) { <foo>{fn:true()}</foo> } 

9. सरलीकरण विकल्प
घोषणा विकल्प निर्देश का उपयोग करके XQuery में सीरियललाइज़ेशन विकल्प निर्दिष्ट किए जा सकते हैं।

10. एक XQuery मॉडल में XSLT स्टाइल आयात करें
XQuery 1.0-मिलीलीटर में, आप XSLT शैलियों को XQuery मॉड्यूल में आयात कर सकते हैं, और आप XSLT मॉड्यूल में घोषित सभी फ़ंक्शन और चर का उपयोग कर सकते हैं।
XSLT आयात करें

 xquery version "1.0-ml"; import stylesheet at "/path-to-stylesheet.xsl"; 

11. कार्यान्वयन-परिभाषित शब्दार्थ
XQuery विनिर्देश में आइटम का एक सेट होता है जिसे अलग-अलग XQuery कार्यान्वयन में अलग-अलग कार्यान्वित किया जा सकता है।

1. पूर्वनिर्धारित नाम स्थान।
प्रत्येक XQuery कार्यान्वयन में नामस्थानों का अपना सेट होता है जिसका उपयोग स्पष्ट रूप से आयात किए बिना किया जा सकता है। उदाहरण के लिए, "fn:" एक ऐसा ही स्थान है।

2. बाहरी चर
बाहरी चर वे चर होते हैं जिनका उपयोग बाहरी मॉड्यूल से किया जा सकता है। इस तरह के एक चर को घोषित करने का एक उदाहरण

 xquery version "1.0-ml"; declare namespace my="myNamespace"; declare variable $my:variable as xs:string* external; fn:concat("The value of $my:variable is: ", $my:variable) 

फ़ंक्शन xdmp: invoke, xdmp: eval, xdmp: spawn या XCC के माध्यम से ऐसे वैरिएबल का मान सेट कर सकते हैं।

 >xquery version "1.0-ml"; declare namespace my="myNamespace"; xdmp:invoke("/extvar.xqy", (xs:QName("my:variable"), "my value")) 

ऐसे चर का उपयोग करना

 The value of $my:variable is: my value 

3. क्रमबद्ध विकल्प
प्रत्येक XQuery कार्यान्वयन के नाम, सॉर्टिंग विकल्प और डिफ़ॉल्ट पैरामीटर व्यक्तिगत हैं। अधिक जानकारी के लिए, खोज डेवलपर की मार्गदर्शिका देखें।

4. XQuery कार्यान्वयन-परिभाषित प्रकार
MarkLogic Server XQuery को अतिरिक्त प्रकार और फ़ंक्शंस के साथ बातचीत करने के लिए विस्तारित करता है। XQuery विनिर्देश में इन प्रकारों की आवश्यकता नहीं है, लेकिन उनके साथ जीवन बेहतर हो रहा है, और इसलिए, वे MarkLogic Server में मौजूद हैं।
कुछ नए प्रकार
• cts: क्वेरी (बहुत से उपप्रकारों जैसे cts: शब्द-क्वेरी, cts: एलिमेंट-क्वेरी, आदि)
• नक्शा: नक्शा
• cts: क्षेत्र (उप-प्रकार के साथ cts: बॉक्स, cts: वृत्त, cts: बहुभुज, और cts: अंक]
• जसन: वस्तु
• json: सरणी
• json: unquotedString

5. दशांश की शुद्धता
मार्कलोगिक सर्वर में दशमलव की सटीकता को सीमित करने के लिए कोई सेटिंग नहीं है। दशमलव संख्या में 18 दशमलव अंकों की सटीकता होती है।

6. मॉड्यूल का नाम स्थान इसके कार्यों का डिफ़ॉल्ट स्थान है।
एक मॉड्यूल के लिए डिफ़ॉल्ट नाम स्थान भी इस मॉड्यूल के अंदर स्थित सभी कार्यों के लिए डिफ़ॉल्ट नाम स्थान है। इसका अर्थ है कि आप मॉड्यूल के अंदर फ़ंक्शन को उनके उपसर्ग (नाम स्थान) को स्पष्ट रूप से निर्दिष्ट किए बिना घोषित कर सकते हैं।