Databases class

Balíček:

@azure/cosmos

Operace pro vytváření nových databází a čtení/dotazování všech databází

Viz Databáze pro čtení nebo odstranění existující databáze; použijte client.database(id).

Poznámka: Všechny tyto operace můžou volat pevný rozpočet. Systém byste měli navrhnout tak, aby volaly dílčí měřítko s vaší aplikací. Například nevolejte databases.readAll() před každým jedním item.read() voláním, abyste se ujistili, že databáze existuje. To udělejte jednou při spuštění aplikace.

Vlastnosti

client

Metody

create(DatabaseRequest, RequestOptions)	Odešlete žádost o vytvoření databáze. Databáze spravuje uživatele, oprávnění a sadu kontejnerů. Každý účet databáze Azure Cosmos DB může podporovat více nezávislých pojmenovaných databází, přičemž databáze je logickým kontejnerem pro data. Každá databáze se skládá z jednoho nebo více kontejnerů, z nichž každý zase obsahuje jeden nebo více dokumentů. Vzhledem k tomu, že databáze jsou prostředkem pro správu, bude se pro přístup k jakékoli akci a úspěšnému dokončení jakékoli akce pomocí uživatelských rozhraní API vyžadovat hlavní klíč služby.
createIfNotExists(DatabaseRequest, RequestOptions)	Zkontrolujte, jestli databáze existuje, a pokud ne, vytvořte ji. Tím se provede operace čtení na základě ID v body, a pokud se nenajde, operace vytvoření. Databáze spravuje uživatele, oprávnění a sadu kontejnerů. Každý účet databáze Azure Cosmos DB může podporovat více nezávislých pojmenovaných databází, přičemž databáze je logickým kontejnerem pro data. Každá databáze se skládá z jednoho nebo více kontejnerů, z nichž každý zase obsahuje jeden nebo více dokumentů. Vzhledem k tomu, že databáze jsou prostředkem pro správu, bude se pro přístup a úspěšné dokončení jakékoli akce pomocí uživatelských rozhraní API vyžadovat hlavní klíč služby.
query(string | SqlQuerySpec, FeedOptions)	Dotazuje všechny databáze. Příklad Čtení všech databází do pole * 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)	Dotazuje všechny databáze. Příklad Čtení všech databází do pole * 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)	Načte všechny databáze. Příklad Čtení všech databází do pole * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

Podrobnosti vlastnosti

client

client: CosmosClient

Hodnota vlastnosti

CosmosClient

Podrobnosti metody

create(DatabaseRequest, RequestOptions)

Odešlete žádost o vytvoření databáze.

Databáze spravuje uživatele, oprávnění a sadu kontejnerů. Každý účet databáze Azure Cosmos DB může podporovat více nezávislých pojmenovaných databází, přičemž databáze je logickým kontejnerem pro data.

Každá databáze se skládá z jednoho nebo více kontejnerů, z nichž každý zase obsahuje jeden nebo více dokumentů. Vzhledem k tomu, že databáze jsou prostředkem pro správu, bude se pro přístup k jakékoli akci a úspěšnému dokončení jakékoli akce pomocí uživatelských rozhraní API vyžadovat hlavní klíč služby.

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

Parametry

body

DatabaseRequest

DatabaseDefinition představující databázi, která má být vytvořena.

options

RequestOptions

Slouží k nastavení možností, jako je velikost stránky odpovědi, pokračovací tokeny atd.

Návraty

Promise<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

Zkontrolujte, jestli databáze existuje, a pokud ne, vytvořte ji. Tím se provede operace čtení na základě ID v body, a pokud se nenajde, operace vytvoření.

Databáze spravuje uživatele, oprávnění a sadu kontejnerů. Každý účet databáze Azure Cosmos DB může podporovat více nezávislých pojmenovaných databází, přičemž databáze je logickým kontejnerem pro data.

Každá databáze se skládá z jednoho nebo více kontejnerů, z nichž každý zase obsahuje jeden nebo více dokumentů. Vzhledem k tomu, že databáze jsou prostředkem pro správu, bude se pro přístup a úspěšné dokončení jakékoli akce pomocí uživatelských rozhraní API vyžadovat hlavní klíč služby.

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

Parametry

body

DatabaseRequest

DatabaseDefinition představující databázi, která má být vytvořena.

options

RequestOptions

Další možnosti žádosti

Návraty

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

Dotazuje všechny databáze.

Příklad

Čtení všech databází do pole * 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>

Parametry

query

string | SqlQuerySpec

Konfigurace dotazu pro operaci Další informace o konfiguraci dotazu najdete v tématu SqlQuerySpec .

options

FeedOptions

Slouží k nastavení možností, jako je velikost stránky odpovědi, pokračovací tokeny atd.

Návraty

QueryIterator<any>

QueryIterator Umožňuje vrátit všechny databáze v poli nebo je iterovat jednu po druhé. *

query<T>(string | SqlQuerySpec, FeedOptions)

Dotazuje všechny databáze.

Příklad

Čtení všech databází do pole * 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>

Parametry

query

string | SqlQuerySpec

Konfigurace dotazu pro operaci Další informace o konfiguraci dotazu najdete v tématu SqlQuerySpec .

options

FeedOptions

Slouží k nastavení možností, jako je velikost stránky odpovědi, pokračovací tokeny atd.

Návraty

QueryIterator<T>

QueryIterator Umožňuje vrátit všechny databáze v poli nebo je iterovat jednu po druhé. *

readAll(FeedOptions)

Načte všechny databáze.

Příklad

Čtení všech databází do pole * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

function readAll(options?: FeedOptions): QueryIterator<DatabaseDefinition & Resource>

Parametry

options

FeedOptions

Slouží k nastavení možností, jako je velikost stránky odpovědi, pokračovací tokeny atd.

Návraty

QueryIterator<DatabaseDefinition & Resource>

QueryIterator Umožňuje vrátit všechny databáze v poli nebo je iterovat jednu po druhé. *