Containers class
Új tárolók létrehozására és az összes tároló olvasására/lekérdezésére szolgáló műveletek
Meglévő tároló olvasásával, cseréjével vagy törlésével kapcsolatban lásd: Tároló; .container(id)használata.
Megjegyzés: ezek a műveletek rögzített költségvetéssel kapcsolatos hívásokat hajtanak végre.
Úgy kell megterveznie a rendszert, hogy ezek a hívások az alkalmazással együtt alkonyatosan skálázhatók legyenek.
Például ne hívjon containers.readAll() minden egyes item.read() hívás előtt, hogy a tároló létezik-e; ezt egyszer kell elvégeznie az alkalmazás indításakor.
Tulajdonságok
| database |
Metódusok
| create(Container |
Létrehoz egy tárolót. A tároló az elemek nevesített logikai tárolója. Az adatbázisok tartalmazhatnak nullát vagy több elnevezett tárolót, és minden tároló nulla vagy több JSON-elemből áll. Mivel sémamentes, a tároló elemeinek nem kell azonos struktúrát vagy mezőket használniuk. Mivel a tárolók alkalmazáserőforrások, a főkulcs vagy az erőforráskulcsok használatával engedélyezhetők. példa
|
| create |
Ellenőrzi, hogy létezik-e tároló, és ha nem, akkor létrehozza azt.
Ez egy olvasási műveletet hajt végre a A tároló az elemek nevesített logikai tárolója. Az adatbázisok tartalmazhatnak nullát vagy több elnevezett tárolót, és minden tároló nulla vagy több JSON-elemből áll. Mivel sémamentes, a tároló elemeinek nem kell azonos struktúrát vagy mezőket használniuk. Mivel a tárolók alkalmazáserőforrások, a főkulcs vagy az erőforráskulcsok használatával engedélyezhetők. példa
|
| query(Sql |
Lekérdezi az összes tárolót. példa Olvassa el az összes tárolót a tömbbe.
|
| query<T>(Sql |
Lekérdezi az összes tárolót. példa Olvassa el az összes tárolót a tömbbe.
|
| read |
Olvassa el az összes tárolót. példa Olvassa el az összes tárolót a tömbbe.
|
Tulajdonság adatai
database
Metódus adatai
create(ContainerRequest, RequestOptions)
Létrehoz egy tárolót.
A tároló az elemek nevesített logikai tárolója.
Az adatbázisok tartalmazhatnak nullát vagy több elnevezett tárolót, és minden tároló nulla vagy több JSON-elemből áll.
Mivel sémamentes, a tároló elemeinek nem kell azonos struktúrát vagy mezőket használniuk.
Mivel a tárolók alkalmazáserőforrások, a főkulcs vagy az erőforráskulcsok használatával engedélyezhetők.
példa
import { CosmosClient } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const container = client.database("<database id>").containers.create({
id: "<name here>",
});
function create(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>
Paraméterek
- body
- ContainerRequest
A tároló törzsét jelöli.
- options
- RequestOptions
Olyan beállítások beállítására használható, mint a válaszoldal mérete, a folytatási jogkivonatok stb.
Válaszok
Promise<ContainerResponse>
createIfNotExists(ContainerRequest, RequestOptions)
Ellenőrzi, hogy létezik-e tároló, és ha nem, akkor létrehozza azt.
Ez egy olvasási műveletet hajt végre a bodyazonosítója alapján, majd ha nem található, hozzon létre egy létrehozási műveletet.
Győződjön meg arról, hogy a kimenet megegyezik a nem alapértelmezett tulajdonságok (például indexelési szabályzat/stb.) esetében átadott törzstel.
A tároló az elemek nevesített logikai tárolója.
Az adatbázisok tartalmazhatnak nullát vagy több elnevezett tárolót, és minden tároló nulla vagy több JSON-elemből áll.
Mivel sémamentes, a tároló elemeinek nem kell azonos struktúrát vagy mezőket használniuk.
Mivel a tárolók alkalmazáserőforrások, a főkulcs vagy az erőforráskulcsok használatával engedélyezhetők.
példa
import { CosmosClient } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });
function createIfNotExists(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>
Paraméterek
- body
- ContainerRequest
A tároló törzsét jelöli.
- options
- RequestOptions
Olyan beállítások beállítására használható, mint a válaszoldal mérete, a folytatási jogkivonatok stb.
Válaszok
Promise<ContainerResponse>
query(SqlQuerySpec, FeedOptions)
Lekérdezi az összes tárolót.
példa
Olvassa el az összes tárolót a tömbbe.
import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const querySpec: SqlQuerySpec = {
query: `SELECT * FROM root r WHERE r.id = @container`,
parameters: [{ name: "@container", value: "Todo" }],
};
const { resources: containerList } = await client
.database("<db id>")
.containers.query(querySpec)
.fetchAll();
function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>
Paraméterek
- query
- SqlQuerySpec
Lekérdezéskonfiguráció a művelethez. A lekérdezés konfigurálásáról további információt SqlQuerySpec talál.
- options
- FeedOptions
Olyan beállítások beállítására használható, mint a válaszoldal mérete, a folytatási jogkivonatok stb.
Válaszok
QueryIterator<any>
QueryIterator Lehetővé teszi, hogy adott tárolókat adjon vissza egy tömbben, vagy egyenként iterálja át őket.
query<T>(SqlQuerySpec, FeedOptions)
Lekérdezi az összes tárolót.
példa
Olvassa el az összes tárolót a tömbbe.
import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const querySpec: SqlQuerySpec = {
query: `SELECT * FROM root r WHERE r.id = @container`,
parameters: [{ name: "@container", value: "Todo" }],
};
const { resources: containerList } = await client
.database("<db id>")
.containers.query(querySpec)
.fetchAll();
function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>
Paraméterek
- query
- SqlQuerySpec
Lekérdezéskonfiguráció a művelethez. A lekérdezés konfigurálásáról további információt SqlQuerySpec talál.
- options
- FeedOptions
Olyan beállítások beállítására használható, mint a válaszoldal mérete, a folytatási jogkivonatok stb.
Válaszok
QueryIterator Lehetővé teszi, hogy adott tárolókat adjon vissza egy tömbben, vagy egyenként iterálja át őket.
readAll(FeedOptions)
Olvassa el az összes tárolót.
példa
Olvassa el az összes tárolót a tömbbe.
import { CosmosClient } from "@azure/cosmos";
const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { resources: containerList } = await client
.database("<db id>")
.containers.readAll()
.fetchAll();
function readAll(options?: FeedOptions): QueryIterator<ContainerDefinition & Resource>
Paraméterek
- options
- FeedOptions
Olyan beállítások beállítására használható, mint a válaszoldal mérete, a folytatási jogkivonatok stb.
Válaszok
QueryIterator Lehetővé teszi, hogy egy tömb összes tárolója vissza legyen állítva, vagy egyenként iteráljon rajtuk.