TransactionalBatch.ExecuteAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.39.0

Surcharges

ExecuteAsync(CancellationToken)	Exécute le lot transactionnel sur le service Azure Cosmos en tant qu’opération asynchrone.
ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)	Exécute le lot transactionnel sur le service Azure Cosmos en tant qu’opération asynchrone.

ExecuteAsync(CancellationToken)

Source:

TransactionalBatch.cs

Exécute le lot transactionnel sur le service Azure Cosmos en tant qu’opération asynchrone.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member ExecuteAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>

Public MustOverride Function ExecuteAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)

Paramètres

cancellationToken

CancellationToken

(Facultatif) Jeton d’annulation représentant l’annulation de la demande.

Retours

Task<TransactionalBatchResponse>

Réponse attendable qui contient les détails de l’exécution du lot transactionnel.

Si le lot transactionnel s’exécute correctement, le StatusCode sur la réponse retournée est défini sur OK.

Si une opération dans le lot transactionnel échoue pendant l’exécution, aucune modification du lot n’est validée et la status de l’opération ayant échoué est mise à disposition dans .StatusCode Pour obtenir plus de détails sur l’opération qui a échoué, la réponse peut être énumérée : cela retourne TransactionalBatchOperationResult des instances correspondant à chaque opération dans le lot transactionnel dans l’ordre dans lequel elles ont été ajoutées au lot transactionnel. Pour un résultat correspondant à une opération dans le lot transactionnel, indique StatusCode le status de l’opération : si l’opération n’a pas été exécutée ou si elle a été abandonnée en raison de l’échec d’une autre opération dans le lot transactionnel, la valeur de ce champ est HTTP 424 (dépendance ayant échoué) ; pour l’opération qui a provoqué l’abandon du lot, la valeur de ce champ indique la cause de l’échec en tant que code status HTTP.

Le StatusCode sur la réponse retournée peut également avoir des valeurs telles que HTTP 5xx en cas d’erreurs de serveur et HTTP 429 (Trop de requêtes).

Remarques

Cette API lève uniquement des exceptions côté client. Il s’agit d’augmenter les performances et d’éviter la surcharge liée à la levée d’exceptions. Utilisez IsSuccessStatusCode sur la réponse retournée pour vous assurer que le lot transactionnel a réussi. Limites des requêtes TransactionalBatch

ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)

Source:

TransactionalBatch.cs

Exécute le lot transactionnel sur le service Azure Cosmos en tant qu’opération asynchrone.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (Microsoft.Azure.Cosmos.TransactionalBatchRequestOptions requestOptions, System.Threading.CancellationToken cancellationToken = default);

abstract member ExecuteAsync : Microsoft.Azure.Cosmos.TransactionalBatchRequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>

Public MustOverride Function ExecuteAsync (requestOptions As TransactionalBatchRequestOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)

Paramètres

requestOptions

TransactionalBatchRequestOptions

Options qui s’appliquent spécifiquement à la demande par lots.

cancellationToken

CancellationToken

(Facultatif) Jeton d’annulation représentant l’annulation de la demande.

Retours

Task<TransactionalBatchResponse>

Réponse attendable qui contient les détails de l’exécution du lot transactionnel.

Si le lot transactionnel s’exécute correctement, le StatusCode sur la réponse retournée est défini sur OK.

Si une opération dans le lot transactionnel échoue pendant l’exécution, aucune modification du lot n’est validée et la status de l’opération ayant échoué est mise à disposition dans .StatusCode Pour obtenir plus de détails sur l’opération qui a échoué, la réponse peut être énumérée : cela retourne TransactionalBatchOperationResult des instances correspondant à chaque opération dans le lot transactionnel dans l’ordre dans lequel elles ont été ajoutées au lot transactionnel. Pour un résultat correspondant à une opération dans le lot transactionnel, indique StatusCode le status de l’opération : si l’opération n’a pas été exécutée ou si elle a été abandonnée en raison de l’échec d’une autre opération dans le lot transactionnel, la valeur de ce champ est HTTP 424 (dépendance ayant échoué) ; pour l’opération qui a provoqué l’abandon du lot, la valeur de ce champ indique la cause de l’échec en tant que code status HTTP.

Le StatusCode sur la réponse retournée peut également avoir des valeurs telles que HTTP 5xx en cas d’erreurs de serveur et HTTP 429 (Trop de requêtes).

Remarques

Cette API lève uniquement des exceptions côté client. Il s’agit d’augmenter les performances et d’éviter la surcharge liée à la levée d’exceptions. Utilisez IsSuccessStatusCode sur la réponse retournée pour vous assurer que le lot transactionnel a réussi. Limites des requêtes TransactionalBatch