CosmosClient.CreateAndInitializeAsync Methode

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.36.0

Überlädt

CreateAndInitializeAsync(String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)	Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
CreateAndInitializeAsync(String, AzureKeyCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)	Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und AzureKeyCredential. AzureKeyCredential ermöglicht das Ändern/Aktualisieren master-key/ResourceToken, während CosmosClient noch verwendet wird. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
CreateAndInitializeAsync(String, TokenCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)	Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
CreateAndInitializeAsync(String, String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)	Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.

CreateAndInitializeAsync(String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)

Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.

public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string connectionString, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);

static member CreateAndInitializeAsync : string * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>

Public Shared Function CreateAndInitializeAsync (connectionString As String, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)

Parameter

connectionString

String

Die Verbindungszeichenfolge zum Cosmos-Konto. ex: AccountEndpoint=https://XXXXX.documents.azure.com:443/; AccountKey=SuperSecretKey;

containers

IReadOnlyList<ValueTuple<String,String>>

Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.

cosmosClientOptions

CosmosClientOptions

(Optional) Clientoptionen

cancellationToken

CancellationToken

(Optional) Abbruchtoken

Gibt zurück

Task<CosmosClient>

Ein CosmosClient-Objekt.

Beispiele

Der CosmosClient wird mit dem ConnectionString erstellt, und 2 Container im Konto werden initialisiert.

using Microsoft.Azure.Cosmos;
List<(string, string)> containersToInitialize = new List<(string, string)>
{ ("DatabaseName1", "ContainerName1"), ("DatabaseName2", "ContainerName2") };

CosmosClient cosmosClient = await CosmosClient.CreateAndInitializeAsync("connection-string-from-portal",
                                                                        containersToInitialize)

// Dispose cosmosClient at application exit

CreateAndInitializeAsync(String, AzureKeyCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)

Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und AzureKeyCredential. AzureKeyCredential ermöglicht das Ändern/Aktualisieren master-key/ResourceToken, während CosmosClient noch verwendet wird.

Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.

public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string accountEndpoint, Azure.AzureKeyCredential authKeyOrResourceTokenCredential, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);

static member CreateAndInitializeAsync : string * Azure.AzureKeyCredential * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>

Public Shared Function CreateAndInitializeAsync (accountEndpoint As String, authKeyOrResourceTokenCredential As AzureKeyCredential, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)

Parameter

accountEndpoint

String

Der zu verwendende Cosmos-Dienstendpunkt

authKeyOrResourceTokenCredential

AzureKeyCredential

AzureKeyCredential mit master-Schlüssel oder Ressourcentoken.

containers

IReadOnlyList<ValueTuple<String,String>>

Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.

cosmosClientOptions

CosmosClientOptions

(Optional) Clientoptionen

cancellationToken

CancellationToken

(Optional) Abbruchtoken

Gibt zurück

Task<CosmosClient>

Ein CosmosClient-Objekt.

Beispiele

Der CosmosClient wird mit accountEndpoint, AccountKey oder ResourceToken erstellt, und 2 Container im Konto werden initialisiert.

using Microsoft.Azure.Cosmos;
List<(string, string)> containersToInitialize = new List<(string, string)>
{ ("DatabaseName1", "ContainerName1"), ("DatabaseName2", "ContainerName2") };

AzureKeyCredential keyCredential = new AzureKeyCredential("account-master-key/ResourceToken");
CosmosClient cosmosClient = await CosmosClient.CreateAndInitializeAsync("account-endpoint-from-portal", 
                                                                        keyCredential,
                                                                        containersToInitialize)

....

// To udpate key/credentials 
keyCredential.Update("updated master-key/ResourceToken");

// Dispose cosmosClient at application exit

Hinweise

AzureKeyCredential ermöglicht das Ändern/Aktualisieren master-key/ResourceToken, wenn CosmosClient weiterhin verwendet wird.

CreateAndInitializeAsync(String, TokenCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)

Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.

public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string accountEndpoint, Azure.Core.TokenCredential tokenCredential, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);

static member CreateAndInitializeAsync : string * Azure.Core.TokenCredential * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>

Public Shared Function CreateAndInitializeAsync (accountEndpoint As String, tokenCredential As TokenCredential, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)

Parameter

accountEndpoint

String

Der zu verwendende Cosmos-Dienstendpunkt.

tokenCredential

TokenCredential

TokenCredentialDas Token, das AAD-Token für die Autorisierung bereitstellen soll.

containers

IReadOnlyList<ValueTuple<String,String>>

Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.

cosmosClientOptions

CosmosClientOptions

(Optional) Clientoptionen

cancellationToken

CancellationToken

(Optional) Abbruchtoken

Gibt zurück

Task<CosmosClient>

Ein CosmosClient-Objekt.

CreateAndInitializeAsync(String, String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)

Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.

public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string accountEndpoint, string authKeyOrResourceToken, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);

static member CreateAndInitializeAsync : string * string * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>

Public Shared Function CreateAndInitializeAsync (accountEndpoint As String, authKeyOrResourceToken As String, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)

Parameter

accountEndpoint

String

Der zu verwendende Cosmos-Dienstendpunkt

authKeyOrResourceToken

String

Der Cosmos-Kontoschlüssel oder das Ressourcentoken, das zum Erstellen des Clients verwendet werden soll.

containers

IReadOnlyList<ValueTuple<String,String>>

Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.

cosmosClientOptions

CosmosClientOptions

(Optional) Clientoptionen

cancellationToken

CancellationToken

(Optional) Abbruchtoken

Gibt zurück

Task<CosmosClient>

Ein CosmosClient-Objekt.

Beispiele

Der CosmosClient wird mit accountEndpoint, AccountKey oder ResourceToken erstellt, und 2 Container im Konto werden initialisiert.

using Microsoft.Azure.Cosmos;
List<(string, string)> containersToInitialize = new List<(string, string)>
{ ("DatabaseName1", "ContainerName1"), ("DatabaseName2", "ContainerName2") };

CosmosClient cosmosClient = await CosmosClient.CreateAndInitializeAsync("account-endpoint-from-portal", 
                                                                        "account-key-from-portal",
                                                                        containersToInitialize)

// Dispose cosmosClient at application exit

Hinweise

Der zurückgegebene Verweis garantiert keine Anmeldeinformationen oder Konnektivitätsüberprüfungen, da die Initialisierung keine Netzwerkaufrufe durchführt.