Method: projects.databases.documents.partitionQuery

সমান্তরালভাবে কোয়েরি চালানোর জন্য ব্যবহার করা যেতে পারে এমন পার্টিশন কার্সার ফিরিয়ে দিয়ে একটি কোয়েরি পার্টিশন করে। ফিরে আসা পার্টিশন কার্সারগুলি বিভক্ত পয়েন্ট যা documents.runQuery দ্বারা ক্যোয়ারী ফলাফলের জন্য শুরু/শেষ পয়েন্ট হিসাবে ব্যবহার করা যেতে পারে।

HTTP অনুরোধ

POST https://firestore.googleapis.com/v1beta1/{parent=projects/*/databases/*/documents}:partitionQuery

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। মূল সম্পদের নাম। বিন্যাসে: projects/{projectId}/databases/{databaseId}/documents । নথি সম্পদের নাম সমর্থিত নয়; শুধুমাত্র ডাটাবেস সম্পদ নাম নির্দিষ্ট করা যেতে পারে.

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "partitionCount": string,
  "pageToken": string,
  "pageSize": integer,

  // Union field query_type can be only one of the following:
  "structuredQuery": {
    object (StructuredQuery)
  }
  // End of list of possible types for union field query_type.

  // Union field consistency_selector can be only one of the following:
  "readTime": string
  // End of list of possible types for union field consistency_selector.
}
ক্ষেত্র
partitionCount

string ( int64 format)

পার্টিশন পয়েন্টের কাঙ্ক্ষিত সর্বাধিক সংখ্যা। ফলাফলের একাধিক পৃষ্ঠা জুড়ে পার্টিশনগুলি ফেরত দেওয়া হতে পারে। সংখ্যাটি অবশ্যই ইতিবাচক হতে হবে। ফিরে আসা পার্টিশনের প্রকৃত সংখ্যা কম হতে পারে।

উদাহরণস্বরূপ, এটি চালানোর জন্য সমান্তরাল প্রশ্নের সংখ্যার চেয়ে কম সেট করা হতে পারে, বা ডেটা পাইপলাইন কাজ চালানোর ক্ষেত্রে, উপলব্ধ কর্মীদের সংখ্যা বা গণনা দৃষ্টান্তের চেয়ে কম।

pageToken

string

nextPageToken মানটি documents.partitionQuery-তে পূর্ববর্তী কল থেকে ফিরে এসেছে যা ফলাফলের একটি অতিরিক্ত সেট পেতে ব্যবহার করা যেতে পারে। ফলাফলের সেটগুলির মধ্যে কোন অর্ডার গ্যারান্টি নেই। সুতরাং, ফলাফলের একাধিক সেট ব্যবহার করার জন্য বিভিন্ন ফলাফলের সেটগুলিকে একত্রিত করতে হবে।

উদাহরণস্বরূপ, একটি পেজটোকেন ব্যবহার করে পরবর্তী দুটি কল ফিরে আসতে পারে:

  • কার্সার B, কার্সার M, কার্সার Q
  • কার্সার A, কার্সার U, কার্সার W

Documents.partitionQuery-এ সরবরাহ করা প্রশ্নের ফলাফলের সাপেক্ষে একটি সম্পূর্ণ ফলাফল সেট পেতে, ফলাফল সেটগুলিকে একত্রিত করতে হবে: কার্সার A, কার্সার B, কার্সার M, কার্সার Q, কার্সার U, কার্সার W

pageSize

integer

partitionCount সাপেক্ষে, এই কলে ফিরতে হবে সর্বোচ্চ সংখ্যক পার্টিশন।

উদাহরণস্বরূপ, partitionCount = 10 এবং pageSize = 8 হলে, documents.partitionQuery-এ প্রথম কলটি 8টি পার্টিশন পর্যন্ত এবং একটি nextPageToken ফিরে আসবে যদি আরও ফলাফল থাকে। Documents.partitionQuery-এ দ্বিতীয় কলটি 2টি পার্টিশন পর্যন্ত ফিরে আসবে, partitionCount এ উল্লেখিত মোট 10টি সম্পূর্ণ করতে।

ইউনিয়ন ক্ষেত্র query_type । পার্টিশনের জন্য প্রশ্ন। query_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
structuredQuery

object ( StructuredQuery )

একটি কাঠামোগত প্রশ্ন। ক্যোয়ারীটি অবশ্যই সমস্ত বংশধরের সাথে সংগ্রহ উল্লেখ করতে হবে এবং নাম ক্রমানুসারে ক্রমানুসারে সাজাতে হবে। অন্যান্য ফিল্টার, অর্ডার বাই, সীমা, অফসেট এবং শুরু/শেষ কার্সার সমর্থিত নয়।

ইউনিয়ন ক্ষেত্রের consistency_selector । এই অনুরোধের জন্য ধারাবাহিকতা মোড. যদি সেট না করা হয়, ডিফল্ট দৃঢ় ধারাবাহিকতা. consistency_selector নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
readTime

string ( Timestamp format)

প্রদত্ত সময়ে নথিগুলি যেমন ছিল সেগুলি পড়ে।

এটি অবশ্যই গত এক ঘন্টার মধ্যে একটি মাইক্রোসেকেন্ড নির্ভুল টাইমস্ট্যাম্প হতে হবে, অথবা যদি পয়েন্ট-ইন-টাইম পুনরুদ্ধার সক্ষম করা থাকে, অতিরিক্তভাবে গত 7 দিনের মধ্যে পুরো মিনিটের টাইমস্ট্যাম্প হতে পারে৷

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

প্রতিক্রিয়া শরীর

Firestore.PartitionQuery এর প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "partitions": [
    {
      object (Cursor)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
partitions[]

object ( Cursor )

বিভাজনের ফলাফল। প্রতিটি পার্টিশন একটি বিভক্ত বিন্দু যা documents.runQuery দ্বারা ক্যোয়ারী ফলাফলের জন্য শুরু বা শেষ বিন্দু হিসাবে ব্যবহার করা যেতে পারে। documents.runQuery অনুরোধগুলি অবশ্যই এই documents.partitionQuery অনুরোধে সরবরাহ করা একই প্রশ্নের সাথে করা উচিত। পার্টিশন কার্সারগুলি documents.partitionQuery-এ সরবরাহ করা প্রশ্নের ফলাফলের মতো একই ক্রম অনুসারে অর্ডার করা হবে।

উদাহরণস্বরূপ, যদি একটি documents.partitionQuery অনুরোধ পার্টিশন কার্সার A এবং B ফেরত দেয়, তাহলে নিম্নলিখিত তিনটি ক্যোয়ারী চালানোর ফলে মূল ক্যোয়ারীটির সম্পূর্ণ ফলাফল সেট ফিরে আসবে:

  • প্রশ্ন, শেষ এ এ
  • ক্যোয়ারী, শুরু এ এ, শেষ বি এ
  • প্রশ্ন, বি এ শুরু করুন

একটি খালি ফলাফল নির্দেশ করতে পারে যে ক্যোয়ারীটির পার্টিশন করার জন্য খুব কম ফলাফল রয়েছে, অথবা যে ক্যোয়ারীটি এখনও পার্টিশনের জন্য সমর্থিত নয়।

nextPageToken

string

একটি পৃষ্ঠা টোকেন যেটি ফলাফলের একটি অতিরিক্ত সেটের অনুরোধ করতে ব্যবহার করা যেতে পারে, documents.partitionQuery অনুরোধে partitionCount দ্বারা নির্দিষ্ট সংখ্যা পর্যন্ত। ফাঁকা থাকলে, আর কোন ফলাফল নেই।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

আরও তথ্যের জন্য, প্রমাণীকরণ ওভারভিউ দেখুন।