مشاركة عبر

Containers class

الحزمة:
@azure/cosmos

عمليات إنشاء حاويات جديدة، وقراءة/الاستعلام عن جميع الحاويات

راجع حاوية لقراءة حاوية موجودة أو استبدالها أو حذفها؛ استخدم .container(id).

ملاحظة: تجري جميع هذه العمليات مكالمات مقابل ميزانية ثابتة. يجب عليك تصميم النظام الخاص بك بحيث يتم تغيير حجم هذه المكالمات بشكل فرعي مع التطبيق الخاص بك. على سبيل المثال، لا تتصل containers.readAll() قبل كل استدعاء item.read() واحد، للتأكد من وجود الحاوية؛ قم بذلك مرة واحدة على بدء تشغيل التطبيق.

الخصائص

database

الأساليب

create(ContainerRequest, RequestOptions)

إنشاء حاوية.

الحاوية هي حاوية منطقية مسماة للعناصر.

قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON.

لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول.

نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد.

المثال

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const container = client.database("<database id>").containers.create({
  id: "<name here>",
});
createIfNotExists(ContainerRequest, RequestOptions)

التحقق من وجود حاوية، وإذا لم تكن موجودة، فإنها تقوم بإنشائها. سيؤدي هذا إلى إجراء عملية قراءة استنادا إلى المعرف في body، ثم إذا لم يتم العثور عليها، عملية إنشاء. يجب عليك التأكد من أن الإخراج يطابق النص الذي قمت بتمريره للخصائص غير الافتراضية (على سبيل المثال نهج الفهرسة/إلخ.)

الحاوية هي حاوية منطقية مسماة للعناصر.

قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON.

لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول.

نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد.

المثال

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });
query(SqlQuerySpec, FeedOptions)

الاستعلام عن جميع الحاويات.

المثال

قراءة كافة الحاويات إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @container`,
  parameters: [{ name: "@container", value: "Todo" }],
};
const { resources: containerList } = await client
  .database("<db id>")
  .containers.query(querySpec)
  .fetchAll();
query<T>(SqlQuerySpec, FeedOptions)

الاستعلام عن جميع الحاويات.

المثال

قراءة كافة الحاويات إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @container`,
  parameters: [{ name: "@container", value: "Todo" }],
};
const { resources: containerList } = await client
  .database("<db id>")
  .containers.query(querySpec)
  .fetchAll();
readAll(FeedOptions)

اقرأ جميع الحاويات.

المثال

قراءة كافة الحاويات إلى صفيف.

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { resources: containerList } = await client
  .database("<db id>")
  .containers.readAll()
  .fetchAll();

تفاصيل الخاصية

database 

database: Database

قيمة الخاصية

Database

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

create(ContainerRequest, RequestOptions)

إنشاء حاوية.

الحاوية هي حاوية منطقية مسماة للعناصر.

قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON.

لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول.

نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد.

المثال

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const container = client.database("<database id>").containers.create({
  id: "<name here>",
});

function create(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>

المعلمات

body
ContainerRequest

يمثل نص الحاوية.

options
RequestOptions

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

المرتجعات

Promise<ContainerResponse>

createIfNotExists(ContainerRequest, RequestOptions)

التحقق من وجود حاوية، وإذا لم تكن موجودة، فإنها تقوم بإنشائها. سيؤدي هذا إلى إجراء عملية قراءة استنادا إلى المعرف في body، ثم إذا لم يتم العثور عليها، عملية إنشاء. يجب عليك التأكد من أن الإخراج يطابق النص الذي قمت بتمريره للخصائص غير الافتراضية (على سبيل المثال نهج الفهرسة/إلخ.)

الحاوية هي حاوية منطقية مسماة للعناصر.

قد تحتوي قاعدة البيانات على صفر أو أكثر من الحاويات المسماة وتتكون كل حاوية من صفر أو أكثر من عناصر JSON.

لكونها خالية من المخططات، لا تحتاج العناصر الموجودة في الحاوية إلى مشاركة نفس البنية أو الحقول.

نظرا لأن الحاويات هي موارد تطبيق، يمكن تفويضها باستخدام المفتاح الرئيسي أو مفاتيح الموارد.

المثال

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

function createIfNotExists(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>

المعلمات

body
ContainerRequest

يمثل نص الحاوية.

options
RequestOptions

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

المرتجعات

Promise<ContainerResponse>

query(SqlQuerySpec, FeedOptions)

الاستعلام عن جميع الحاويات.

المثال

قراءة كافة الحاويات إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @container`,
  parameters: [{ name: "@container", value: "Todo" }],
};
const { resources: 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)

الاستعلام عن جميع الحاويات.

المثال

قراءة كافة الحاويات إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @container`,
  parameters: [{ name: "@container", value: "Todo" }],
};
const { resources: 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<T>

QueryIterator يسمح لك بإرجاع حاويات معينة في صفيف أو تكرارها واحدا تلو الآخر.

readAll(FeedOptions)

اقرأ جميع الحاويات.

المثال

قراءة كافة الحاويات إلى صفيف.

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { resources: containerList } = await client
  .database("<db id>")
  .containers.readAll()
  .fetchAll();

function readAll(options?: FeedOptions): QueryIterator<ContainerDefinition & Resource>

المعلمات

options
FeedOptions

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

المرتجعات

QueryIterator<ContainerDefinition & Resource>

QueryIterator يسمح لك بإرجاع جميع الحاويات في صفيف أو تكرارها واحدا تلو الآخر.