Skip to main content

Blue icon with a stream-like object flowing into a database. データストリーム入力ツール

ユーザーロール要件

ユーザーロール*

ツール/機能へのアクセス

フルユーザー

✓

ベーシックユーザー

X

*Alteryx Oneプロフェッショナルエディションおよびエンタープライズエディションをご契約中で、Designerバージョン2025.1以降をお使いのお客様に適用されます。

データストリーム入力を使用すると、Alteryx DesignerからIn-DBワークフローにデータを取り込むことができます。

インデータベースは、データベースからデータを移動することなく大きなデータセットに対してブレンディングと分析を可能にし、従来の分析メソッドに比べて大幅なパフォーマンス向上を実現します。インデータベースツールカテゴリの詳細については、「インデータベースの概要」を参照してください。

ツールの設定

Connection Name

接続 名 : ドロップダウンを選択して、新しい接続を作成するか、既存の接続を管理するか、既に設定されている接続の一覧から接続を選択します。

  • 接続 の管理 : 接続を作成、編集、または削除する場合に選択します。

  • ファイル接続を開く : 保存されたデータベース接続ファイルを参照する場合に選択します。

Creation Mode

作成モード : データを書き込む適切なオプションを選択します。選択肢には次が含まれます：

  • 一時テーブルを作成する : セッションの終了まで使用可能な一時テーブルに書き込みます。このオプションは、メタデータを所定の位置に一時的に保持するため、In-DB 予測マクロを作成する場合に便利です。このオプションを選択すると、テーブル名フィールドは無効になり、[各実行時に固有の一時テーブル名が生成されます] と表示されます。

  • 新しいテーブルを作成する : 新しいテーブルを作成します。既存のテーブルを上書きしません。HDFS Avro　オプションが選択されている場合、avro.schema.literal　は4000　文字で失敗し、テーブル作成時にエラーが発生します。列名の文字数を減らすか、列数を減らしてください。

  • テーブルを上書きする (ドロップ) : 既存のテーブルを完全に削除し、新しいテーブルを作成します。

Table Name

テーブル名 : 作成または更新するデータベーステーブルの名前を入力します。[ 一時テーブルの作成 ] を選択すると、[ テーブル名 ] フィールドが無効になり、[一意の一時テーブル名は各実行時に生成されます] と表示されます。

Advanced Query Options

Use this section to define a Pre-SQL statement to execute before the In-DB execution. This option is compatible with all of the above creation modes.

  • If your workflow includes a Data Stream In tool, this is the best place to put session variables in Pre-SQL. If there is no Data Stream In tool, then the Write Data In-DB tool is a good alternative. However, note that Write Data In-DB runs after any Data Stream In tools, if they exist.Blue icon with floppy disk. データ書込In-DBツール

  • Pre-SQL calls in Data Stream In should be primarily used for calls that need to be done before the creation of the Stream In table.

  • Pre-SQL statements are compatible with Bulk Loaders, OCI, ODBC, and OLE DB technologies.

To configure your Pre-SQL statements...

  1. Use the 3-dot menu associated with the Pre-SQL Statement field to launch the Configure Pre-SQL Statements window, which includes the SQL Editor and Stored Procedures tabs.

  2. Next, define your SQL statement

    • Use the SQL Editor tab to define a SQL statement to execute before the In-DB execution. When the workflow runs, the Results window displays messages to show that the tool is executing SQL statements, along with a label (PreSQL). All SQL statements are sent directly to the database.

      • Pre-SQL statements do not return data. While SQL can return data, Designer doesn't do anything with it.

      • If there are multiple streams of In-DB tools, there is no guaranteed order of execution between different streams. The Results window displays the order.

    • Use the Stored Procedures tab to select and configure a stored procedure call for your database. You can select a Parameter and set a Value for your stored procedures if needed. All stored procedures are sent directly to the database.

      • If a stored procedure is executed successfully, it returns any necessary status messages or warnings in the Results window.

      • If a stored procedure returns data, Designer does not return it anywhere. The data is not displayed in the Results window.

      重要

      Stored procedures are supported for these connections:

      • SQL Server for ODBC and Bulk Writer

      • Oracle for ODBC Only

  3. Select OK when you're finished or Cancel to return to the tool configuration window.

Notes

注記

このツールをOracleで使用するには、 GLOBAL TEMPORARY に割り当てられた一時スペースに書き込む権限が必要です。Oracle データベース管理者に問い合わせてください。

詳細については、「 接続In-DBツール 」を参照してください。

このセクションの内容: