E-MapReduce フックは、SparkSQL ジョブからデータリネージおよびアクセス頻度を収集します。Data Lake Formation (DLF) を使用してテーブルおよびパーティションのアクセス回数を追跡したり、DataWorks を使用してデータリネージを管理したりできます。
前提条件
DataLake または Spark サービスを搭載したカスタムクラスターが必要です。詳細については、「クラスターの作成」をご参照ください。
制限事項
-
EMR-HOOK は、EMR-CLI を使用してカスタムデプロイされたゲートウェイ環境のジョブから SQL 情報を収集することをサポートしていません。
-
EMR バージョン 5.16.0 および 3.50.0 より前のバージョンでは、Hive 向けの hive.exec.post.hooks パラメーターおよび Spark 向けの spark.sql.queryExecutionListeners パラメーターの設定がゲートウェイノードに同期されません。EMR バージョン 5.16.0 以降および 3.50.0 以降では、これらの設定がゲートウェイノードに同期されます。また、これらのバージョンでは、ゲートウェイノード上でカスタム拡張 JAR ファイルを個別に使用できるようにする hive_aux_jars_path_gateway_only パラメーターも導入されています。
注意事項
-
E-MapReduce バージョン EMR-5.14.0 および EMR-3.48.0 より前のバージョンでは、E-MapReduce フックはデフォルトで有効になっています。
EMR-3.44 を実行するカスタムクラスターでは、E-MapReduce フックはデフォルトで無効になっているため、手動で有効化できます。詳細については、「よくある質問」をご参照ください。
-
E-MapReduce バージョン EMR-5.14.0 以降および EMR-3.48.0 以降では、E-MapReduce フックはデフォルトで無効になっており、手動で有効化する必要があります。
操作手順
-
ご利用のクラスターの [サービス] ページに移動します。
-
E-MapReduce コンソール にログインします。
-
上部ナビゲーションバーで、ご利用の要件に基づきリージョン およびリソースグループ を選択します。
-
ECS 上の EMR ページで、対象のクラスターを見つけ、[サービス] 列の Services をクリックします。
-
-
E-MapReduce フックを構成します。
-
Services ページで、Spark2 または Spark3 サービスを見つけ、Configure をクリックします。
-
Configure ページの該当するタブで、E-MapReduce フックの以下のパラメーターを編集または追加します。
タブ
パラメーター
説明
spark-defaults.conf
spark.sql.queryExecutionListeners
データリネージおよびアクセス頻度のために Spark サービスから SQL 情報をキャプチャします。
-
E-MapReduce フックを有効にするには、このパラメーターを
com.aliyun.emr.meta.spark.listener.EMRQueryLoggerに設定します。 -
E-MapReduce フックを無効にするには、パラメーター値を空のままにします。
hive-site.xml
dlf.emrhook.webtracking
アクセス頻度のレポートを有効にするかどうかを指定します。有効な値は以下のとおりです。
-
true:有効
-
false:無効
説明E-MapReduce フックを無効にすると、Data Lake Formation (DLF) コンソールのデータテーブルの [データ概要] ページに、[過去 1 日間のファイル訪問数]、[過去 7 日間のファイル訪問数]、および [過去 30 日間のファイル訪問数] のデータが表示されなくなります。
-
-
構成を保存します。
-
Configure ページで、Save をクリックします。
-
表示されるダイアログボックスで、Execution Reason フィールドに理由を入力し、Save をクリックします。
-
-
-
Spark サービスを再起動します。
-
Configure ページで、More > 再起動 を選択します。
-
表示されるダイアログボックスで、Execution Reason フィールドに理由を入力し、OK をクリックします。
-
[確認] ダイアログボックスで、[OK] をクリックします。
-
-
データ概要およびデータリネージを表示します。
-
Data Lake Formation (DLF) でデータ概要を表示します。詳細については、「データテーブルのデータ概要」をご参照ください。
-
DataWorks でデータリネージを表示します。詳細については、「データリネージ分析」をご参照ください。
-
よくある質問
関連ドキュメント
Hive サービス向けに E-MapReduce フックを構成する方法については、「Hive 拡張機能によるデータリネージおよびアクセス履歴の記録」をご参照ください。