:UDF の開発とデバッグ

手順

1. 作成した MaxCompute Java モジュールディレクトリを展開し、次の図に示すように、[src] > [main] > [java] > [new] の順に移動し、 [MaxCompute Java] をクリックします。
2. 次の図に示すように、[Name] と [Kind] を設定して [OK] をクリックします。
   
   • Name: MaxCompute Java クラスの名前を指定します。 パッケージを作成していない場合は、"packagename.classname" と入力してパッケージを自動的に作成します。
   • Kind: 種類を指定します。 サポートされている種類には、カスタマイズ関数 (UDF、UDAF、UDTF) 、MapReduce (Driver、Mapper、Reducer) 、および非構造開発 (StorageHandler、Extractor) が含まれます。
3. 作成が成功すると、Java プログラムの開発、変更、およびテストが可能です。
   
   注 これは Intellij でカスタマイズ可能なコードテンプレートです。 [Preference] > [Editor] > [File] > [Code Template] でそれを定義します。 [Code] タブで、対応するテンプレートを探します。

詳細な開発手順については、「 JAVA UDF の開発」をご参照ください。

通常、JAVA UDF の開発は次の方法で行います。

• MaxCompute Studio を使用して JAVA UDF 開発の全プロセスを完了します。
• Eclipse プラグインを使用した JAVA UDF の開発およびデバッグを使用し、jar パッケージをエクスポートして、コマンドまたは DataWorks によって リソースを追加し、関数を登録します。

詳細な開発手順については「 JAVA UDF の開発」をご参照ください。

UDF プログラムのデバッグ

UDFプログラムを開発した後、単体テスト (UT) またはローカル実行を使用してそれをテストし、想定どおりか確認します。

"examples" ディレクトリにはさまざまな UT の例があり、それらを参照して UT をコンパイルします。

ローカル実行

UDF プログラムのローカル実行中に、実行中のデータソースを指定する必要があります。 テストデータソースを設定するには、次の 2 つの方法があります。

• MaxCompute Studio は、トンネルサービスを使用して、特定のプロジェクトのテーブルデータを "warehouse" ディレクトリに自動的にダウンロードします。
• モックプロジェクトとテーブルデータが提供されます。 "warehouse" 内の "example_project" を参照し、自身でそれを設定します。

1. [UDF Class] を右クリックし、[Run UDF class.main()] をクリックします。 [Run Configuration] ダイアログボックスが表示されます。 通常、UDF、UDAF、UDTF データは、SELECT サブ文のテーブルの列として使用されます。 MaxCompute プロジェクト、テーブル、および列を設定する必要があります (メタデータは、"project explorer" と "warehouse" 配下のモックプロジェクトに由来します) 。 次の図に示すように、複合型のデバッグもサポートされています。
   

2. [OK] をクリックします。

   
   注

   • 指定されたプロジェクト配下のテーブルデータが "glashourse" にダウンロードされていない場合は、まずデータをダウンロードする必要があります。デフォルトでは、100 エントリーをダウンロードします。 さらにデータが必要な場合は、コンソールのトンネルコマンドまたは Studio のテーブルダウンロード機能を使用します。
   • モックプロジェクトを使用する、またはテーブルデータをダウンロードする場合は、プログラムを直接実行します。
   • UDF ローカル実行フレームワークは、"warehouse" 内の特定の列のデータを UDF 入力として使用し、 UDF プログラムをローカルに実行します。 ログ出力と結果画面がコンソールに表示されます。

ローカル "warehouse" ディレクトリは、ローカル UDF または MR 実行用のテーブル (メタおよびデータを含む) またはリソースを格納するために使用されます。 次の図は、"warehouse" ディレクトリを示しています。