CosmosClient.CreateDatabaseIfNotExistsAsync Méthode

Référence

Définition

Espace de noms:: Azure.Cosmos

Assembly:: Azure.Cosmos.dll

Paquet:: Azure.Cosmos v4.0.0-preview3

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.

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<Azure.Cosmos.DatabaseResponse> CreateDatabaseIfNotExistsAsync (string id, int? throughput = default, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<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.

throughput: Nullable<Int32>

(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<DatabaseResponse>

Task contenant un Response qui encapsule un DatabaseProperties contenant l’enregistrement de ressource.

Remarques

https://docs.microsoft.com/azure/cosmos-db/request-units pour plus d’informations sur le débit d’approvisionnement.

S’applique à

Partager via