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(Database |
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. |
create |
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 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 | Sql |
Hiermee voert u query's uit op alle databases. Voorbeeld Lees alle databases naar matrix.
* |
query<T>(string | Sql |
Hiermee voert u query's uit op alle databases. Voorbeeld Lees alle databases naar matrix.
* |
read |
Leest alle databases. Voorbeeld Lees alle databases naar matrix.
* |
Eigenschapdetails
client
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<any>
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. *