CosmosClient.CreateDatabaseIfNotExistsAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken) |
Vérifiez si une base de données existe et si ce n’est pas le cas, créez-la. Seul l’ID de base de données est utilisé pour vérifier s’il existe une base de données existante. D’autres propriétés de base de données, telles que le débit, ne sont pas validées et peuvent être différentes des propriétés passé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, 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 de service est requise pour accéder à toute action à l’aide des API utilisateur et y effectuer correctement. |
| CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken) |
Vérifiez si une base de données existe et si ce n’est pas le cas, créez-la. Seul l’ID de base de données est utilisé pour vérifier s’il existe une base de données existante. D’autres propriétés de base de données, telles que le débit, ne sont pas validées et peuvent être différentes des propriétés passé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, 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 de service est requise pour accéder à toute action à l’aide des API utilisateur et y effectuer correctement. |
CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)
Vérifiez si une base de données existe et si ce n’est pas le cas, créez-la. Seul l’ID de base de données est utilisé pour vérifier s’il existe une base de données existante. D’autres propriétés de base de données, telles que le débit, ne sont pas validées et peuvent être différentes des propriétés passé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, 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 de service est requise pour accéder à toute action à l’aide des API utilisateur et y effectuer correctement.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse> CreateDatabaseIfNotExistsAsync (string id, int? throughput = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);abstract member CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>Public Overridable Function CreateDatabaseIfNotExistsAsync (id As String, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DatabaseResponse)Paramètres
- id
- String
ID de base de données.
(Facultatif) Débit provisionné pour une base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos DB.
- requestOptions
- RequestOptions
(Facultatif) Ensemble d’options supplémentaires qui peuvent être définies.
- cancellationToken
- CancellationToken
(Facultatif) CancellationToken représentant l’annulation de la demande.
Retours
Task contenant un DatabaseResponse qui encapsule un DatabaseProperties contenant l’enregistrement de ressource.
| StatusCode | Codes d’état de réussite courants pour l’opération CreateDatabaseIfNotExistsAsync |
|---|---|
| 201 | Créé : une nouvelle base de données est créée. |
| 200 | OK : cela signifie que la base de données existe déjà. |
Remarques
https://docs.microsoft.com/azure/cosmos-db/request-units pour plus d’informations sur le débit d’approvisionnement.
S’applique à
CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken)
Vérifiez si une base de données existe et si ce n’est pas le cas, créez-la. Seul l’ID de base de données est utilisé pour vérifier s’il existe une base de données existante. D’autres propriétés de base de données, telles que le débit, ne sont pas validées et peuvent être différentes des propriétés passé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, 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 de service est requise pour accéder à toute action à l’aide des API utilisateur et y effectuer correctement.
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse> CreateDatabaseIfNotExistsAsync (string id, Microsoft.Azure.Cosmos.ThroughputProperties throughputProperties, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);abstract member CreateDatabaseIfNotExistsAsync : string * Microsoft.Azure.Cosmos.ThroughputProperties * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Microsoft.Azure.Cosmos.ThroughputProperties * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>Public Overridable Function CreateDatabaseIfNotExistsAsync (id As String, throughputProperties As ThroughputProperties, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DatabaseResponse)Paramètres
- id
- String
ID de base de données.
- throughputProperties
- ThroughputProperties
Débit provisionné pour une base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos DB.
- requestOptions
- RequestOptions
(Facultatif) Ensemble d’options supplémentaires qui peuvent être définies.
- cancellationToken
- CancellationToken
(Facultatif) CancellationToken représentant l’annulation de la demande.
Retours
Task contenant un DatabaseResponse qui encapsule un DatabaseProperties contenant l’enregistrement de ressource.
| StatusCode | Codes d’état de réussite courants pour l’opération CreateDatabaseIfNotExistsAsync |
|---|---|
| 201 | Créé : une nouvelle base de données est créée. |
| 200 | OK : cela signifie que la base de données existe déjà. |
S’applique à
Azure SDK for .NET
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour