データ出力ツール
データ出力ツールを使用して、サポートされているファイルの種類またはデータソースにワークフローの結果を書き込みます。
パレットで [データ出力] ツールを選択し、ワークフローキャンバスにドラッグします。
ツールコンポーネント
 |
図: アンカー付きデータ出力ツール
データ出力ツールには 1 つのアンカーがあります。
入力アンカー: 入力アンカーをワークフローに接続して、ワークフローの結果をデータソースまたはサポートされているファイルの種類に書き込みます。
ツールの設定
Databricksに保存する
ワークフローの結果をDatabricksに書き込む方法:
ツール設定ウィンドウから、[出力場所の選択]を選択し、[データ出力]ウィンドウを開きます。
[接続]からクラウドデータ接続を選択するか、[既存のデータセット]から選択します。
[テーブル名]を入力します。オプションで、{x}(パラメーターの追加)アイコンを選択し、[テーブル名]にパラメーターを追加します。詳細については、パラメーターセクションを参照してください。
次に、テーブルを保存するスキーマを選択した後、[次へ]を選択します。
[毎回の実行時の出力アクション]ドロップダウンを使用して、ジョブの実行時に同じ名前のテーブルが存在する場合に実行するアクションを選択します。
新しいテーブルを作成する: 新しいテーブルを作成します。
テーブルに追加: データが既存のテーブルの末尾に追加されます。
既存のテーブルの短縮: 既存のテーブルデータを短縮し、新しいデータに置き換えます。
既存のテーブルの削除: 既存のテーブルを削除し、新しいテーブルに置き換えます。
既存のテーブルとマージ: 出力データは既存のテーブルとマージされます。
[確認]を選択し、出力データの詳細を保存します。次に、データ出力ツールの設定パネルで選択内容を確認し、必要があれば鉛筆アイコンを使用して変更することができます。
[ジョブを実行]を選択してワークフローを実行し、選択した接続にファイルを保存します。
パラメーター
パラメーターを使用して、動的な文字列またはタイムスタンプ値を出力データに適用します。[テーブル名]にパラメーターを適用できます。
文字列のパラメーターには、スケジュールまたはプラン内のジョブ実行ごとに上書きできる既定値があります。
タイムスタンプパラメーターには、ジョブ実行時のフォーマットされたタイムスタンプが自動的に入力されます。
[テーブル名]でパラメーターを使用する方法:
[]または[テーブル名]フィールドで、{x} (パラメーターを追加)アイコンを選択し、[パラメーター]ウィンドウを開きます。
以前にパラメーターを作成したことがある場合は、[ワークスペースパラメーター]セクションからそれを選択します。パラメーターは、[ファイル名]フィールドのカーソル位置に挿入されます。ファイル名からパラメーターを削除するには、そのパラメーターを選択した後、[削除]を選択します。
新しいパラメーターを作成する必要がある場合は、[+新規]を選択します。[パラメーターの管理]リンクを選択して[パラメーター]ページを起動し、このページで新しいパラメーターの作成や既存パラメーターの編集を行うことができます。
文字列パラメーターの作成
文字列パラメーターを使用して、出力データに動的にラベルを付けます。
文字列パラメーターを作成するには、[パラメーター]ウィンドウから[+新規]を選択した後、[タイプ]ドロップダウンから[文字列]を選択します。
パラメーターの[名前]を入力します。これは、このパラメーターを使用するとファイル名フィールドに表示されるものです。
[説明]を入力します。これは、将来的に自分自身や他のユーザーに役立つ分かりやすいものである必要があります。
パラメーターの[既定値]を入力します。パラメーターが動的に更新されない場合、この値が使用されます。
[作成]を選択してパラメーターを作成し、ファイル名またはパスに追加します。パラメーターを削除するには、そのパラメーターを選択し、[削除]を選択します。
タイムスタンプパラメーターの作成
タイムスタンプパラメーターを使用すると、ジョブ実行時にフォーマットされたタイムスタンプが自動的に入力されます。
注記
文字列パラメーターとは異なり、タイムスタンプパラメーターは[パラメーター]ページに保存されません。
タイムスタンプパラメーターを作成するには、[パラメーター]ウィンドウから[+新規]を選択した後、[タイプ]ドロップダウンから[タイムスタンプ]を選択します。
必要に応じてタイムスタンプの形式をカスタマイズします。既定の形式はyyyy-MM-ddです。[+]ボタンを選択すると、カスタマイズオプションが表示されます。[形式のプレビュー]には、選択した形式を使用しての今日の日付が表示されます。
次に、[タイムスタンプ値]を設定します。以下の中から選択します。
ジョブの開始時と一致: ジョブの開始時刻の正確なタイムスタンプ値を出力します。
ジョブの開始時に相対: ジョブの開始時刻を基準にしたタイムスタンプを出力します。たとえば、ジョブ開始時刻の1時間後にタイムスタンプを出力できます。
タイミング: ジョブ開始時刻より後または前のタイムスタンプを出力します。
値: 相対的なタイムスタンプの数値を選択します。
単位: 相対的なタイムスタンプの単位を選択します。オプションには以下が含まれます。
分
時間
日
週
月
四半期
年
次に、タイムスタンプパラメーターの[タイムゾーン]を選択します。
最後に、[作成]を選択してパラメーターを作成し、それをカーソルの位置に挿入します。
パラメーターの上書き
文字列パラメーターを使用してワークフローを実行すると、そのワークフローではパラメーターの作成時に指定した既定値が使用されます。ただし、この値を上書きするオプションがあります。
文字列パラメーターの既定値を上書きするには:
[ジョブを実行]ボタンにあるドロップダウンアイコンを選択します。
[パラメーター]を選択し、[パラメーターの上書き]ウィンドウを開きます。
既定値を使用しないすべてのパラメーターについて、[値を上書き]列に、上書きする値を入力します。
[ジョブの保存と実行]を選択し、更新されたパラメーター値でワークフローを実行します。