مشاركة عبر

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 يسمح لك بإرجاع جميع قواعد البيانات في صفيف أو تكرارها واحدا تلو الآخر. *