CosmosClient.CreateDatabaseIfNotExistsAsync Methode

Referenz

Definition

Namespace:: Azure.Cosmos

Assembly:: Azure.Cosmos.dll

Paket:: Azure.Cosmos v4.0.0-preview3

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überprüfen Sie, ob eine Datenbank vorhanden ist, und erstellen Sie sie, falls dies nicht der Fall ist. Nur die Datenbank-ID wird verwendet, um zu überprüfen, ob eine Datenbank vorhanden ist. Andere Datenbankeigenschaften wie der Durchsatz werden nicht überprüft und können sich von den übergebenen Eigenschaften unterscheiden.

Eine Datenbank verwaltet Benutzer, Berechtigungen und eine Gruppe von Containern. Jedes Azure Cosmos DB-Datenbankkonto kann mehrere unabhängige benannte Datenbanken unterstützen, wobei die Datenbank der logische Container für Daten ist.

Jede Datenbank besteht aus einem oder mehreren Containern, von denen jeder wiederum ein oder mehrere Dokumente enthält. Da Es sich bei Datenbanken um eine administrative Ressource handelt, ist der Diensthauptschlüssel erforderlich, um mithilfe der Benutzer-APIs auf alle Aktionen zuzugreifen und diese erfolgreich abzuschließen.

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)

Parameter

id: String

Die Datenbank-ID.

throughput: Nullable<Int32>

(Optional) Der für eine Datenbank bereitgestellte Durchsatz bei der Messung von Anforderungseinheiten pro Sekunde im Azure Cosmos DB-Dienst.

requestOptions: RequestOptions

(Optional) Eine Reihe zusätzlicher Optionen, die festgelegt werden können.

cancellationToken: CancellationToken

(Optional) CancellationToken stellt den Anforderungsabbruch dar.

Gibt zurück

Task<DatabaseResponse>

Ein Task mit einem Response , das ein umschließt, DatabaseProperties das den Ressourcendatensatz enthält.

Hinweise

https://docs.microsoft.com/azure/cosmos-db/request-units weitere Informationen zum Bereitstellungsdurchsatz.

Gilt für:

Freigeben über