Skip to main content

データ出力ツール

データ出力ツールを使用して、サポートされているファイルの種類またはデータソースにワークフローの結果を書き込みます。

パレットで [データ出力] ツールを選択し、ワークフローキャンバスにドラッグします。

ツールコンポーネント

Output Data with Anchors.png

図: アンカー付きデータ出力ツール

データ出力ツールには 1 つのアンカーがあります。

入力アンカー: 入力アンカーをワークフローに接続して、ワークフローの結果をデータソースまたはサポートされているファイルの種類に書き込みます。

ツールの設定

For Google BigQuery Live Query workflows, you can save results as CSV or Excel files to the workspace’s Google Cloud Storage base storage, or write results to any eligible BigQuery connection in the workspace. Only supported output destinations and file formats appear in the tool. Other storage destinations aren't supported.

Save to CSV or Excel

To save your results to a file:

  1. From the tool configuration window, select Select Output Location to open the Output Data window.

  2. Choose a supported file-output destination.

  3. Enter a File Name.

  4. From Format, choose the required CSV or Excel format.

  5. Review the File Path. To change it, select Customize Location and choose the destination folder.

  6. Select Next to open Output Options.

  7. Choose an available Output Actions on Every Run setting to specify how subsequent runs handle an existing file or workbook.

  8. Configure the options displayed for your selected format.

  9. Select Confirm. To revise the saved configuration, select the pencil icon in the tool configuration panel.

  10. Select Run Job to execute the workflow and publish the file.

注記

CSV and Excel output is also supported in Snowflake Live Query workflows.

Google BigQueryに保存する

CDPテーブル出力の場合は、対象となる接続を介してアクセスできるカタログ、データベース、またはスキーマを選択します。現時点では、暗黙的に選択される既定のスキーマはありません。自身で出力先を選択します。同じ接続内で、使用可能なデータベースを選択できます。

CDP出力のテーブル名はパラメーター化できます。

ワークフローの結果をGoogle BigQueryに書き込む方法:

  1. ツール設定ウィンドウから、[出力場所の選択]を選択し、[データ出力]ウィンドウを開きます。

  2. [接続]からクラウドデータ接続を選択するか、[既存のデータセット]から選択します。

  3. [テーブル名]を入力します。オプションで、{x}(パラメーターの追加)アイコンを選択し、[テーブル名]にパラメーターを追加します。詳細については、パラメーターセクションを参照してください。

  4. 次に、テーブルを保存するスキーマを選択した後、[次へ]を選択します。

  5. [毎回の実行時の出力アクション]ドロップダウンを使用して、ジョブの実行時に同じ名前のテーブルが存在する場合に実行するアクションを選択します。

    • 新しいテーブルを作成する: 新しいテーブルを作成します。

    • テーブルに追加: データが既存のテーブルの末尾に追加されます。

    • 既存のテーブルの短縮: 既存のテーブルデータを短縮し、新しいデータに置き換えます。

    • 既存のテーブルの削除: 既存のテーブルを削除し、新しいテーブルに置き換えます。

    • 既存のテーブルとマージ: 出力データは既存のテーブルとマージされます。

  6. [確認]を選択し、出力データの詳細を保存します。次に、データ出力ツールの設定パネルで選択内容を確認し、必要があれば鉛筆アイコンを使用して変更することができます。

  7. [ジョブを実行]を選択してワークフローを実行し、選択した接続にファイルを保存します。

注記

一時出力は現在、ユーザー向けの出力オプションとしては使用できません。

出力権限

接続には、ジョブを実行し、選択した出力先に書き込むために必要な権限が必要です。

テーブル出力には、出力先に対する適切な作成権限または書き込み権限が必要です。

パラメーター

パラメーターを使用して、動的な文字列またはタイムスタンプ値を出力データに適用します。[テーブル名]にパラメーターを適用できます。

  • 文字列のパラメーターには、スケジュールまたはプラン内のジョブ実行ごとに上書きできる既定値があります。

  • タイムスタンプパラメーターには、ジョブ実行時のフォーマットされたタイムスタンプが自動的に入力されます。

[テーブル名]でパラメーターを使用する方法:

  1. []または[テーブル名]フィールドで、{x} (パラメーターを追加)アイコンを選択し、[パラメーター]ウィンドウを開きます。

  2. 以前にパラメーターを作成したことがある場合は、[ワークスペースパラメーター]セクションからそれを選択します。パラメーターは、[ファイル名]フィールドのカーソル位置に挿入されます。ファイル名からパラメーターを削除するには、そのパラメーターを選択した後、[削除]を選択します。

  3. 新しいパラメーターを作成する必要がある場合は、[+新規]を選択します。[パラメーターの管理]リンクを選択して[パラメーター]ページを起動し、このページで新しいパラメーターの作成や既存パラメーターの編集を行うことができます。

文字列パラメーターの作成

文字列パラメーターを使用して、出力データに動的にラベルを付けます。

  1. 文字列パラメーターを作成するには、[パラメーター]ウィンドウから[+新規]を選択した後、[タイプ]ドロップダウンから[文字列]を選択します。

  2. パラメーターの[名前]を入力します。これは、このパラメーターを使用するとファイル名フィールドに表示されるものです。

  3. [説明]を入力します。これは、将来的に自分自身や他のユーザーに役立つ分かりやすいものである必要があります。

  4. パラメーターの[既定値]を入力します。パラメーターが動的に更新されない場合、この値が使用されます。

  5. [作成]を選択してパラメーターを作成し、ファイル名またはパスに追加します。パラメーターを削除するには、そのパラメーターを選択し、[削除]を選択します。

タイムスタンプパラメーターの作成

タイムスタンプパラメーターを使用すると、ジョブ実行時にフォーマットされたタイムスタンプが自動的に入力されます。

注記

文字列パラメーターとは異なり、タイムスタンプパラメーターは[パラメーター]ページに保存されません。パラメーターページ

  1. タイムスタンプパラメーターを作成するには、[パラメーター]ウィンドウから[+新規]を選択した後、[タイプ]ドロップダウンから[タイムスタンプ]を選択します。

  2. 必要に応じてタイムスタンプの形式をカスタマイズします。既定の形式はyyyy-MM-ddです。[+]ボタンを選択すると、カスタマイズオプションが表示されます。[形式のプレビュー]には、選択した形式を使用しての今日の日付が表示されます。

  3. 次に、[タイムスタンプ値]を設定します。以下の中から選択します。

    • ジョブの開始時と一致: ジョブの開始時刻の正確なタイムスタンプ値を出力します。

    • ジョブの開始時に相対: ジョブの開始時刻を基準にしたタイムスタンプを出力します。たとえば、ジョブ開始時刻の1時間後にタイムスタンプを出力できます。

      • タイミング: ジョブ開始時刻より後または前のタイムスタンプを出力します。

      • 値: 相対的なタイムスタンプの数値を選択します。

      • 単位: 相対的なタイムスタンプの単位を選択します。オプションには以下が含まれます。

        • 分

        • 時間

        • 日

        • 週

        • 月

        • 四半期

        • 年

  4. 次に、タイムスタンプパラメーターの[タイムゾーン]を選択します。

  5. 最後に、[作成]を選択してパラメーターを作成し、それをカーソルの位置に挿入します。

パラメーターの上書き

文字列パラメーターを使用してワークフローを実行すると、そのワークフローではパラメーターの作成時に指定した既定値が使用されます。ただし、この値を上書きするオプションがあります。

文字列パラメーターの既定値を上書きするには:

  1. [ジョブを実行]ボタンにあるドロップダウンアイコンを選択します。

  2. [パラメーター]を選択し、[パラメーターの上書き]ウィンドウを開きます。

  3. 既定値を使用しないすべてのパラメーターについて、[値を上書き]列に、上書きする値を入力します。

  4. [ジョブの保存と実行]を選択し、更新されたパラメーター値でワークフローを実行します。

このセクションの内容: