データ出力ツール

ユーザーロール要件

ユーザーロール*	ツール/機能へのアクセス
フルユーザー	✓
ベーシックユーザー	✓

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

データ出力ツールを使用して、サポートされているファイルの種類またはデータソースにワークフローの結果を書き込みます。他のツールを使用して、サポートされている他のデータソースに書き込みます。Designer でサポートされているデータソースの完全な一覧については、サポートされているデータソースとファイル形式を参照してください。

ツールごとに学習

このツールには「ツールごとに学習」があります。サンプルワークフローをご覧いただき、Designerからこのサンプルやその他の多くのサンプルに直接アクセスする方法をご確認ください。

Configure the Tool

The Output Data Configuration window has 2 sections: Write to File or Database and Options. Note that the Write to a File or Database configuration options vary based on whether DCM is enabled.

まず、[ファイルまたはデータベースへの書き込み]セクションを使用して、出力用のファイルまたはデータベースを選択する必要があります。
次に、[オプション] セクションで、そのファイルまたはデータベースに関連付けられた設定を構成する必要があります。

Connect with DCM (Default)

The steps below describe the default process with Data Connection Manager (DCM) enabled.

With the Output Data tool on the canvas, follow these steps:

In the Configuration window Write to File or Database section, you can enter your output file path or select...
- Open File: Browse to and connect to a file in a local or network directory. Refer to the Files section below.
- Connect To: Open the Connector Setup window.
When you select Connect To, Designer displays the Connector Setup window. Configure your data connections using one of these tabs: Recent and Connections. You can also access External Vaults and Synchronize via the More dropdown at the bottom of the page.

Recents

Use the Recents tab to view and access a list of recently used connections. The section also contains links to these options:

Create or Browse a Data Connection: Use DCM to create a new connection or browse previously created connections. For details, go to Data Connection Manager.DCM - Designer
Select a File on Your Local Storage: Select a locally stored file to use in the Input Data tool.

Connections

Use the Connections tab to access or create connections via Data Connection Manager (DCM). Only connections supported by DCM are available.

The Connections tab lists any previously created connections (including Name, Technology, and Last Updated information), along with the option to create new ones. You can use the 3-dot icon to copy the connection ID, test the connection, or delete the connection if it's no longer needed.

To connect your Output Data tool to a previously-created connection, locate it in the list and select the Connect button.

Add New Connection

To create a new connection via the Output Data tool, follow these steps:

On the Connections tab, select the + New button to bring up the Select a Technology window.
Next, you can select the connection technology from the supported connections list. You can also use the Search Technology search box if needed.
If the technology you selected supports multiple connection types, the Select Connection Type window appears. Choose the connection type. This might include Quick Connect, Connect with ODBC Admin, Bulk with Local Staging, Bulk with Staging on Amazon S3, etc.
If you select a bulk connection that requires multiple connections, a screen appears and prompts you to select existing bulk connections.
- Use the Select buttons to navigate to the bulk connections section and select Connect to choose the connections.
- Once multiple bulk connections are chosen, select Continue to use them in the workflow.
On the New Connection screen, fill out the relevant fields:
- Connection Details: Provide a connection name.
- Data Source: Provide a data source name as well as other required data source-specific information (refer to Data Sources for additional information).
- Credentials: Select an authentication method and enter the required credential information (for example, Client ID, Secret Key, Username, and Password) for the selected authentication method.
Once you've provided the necessary information, select Save to create the connection. You'll see your connection details appear. Select Connect to use the connection in your workflow.

External Vaults

Use the External Vaults tab to access or configure External Vaults via DCM. For more information and instructions, go to DCM External Vaults.

The External Vaults tab lists any previously created vaults (including Vault Name, Technology, and Last Updated information), along with the option to create new ones.

Synchronize

With DCM, you can sync credentials across your Alteryx apps. For more information, go to Designer DCM.DCM - Designer

ツールの設定

重要

Non-DCM workflows are not supported with Workspace Execution. As such, this is not the recommended approach for creating connections within the Output Data tool.

The steps below describe the process with Data Connection Manager (DCM) disabled.

ツールパレットで[

In the Configuration window Write to File or Database section, you can enter your input file path or select...
- Open File: Browse to and connect to a file in a local or network directory. Refer to the Files section below.
- Connect To: To open the Data Connections window.
- Use Data Connection Manager (DCM): Select this checkbox to connect to data with DCM. Note that this resets your Input Tool configuration. Refer to the Connect with DCM section above.
When you select Connect To, Designer displays the Data connections window. Configure your data connection using one of these tabs: Recent, Saved, Files, Data Sources, or Server.

ファイルまたはデータベースへの書き込み

Designer では、[データ接続] ウィンドウが表示されます。[最近]、[保存済み]、[[ファイル]、[データソース]、[Server]のいずれかのタブからデータ接続を設定します。

注記

AMP Engineは、CSVファイルに保存するときにSpatialObjデータをファイルに書き込みますが、従来のEngineは書き込みません。これによりファイルサイズに違いが生じ、パフォーマンスが低下する可能性があります。

保存済み

[保存済み]の接続を選択します。接続の名前を変更および編集するには、データ接続の管理を使用します。

ファイル

[ファイルを選択] ボタンを使用して、データセットに接続します。

Supported File Types

Here are the supported file types:

File Type	File Extension
Alteryxカルガリー	.cybd
Alteryxデータベース	.yxdb
Alteryx Spatial Zip	.sv
Avro	.avro
コンマ区切り値	.csv
dBase	.dbf
ESRI Personal GeoDatabase	.mdb
ESRI Shapefile	.shp
Extensible Markup Language	.xml
Flat ASCII	.flat
GIS	.grc、.grd
Google Earth/Google Maps	.kml
Gzip	.gz、.tgz
IBM SPSS	.sav
JSON	.json
MapInfo Professional Interchange Format	.mif
MapInfo Professional Table	.tab
Microsoft Access 2000-2003	.bdb
Microsoft Access 2007、2010、2013、2016	.accdb
Microsoft Excelバイナリ	.xlsb
Microsoft Excel 1997-2003	.xls
Microsoft Excel	.xlsx
Microsoft Excel Macro-Enabled	.xlsm
QlikView	.qvx
SAS	.sas7dbat
SQLite	.sqlite
SRC Geography	.geo
テキスト	.txt、.asc
Zip	.zip

データソース

データソース には、サポートされているデータソースと頻繁に使用されるデータソースが表示されます。

ツール: インストールされていないツールに対して [クイック接続] を選択すると、Alteryx コミュニティのそのツールをダウンロードしてインストールする手順を表示するブラウザーが開きます。ページの指示をよくお読みください。
データソース:
- ODBC は、その特定のドライバーを使用するシステム上の DSN のフィルター処理された一覧を表示する ODBC 接続ウィンドウを起動します。
- OleDB は、ネイティブ Windows OleDB マネージャーを起動します。
- OCI は、ネイティブ Oracle OCI 接続マネージャーを起動します。ここから、この接続に使用するtnsnames.oraファイルに定義されているネットサービス名と、ユーザー名とパスワードの資格情報を選択します。
- [バルク]は、特別なダイアログボックスを開き、選択した接続タイプのバルク接続を設定できます。
- クイック接続: SQL または Oracle クイック接続の場合、既存の保存済み接続を使用するか、または保存済みの新しい接続を作成できます。詳細については、以下を参照してください。
  - SQL
  - OracleOracle データベースへの接続
- 他のすべてのクイック接続は、別のツールを使用した接続です。

Hadoop

[HDFS] の下の [クイック接続] を選択して、新しい Hadoop データベース接続を作成します。

Designer はにHDFS (Hadoop 分散ファイルシステム) に接続し、.csv ファイルや .avro ファイルを読み取ります。HDFS 標準を実装するすべての Hadoop distributions がサポートされています。

HDFS 接続の設定

HDFSは、httpfs (ポート14000)、webhdfs (ポート50070)、またはKnox Gateway (8443)を使用して読み込むことができます。どれを使用するかはHadoop管理者にご確認ください。Hadoop High Availability (HA)クラスターを使用している場合、Hadoop管理者はhttpfsを明示的に有効にする必要があります。

MapR は webhdfs をサポートしていない場合があります。

HDFS接続ウィンドウ:

サーバー構成を選択してください: HTTPFS 、 WebHDFS 、または ノックスゲートウェイ から選べます。
ホスト: Hadoop サーバーのインストール済みインスタンスを指定します。エントリはURLまたはIPアドレスでなければなりません。
ポート: httpfs (14000)、webhdfs (50070)、Knox Gateway (8443) の既定のポート番号を表示するか、または特定のポート番号を入力します。
URL: ホストに基づく URL の既定値。URLは変更可能です。
ユーザー名: クラスターのセットアップに応じて、アクセスするユーザー名とパスワードを指定します。
- httpfs: ユーザー名が必要ですが、どんなものでも構いません。
- webhdfs: ユーザー名は不要です。
- Knox Gateway: ユーザー名とパスワードが必要です。
注記
自己署名証明書は Alteryx ではサポートされていません。Knox 認証 を設定する場合は、信頼できる証明書を使用してください。
kerberos: HDFS への読み書きのための kerberos 認証 オプションを選択します。選択するオプションは、IT管理者がHDFSサーバーをどのように設定したかによって異なります。
- なし: 認証なし。
- Kerberos MIT: Designer は、既定の MIT チケットを使用してサーバーで認証します。まず、MIT Kerberos Ticket Manager を使用して有効なチケットを取得する必要があります。
- Kerberos SSPI: Designerは、Windows資格情報を使用してWindowsにログインしたときに取得するWindows Kerberosキーを認証に使用します。従って、ユーザー名とパスワードのフィールドは使用できません。
(推奨) [テスト] を選択して接続をテストします。
[OK]を選択します。
ファイルのパス (パス/ファイル .csv) を指定するか、ファイルを参照して選択します。
Avro または CSV ファイル形式を選択し、>[OK] を選択します。

インデータベース処理のために HDFS に接続するには、接続 (In-DB) ツールを使用します。

その他のデータベース

汎用接続、またはデータベースへの 32 ビット接続を作成することもできます。

データベースに接続する前に、次の点を考慮してください：

ODBC 接続タイプと OleDB 接続タイプの両方が空間接続をサポートしています。Designer は、データベースが空間機能をサポートしているかどうかを自動検出し、必要な設定を表示します。
インデータベース処理のためにデータベースに接続するには、インデータベースの概要を参照してください。

保存済みデータ接続

オプションをポイントして、保存または 共有データ接続 を選択して接続するか、管理を選択して接続を表示および編集します。

すべての接続: コンピューターに保存されている接続と、Serverから共有している接続の一覧が表示されます。

マイコンピュータ: コンピュータに保存されている接続の一覧を表示します。

Server: Serverから共有されている接続の一覧を表示します。

Serverを追加: クリックして、Server URLを追加します。次に、プロンプトが表示されたら、ユーザー名とパスワードを使用してサインインします。サインイン後に、[保存されたデータ接続]に戻り、一覧からServerを選択して、Serverから共有されている接続を表示します。

保存および共有されたデータ接続の管理とトラブルシューティングの詳細については、データ接続の管理を参照してください。

サポートされているデータソース

For a detailed list of supported data sources, go to Data Sources.

Server

[Server]には、各Alteryx Serverとそれに関連付けられたURL (ローカルコンピューターに追加されたもの)が表示されます。各 Server 名の下のリストには、利用可能な Server に保存されている保存済みの接続が含まれています。

[+ Server] を選択して、別の Alteryx Server を追加します。

出力オプション

ファイル形式の オプション を選択します。
重要
オプションは、接続先のファイルまたはデータベースによって異なります。重要な設定情報については、ファイル形式オプションを参照してください。
(オプション)選択したフィールドの値ごとに個別のファイルを書き込むには、[フィールドからファイル/テーブル名を取得する]を選択します。ドロップダウンを選択し、オプションを選択します。
- ファイル/テーブル名に接尾辞を追加する: 選択したフィールド名を、選択したテーブルの名前の末尾に追加します。
- ファイル/テーブル名の前にプリフィックスを付ける : 選択したテーブルの名前の先頭に選択したフィールド名を付加します。
- ファイル/テーブル名を変更: ファイル名を選択したフィールド名に変更します。
- ファイルパス全体を変更: ファイル名を、選択したフィールドの名前に変更します。名前は完全なファイルパスである必要があります。ファイルがフルパスディレクトリに存在する場合、このオプションは既存のファイルを上書きすることができます。
  1. [ファイル名またはファイル名の一部を含むフィールド]を選択し、フィールドを選択します。
  2. (オプション) [フィールドを出力に保持]を選択します。

出力ツールを無効にする

データ出力ツールを無効にするには、[ツールを無効化]チェックボックスをオンにします。これにより、ワークフローの実行時にツールがデータを書き込むことがなくなります。無効にすると、ツールはワークフローキャンバスから選択できなくなります。

この機能は、ワークフローの開発またはトラブルシューティングを行う際に特に便利です。

注記

グローバル設定の[出力を書き込むすべてのツールを無効にする] ([ワークフロー-設定]の[ランタイム]タブ内)は、このツール固有の設定よりも優先されます。

出力ファイルの表示

ワークフローを実行したら、データ出力ツールを選択します。
結果ウィンドウで、メッセージ ボタンを選択します。
出力ファイルを見つけて、ファイルリンクを選択して開きます。