DeleteMultiple の使用 (プレビュー)

[このトピックはプレリリース ドキュメントであり、変更されることがあります。]

重要

これはプレビュー機能です。

プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。

DeleteMultiple

1 回のリクエストでエラスティック テーブル内の複数行のデータを削除します。

.NET 用 SDK

SDK for .NET には現在 DeleteMultipleRequest クラスがないため、OrganizationRequest クラスを使用する必要があります。 メッセージを .NET 用 SDK と共に使用する方法については、こちらをご覧ください。

次の DeleteMultipleExample 静的メソッドでは、OrganizationRequest クラスを持つ DeleteMultiple メッセージを使用して、contoso_SensorData エラスティック テーブルから複数の行を削除し、代替キーを使用して行を一意に識別する partitionid を含めます。

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);
}

Web API

次の例は、DeleteMultiple アクションを使用して、partitionid を含む contoso_SensorData エラスティック テーブルから複数の行を削除して、行を一意に識別する方法を示しています。

注意

この記事の執筆時点では、Web API DeleteMultiple アクションはプライベート アクションです。 CSDL $metadata ドキュメント または Dataverse Web API Action Reference には見つかりません。 このアクションは間もなく公開される予定です。 プライベートである間に使用できます。

要求:

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"
        }
    ]
}

応答:

HTTP/1.1 204 NoContent
OData-Version: 4.0

空き時間

DeleteMultiple は、エラスティック テーブルに対してのみサポートされます。 エラスティック テーブルはテーブル リレーションシップのカスケード動作をサポートしないため、削除操作の実行時間が予測不能になる可能性があります。 標準テーブルで DeleteMultiple を使用すると、次のエラーが発生します: DeleteMultiple has not yet been implemented.

使用例

GitHub github.com/microsoft/PowerApps-Samples にサンプル コードが用意されています。

• エラスティック テーブルのサンプル コード
• サンプル: SDK for .NET 一括操作の使用 または サンプル: Web API 一括操作の使用 内で、Settings.cs 設定ファイルを変更して、 UseElastic オプションを選択します。

参照

一括操作メッセージを使う
エラスティック テーブル
エラスティック テーブル サンプル コード
サンプル: .NET 用 SDK 一括操作の使用
サンプル: Web API 一括操作の使用