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

DataWorks:Flink のリソースと関数

最終更新日:Aug 21, 2026

このトピックでは、リソース管理を使用してさまざまな種類の Flink リソースと関数を作成する方法について説明します。これらのリソースを使用して、カスタム関数を作成したり、データ開発に利用したりできます。

前提条件

  • リソースと関数の作成に使用するフルマネージド Flink コンピューティングリソースがワークスペースにバインドされていること。

  • ローカルマシンからアップロードするリソースファイルが準備できていること。

リソースの作成と使用

リソース

Data Studio のリソース管理ページでは、DataWorks を介してローカルリソースを Flink にアップロードできます。その後、これらのリソースを使用して、DataWorks で Flink ジョブを開発したり、カスタム関数を作成したりできます。

制限事項

アップロードされたリソースは、次の制限事項に準拠する必要があります:

  • リソースサイズ:

    • オンライン編集:最大サイズは、Python リソースの場合は 10 MB、ファイルリソースの場合は 500 KB です。

    • ローカルファイルからのアップロード:単一リソースの最大サイズは 500 MB です。

    • OSS ファイルからのアップロード:単一リソースの最大サイズは 500 MB です。

  • リソースの公開:標準モードのワークスペースを使用する場合、使用前にリソースを本番環境に公開する必要があります。

    説明

    データソース情報は、開発環境と本番環境で異なる場合があります。テーブルまたはリソースをクエリする前に、現在の環境のデータソース情報を確認してください。

  • リソース管理:DataWorks では、DataWorks UI 経由でアップロードされたリソースのみを表示および管理できます。

リソースの作成

ローカルファイルからFlink リソースをアップロードできます。作成したリソースは、データ開発のために直接参照するか、関数として登録できます。Flink リソースには、次の種類があります:

  1. [リソース管理] ページでリソースを作成し、表示された[リソースと関数の作成] ダイアログボックスで、リソースのタイプ、ストレージのパス、およびリソースの名前を設定します。

  2. リソースを作成した後、ローカルファイルをアップロードします。

  3. 上部のツールバーで、リソースを保存し、公開します。公開済みのリソースのみがデータ開発で使用できるためです。

リソースの使用

リソースを作成した後、データ開発ノードを編集する際に、左側のナビゲーションバーでリソース管理をクリックし、目的のリソースまたは関数を見つけて右クリックし、リソースのリファレンスを選択します。リソースが正常に参照されると、--@resource_reference{"Resource Name"} 形式のコードが表示されます。

説明

たとえば、Flink SQL Streaming ノードでは--@resource_reference{"example.jar"} のように表示されます。表示形式はノードの種類によって異なります。実際のインターフェイスをご参照ください。

リソースを直接使用するだけでなく、リソースを関数として登録し、開発ノードで使用することもできます。

関数の作成と使用

関数

Data Studio では、リソース管理を使用してリソースを関数として登録できます。データ開発では、Flink の組み込み関数およびカスタム関数を使用できます。

関数の作成

  1. 「リソース管理」ページで関数を作成すると開く[リソースと関数の作成] ダイアログボックスで、関数のタイプ、ストレージのパス、および関数の名前を設定します。

  2. 確認 をクリックして、新しい関数リソースを作成し、関数のタイプに基づいて関連情報を設定します。

    Flink 関数を設定するには、まず DataWorks でコンピューティングリソースとして Flink クラスターを作成し、関連する Flink リソースを作成する必要があります。次の表に、Flink 関数のパラメーターを示します。

    パラメーター

    説明

    [関数タイプ]

    関数タイプを選択します:MATH (数学演算関数)、AGGREGATE (集計関数)、STRING (文字列処理関数)、DATE (日付関数)、ANALYTIC (ウィンドウ関数)、および OTHER (その他の関数)。

    [Flink クラスター]

    ドロップダウンリストから登録済みの Flink クラスターを選択します。

    [リソース一覧]

    Flink 関数はビジュアルインターフェイスからのみ設定できます。ドロップダウンリストからFlink Jar リソースを選択します。

    [コマンドのフォーマット]

    このユーザー定義関数 (UDF) の使用例です。

  3. 上部のツールバーで、関数を保存し、公開します。データ開発で使用できるのは、公開された関数のみです。

関数の使用

関数を作成して公開した後、データ開発ノードを編集する際に、左側のナビゲーションバーで リソース管理 をクリックし、目的のリソースまたは関数を見つけ、それを右クリックして リファレンス関数 を選択します。 この操作により、現在のノードの編集ページに example_function() などのカスタム関数名がすばやく生成されます。

リソースと関数の管理

Data Studio のビジュアルインターフェイスを通じてリソースをアップロードしたり、関数を作成したりした後、リソース管理ページでターゲットのリソースまたは関数をクリックして管理できます。

  • バージョン履歴の表示:リソースまたは関数エディターページの右側にあるバージョンボタンをクリックして、保存または送信された関数バージョンを表示および比較し、異なるバージョン間の変更を確認します。

    説明

    バージョンを比較するには、少なくとも 2 つのバージョンを選択する必要があります。

  • リソースまたは関数の削除:ターゲットのリソースまたは関数を右クリックし、削除 ボタンをクリックして削除します。

    本番環境でリソースまたは関数を削除するには、タスクをデプロイし、削除を本番環境にデプロイする必要があります。デプロイが成功すると、リソースまたは関数は本番環境から同期的に削除されます。