Containers class
عمليات إنشاء حاويات جديدة، وقراءة/الاستعلام عن جميع الحاويات
راجع حاوية لقراءة حاوية موجودة أو استبدالها أو حذفها؛ استخدم .container(id).
ملاحظة: تجري جميع هذه العمليات مكالمات مقابل ميزانية ثابتة.
يجب عليك تصميم النظام الخاص بك بحيث يتم تغيير حجم هذه المكالمات بشكل فرعي مع التطبيق الخاص بك.
على سبيل المثال، لا تتصل containers.readAll() قبل كل استدعاء item.read() واحد، للتأكد من وجود الحاوية؛ قم بذلك مرة واحدة على بدء تشغيل التطبيق.
المنشئون
| Containers(Database, Client |
الخصائص
| database |
الأساليب
| create(Container |
إنشاء حاوية. الحاوية هي حاوية منطقية مسماة للعناصر. قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON. لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول. نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد. |
| create |
التحقق من وجود حاوية، وإذا لم تكن موجودة، فإنها تقوم بإنشائها.
سيؤدي هذا إلى إجراء عملية قراءة استنادا إلى المعرف في الحاوية هي حاوية منطقية مسماة للعناصر. قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON. لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول. نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد. |
| query(Sql |
الاستعلام عن جميع الحاويات. المثال قراءة كافة الحاويات إلى صفيف.
* |
| query<T>(Sql |
الاستعلام عن جميع الحاويات. المثال قراءة كافة الحاويات إلى صفيف.
* |
| read |
اقرأ جميع الحاويات. المثال قراءة كافة الحاويات إلى صفيف.
* |
تفاصيل المنشئ
Containers(Database, ClientContext)
new Containers(database: Database, clientContext: ClientContext)المعلمات
- database
- Database
- clientContext
-
ClientContext
تفاصيل الخاصية
database
تفاصيل الأسلوب
create(ContainerRequest, RequestOptions)
إنشاء حاوية.
الحاوية هي حاوية منطقية مسماة للعناصر.
قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON.
لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول.
نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد.
function create(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>المعلمات
- body
- ContainerRequest
يمثل نص الحاوية.
- options
- RequestOptions
استخدم لتعيين خيارات مثل حجم صفحة الاستجابة والرموز المميزة للمتابعة وما إلى ذلك.
المرتجعات
Promise<ContainerResponse>
createIfNotExists(ContainerRequest, RequestOptions)
التحقق من وجود حاوية، وإذا لم تكن موجودة، فإنها تقوم بإنشائها.
سيؤدي هذا إلى إجراء عملية قراءة استنادا إلى المعرف في body، ثم إذا لم يتم العثور عليها، عملية إنشاء.
يجب عليك التأكد من أن الإخراج يطابق النص الذي قمت بتمريره للخصائص غير الافتراضية (على سبيل المثال نهج الفهرسة/إلخ.)
الحاوية هي حاوية منطقية مسماة للعناصر.
قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON.
لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول.
نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد.
function createIfNotExists(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>المعلمات
- body
- ContainerRequest
يمثل نص الحاوية.
- options
- RequestOptions
استخدم لتعيين خيارات مثل حجم صفحة الاستجابة والرموز المميزة للمتابعة وما إلى ذلك.
المرتجعات
Promise<ContainerResponse>
query(SqlQuerySpec, FeedOptions)
الاستعلام عن جميع الحاويات.
المثال
قراءة كافة الحاويات إلى صفيف.
* typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *
function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>المعلمات
- query
- SqlQuerySpec
تكوين الاستعلام للعملية. راجع SqlQuerySpec لمزيد من المعلومات حول كيفية تكوين استعلام.
- options
- FeedOptions
استخدم لتعيين خيارات مثل حجم صفحة الاستجابة والرموز المميزة للمتابعة وما إلى ذلك.
المرتجعات
QueryIterator<any>
QueryIterator يسمح لك بإرجاع حاويات معينة في صفيف أو تكرارها واحدا تلو الآخر. *
query<T>(SqlQuerySpec, FeedOptions)
الاستعلام عن جميع الحاويات.
المثال
قراءة كافة الحاويات إلى صفيف.
* typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *
function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>المعلمات
- query
- SqlQuerySpec
تكوين الاستعلام للعملية. راجع SqlQuerySpec لمزيد من المعلومات حول كيفية تكوين استعلام.
- options
- FeedOptions
استخدم لتعيين خيارات مثل حجم صفحة الاستجابة والرموز المميزة للمتابعة وما إلى ذلك.
المرتجعات
QueryIterator يسمح لك بإرجاع حاويات معينة في صفيف أو تكرارها واحدا تلو الآخر. *
readAll(FeedOptions)
اقرأ جميع الحاويات.
المثال
قراءة كافة الحاويات إلى صفيف.
* typescript * const {body: containerList} = await client.database("<db id>").containers.readAll().fetchAll(); *
function readAll(options?: FeedOptions): QueryIterator<ContainerDefinition & Resource>المعلمات
- options
- FeedOptions
استخدم لتعيين خيارات مثل حجم صفحة الاستجابة والرموز المميزة للمتابعة وما إلى ذلك.
المرتجعات
QueryIterator يسمح لك بإرجاع جميع الحاويات في صفيف أو تكرارها واحدا تلو الآخر. *