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ı ; .container(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, kapsayıcının mevcut olduğundan emin olmak için her item.read()
çağrısından önce containers.readAll()
çağırmayın; uygulama başlatılırken bunu 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, 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ı okuyun. Ö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, body
içindeki kimliği temel alan bir okuma işlemi yapar ve bulunamazsa oluşturma işlemi yapar.
Çıktının varsayılan olmayan özellikler (dizin oluşturma ilkesi vb.) için geçirilen 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ı birer birer 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ı birer birer yinelemenize olanak tanır. *
readAll(FeedOptions)
Tüm kapsayıcıları okuyun.
Ö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ı birer birer yinelemenize olanak tanır. *