Databases class
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(Database |
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. |
create |
Veritabanının var olup olmadığını denetleyin ve yoksa oluşturun.
Bu, 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 | Sql |
Tüm veritabanlarını sorgular. Örnek Diziye tüm veritabanlarını okuyun.
* |
query<T>(string | Sql |
Tüm veritabanlarını sorgular. Örnek Diziye tüm veritabanlarını okuyun.
* |
read |
Tüm veritabanlarını okur. Örnek Diziye tüm veritabanlarını okuyun.
* |
Özellik Ayrıntıları
client
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, body
iç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 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 Bir dizideki tüm veritabanlarını döndürmenize veya bunları birer birer yinelemenize olanak tanır. *