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