CosmosClient Klasse

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.

Stellt eine clientseitige logische Darstellung des Azure Cosmos DB-Kontos bereit. Dieser Client kann zum Konfigurieren und Ausführen von Anforderungen im Azure Cosmos DB-Datenbankdienst verwendet werden.

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 unter https://docs.microsoft.com/azure/cosmos-db/performance-tips.

public class CosmosClient : IDisposable

type CosmosClient = class
    interface IDisposable

Public Class CosmosClient
Implements IDisposable

Vererbung: Object
CosmosClient

Implementiert: IDisposable

Beispiele

In diesem Beispiel wird ein CosmosClient, CosmosDatabaseund ein CosmosContainererstellt. Der CosmosClient wird mit der Verbindungszeichenfolge erstellt und für die Verwendung der Region "USA, Osten 2" konfiguriert.

using Azure.Cosmos;

CosmosClient cosmosClient = new CosmosClient(
            "connection-string-from-portal", 
            new CosmosClientOptions()
            {
                ApplicationRegion = Regions.EastUS2,
            });

Database db = await client.CreateDatabaseAsync("database-id");
Container container = await db.CreateContainerAsync("container-id");

// Dispose cosmosClient at application exit

In diesem Beispiel wird ein CosmosClient, CosmosDatabaseund ein CosmosContainererstellt. Der CosmosClient wird mit der Region "AccountEndpoint", "AccountKey" oder "ResourceToken" erstellt und für die Verwendung der Region "USA, Osten 2" konfiguriert.

using Azure.Cosmos;

CosmosClient cosmosClient = new CosmosClient(
            "account-endpoint-from-portal", 
            "account-key-from-portal", 
            new CosmosClientOptions()
            {
                ApplicationRegion = Regions.EastUS2,
            });

Database db = await client.CreateDatabaseAsync("database-id");
Container container = await db.CreateContainerAsync("container-id");

// Dispose cosmosClient at application exit

In diesem Beispiel wird ein CosmosClient, CosmosDatabaseund ein CosmosContainererstellt. Der CosmosClient wird über das Generatormuster CosmosClientBuildererstellt.

using Azure.Cosmos;
using Azure.Cosmos.Fluent;

CosmosClient cosmosClient = new CosmosClientBuilder("connection-string-from-portal")
    .WithApplicationRegion("East US 2")
    .Build();

Database db = await client.CreateDatabaseAsync("database-id")
Container container = await db.CreateContainerAsync("container-id");

// Dispose cosmosClient at application exit

Hinweise

https://docs.microsoft.com/azure/cosmos-db/performance-tips https://docs.microsoft.com/azure/cosmos-db/troubleshoot-dot-net-sdk https://docs.microsoft.com/azure/cosmos-db/distribute-data-globally https://docs.microsoft.com/azure/cosmos-db/partitioning-overview https://docs.microsoft.com/azure/cosmos-db/request-units

Konstruktoren

CosmosClient()

Erstellen eines neuen CosmosClients, der für Pseudotests verwendet wird

CosmosClient(String, CosmosClientOptions)

Erstellen eines neuen CosmosClient mit der Verbindungszeichenfolge

CosmosClient(String, String, CosmosClientOptions)

Erstellen eines neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und kontoschlüssels

Eigenschaften

ClientOptions	Die CosmosClientOptions verwendete Initialisierung von CosmosClient
Endpoint	Ruft den Endpunkt-URI für den Azure Cosmos DB-Dienst ab.

Methoden

CreateDatabaseAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)	Senden Sie eine Anforderung zum Erstellen einer Datenbank. 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.
CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)	Ü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.
CreateDatabaseStreamAsync(DatabaseProperties, Nullable<Int32>, RequestOptions, CancellationToken)	Senden Sie eine Anforderung zum Erstellen einer Datenbank. 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.
Dispose()	Verwerfen des Cosmos-Clients
Dispose(Boolean)	Verwerfen des Cosmos-Clients
GetContainer(String, String)	Gibt einen Proxyverweis auf einen Container zurück.
GetDatabase(String)	Gibt einen Proxyverweis auf eine Datenbank zurück.
GetDatabaseQueryIterator<T>(QueryDefinition, String, QueryRequestOptions, CancellationToken)	Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung mit parametrisierten Werten. Er gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition.
GetDatabaseQueryIterator<T>(String, String, QueryRequestOptions, CancellationToken)	Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung. Er gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition Überladung.
GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions, CancellationToken)	Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung mit parametrisierten Werten. Er gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition.
GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions, CancellationToken)	Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung. Er gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition Überladung.
ReadAccountAsync()	Lesen von Azure Cosmos DB-Kontoeigenschaften AccountProperties

Gilt für:

Freigeben über