すべてのプロダクト
Search
ドキュメントセンター

DataWorks:API フィルター (関数) の設定

最終更新日:Feb 28, 2026

DataService Studio では、関数を作成して API に関連付けることができます。これらの関数は、API のリクエストパラメーターや戻り値を処理するフィルターとして機能します。このトピックでは、この機能について説明します。

制限事項

  • フィルター機能を使用するには、DataWorks Basic Edition 以降のバージョンを購入する必要があります。

  • Python 関数は現在アップグレード中です。新しい Python 関数の作成、クローン、公開はできません。関数を API フィルターとして使用するには、Aviator 関数タイプを使用してください。詳細については、「Aviator 関数の作成」をご参照ください。

注意事項

  • API のプレフィルターとポストフィルターは、同じ関数タイプ (両方とも Aviator または両方とも Python) である必要があります。同じ API のプレフィルターとポストフィルターに異なる関数タイプを使用することはサポートされていません。

  • セキュリティとパフォーマンス上の理由から、Aviator 関数はデータサービススタジオ専用リソースグループで実行する必要があります。

    • 関数を編集またはテストする際には、データサービススタジオ専用リソースグループをアタッチする必要があります。詳細については、「関数の作成」をご参照ください。

    • API 開発中にフィルターを有効にしてターゲット関数を関連付ける場合は、データサービススタジオ専用リソースグループを API にアタッチする必要があります。詳細については、「コードレス UI での API の生成」をご参照ください。

関数の概要

DataService Studio は、Aviator 関数と Python 関数をサポートしています。DataService Studio を使用して、関数の作成関数のテスト、公開、使用、および関数の公開ができます。関数を公開した後、API に関連付けて、API のリクエストパラメーターや戻り値を処理するフィルターとして使用できます。これにより、複雑なクエリ要件に対応し、さまざまなビジネスシナリオに適応できます。詳細については、「関数を API フィルターとして使用」をご参照ください。

  • プレフィルターは、API が呼び出されたときに、API のリクエストパラメーターを前処理できます。

  • ポストフィルターは、API が呼び出されたときに、API の戻り値を再処理および変換できます。

一般的なシナリオのコード例については、「ベストプラクティス:Aviator 関数をフィルターとして使用」をご参照ください。