Aracılığıyla paylaş

Databases class

  • Başvuru
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ı; client.database(id)kullanın.

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 mevcut olduğundan emin olmak için her item.read() çağrısından önce databases.readAll() çağırmayın; uygulama başlatılırken bunu 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 kapsayıcı kümesini 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 işlemi 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, bodyiçindeki kimliği temel alan bir okuma işlemi yapar ve bulunamazsa oluşturma işlemi yapar.

Veritabanı kullanıcıları, izinleri ve bir kapsayıcı kümesini 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 kapsayıcı kümesini 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 işlemi başarıyla tamamlamak için Hizmet Ana Anahtarı gerekir.

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

Parametreler

body
DatabaseRequest

Oluşturulacak Veritabanı 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, bodyiçindeki kimliği temel alan bir okuma işlemi yapar ve bulunamazsa oluşturma işlemi yapar.

Veritabanı kullanıcıları, izinleri ve bir kapsayıcı kümesini 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ı 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ı birer birer 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ı birer birer 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ı birer birer yinelemenize olanak tanır. *