Database.CreateContainerAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Cosmos

Assembly:: Microsoft.Azure.Cosmos.Client.dll

Paket:: Microsoft.Azure.Cosmos v3.36.0

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.

Überlädt

CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	Erstellt einen Container als asynchronen Vorgang im Azure Cosmos-Dienst.
CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	Erstellt einen Container als asynchronen Vorgang im Azure Cosmos-Dienst.
CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	Erstellt einen Container als asynchronen Vorgang im Azure Cosmos-Dienst.

CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)

Erstellt einen Container als asynchronen Vorgang im Azure Cosmos-Dienst.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse> CreateContainerAsync (Microsoft.Azure.Cosmos.ContainerProperties containerProperties, Microsoft.Azure.Cosmos.ThroughputProperties throughputProperties, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateContainerAsync : Microsoft.Azure.Cosmos.ContainerProperties * Microsoft.Azure.Cosmos.ThroughputProperties * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse>

Public MustOverride Function CreateContainerAsync (containerProperties As ContainerProperties, throughputProperties As ThroughputProperties, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ContainerResponse)

Parameter

containerProperties: ContainerProperties

Das ContainerProperties-Objekt.

throughputProperties: ThroughputProperties

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

requestOptions: RequestOptions

(Optional) Die Optionen für die Anforderung.

cancellationToken: CancellationToken

(Optional) CancellationToken stellt die Anforderungsabbruch dar.

Gibt zurück

Task<ContainerResponse>

Eine Task , die einen ContainerResponse enthält, der einen ContainerProperties umschließt, der den Leseressourcendatensatz enthält.

Ausnahmen

ArgumentNullException

Wenn containerProperties nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.

CosmosException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen eines Containers erhalten, sind:

StatusCode	Ausnahmegrund
400	BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. Es ist wahrscheinlich, dass für den neuen Container keine ID angegeben wurde.
403	Verboten: Dies bedeutet, dass Sie versucht haben, Ihr Kontingent für Container zu überschreiten. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409	Konflikt: Dies bedeutet, dass eine ContainerProperties mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.

Beispiele

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = Guid.NewGuid().ToString(),
    PartitionKeyPath = "/pk",
    IndexingPolicy = new IndexingPolicy()
   {
        Automatic = false,
        IndexingMode = IndexingMode.Lazy,
   }
};

ContainerResponse response = await this.cosmosDatabase.CreateContainerAsync(
    containerProperties,
    ThroughputProperties.CreateAutoscaleThroughput(10000));

Gilt für:

CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)

Erstellt einen Container als asynchronen Vorgang im Azure Cosmos-Dienst.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse> CreateContainerAsync (Microsoft.Azure.Cosmos.ContainerProperties containerProperties, int? throughput = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateContainerAsync : Microsoft.Azure.Cosmos.ContainerProperties * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse>

Public MustOverride Function CreateContainerAsync (containerProperties As ContainerProperties, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ContainerResponse)

Parameter

containerProperties: ContainerProperties

Das ContainerProperties-Objekt.

throughput: Nullable<Int32>

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

requestOptions: RequestOptions

(Optional) Die Optionen für die Anforderung.

cancellationToken: CancellationToken

(Optional) CancellationToken stellt die Anforderungsabbruch dar.

Gibt zurück

Task<ContainerResponse>

Eine Task , die einen ContainerResponse enthält, der einen ContainerProperties umschließt, der den Leseressourcendatensatz enthält.

Ausnahmen

ArgumentNullException

Wenn containerProperties nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.

CosmosException

StatusCode	Ausnahmegrund
400	BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. Es ist wahrscheinlich, dass für den neuen Container keine ID angegeben wurde.
403	Verboten: Dies bedeutet, dass Sie versucht haben, Ihr Kontingent für Container zu überschreiten. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409	Konflikt: Dies bedeutet, dass eine ContainerProperties mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.

Beispiele

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = Guid.NewGuid().ToString(),
    PartitionKeyPath = "/pk",
    IndexingPolicy = new IndexingPolicy()
   {
        Automatic = false,
        IndexingMode = IndexingMode.Lazy,
   }
};

ContainerResponse response = await this.cosmosDatabase.CreateContainerAsync(containerProperties);

Hinweise

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

Weitere Informationen

DefineContainer(String, String)

Gilt für:

CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)

Erstellt einen Container als asynchronen Vorgang im Azure Cosmos-Dienst.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse> CreateContainerAsync (string id, string partitionKeyPath, int? throughput = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateContainerAsync : string * string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse>

Public MustOverride Function CreateContainerAsync (id As String, partitionKeyPath As String, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ContainerResponse)

Parameter

id: String

Die Cosmos-Container-ID

partitionKeyPath: String

Der Pfad zum Partitionsschlüssel. Beispiel: /location

throughput: Nullable<Int32>

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

requestOptions: RequestOptions

(Optional) Die Optionen für die Anforderung.

cancellationToken: CancellationToken

(Optional) CancellationToken stellt die Anforderungsabbruch dar.

Gibt zurück

Task<ContainerResponse>

Eine Task , die einen ContainerResponse enthält, der einen ContainerProperties umschließt, der den Leseressourcendatensatz enthält.

Ausnahmen

ArgumentNullException

Wenn id nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.

CosmosException

StatusCode	Ausnahmegrund
400	BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. Es ist wahrscheinlich, dass für den neuen Container keine ID angegeben wurde.
403	Verboten: Dies bedeutet, dass Sie versucht haben, Ihr Kontingent für Container zu überschreiten. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409	Konflikt: Dies bedeutet, dass eine ContainerProperties mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.

Beispiele

ContainerResponse response = await this.cosmosDatabase.CreateContainerAsync(Guid.NewGuid().ToString(), "/pk");

Hinweise

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

Weitere Informationen

DefineContainer(String, String)

Gilt für:

Freigeben über

Database.CreateContainerAsync Methode

Definition

Überlädt

CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Gilt für:

CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen