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(Database |
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. |
| create |
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' 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 | Sql |
Interroge toutes les bases de données. exemple de Lisez toutes les bases de données dans le tableau.
* |
| query<T>(string | Sql |
Interroge toutes les bases de données. exemple de Lisez toutes les bases de données dans le tableau.
* |
| read |
Lit toutes les bases de données. exemple de Lisez toutes les bases de données dans le tableau.
* |
Détails de la propriété
client
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<any>
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. *