Delen via


Databases class

Bewerkingen voor het maken van nieuwe databases en het lezen/opvragen van alle databases

Zie Database voor het lezen of verwijderen van een bestaande database; gebruik client.database(id).

Opmerking: al deze bewerkingen voeren aanroepen uit tegen een vast budget. U moet uw systeem zo ontwerpen dat deze aanroepen sublineair worden geschaald met uw toepassing. Roep bijvoorbeeld niet databases.readAll() aan vóór elke aanroep item.read() om ervoor te zorgen dat de database bestaat. Doe dit eenmaal bij het opstarten van de toepassing.

Eigenschappen

client

Methoden

create(DatabaseRequest, RequestOptions)

Een aanvraag verzenden voor het maken van een database.

Een database beheert gebruikers, machtigingen en een set containers. Elk Azure Cosmos DB-databaseaccount kan ondersteuning bieden voor meerdere onafhankelijke benoemde databases, waarbij de database de logische container voor gegevens is.

Elke database bestaat uit een of meer containers, die elk op hun beurt een of meer documenten bevatten. Omdat databases een beheerresource zijn, is de hoofdsleutel van de service vereist om een actie te openen en te voltooien met behulp van de gebruikers-API's.

createIfNotExists(DatabaseRequest, RequestOptions)

Controleer of er een database bestaat en maak deze als dat niet het probleem is. Hiermee wordt een leesbewerking gemaakt op basis van de id in de body, en als deze niet wordt gevonden, een maakbewerking.

Een database beheert gebruikers, machtigingen en een set containers. Elk Azure Cosmos DB-databaseaccount kan ondersteuning bieden voor meerdere onafhankelijke benoemde databases, waarbij de database de logische container voor gegevens is.

Elke database bestaat uit een of meer containers, die elk op hun beurt een of meer documenten bevatten. Omdat databases een beheerresource zijn, is de hoofdsleutel van de service vereist om een actie te openen en te voltooien met behulp van de gebruikers-API's.

query(string | SqlQuerySpec, FeedOptions)

Hiermee voert u query's uit op alle databases.

Voorbeeld

Lees alle databases naar matrix. * 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)

Hiermee voert u query's uit op alle databases.

Voorbeeld

Lees alle databases naar matrix. * 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)

Leest alle databases.

Voorbeeld

Lees alle databases naar matrix. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

Eigenschapdetails

client

client: CosmosClient

Waarde van eigenschap

Methodedetails

create(DatabaseRequest, RequestOptions)

Een aanvraag verzenden voor het maken van een database.

Een database beheert gebruikers, machtigingen en een set containers. Elk Azure Cosmos DB-databaseaccount kan ondersteuning bieden voor meerdere onafhankelijke benoemde databases, waarbij de database de logische container voor gegevens is.

Elke database bestaat uit een of meer containers, die elk op hun beurt een of meer documenten bevatten. Omdat databases een beheerresource zijn, is de hoofdsleutel van de service vereist om een actie te openen en te voltooien met behulp van de gebruikers-API's.

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

Parameters

body
DatabaseRequest

De DatabaseDefinition die de database vertegenwoordigt die moet worden gemaakt.

options
RequestOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

Promise<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

Controleer of er een database bestaat en maak deze als dat niet het probleem is. Hiermee wordt een leesbewerking gemaakt op basis van de id in de body, en als deze niet wordt gevonden, een maakbewerking.

Een database beheert gebruikers, machtigingen en een set containers. Elk Azure Cosmos DB-databaseaccount kan ondersteuning bieden voor meerdere onafhankelijke benoemde databases, waarbij de database de logische container voor gegevens is.

Elke database bestaat uit een of meer containers, die elk op hun beurt een of meer documenten bevatten. Omdat databases een beheerresource zijn, is de hoofdsleutel van de service vereist om een actie te openen en te voltooien met behulp van de gebruikers-API's.

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

Parameters

body
DatabaseRequest

De DatabaseDefinition die de database vertegenwoordigt die moet worden gemaakt.

options
RequestOptions

Aanvullende opties voor de aanvraag

Retouren

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

Hiermee voert u query's uit op alle databases.

Voorbeeld

Lees alle databases naar matrix. * 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>

Parameters

query

string | SqlQuerySpec

Queryconfiguratie voor de bewerking. Zie SqlQuerySpec voor meer informatie over het configureren van een query.

options
FeedOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

QueryIterator Hiermee kunt u alle databases in een matrix retourneren of ze één voor één herhalen. *

query<T>(string | SqlQuerySpec, FeedOptions)

Hiermee voert u query's uit op alle databases.

Voorbeeld

Lees alle databases naar matrix. * 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>

Parameters

query

string | SqlQuerySpec

Queryconfiguratie voor de bewerking. Zie SqlQuerySpec voor meer informatie over het configureren van een query.

options
FeedOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

QueryIterator Hiermee kunt u alle databases in een matrix retourneren of ze één voor één herhalen. *

readAll(FeedOptions)

Leest alle databases.

Voorbeeld

Lees alle databases naar matrix. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

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

Parameters

options
FeedOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

QueryIterator Hiermee kunt u alle databases in een matrix retourneren of ze één voor één herhalen. *