MarkLogic सर्वर में फाइल सिस्टम एक्सेस

MarkLogic एक एप्लिकेशन सर्वर है और इसके लिए XQuery में लिखा गया कोई भी प्रोग्राम न केवल डेटाबेस में संग्रहीत वस्तुओं तक पहुँच प्राप्त कर सकता है, बल्कि सीधे फाइल सिस्टम पर स्थित फाइलों तक भी पहुँच सकता है।
MarkLogic Server में फ़ाइल सिस्टम तक पहुँच प्रदान करने वाला API इतना समृद्ध नहीं है, लेकिन उपलब्ध उपकरण XQuery कोड से सीधे फ़ाइल सिस्टम से डेटा पढ़ने और फ़ाइलों को सहेजने के लिए पर्याप्त हैं।

MarkLogic API के भीतर, एक बाहरी फ़ाइल या ऑब्जेक्ट एक फ़ाइल या ऑब्जेक्ट है जिसे फ़ाइल सिस्टम पर संग्रहीत किया जाता है। तदनुसार, एक आंतरिक वस्तु एक ऐसी वस्तु है जो डेटाबेस में ही संग्रहीत होती है।

आइए मौजूदा एपीआई पर करीब से नज़र डालें। फ़ाइल सिस्टम एक्सेस फ़ंक्शंस "xdmp" नामस्थान में स्थित हैं।
और पहला फ़ंक्शन आपको फ़ाइल सिस्टम पर बाइनरी () ऑब्जेक्ट को एक्सेस करने की अनुमति देता है

xdmp:external-binary( $path as xs:string, [$starting-location as xs:double], [$length as xs:double] ) as binary() 

$ पथ - फ़ाइल पथ
$ शुरुआती स्थान - फ़ाइल में पहले बाइट का सूचकांक 1. डिफ़ॉल्ट = 1 है
$ लंबाई - पढ़ने के लिए बाइट्स की संख्या
इस मामले में, एक बाइनरी () ऑब्जेक्ट एफएस पर एक फ़ाइल के साथ जुड़ा हुआ है और आप हमेशा यह निर्धारित कर सकते हैं कि क्या एक बाइनरी () ऑब्जेक्ट आंतरिक या बाहरी है।
इस सुविधा का उपयोग करने के लिए आपके पास अनुमति होनी चाहिए।
marklogic.com/xdmp/privileges/xdmp-external-binary
यदि फ़ाइल फ़ाइल सिस्टम पर मौजूद नहीं है, तो एक XDMP-MISSINGFILE अपवाद फेंक दिया गया है।

निम्न फ़ंक्शन एक बाइनरी () फ़ाइल ऑब्जेक्ट लेता है और फ़ाइल सिस्टम पर इसके साथ जुड़ी फ़ाइल का पथ देता है।

 xdmp:external-binary-path( $source as binary() ) as xs:string? 

यदि फ़ाइल सिस्टम पर फ़ाइल के साथ बाइनरी () फ़ंक्शन के लिए पारित नहीं किया गया है तो एक XDMP-ARG अपवाद को फेंक दिया जाता है।

Xdmp फ़ंक्शन : बाइनरी-इज़-एक्सटर्नल - चेक अगर बाइनरी () एक बाहरी ऑब्जेक्ट (फ़ाइल) है

 xdmp:binary-is-external( $source as binary() ) as xs:boolean 

निम्नलिखित फ़ंक्शन का उपयोग करके, आप फ़ाइल सिस्टम पर एक निर्देशिका लिस्टिंग प्राप्त कर सकते हैं।

 xdmp:filesystem-directory( $pathname as xs:string ) as element(dir:directory) 

$ pathname - हमारे लिए ब्याज की निर्देशिका
फ़ंक्शन करने के लिए आपके पास अधिकार होना चाहिए
marklogic.com/xdmp/privileges/xdmp-filesystem-directory
इसके अलावा, सिस्टम उपयोगकर्ता को निर्दिष्ट निर्देशिका तक पहुंच पढ़ना होगा
अपवाद SVC-DIROPEN या SVC-FILOPEN को फेंक दिया जाता है यदि फ़ंक्शन को निष्पादित करने वाले उपयोगकर्ता के पास ऐसा करने के लिए पर्याप्त अधिकार नहीं हैं।
फ़ंक्शन का परिणाम एफएस पर स्थित वस्तुओं की एक सूची है। उदाहरण

 xdmp:filesystem-directory( "./" ) <dir:directory xsi:schemaLocation="http://marklogic.com/xdmp/directory directory.xsd" xmlns:dir="http://marklogic.com/xdmp/directory" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <dir:entry> <dir:filename>Admin</dir:filename> <dir:pathname>./Admin</dir:pathname> <dir:type>directory</dir:type> <dir:content-length>0</dir:content-length> <dir:last-modified>2013-05-02T13:09:53+04:00</dir:last-modified> </dir:entry> <dir:entry> <dir:filename>LEGALNOTICES.txt</dir:filename> <dir:pathname>./LEGALNOTICES.txt</dir:pathname> <dir:type>file</dir:type> <dir:content-length>28343</dir:content-length> <dir:last-modified>2013-04-19T23:06:32+04:00</dir:last-modified> </dir:entry> ... </dir:directory> 

आप फ़ाइल सिस्टम से पाठ डेटा पढ़ने के लिए इस फ़ंक्शन का उपयोग कर सकते हैं।

 xdmp:filesystem-file( $pathname as xs:string ) as xs:string 

जहां $ pathname XQuery में पढ़ने के लिए फ़ाइल का पथ है
रीड ऑपरेशन को सफलतापूर्वक पूरा करने के लिए, आपको फ़ाइल को UTF-8 एन्कोडिंग में होना चाहिए। इस आवश्यकता के कारण, जब बाइनरी डेटा पढ़ते हैं, तो यह फ़ंक्शन एक अपवाद फेंक देगा और MarkLogic डेटा एन्कोडिंग के लिए वाउच करेगा। बाइनरी डेटा पढ़ने के लिए, xdmp का उपयोग करें : बाहरी-बाइनरी फ़ंक्शन।
फ़ंक्शन करने के लिए, विशेषाधिकारों की आवश्यकता होती है
marklogic.com/xdmp/privileges/xdmp-filesystem-file

जांचें कि क्या फाइल सिस्टम पर मौजूद है।

 xdmp:filesystem-file-exists( $pathname as xs:string ) as xs:boolean 

जहाँ $ pathname चेक किया हुआ पथ है
फ़ंक्शन करने के लिए, विशेषाधिकारों की आवश्यकता होती है
marklogic.com/xdmp/privileges/xdmp-filesystem-file-exists

फ़ाइल आकार का पता लगाने के लिए, एक xdmp फ़ंक्शन है : फाइलसिस्टम-फाइल-लंबाई

 xdmp:filesystem-file-length( $pathname as xs:string ) as xs:unsignedLong? 

यदि फ़ाइल मौजूद नहीं है तो फ़ंक्शन एक खाली अनुक्रम देता है।
फ़ंक्शन करने के लिए, विशेषाधिकारों की आवश्यकता होती है
marklogic.com/xdmp/privileges/xdmp-filesystem-file-length

अगला, सहेजें फ़ंक्शन पर विचार करें

 xdmp:save( $path as xs:string, $node as node(), [$options as node()?] ) as empty-sequence() 

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

 let $text := text { "hello world" } return xdmp:save("greeting.txt", $text) 

या उदाहरण के लिए, तो आप किसी फ़ाइल को DB से फ़ाइल सिस्टम में सहेज सकते हैं

 let $pdf := doc("/mydocs/stuff.pdf") return xdmp:save("mystuff.pdf", $pdf) 

फ़ंक्शन करने के लिए, विशेषाधिकारों की आवश्यकता होती है
marklogic.com/xdmp/privileges/xdmp-save

MarkLogic सर्वर मुख्य रूप से एक डेटाबेस में दस्तावेज़ों को संग्रहीत कर रहा है और इन दस्तावेजों को XQuery प्रश्नों के साथ संसाधित कर रहा है। लेकिन कभी-कभी आपको फ़ाइल सिस्टम पर फ़ाइल पढ़ने या लिखने की आवश्यकता होती है और इसके लिए मार्कलॉजिक के पास वह सब कुछ है जिसकी आपको आवश्यकता है। बेशक, ये उपकरण बाइनरी फ़ाइलों, छवि रूपांतरणों के जटिल प्रसंस्करण के लिए उपयुक्त नहीं हैं, लेकिन वे पूरी तरह से उन्हें सौंपे गए कार्यों से सामना करते हैं।