Databases class

الحزمة:

@azure/cosmos

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

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

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

الخصائص

client

الأساليب

create(DatabaseRequest, RequestOptions)	إرسال طلب لإنشاء قاعدة بيانات. تدير قاعدة البيانات المستخدمين والأذونات ومجموعة من الحاويات. كل حساب قاعدة بيانات Azure Cosmos DB قادر على دعم قواعد بيانات مسماة مستقلة متعددة، مع كون قاعدة البيانات هي الحاوية المنطقية للبيانات. تتكون كل قاعدة بيانات من حاوية واحدة أو أكثر، تحتوي كل منها بدورها على مستند واحد أو أكثر. نظرا لأن قواعد البيانات هي مورد إداري، فسيكون مفتاح الخدمة الرئيسي مطلوبا للوصول إلى أي إجراء باستخدام واجهات برمجة تطبيقات المستخدم وإكماله بنجاح.
createIfNotExists(DatabaseRequest, RequestOptions)	تحقق مما إذا كانت قاعدة البيانات موجودة، وإذا لم تكن موجودة، فقم بإنشائها. سيؤدي هذا إلى إجراء عملية قراءة استنادا إلى المعرف في body، ثم إذا لم يتم العثور عليه، عملية إنشاء. تدير قاعدة البيانات المستخدمين والأذونات ومجموعة من الحاويات. كل حساب قاعدة بيانات Azure Cosmos DB قادر على دعم قواعد بيانات مسماة مستقلة متعددة، مع كون قاعدة البيانات هي الحاوية المنطقية للبيانات. تتكون كل قاعدة بيانات من حاوية واحدة أو أكثر، تحتوي كل منها بدورها على مستند واحد أو أكثر. نظرا لأن قواعد البيانات هي مورد إداري، فسيكون المفتاح الرئيسي للخدمة مطلوبا للوصول إلى أي إجراء وإكماله بنجاح باستخدام واجهات برمجة تطبيقات المستخدم.
query(string | SqlQuerySpec, FeedOptions)	الاستعلام عن جميع قواعد البيانات. مثال اقرأ جميع قواعد البيانات إلى صفيف. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *
query<T>(string | SqlQuerySpec, FeedOptions)	الاستعلام عن جميع قواعد البيانات. مثال اقرأ جميع قواعد البيانات إلى صفيف. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *
readAll(FeedOptions)	يقرأ جميع قواعد البيانات. مثال اقرأ جميع قواعد البيانات إلى صفيف. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

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

client

client: CosmosClient

قيمة الخاصية

CosmosClient

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

create(DatabaseRequest, RequestOptions)

إرسال طلب لإنشاء قاعدة بيانات.

تدير قاعدة البيانات المستخدمين والأذونات ومجموعة من الحاويات. كل حساب قاعدة بيانات Azure Cosmos DB قادر على دعم قواعد بيانات مسماة مستقلة متعددة، مع كون قاعدة البيانات هي الحاوية المنطقية للبيانات.

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

function create(body: DatabaseRequest, options?: RequestOptions): Promise<DatabaseResponse>

المعلمات

body

DatabaseRequest

DatabaseDefinition الذي يمثل قاعدة البيانات المراد إنشاؤها.

options

RequestOptions

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

المرتجعات

Promise<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

تحقق مما إذا كانت قاعدة البيانات موجودة، وإذا لم تكن موجودة، فقم بإنشائها. سيؤدي هذا إلى إجراء عملية قراءة استنادا إلى المعرف في body، ثم إذا لم يتم العثور عليه، عملية إنشاء.

تدير قاعدة البيانات المستخدمين والأذونات ومجموعة من الحاويات. كل حساب قاعدة بيانات Azure Cosmos DB قادر على دعم قواعد بيانات مسماة مستقلة متعددة، مع كون قاعدة البيانات هي الحاوية المنطقية للبيانات.

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

function createIfNotExists(body: DatabaseRequest, options?: RequestOptions): Promise<DatabaseResponse>

المعلمات

body

DatabaseRequest

DatabaseDefinition الذي يمثل قاعدة البيانات المراد إنشاؤها.

options

RequestOptions

خيارات إضافية للطلب

المرتجعات

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

الاستعلام عن جميع قواعد البيانات.

مثال

اقرأ جميع قواعد البيانات إلى صفيف. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *

function query(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

المعلمات

query

string | SqlQuerySpec

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

options

FeedOptions

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

المرتجعات

QueryIterator<any>

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

query<T>(string | SqlQuerySpec, FeedOptions)

الاستعلام عن جميع قواعد البيانات.

مثال

اقرأ جميع قواعد البيانات إلى صفيف. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *

function query<T>(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

المعلمات

query

string | SqlQuerySpec

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

options

FeedOptions

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

المرتجعات

QueryIterator<T>

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

readAll(FeedOptions)

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

مثال

اقرأ جميع قواعد البيانات إلى صفيف. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

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

المعلمات

options

FeedOptions

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

المرتجعات

QueryIterator<DatabaseDefinition & Resource>

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