مشاركة عبر

QueryIterator class

  • ‏‏المرجع
الحزمة:
@azure/cosmos

يمثل كائن QueryIterator، وهو تنفيذ للموجز أو استجابة الاستعلام التي تمكن الاجتياز والتكرار عبر الاستجابة في خدمة قاعدة بيانات Azure Cosmos DB.

الأساليب

fetchAll()

إحضار كافة صفحات الاستعلام وإرجاع FeedResponse واحد.
fetchNext()

استرداد الدفعة التالية من الموجز.

قد يؤدي ذلك إلى إحضار المزيد من الصفحات من الواجهة الخلفية أو عدم إحضارها استنادا إلى إعداداتك ونوع الاستعلام. عادة ما تجلب الاستعلامات المجمعة جميع الصفحات الخلفية قبل إرجاع الدفعة الأولى من الاستجابات.
getAsyncIterator()

يحصل على مكرر غير متزامن سيؤدي إلى نتائج حتى الاكتمال.

ملاحظة: AsyncIterators هي ميزة جديدة جدا وقد تحتاج إلى استخدام polyfils/etc. من أجل استخدامها في التعليمات البرمجية الخاصة بك.

إذا كنت تستخدم TypeScript، يمكنك استخدام polyfill التالية طالما كنت تستهدف ES6 أو أعلى ويتم تشغيلها على العقدة 6 أو أعلى.

if (!Symbol || !Symbol.asyncIterator) {
  (Symbol as any).asyncIterator = Symbol.for("Symbol.asyncIterator");
}

المثال

التكرار عبر جميع قواعد البيانات

for await(const { resources: db } of client.databases.readAll().getAsyncIterator()) {
  console.log(`Got ${db} from AsyncIterator`);
}
hasMoreResults()

حدد ما إذا كانت هناك موارد متبقية لمعالجتها استنادا إلى قيمة رمز المتابعة المميز أو العناصر المتبقية على الدفعة الحالية في QueryIterator.
reset()

إعادة تعيين QueryIterator إلى البداية ومسح جميع الموارد الموجودة بداخله

تفاصيل الأسلوب

fetchAll()

إحضار كافة صفحات الاستعلام وإرجاع FeedResponse واحد.

function fetchAll(): Promise<FeedResponse<T>>

المرتجعات

Promise<FeedResponse<T>>

fetchNext()

استرداد الدفعة التالية من الموجز.

قد يؤدي ذلك إلى إحضار المزيد من الصفحات من الواجهة الخلفية أو عدم إحضارها استنادا إلى إعداداتك ونوع الاستعلام. عادة ما تجلب الاستعلامات المجمعة جميع الصفحات الخلفية قبل إرجاع الدفعة الأولى من الاستجابات.

function fetchNext(): Promise<FeedResponse<T>>

المرتجعات

Promise<FeedResponse<T>>

getAsyncIterator()

يحصل على مكرر غير متزامن سيؤدي إلى نتائج حتى الاكتمال.

ملاحظة: AsyncIterators هي ميزة جديدة جدا وقد تحتاج إلى استخدام polyfils/etc. من أجل استخدامها في التعليمات البرمجية الخاصة بك.

إذا كنت تستخدم TypeScript، يمكنك استخدام polyfill التالية طالما كنت تستهدف ES6 أو أعلى ويتم تشغيلها على العقدة 6 أو أعلى.

if (!Symbol || !Symbol.asyncIterator) {
  (Symbol as any).asyncIterator = Symbol.for("Symbol.asyncIterator");
}

المثال

التكرار عبر جميع قواعد البيانات

for await(const { resources: db } of client.databases.readAll().getAsyncIterator()) {
  console.log(`Got ${db} from AsyncIterator`);
}

function getAsyncIterator(): AsyncIterable<FeedResponse<T>>

المرتجعات

AsyncIterable<FeedResponse<T>>

hasMoreResults()

حدد ما إذا كانت هناك موارد متبقية لمعالجتها استنادا إلى قيمة رمز المتابعة المميز أو العناصر المتبقية على الدفعة الحالية في QueryIterator.

function hasMoreResults(): boolean

المرتجعات

boolean

صحيح إذا كانت هناك عناصر أخرى لمعالجتها في QueryIterator.

reset()

إعادة تعيين QueryIterator إلى البداية ومسح جميع الموارد الموجودة بداخله

function reset()