TransactionalBatch.ExecuteAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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
S’applique à
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
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
S’applique à
Azure SDK for .NET