विभाजन कर्सर लौटाकर क्वेरी को विभाजित करता है जिसका उपयोग क्वेरी को समानांतर में चलाने के लिए किया जा सकता है। लौटाए गए विभाजन कर्सर विभाजित बिंदु हैं जिनका उपयोग दस्तावेज़ों द्वारा क्वेरी परिणामों के लिए प्रारंभिक/अंत बिंदु के रूप में किया जा सकता है।
HTTP अनुरोध
POST https://firestore.googleapis.com/v1/{parent=projects/*/databases/*/documents}:partitionQuery
यूआरएल जीआरपीसी ट्रांसकोडिंग सिंटैक्स का उपयोग करता है।
पथ पैरामीटर
पैरामीटर | |
---|---|
parent | आवश्यक। मूल संसाधन का नाम. प्रारूप में: |
निकाय से अनुरोध करें
अनुरोध निकाय में निम्नलिखित संरचना वाला डेटा शामिल है:
JSON प्रतिनिधित्व |
---|
{ "partitionCount": string, "pageToken": string, "pageSize": integer, // Union field |
खेत | |
---|---|
partitionCount | विभाजन बिंदुओं की वांछित अधिकतम संख्या. विभाजन परिणामों के अनेक पृष्ठों पर लौटाए जा सकते हैं। संख्या धनात्मक होनी चाहिए. लौटाए गए विभाजनों की वास्तविक संख्या कम हो सकती है। उदाहरण के लिए, इसे चलाए जाने वाले समानांतर प्रश्नों की संख्या से एक कम पर सेट किया जा सकता है, या डेटा पाइपलाइन कार्य चलाने में, उपलब्ध श्रमिकों या गणना उदाहरणों की संख्या से एक कम पर सेट किया जा सकता है। |
pageToken | उदाहरण के लिए, पेजटोकन का उपयोग करने वाली दो बाद की कॉलें वापस आ सकती हैं:
Documents.partitionQuery को प्रदान की गई क्वेरी के परिणामों के संबंध में आदेशित पूर्ण परिणाम सेट प्राप्त करने के लिए, परिणाम सेट को मर्ज किया जाना चाहिए: कर्सर ए, कर्सर बी, कर्सर एम, कर्सर क्यू, कर्सर यू, कर्सर डब्ल्यू |
pageSize | इस कॉल में लौटाए जाने वाले विभाजनों की अधिकतम संख्या, उदाहरण के लिए, यदि |
यूनियन फ़ील्ड query_type . विभाजन के लिए प्रश्न. query_type निम्नलिखित में से केवल एक ही हो सकता है: | |
structuredQuery | एक संरचित क्वेरी. क्वेरी को सभी वंशजों के साथ संग्रह निर्दिष्ट करना होगा और नाम को आरोही क्रम में क्रमबद्ध करना होगा। अन्य फ़िल्टर, ऑर्डर बाय, सीमाएं, ऑफसेट और स्टार्ट/एंड कर्सर समर्थित नहीं हैं। |
यूनियन फ़ील्ड consistency_selector । इस अनुरोध के लिए संगति मोड. यदि सेट नहीं किया गया है, तो डिफॉल्ट मजबूत स्थिरता पर निर्भर करता है। consistency_selector निम्नलिखित में से केवल एक हो सकता है: | |
readTime | दस्तावेज़ों को वैसे ही पढ़ता है जैसे वे दिए गए समय पर थे। यह पिछले एक घंटे के भीतर एक माइक्रोसेकंड सटीक टाइमस्टैम्प होना चाहिए, या यदि पॉइंट-इन-टाइम रिकवरी सक्षम है, तो यह पिछले 7 दिनों के भीतर एक पूरे मिनट का टाइमस्टैम्प भी हो सकता है। RFC3339 UTC "ज़ुलु" प्रारूप में एक टाइमस्टैम्प, नैनोसेकंड रिज़ॉल्यूशन और नौ भिन्नात्मक अंकों तक। उदाहरण: |
प्रतिक्रिया निकाय
Firestore.PartitionQuery
के लिए प्रतिक्रिया।
सफल होने पर, प्रतिक्रिया निकाय में निम्नलिखित संरचना वाला डेटा शामिल होता है:
JSON प्रतिनिधित्व |
---|
{
"partitions": [
{
object ( |
खेत | |
---|---|
partitions[] | विभाजन के परिणाम. प्रत्येक विभाजन एक विभाजन बिंदु है जिसका उपयोग दस्तावेज़ों.runQuery द्वारा क्वेरी परिणामों के लिए प्रारंभिक या अंतिम बिंदु के रूप में किया जा सकता है। डॉक्युमेंट्स.रनक्वेरी अनुरोध इस डॉक्युमेंट्स.पार्टीशनक्वेरी अनुरोध में दी गई उसी क्वेरी के साथ किए जाने चाहिए। विभाजन कर्सर को document.partitionQuery को प्रदान की गई क्वेरी के परिणामों के समान क्रम के अनुसार क्रमबद्ध किया जाएगा। उदाहरण के लिए, यदि कोई document.partitionQuery अनुरोध विभाजन कर्सर A और B लौटाता है, तो निम्नलिखित तीन क्वेरी चलाने से मूल क्वेरी का संपूर्ण परिणाम सेट वापस आ जाएगा:
एक खाली परिणाम यह संकेत दे सकता है कि क्वेरी में विभाजन के लिए बहुत कम परिणाम हैं, या क्वेरी विभाजन के लिए अभी तक समर्थित नहीं है। |
nextPageToken | एक पृष्ठ टोकन जिसका उपयोग दस्तावेज़ों में |
प्राधिकरण के दायरे
निम्नलिखित OAuth स्कोप में से एक की आवश्यकता है:
-
https://www.googleapis.com/auth/datastore
-
https://www.googleapis.com/auth/cloud-platform
अधिक जानकारी के लिए, प्रमाणीकरण अवलोकन देखें।