ファイル ストリームへのエクスポート アクション

この ファイルストリームにエクスポート アクション は、SELECT ステートメント または ストアド プロシージャ を使用してデータベースからデータを取得し、クエリ結果を効率的な処理や自動化タスク間での共有のためにファイルストリーム変数にエクスポートします。

ファイルストリームへのエクスポート アクション を利用することで、タスク Bot と API タスク の両方でデータベースからファイルを直接操作できます。 詳細については、ファイル変数を使用したファイルストリーミングを参照してください。

データベースからデータを読み取り、それをファイルストリーム変数にエクスポートするタスクを自動化するには、次の手順に従ってください：

手順

  1. 接続 アクション に、データベース サーバーへの接続に使用したセッションの名前を入力します。 詳細については、データベースでの [接続] アクションの使用を参照してください。
  2. データベースからデータを読み取るには、次のオプションのいずれかを選択します。
    • SELECT ステートメント
    • ストアド プロシージャ
    SELECT ステートメントの使用
    1. SELECT ステートメントを入力して、列名およびテーブル名を指定します。
      このフィールドは SQL 構文をサポートしています。 たとえば、SELECT CustomerName,City FROM Customers です。
      注: CTE (共通テーブル式) は、Oracle や MySQL などの SQL 準拠データベースで WITH キーワードを使用することでサポートされます。 例:
      WITH customers_in_usa AS (SELECT CustomerName, state FROM customers WHERE country = 'USA') 
SELECT cName FROM customers_in_usa WHERE state = 'LA' ORDER BY CustomerName
    ストアド プロシージャを使用
    1. ストアド プロシージャの名前を入力します。
    2. オプション: パラメーターを追加 をクリックして入力パラメーターを指定するか、出力パラメーターを設定します。
      次のパラメーター オプションから選択します。
      オプション パラメーターおよび説明 サポートされているデータ タイプ
      入力 パラメーターは Bot からストアド プロシージャに渡されます。
      • 名前: ストアド プロシージャのパラメーター名を入力します。
      • 値 (任意): 値を入力するか、変数を選択します。
      • タイプ: リストから必要なデータ型を選択します。
      たとえば、ストアド プロシージャを管理 アクション からサンプル関数を実行する場合は、次の 2 つの入力パラメーターと sum_of_two 関数の値を設定して追加します。
      • パラメーター 1: num1, 5, TINYINT
      • パラメーター 2: num2、10、TINYINT
      • BIGINT (数値)
      • BINARY (Boolean)
      • BIT (数値)
      • CHAR (文字列)
      • DATE (日時)

        サポートされている形式yyyy-mm-dd

      • DECIMAL (数値)
      • DOUBLE (数値)

        10 進値のデフォルトの選択肢です。

      • FLOAT (数値)
      • INTEGER (数値)

        4 バイトを使用して、-2,147,483,648～2,147,483,647 の整数値を格納します。

      • LONGVARBINARY (Boolean)
      • LONGVARCHAR (文字列)
      • NUMERIC (数値)
      • REAL (数値)
      • SMALLINT (数値)

        2 バイトを使用して、-32,768～32,767 の値の整数を格納します。

      • TIME (日時)

        サポートされている形式hh:mm:ss

      • TIMESTAMP (日時)

        サポートされている形式はyyyy-mm-dd hh:mm:ss.fで、f は小数秒です。

      • TINYINT (数値)

        1 バイトを使用して、0～255 までの整数を格納します。

      • VARBINARY (Boolean)
      • VARCHAR (文字列)
      出力 パラメーターは、ストアド プロシージャから Bot に渡されます。
      • 名前: ストアド プロシージャのパラメーター名を入力します。
      • タイプ: リストから必要なデータ型を選択します。

      オートメーション を実行すると、アクション はデータベースのデータ型を、Automation 360 がサポートするデータ型に変換します。

      たとえば、ストアド プロシージャを管理 アクション から sum_of_two関数の例を実行する場合は、出力パラメーター sum、TINYINT を構成します。
      入力/出力 パラメーターは、入力と出力の両方に使用できます。
      • 名前: ストアド プロシージャのパラメーター名を入力します。
      • 値 (任意): 値を入力するか、変数を選択します。
      • タイプ: リストから必要なデータ型を選択します。
  3. 取得したいレコードの最大数を入力してください。
    実行の結果は制限できます。
    注: 最大取得レコード数を指定しない場合、この アクション はすべてのレコードを取得します。
  4. オプション: タイムアウト値を入力します。
    指定された時間が経過すると、実行が完了していなくてもステートメントの実行は停止します。
    注: タイムアウト値を指定しない場合、この アクション はクエリの実行が完了するまで待機します。 そうでなければ、タイムアウトが発生した場合にエラーメッセージが表示されます。
  5. クエリ結果をエクスポートするために、.CSV 拡張子を持つ有効なファイル名を入力してください。
    注: これは、クエリ結果をファイルストリーム変数に渡すための参照ファイル名に過ぎません。
  6. 次のいずれかの CSV ファイルのエンコードオプションを選択してください。
    • ANSI: デフォルトのオプションです。 システムのデフォルト コードページをエンコーディングに使用します。 特殊文字を含まない英語および西ヨーロッパ言語に適しています。
    • ユニコード: より広範囲の文字をサポートしています (UTF-16)。 多言語テキストや拡張文字セットを含むデータに適しています。
    • UTF8: ユニコード変換形式（8ビット）。 プラットフォームやツール（Excel、Notepad++など）で広くサポートされています。 ユニコードと比較して、ファイルサイズが小さくなります。
  7. クエリ結果に列ヘッダーを含めるかどうかを選択してください。

    列ヘッダーなし（デフォルト選択）

    Manny Pittsburgh
    Kate Los Angeles
    John Boston

    列ヘッダー付き

    CustomerName 都市
    Manny Pittsburgh
    Kate Los Angeles
    John Boston
  8. クエリー結果を保存するファイルストリーム変数を指定します。
    変数を作成 オプションを使用してファイルストリーム変数を作成するか、ドロップダウンリストから既存のファイルストリーム変数を選択できます。
  9. 保存 をクリックします。
    この アクション で API タスクを実行すると、SELECT ステートメント または ストアド プロシージャ がデータベースからデータを取得し、クエリの出力を指定されたファイル ストリーム変数に保存します。