Utiliser DeleteMultiple (version préliminaire)

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l'objet de modifications.]

Important

Cette fonctionnalité est en version préliminaire.

Les fonctionnalités préliminaires ne sont pas destinées à une utilisation en production et peuvent avoir des fonctionnalités restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

DeleteMultiple

Supprimez plusieurs lignes de données dans des tables élastiques avec une seule requête.

SDK pour .NET

Vous devez utiliser la classe OrganizationRequest, car le SDK poru .NET n’a pas actuellement de classe DeleteMultipleRequest. Découvrez comment utiliser les messages avec le SDK pour .NET.

La méthode statique DeleteMultipleExample suivante utilise le message DeleteMultiple avec la classe OrganizationRequest pour supprimer plusieurs lignes de la table élastique contoso_SensorData en utilisant la clé secondaire pour inclure partitionid pour identifier de manière unique les lignes.

public static void DeleteMultipleExample(IOrganizationService service)
{
    string tableLogicalName = "contoso_sensordata";

    List<EntityReference> entityReferences = new() {
        {
            new EntityReference(logicalName: tableLogicalName,
               keyAttributeCollection: new KeyAttributeCollection
               {
                  { "contoso_sensordataid", "3f56361a-b210-4a74-8708-3c664038fa41" },
                  { "partitionid", "deviceid-001" }
               })
        },
        { new EntityReference(logicalName: tableLogicalName,
               keyAttributeCollection: new KeyAttributeCollection
               {
                  { "contoso_sensordataid", "e682715b-1bba-415e-b2bc-de9327308423" },
                  { "partitionid", "deviceid-002" }
               })
        }
    };

    OrganizationRequest request = new(requestName:"DeleteMultiple")
    {
        Parameters = {
            {"Targets", new EntityReferenceCollection(entityReferences)}
        }
    };

    service.Execute(request);
}

API web

L’exemple suivant montre comment utiliser l’action DeleteMultiple pour supprimer plusieurs lignes de la table élastique contoso_SensorData, y compris partitionid pour identifier de manière unique les lignes.

Notes

Au moment de la rédaction de cet article, l’action DeleteMultiple de l’API Web est une action privée. Vous ne la trouverez pas dans le document CSDL $metadata, ni dans Dataverse Web API Action Reference. Cette action sera bientôt rendue publique. Vous pouvez l’utiliser lorsqu’elle est privée.

Demande :

POST [Organization Uri]/api/data/v9.2/contoso_sensordatas/Microsoft.Dynamics.CRM.DeleteMultiple
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
Content-Type: application/json; charset=utf-8
Content-Length: 603

{
    "Targets": [
        {
            "@odata.type": "Microsoft.Dynamics.CRM.contoso_sensordata",
            "contoso_sensordataid": "6114ca58-0928-ee11-9965-6045bd5cd155",
            "partitionid": "Device-ABC-1234"
        },
        {
            "@odata.type": "Microsoft.Dynamics.CRM.contoso_sensordata",
            "contoso_sensordataid": "6214ca58-0928-ee11-9965-6045bd5cd155",
            "partitionid": "Device-ABC-1234"
        },
        {
            "@odata.type": "Microsoft.Dynamics.CRM.contoso_sensordata",
            "contoso_sensordataid": "6314ca58-0928-ee11-9965-6045bd5cd155",
            "partitionid": "Device-ABC-1234"
        }
    ]
}

Réponse :

HTTP/1.1 204 NoContent
OData-Version: 4.0

Disponibilité

DeleteMultiple n’est pris en charge que pour les tables élastiques. Les tables élastiques ne prennent pas en charge le comportement en cascade des relations de table, ce qui entraîne des délais d’exécution imprévisibles pour les opérations de suppression. Si vous utilisez DeleteMultiple sur une table standard, vous obtenez l’erreur : DeleteMultiple has not yet been implemented.

Examples

Vous pouvez trouver un exemple de code sur GitHub dans github.com/microsoft/PowerApps-Samples :

• Exemple de code de table élastique
• Dans Exemple : SDK pour .NET Utiliser des opérations groupées ou Exemple : API Web Utiliser des opérations groupées, modifiez le Settings.cs fichier de configuration et choisissez l’option UseElastic .

Voir aussi

Utiliser les messages d’opération en bloc
Tableaux élastiques
Exemple de code de table élastique
Exemple : Opérations en bloc SDK pour .NET
Exemple : Opérations en bloc API web