DataWorks:SSH ノード

使用上の注意

• SSH ノードを使用してリモートホスト上でプロセスを起動した後、タイムアウトなどが原因で SSH ノードタスクが予期せず終了しても、リモートホスト上のプロセスに影響はありません。DataWorks はプロセスを終了するコマンドを送信しません。

• SSH ノードは標準の Shell 構文をサポートしていますが、対話型構文はサポートしていません。

• SSH ノードを使用して ECS インスタンス上でスクリプトをリモート実行すると、インスタンス上に一時ファイルが作成されます。ECS インスタンスに十分なディスク容量があり、ファイル数の上限が要件を満たしていることを確認してください。

• 複数のタスクで同じファイルを同時に操作しないでください。競合が発生すると、SSH ノードが失敗する可能性があります。

前提条件

• ビジネスフローが作成されている必要があります。

  Data Studio では、ビジネスフローに基づいてエンジン固有の開発操作を実行します。ノードを作成する前に、まずビジネスフローを作成してください。詳細については、「ビジネスフローの作成」をご参照ください。

• SSH データソースが作成済みであること。

  SSH ノードで定期実行タスクの開発やスケジュールを行う前に、SSH サーバーにアクセスするための SSH データソースを作成する必要があります。データソースの作成については、「SSH データソース」をご参照ください。

  説明

  SSH ノードは、JDBC 接続文字列で作成された SSH データソースのみをサポートしています。タスクの失敗を防ぐため、データソースがリソースグループへのネットワーク接続性があることを確認してください。

• (オプション。RAM ユーザーの場合は必須) タスク開発に使用する RAM ユーザーがターゲットワークスペースに追加され、[開発者] または [ストレージ管理者] ロール (広範な権限を付与するため、慎重に割り当ててください) のいずれかが割り当てられている必要があります。メンバーの追加と権限の付与の詳細については、「ワークスペースへのメンバーの追加」をご参照ください。

制限事項

• Serverless リソースグループで SSH タスクを実行できます。Serverless リソースグループの購入と使用方法の詳細については、「Serverless リソースグループの使用」をご参照ください。

• サポートされているリージョン：中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深圳)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、ドイツ (フランクフルト)、英国 (ロンドン)、米国 (シリコンバレー)、米国 (バージニア)。

• SSH ノードの最大コード長は 128 KB です。

ステップ 1: SSH ノードの作成

1. DataStudioページに移動します。

   DataWorks コンソールにログインします。 左側のナビゲーションウィンドウで、[データモデリングと開発] > [DataStudio] を選択します。 表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[DataStudioに移動] をクリックします。

2. 対象のワークフローを右クリックし、ノードの作成 > [SSH] を選択します。

3. ノードの作成 ダイアログボックスで、ノードの 名前 を入力し、確認 をクリックします。ノードが作成されると、タスクを開発および設定できます。

ステップ 2: SSH タスクの開発

# 1. 環境の準備
# リモートホストで、実行するファイルを探します。例: リモートホストの /tmp ディレクトリにある nihao.sh ファイル。
# テスト用に、SSH ノードで次のコマンドを実行して nihao.sh ファイルを作成できます。
echo "echo nihao,dataworks" >/tmp/nihao.sh
# 2. SSH ノードでリモートホスト上のファイルを実行
# DataWorks の SSH ノードで /tmp/nihao.sh ファイルを実行します。
sh /tmp/nihao.sh

# 目標: SSH ノードの実行時刻を毎日 /tmp/sshnode.log ファイルに書き込む
# 実装: ${myDate} 変数に値 $[yyyy-mm-dd hh24:mi:ss] を割り当てることで、SSH ノードの実行時刻をファイルに書き込みます。
echo ${myDate} >/tmp/sshnode.log
cat /tmp/sshnode.log

ステップ 3: タスクスケジューリングの設定

ノードタスクを定期的に実行するには、ノード編集ページの右側にある [スケジューリング設定] をクリックし、必要に応じてスケジューリング設定を構成します。詳細については、「タスクスケジューリングプロパティの概要」をご参照ください。

ステップ 5: タスクの送信とパブリッシュ

ノードタスクを設定したら、送信してパブリッシュします。パブリッシュされると、ノードはスケジューリング設定に基づいて定期的に実行されます。

1. ツールバーの アイコンをクリックしてノードを保存します。

2. ツールバーの アイコンをクリックしてノードタスクを送信します。

   [コミット] ダイアログボックスで、[変更内容] を入力します。必要に応じて、送信後にコードレビューを要求するかどうかを選択します。

   説明

   • ノードを送信する前に、ノードの [再実行プロパティ] と [依存する先祖ノード] を設定する必要があります。

   • コードレビューは、コード品質を確保し、レビューされていないコードが本番環境に直接パブリッシュされることによるエラーを防ぎます。コードレビューが有効になっている場合、送信されたノードコードは、パブリッシュする前にレビュー担当者の承認を受ける必要があります。詳細については、「コードレビュー」をご参照ください。

標準モードのワークスペースを使用している場合、タスクの送信に成功したら、ノード編集ページの右上隅にある [パブリッシュ] をクリックして、タスクを本番環境にデプロイします。詳細については、「タスクのパブリッシュ」をご参照ください。

次のステップ

タスク操作： タスクがコミットされ公開されると、ノードの設定に基づいて定期的に実行されます。ノード編集ページの右上隅にある 運用保守 をクリックしてオペレーションセンターに移動し、定期タスクのスケジューリングと実行ステータスを表示できます。詳細については、「定期タスクの管理」をご参照ください。

関連ドキュメント

SSH ノードの負荷分散と高可用性の実装については、「SSH ノードの負荷分散と高可用性の実装」をご参照ください。