Containers class
Yeni kapsayıcılar oluşturma ve tüm kapsayıcıları okuma/sorgulama işlemleri
Mevcut kapsayıcıyı okumak, değiştirmek veya silmek için bkz. Kapsayıcı; kullanın .container(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, kapsayıcının var olduğundan emin olmak için her item.read()
çağrıdan önce çağırmayıncontainers.readAll()
; bunu uygulama başlatıldığında bir kez yapın.
Oluşturucular
Containers(Database, Client |
Özellikler
database |
Yöntemler
create(Container |
Bir kapsayıcı oluşturur. Kapsayıcı, öğeler için adlandırılmış bir mantıksal kapsayıcıdır. Bir veritabanı sıfır veya daha fazla adlandırılmış kapsayıcı içerebilir ve her kapsayıcı sıfır veya daha fazla JSON öğesinden oluşur. Şema içermeyen bir kapsayıcıdaki öğelerin aynı yapıyı veya alanları paylaşması gerekmez. Kapsayıcılar uygulama kaynakları olduğundan, ana anahtar veya kaynak anahtarları kullanılarak yetkilendirilebilirler. |
create |
Kapsayıcının var olup olmadığını denetler ve yoksa oluşturur.
Bu, içindeki Kapsayıcı, öğeler için adlandırılmış bir mantıksal kapsayıcıdır. Bir veritabanı sıfır veya daha fazla adlandırılmış kapsayıcı içerebilir ve her kapsayıcı sıfır veya daha fazla JSON öğesinden oluşur. Şema içermeyen bir kapsayıcıdaki öğelerin aynı yapıyı veya alanları paylaşması gerekmez. Kapsayıcılar uygulama kaynakları olduğundan, ana anahtar veya kaynak anahtarları kullanılarak yetkilendirilebilirler. |
query(Sql |
Tüm kapsayıcıları sorgular. Örnek Diziye tüm kapsayıcıları okuyun.
* |
query<T>(Sql |
Tüm kapsayıcıları sorgular. Örnek Diziye tüm kapsayıcıları okuyun.
* |
read |
Tüm kapsayıcıları okuma. Örnek Diziye tüm kapsayıcıları okuyun.
* |
Oluşturucu Ayrıntıları
Containers(Database, ClientContext)
new Containers(database: Database, clientContext: ClientContext)
Parametreler
- database
- Database
- clientContext
-
ClientContext
Özellik Ayrıntıları
database
Yöntem Ayrıntıları
create(ContainerRequest, RequestOptions)
Bir kapsayıcı oluşturur.
Kapsayıcı, öğeler için adlandırılmış bir mantıksal kapsayıcıdır.
Bir veritabanı sıfır veya daha fazla adlandırılmış kapsayıcı içerebilir ve her kapsayıcı sıfır veya daha fazla JSON öğesinden oluşur.
Şema içermeyen bir kapsayıcıdaki öğelerin aynı yapıyı veya alanları paylaşması gerekmez.
Kapsayıcılar uygulama kaynakları olduğundan, ana anahtar veya kaynak anahtarları kullanılarak yetkilendirilebilirler.
function create(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>
Parametreler
- body
- ContainerRequest
Kapsayıcının gövdesini temsil eder.
- 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<ContainerResponse>
createIfNotExists(ContainerRequest, RequestOptions)
Kapsayıcının var olup olmadığını denetler ve yoksa oluşturur.
Bu, içindeki body
kimliğe göre bir okuma işlemi yapar ve bulunamazsa oluşturma işlemi yapar.
Çıktının, varsayılan olmayan özellikler için (dizin oluşturma ilkesi vb.) için girdiğiniz gövdeyle eşleşdiğini onaylamanız gerekir.
Kapsayıcı, öğeler için adlandırılmış bir mantıksal kapsayıcıdır.
Bir veritabanı sıfır veya daha fazla adlandırılmış kapsayıcı içerebilir ve her kapsayıcı sıfır veya daha fazla JSON öğesinden oluşur.
Şema içermeyen bir kapsayıcıdaki öğelerin aynı yapıyı veya alanları paylaşması gerekmez.
Kapsayıcılar uygulama kaynakları olduğundan, ana anahtar veya kaynak anahtarları kullanılarak yetkilendirilebilirler.
function createIfNotExists(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>
Parametreler
- body
- ContainerRequest
Kapsayıcının gövdesini temsil eder.
- 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<ContainerResponse>
query(SqlQuerySpec, FeedOptions)
Tüm kapsayıcıları sorgular.
Örnek
Diziye tüm kapsayıcıları okuyun.
* typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *
function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>
Parametreler
- query
- 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 belirli kapsayıcıları döndürmenize veya bunları teker teker yinelemenize olanak tanır. *
query<T>(SqlQuerySpec, FeedOptions)
Tüm kapsayıcıları sorgular.
Örnek
Diziye tüm kapsayıcıları okuyun.
* typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *
function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>
Parametreler
- query
- 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 belirli kapsayıcıları döndürmenize veya bunları teker teker yinelemenize olanak tanır. *
readAll(FeedOptions)
Tüm kapsayıcıları okuma.
Örnek
Diziye tüm kapsayıcıları okuyun.
* typescript * const {body: containerList} = await client.database("<db id>").containers.readAll().fetchAll(); *
function readAll(options?: FeedOptions): QueryIterator<ContainerDefinition & 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 kapsayıcıları döndürmenize veya bunları teker teker yinelemenize olanak tanır. *