Database Classe

Définition

Espace de noms:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.39.0

Source:

Database.cs

Opérations de lecture ou de suppression d’une base de données existante.

Consultez Client pour créer des bases de données et lire/interroger toutes les bases de données ; utilisez client.Databases.

public abstract class Database

type Database = class

Public MustInherit Class Database

Héritage

Object

Database

Remarques

Remarque : toutes ces opérations effectuent des appels sur un budget fixe. Vous devez concevoir votre système de sorte que ces appels soient mis à l’échelle de manière sub-linéaire avec votre application. Pour instance, n’appelez pas la base de données. ReadAsync()' avant chaque 'conteneur. Appel ReadItemAsync() pour s’assurer que la base de données existe ; effectuez cette opération une fois au démarrage de l’application.

Constructeurs

Database()

Opérations de lecture ou de suppression d’une base de données existante. Consultez Client pour créer des bases de données et lire/interroger toutes les bases de données ; utilisez client.Databases.

Propriétés

Client	Le client Cosmos parent instance lié à la base de données instance
Id	ID de la base de données Cosmos

Méthodes

CreateClientEncryptionKeyAsync(ClientEncryptionKeyProperties, RequestOptions, CancellationToken)	Enregistre la clé de chiffrement du client en tant qu’opération asynchrone dans le service Azure Cosmos. Cette méthode n’est pas destinée à être appelée directement. https://aka.ms/CosmosClientEncryption Consultez pour utiliser le chiffrement côté client.
CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateContainerIfNotExistsAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	Vérifiez si un conteneur existe et, si ce n’est pas le cas, créez-le. Seul l’ID de conteneur est utilisé pour vérifier s’il existe un conteneur existant. D’autres propriétés de conteneur, telles que le débit, ne sont pas validées et peuvent être différentes des propriétés passées.
CreateContainerIfNotExistsAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	Vérifiez si un conteneur existe et, si ce n’est pas le cas, créez-le. Seul l’ID de conteneur est utilisé pour vérifier s’il existe un conteneur existant. D’autres propriétés de conteneur, telles que le débit, ne sont pas validées et peuvent être différentes des propriétés passées.
CreateContainerIfNotExistsAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	Vérifiez si un conteneur existe et, si ce n’est pas le cas, créez-le. Cette opération crée une opération de lecture et, si le conteneur est introuvable, elle effectue une opération de création.
CreateContainerStreamAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateContainerStreamAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.
CreateUserAsync(String, RequestOptions, CancellationToken)	Crée un utilisateur en tant qu’opération asynchrone dans le service Azure Cosmos.
DefineContainer(String, String)	Crée un containerBuilder.
DeleteAsync(RequestOptions, CancellationToken)	Supprimer une base de données du service Azure Cosmos DB en tant qu’opération asynchrone.
DeleteStreamAsync(RequestOptions, CancellationToken)	Supprimez un DatabaseProperties du service Azure Cosmos DB en tant qu’opération asynchrone.
GetClientEncryptionKey(String)	Retourne une référence à un objet de clé de chiffrement client. Cette méthode n’est pas destinée à être appelée directement. https://aka.ms/CosmosClientEncryption Consultez pour utiliser le chiffrement côté client.
GetClientEncryptionKeyQueryIterator(QueryDefinition, String, QueryRequestOptions)	Retourne un itérateur qui peut être itéré pour obtenir les propriétés des clés de chiffrement client. Cette méthode n’est pas destinée à être appelée directement. https://aka.ms/CosmosClientEncryption Consultez pour utiliser le chiffrement côté client.
GetContainer(String)	Retourne une référence à un objet conteneur.
GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)	Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator.
GetContainerQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.
GetContainerQueryStreamIterator(String, String, QueryRequestOptions)	Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator.
GetUser(String)	Retourne une référence à un objet utilisateur.
GetUserQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les utilisateurs sous une base de données à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.
GetUserQueryIterator<T>(String, String, QueryRequestOptions)	Cette méthode crée une requête pour les utilisateurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator.
ReadAsync(RequestOptions, CancellationToken)	Lit un DatabaseResponse à partir du service Azure Cosmos en tant qu’opération asynchrone.
ReadStreamAsync(RequestOptions, CancellationToken)	Lit un DatabaseProperties à partir du service Azure Cosmos en tant qu’opération asynchrone.
ReadThroughputAsync(CancellationToken)	Obtient le débit de la base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReadThroughputAsync(RequestOptions, CancellationToken)	Obtient le débit de la base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReplaceThroughputAsync(Int32, RequestOptions, CancellationToken)	Définit le débit approvisionné pour une base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReplaceThroughputAsync(ThroughputProperties, RequestOptions, CancellationToken)	Définit le débit approvisionné pour une base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
UpsertUserAsync(String, RequestOptions, CancellationToken)	Upserts d’un utilisateur en tant qu’opération asynchrone dans le service Azure Cosmos.