Partager via


Databases class

Opérations de création de bases de données et lecture/interrogation de toutes les bases de données

Consultez base de données pour lire ou supprimer une base de données existante ; utilisez client.database(id).

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système afin que ces appels soient mis à l’échelle sous-linéairement avec votre application. Par exemple, n’appelez pas databases.readAll() avant chaque appel de item.read() unique, pour vous assurer que la base de données existe ; effectuez cette opération une fois sur le démarrage de l’application.

Propriétés

client

Méthodes

create(DatabaseRequest, RequestOptions)

Envoyez une demande de création d’une base de données.

Une base de données gère les utilisateurs, les autorisations et un ensemble de conteneurs. Chaque compte de base de données Azure Cosmos DB peut prendre en charge plusieurs bases de données nommées indépendantes, avec la base de données étant le conteneur logique des données.

Chaque base de données se compose d’un ou plusieurs conteneurs, chacun contenant à son tour un ou plusieurs documents. Étant donné que les bases de données sont une ressource d’administration, la clé principale du service est requise pour accéder à toutes les actions et effectuer correctement toute action à l’aide des API utilisateur.

createIfNotExists(DatabaseRequest, RequestOptions)

Vérifiez si une base de données existe et si ce n’est pas le cas, créez-la. Une opération de lecture est effectuée en fonction de l’ID de l'body, puis, si elle est introuvable, une opération de création.

Une base de données gère les utilisateurs, les autorisations et un ensemble de conteneurs. Chaque compte de base de données Azure Cosmos DB peut prendre en charge plusieurs bases de données nommées indépendantes, avec la base de données étant le conteneur logique des données.

Chaque base de données se compose d’un ou plusieurs conteneurs, chacun contenant à son tour un ou plusieurs documents. Étant donné que les bases de données sont une ressource d’administration, la clé principale du service est nécessaire pour accéder à toutes les actions à l’aide des API utilisateur et les effectuer.

query(string | SqlQuerySpec, FeedOptions)

Interroge toutes les bases de données.

exemple de

Lisez toutes les bases de données dans le tableau. * 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)

Interroge toutes les bases de données.

exemple de

Lisez toutes les bases de données dans le tableau. * 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)

Lit toutes les bases de données.

exemple de

Lisez toutes les bases de données dans le tableau. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

Détails de la propriété

client

client: CosmosClient

Valeur de propriété

Détails de la méthode

create(DatabaseRequest, RequestOptions)

Envoyez une demande de création d’une base de données.

Une base de données gère les utilisateurs, les autorisations et un ensemble de conteneurs. Chaque compte de base de données Azure Cosmos DB peut prendre en charge plusieurs bases de données nommées indépendantes, avec la base de données étant le conteneur logique des données.

Chaque base de données se compose d’un ou plusieurs conteneurs, chacun contenant à son tour un ou plusieurs documents. Étant donné que les bases de données sont une ressource d’administration, la clé principale du service est requise pour accéder à toutes les actions et effectuer correctement toute action à l’aide des API utilisateur.

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

Paramètres

body
DatabaseRequest

DatabaseDefinition qui représente le de base de données à créer.

options
RequestOptions

Permet de définir des options telles que la taille de page de réponse, les jetons de continuation, etc.

Retours

Promise<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

Vérifiez si une base de données existe et si ce n’est pas le cas, créez-la. Une opération de lecture est effectuée en fonction de l’ID de l'body, puis, si elle est introuvable, une opération de création.

Une base de données gère les utilisateurs, les autorisations et un ensemble de conteneurs. Chaque compte de base de données Azure Cosmos DB peut prendre en charge plusieurs bases de données nommées indépendantes, avec la base de données étant le conteneur logique des données.

Chaque base de données se compose d’un ou plusieurs conteneurs, chacun contenant à son tour un ou plusieurs documents. Étant donné que les bases de données sont une ressource d’administration, la clé principale du service est nécessaire pour accéder à toutes les actions à l’aide des API utilisateur et les effectuer.

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

Paramètres

body
DatabaseRequest

DatabaseDefinition qui représente le de base de données à créer.

options
RequestOptions

Options supplémentaires pour la demande

Retours

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

Interroge toutes les bases de données.

exemple de

Lisez toutes les bases de données dans le tableau. * 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>

Paramètres

query

string | SqlQuerySpec

Configuration de requête pour l’opération. Pour plus d’informations sur la configuration d’une requête, consultez SqlQuerySpec.

options
FeedOptions

Permet de définir des options telles que la taille de page de réponse, les jetons de continuation, etc.

Retours

QueryIterator vous permet de retourner toutes les bases de données d’un tableau ou d’itérer sur eux un par un. *

query<T>(string | SqlQuerySpec, FeedOptions)

Interroge toutes les bases de données.

exemple de

Lisez toutes les bases de données dans le tableau. * 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>

Paramètres

query

string | SqlQuerySpec

Configuration de requête pour l’opération. Pour plus d’informations sur la configuration d’une requête, consultez SqlQuerySpec.

options
FeedOptions

Permet de définir des options telles que la taille de page de réponse, les jetons de continuation, etc.

Retours

QueryIterator vous permet de retourner toutes les bases de données d’un tableau ou d’itérer sur eux un par un. *

readAll(FeedOptions)

Lit toutes les bases de données.

exemple de

Lisez toutes les bases de données dans le tableau. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

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

Paramètres

options
FeedOptions

Permet de définir des options telles que la taille de page de réponse, les jetons de continuation, etc.

Retours

QueryIterator vous permet de retourner toutes les bases de données d’un tableau ou d’itérer sur eux un par un. *