Databases class

Paket:

@azure/cosmos

Yeni veritabanları oluşturma ve tüm veritabanlarını okuma/sorgulama işlemleri

Mevcut veritabanını okumak veya silmek için bkz . Veritabanı ; kullanın client.database(id).

Not: Tüm bu işlemler sabit bir bütçeye göre çağrı yapar. Sisteminizi, bu çağrıların uygulamanızla birlikte alt satır olarak ölçeklendirilmesi için tasarlamanız gerekir. Örneğin, veritabanının var olduğundan emin olmak için her item.read() çağrıdan önce çağırmayındatabases.readAll(); bunu uygulama başlatıldığında bir kez yapın.

Özellikler

client

Yöntemler

create(DatabaseRequest, RequestOptions)	Veritabanı oluşturmak için bir istek gönderin. Veritabanı kullanıcıları, izinleri ve bir dizi kapsayıcıyı yönetir. Her Azure Cosmos DB Veritabanı Hesabı, birden çok bağımsız adlandırılmış veritabanını destekleyebiliyor ve veritabanı verilerin mantıksal kapsayıcısı oluyor. Her Veritabanı, her biri bir veya daha fazla belge içeren bir veya daha fazla kapsayıcıdan oluşur. Veritabanları bir yönetim kaynağı olduğundan, Kullanıcı API'lerini kullanarak herhangi bir eyleme erişmek ve bu eylemi başarıyla tamamlamak için Hizmet Ana Anahtarı gerekir.
createIfNotExists(DatabaseRequest, RequestOptions)	Veritabanının var olup olmadığını denetleyin ve yoksa oluşturun. Bu, içindeki bodykimliğe göre bir okuma işlemi yapar ve bulunamazsa oluşturma işlemi yapar. Veritabanı kullanıcıları, izinleri ve bir dizi kapsayıcıyı yönetir. Her Azure Cosmos DB Veritabanı Hesabı, birden çok bağımsız adlandırılmış veritabanını destekleyebiliyor ve veritabanı verilerin mantıksal kapsayıcısı oluyor. Her Veritabanı, her biri bir veya daha fazla belge içeren bir veya daha fazla kapsayıcıdan oluşur. Veritabanları bir yönetim kaynağı olduğundan, Kullanıcı API'lerini kullanarak herhangi bir eyleme erişmek ve bu eylemi başarıyla tamamlamak için Hizmet Ana Anahtarı gerekir.
query(string | SqlQuerySpec, FeedOptions)	Tüm veritabanlarını sorgular. Örnek Diziye tüm veritabanlarını okuyun. * 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)	Tüm veritabanlarını sorgular. Örnek Diziye tüm veritabanlarını okuyun. * 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)	Tüm veritabanlarını okur. Örnek Diziye tüm veritabanlarını okuyun. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

Özellik Ayrıntıları

client

client: CosmosClient

Özellik Değeri

CosmosClient

Yöntem Ayrıntıları

create(DatabaseRequest, RequestOptions)

Veritabanı oluşturmak için bir istek gönderin.

Veritabanı kullanıcıları, izinleri ve bir dizi kapsayıcıyı yönetir. Her Azure Cosmos DB Veritabanı Hesabı, birden çok bağımsız adlandırılmış veritabanını destekleyebiliyor ve veritabanı verilerin mantıksal kapsayıcısı oluyor.

Her Veritabanı, her biri bir veya daha fazla belge içeren bir veya daha fazla kapsayıcıdan oluşur. Veritabanları bir yönetim kaynağı olduğundan, Kullanıcı API'lerini kullanarak herhangi bir eyleme erişmek ve bu eylemi başarıyla tamamlamak için Hizmet Ana Anahtarı gerekir.

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

Parametreler

body

DatabaseRequest

Oluşturulacak Veritabanını temsil eden DatabaseDefinition.

options

RequestOptions

Yanıt sayfası boyutu, devamlılık belirteçleri vb. gibi seçenekleri ayarlamak için kullanın.

Döndürülenler

Promise<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

Veritabanının var olup olmadığını denetleyin ve yoksa oluşturun. Bu, içindeki bodykimliğe göre bir okuma işlemi yapar ve bulunamazsa oluşturma işlemi yapar.

Veritabanı kullanıcıları, izinleri ve bir dizi kapsayıcıyı yönetir. Her Azure Cosmos DB Veritabanı Hesabı, birden çok bağımsız adlandırılmış veritabanını destekleyebiliyor ve veritabanı verilerin mantıksal kapsayıcısı oluyor.

Her Veritabanı, her biri bir veya daha fazla belge içeren bir veya daha fazla kapsayıcıdan oluşur. Veritabanları bir yönetim kaynağı olduğundan, Kullanıcı API'lerini kullanarak herhangi bir eyleme erişmek ve bu eylemi başarıyla tamamlamak için Hizmet Ana Anahtarı gerekir.

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

Parametreler

body

DatabaseRequest

Oluşturulacak Veritabanını temsil eden DatabaseDefinition.

options

RequestOptions

İstek için ek seçenekler

Döndürülenler

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

Tüm veritabanlarını sorgular.

Örnek

Diziye tüm veritabanlarını okuyun. * 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>

Parametreler

query

string | SqlQuerySpec

İşlem için sorgu yapılandırması. Sorgu yapılandırma hakkında daha fazla bilgi için bkz . SqlQuerySpec .

options

FeedOptions

Yanıt sayfası boyutu, devamlılık belirteçleri vb. gibi seçenekleri ayarlamak için kullanın.

Döndürülenler

QueryIterator<any>

QueryIterator Bir dizideki tüm veritabanlarını döndürmenize veya bunları teker teker yinelemenize olanak tanır. *

query<T>(string | SqlQuerySpec, FeedOptions)

Tüm veritabanlarını sorgular.

Örnek

Diziye tüm veritabanlarını okuyun. * 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>

Parametreler

query

string | SqlQuerySpec

İşlem için sorgu yapılandırması. Sorgu yapılandırma hakkında daha fazla bilgi için bkz . SqlQuerySpec .

options

FeedOptions

Yanıt sayfası boyutu, devamlılık belirteçleri vb. gibi seçenekleri ayarlamak için kullanın.

Döndürülenler

QueryIterator<T>

QueryIterator Bir dizideki tüm veritabanlarını döndürmenize veya bunları teker teker yinelemenize olanak tanır. *

readAll(FeedOptions)

Tüm veritabanlarını okur.

Örnek

Diziye tüm veritabanlarını okuyun. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

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

Parametreler

options

FeedOptions

Yanıt sayfası boyutu, devamlılık belirteçleri vb. gibi seçenekleri ayarlamak için kullanın.

Döndürülenler

QueryIterator<DatabaseDefinition & Resource>

QueryIterator Bir dizideki tüm veritabanlarını döndürmenize veya bunları teker teker yinelemenize olanak tanır. *