Megosztás a következőn keresztül:

Databases class

Csomag:
@azure/cosmos

Új adatbázisok létrehozására és az összes adatbázis olvasására/lekérdezésére szolgáló műveletek

A meglévő adatbázisok olvasásával vagy törlésével kapcsolatban lásd: Adatbázis; client.database(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 databases.readAll() minden egyes item.read() hívás előtt, hogy meggyőződjön arról, hogy az adatbázis létezik; ezt egyszer kell elvégeznie az alkalmazás indításakor.

Tulajdonságok

client

Metódusok

create(DatabaseRequest, RequestOptions)

Adatbázis létrehozására vonatkozó kérés küldése.

Az adatbázis kezeli a felhasználókat, az engedélyeket és a tárolók készletét. Minden Azure Cosmos DB-adatbázisfiók több független, elnevezett adatbázist támogat, és az adatbázis az adatok logikai tárolója.

Minden adatbázis egy vagy több tárolóból áll, amelyek mindegyike egy vagy több dokumentumot tartalmaz. Mivel az adatbázisok rendszergazdai erőforrások, a szolgáltatás főkulcsára lesz szükség a felhasználói API-k használatával végzett műveletek eléréséhez és sikeres végrehajtásához.

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 { resource: databaseDefinition, database } = await client.databases.create({
  id: "<name here>",
});
createIfNotExists(DatabaseRequest, RequestOptions)

Ellenőrizze, hogy létezik-e adatbázis, és ha nem, hozza létre. 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.

Az adatbázis kezeli a felhasználókat, az engedélyeket és a tárolók készletét. Minden Azure Cosmos DB-adatbázisfiók több független, elnevezett adatbázist támogat, és az adatbázis az adatok logikai tárolója.

Minden adatbázis egy vagy több tárolóból áll, amelyek mindegyike egy vagy több dokumentumot tartalmaz. Mivel az adatbázisok rendszergazdai erőforrásnak minősülnek, a szolgáltatás főkulcsára lesz szükség a felhasználói API-k használatával végzett műveletek eléréséhez és sikeres végrehajtásához.

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" });
query(string | SqlQuerySpec, FeedOptions)

Lekérdezi az összes adatbázist.

példa

Az összes adatbázis beolvasása 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 = @database`,
  parameters: [{ name: "@database", value: "Todo" }],
};
const { resources: databaseList } = await client.databases.query(querySpec).fetchAll();
query<T>(string | SqlQuerySpec, FeedOptions)

Lekérdezi az összes adatbázist.

példa

Az összes adatbázis beolvasása 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 = @database`,
  parameters: [{ name: "@database", value: "Todo" }],
};
const { resources: databaseList } = await client.databases.query(querySpec).fetchAll();
readAll(FeedOptions)

Beolvassa az összes adatbázist.

példa

Az összes adatbázis beolvasása 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: databaseList } = await client.databases.readAll().fetchAll();

Tulajdonság adatai

client 

client: CosmosClient

Tulajdonság értéke

CosmosClient

Metódus adatai

create(DatabaseRequest, RequestOptions)

Adatbázis létrehozására vonatkozó kérés küldése.

Az adatbázis kezeli a felhasználókat, az engedélyeket és a tárolók készletét. Minden Azure Cosmos DB-adatbázisfiók több független, elnevezett adatbázist támogat, és az adatbázis az adatok logikai tárolója.

Minden adatbázis egy vagy több tárolóból áll, amelyek mindegyike egy vagy több dokumentumot tartalmaz. Mivel az adatbázisok rendszergazdai erőforrások, a szolgáltatás főkulcsára lesz szükség a felhasználói API-k használatával végzett műveletek eléréséhez és sikeres végrehajtásához.

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 { resource: databaseDefinition, database } = await client.databases.create({
  id: "<name here>",
});

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

Paraméterek

body
DatabaseRequest

A létrehozandó adatbázisDatabaseDefinition.

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<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

Ellenőrizze, hogy létezik-e adatbázis, és ha nem, hozza létre. 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.

Az adatbázis kezeli a felhasználókat, az engedélyeket és a tárolók készletét. Minden Azure Cosmos DB-adatbázisfiók több független, elnevezett adatbázist támogat, és az adatbázis az adatok logikai tárolója.

Minden adatbázis egy vagy több tárolóból áll, amelyek mindegyike egy vagy több dokumentumot tartalmaz. Mivel az adatbázisok rendszergazdai erőforrásnak minősülnek, a szolgáltatás főkulcsára lesz szükség a felhasználói API-k használatával végzett műveletek eléréséhez és sikeres végrehajtásához.

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" });

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

Paraméterek

body
DatabaseRequest

A létrehozandó adatbázisDatabaseDefinition.

options
RequestOptions

További lehetőségek a kéréshez

Válaszok

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

Lekérdezi az összes adatbázist.

példa

Az összes adatbázis beolvasása 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 = @database`,
  parameters: [{ name: "@database", value: "Todo" }],
};
const { resources: databaseList } = await client.databases.query(querySpec).fetchAll();

function query(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

Paraméterek

query

string | 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 egy tömb összes adatbázisát visszaadja, vagy egyenként iterálja át őket.

query<T>(string | SqlQuerySpec, FeedOptions)

Lekérdezi az összes adatbázist.

példa

Az összes adatbázis beolvasása 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 = @database`,
  parameters: [{ name: "@database", value: "Todo" }],
};
const { resources: databaseList } = await client.databases.query(querySpec).fetchAll();

function query<T>(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

Paraméterek

query

string | 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<T>

QueryIterator Lehetővé teszi, hogy egy tömb összes adatbázisát visszaadja, vagy egyenként iterálja át őket.

readAll(FeedOptions)

Beolvassa az összes adatbázist.

példa

Az összes adatbázis beolvasása 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: databaseList } = await client.databases.readAll().fetchAll();

function readAll(options?: FeedOptions): QueryIterator<DatabaseDefinition & 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<DatabaseDefinition & Resource>

QueryIterator Lehetővé teszi, hogy egy tömb összes adatbázisát visszaadja, vagy egyenként iterálja át őket.