データ入力ツール
データ入力ツール
Dataset Support in Preview in 2026.1
This initial release of Alteryx One dataset support is in preview. Please refer to Datasets for requirements and limitations.
ユーザーロール要件
ユーザーロール* | ツール/機能へのアクセス |
|---|---|
フルユーザー | ✓ |
ベーシックユーザー | ✓ |
*Alteryx Oneプロフェッショナルエディションおよびエンタープライズエディションをご契約中で、Designerバージョン2025.1以降をお使いのお客様に適用されます。
データ入力ツールを使用して、データをファイルまたはデータベースに接続してワークフローに追加します。
ツールごとに学習
このツールには「ツールごとに学習」があります。サンプルワークフローをご覧いただき、Designerからこのサンプルやその他の多くのサンプルに直接アクセスする方法をご確認ください。
重要
ワイルドカードを使用して Hadoop 分散ファイルシステムで複数の .csv ファイルを読み取ると、エラーが発生します。
ツールの設定
データ入力ツールの設定ウィンドウには、ファイルまたはデータベースを接続する と オプション の 2 つのセクションがあります。[ファイルまたはデータベースを接続する]の設定オプションは、DCMが有効になっているかどうかによって異なります。
DCMを使用した接続(既定)
以下の手順では、データ接続マネージャー(DCM)が有効になっている場合の既定のプロセスについて説明します。
キャンバス上のデータ入力ツールを使用して、次の手順に従います。
[設定]ウィンドウの[ファイルまたはデータベースを接続する]セクションで、入力ファイルパスを入力するか、次のいずれかを選択できます。
ファイルを開く: ローカルまたはネットワークディレクトリ内のファイルを参照して接続します。以下の「ファイル」セクションを参照してください。
接続先: [コネクタの設定]ウィンドウを開きます。
[接続先]を選択すると、Designerに[コネクタの設定]ウィンドウが表示されます。[最近]、[データセット]、[接続]のいずれかのタブを使用してデータ接続を設定します。また、ページ下部にある[詳細]ドロップダウンの[外部保管庫]および[同期]からもアクセスできます。
最近
最近使用した接続のリストを表示してアクセスするには、[最近]タブを使用します。このセクションには、次のオプションへのリンクも含まれています。
データ接続の作成または参照: DCMを使用して新しい接続を作成するか、以前に作成した接続を参照します。詳細については、データ接続マネージャーを参照してください。
ローカルストレージのファイルを選択: データ入力ツールで使用する、ローカルに保存されたファイルを選択します。
Alteryx Oneのデータセットを選択: データ入力ツールを、Alteryx Oneワークスペースで使用可能なデータセットに接続できます。これにより、一元管理されたデータセットを直接Designerワークフローで使用できます。
データセット
2026.1のプレビュー版でのデータセットサポート
このAlteryx Oneデータセットサポートの初回リリースはプレビュー中です。次の要件と制限事項に注意してください。
この機能は現在プレビュー版で、引き続き開発が進められています。Designerが更新されると、破壊的変更によって、以前のバージョンで作成されたアセットに影響が生じる可能性があり、データセット設定の更新が必要になる場合があります。
データ入力ツールを介してデータセットに接続するには、AMP Engineを有効にする必要があります。
Alteryx Oneユーザーロールに基づく権限を持つデータセットにのみアクセスできます(データセットはワークスペースで利用可能である必要があります)。
データ入力ツールごとに1つのデータセットにアクセスできます。
[データセット]タブを使用して、Alteryx Oneワークスペースで利用可能なデータセットにデータ入力ツールを接続します。これにより、一元管理されたデータセットを直接Designerワークフローで使用できます。ワークフローでAlteryx Oneデータセットを使用するには、次の手順に従います。
[コネクタの設定]ウィンドウの左側のメニューから[データセット]を選択します。
利用可能なデータセットの[名前]、[ソース]、[所有者]、データセットの共有先、最終更新日時を含むリストが表示されます。アクセスできるデータセットは、アクセス権があるデータセットのみです。
このリストは、すべてのデータセット、自分が所有しているデータセット、または自分と共有されているデータセットのみを表示するようフィルタリングできます。検索バーを使用して、名前でデータセットを検索することもできます。
利用可能なデータセットのリストからデータセットを選択します。
データセットを選択すると、ワークフローでそのデータセットを使用するように、データ入力ツールが設定されます。
接続
[接続]タブを使用して、データ接続マネージャー(DCM)から接続にアクセスするか新しい接続を作成します。DCMでサポートされている接続のみ使用できます。
[接続]タブには、以前に作成した接続のリスト(名前、テクノロジー、最終更新の情報を含む)と、新しい接続を作成するオプションが表示されます。三点リーダーアイコン(⋮)を使用して、接続IDのコピー、接続のテスト、不要になった接続の削除を行うことができます。
データ入力ツールを以前に作成した接続に接続するには、その接続を一覧から探し、[接続]を選択します。
新しい接続の追加
データ入力ツールを介して新しい接続を作成するには、次の手順を実行します。
[接続]タブで[+新規]ボタンを選択して、[テクノロジーを選択]ウィンドウを表示します。
次に、サポートされている接続のリストから接続テクノロジーを選択します。必要に応じて、[テクノロジーを検索]の検索ボックスを使用することもできます。
選択したテクノロジーが複数の接続タイプをサポートしている場合は、[接続タイプを選択]ウィンドウが表示されます。接続タイプを選択します。これには、クイック接続、ODBC管理者との接続、ローカルステージングのバルク、Amazon S3経由のステージングのバルクなどが含まれます。
複数の接続を必要とするバルク接続を選択すると、画面が表示され、既存のバルク接続を選択するよう求められます。
[選択]ボタンを使用してバルク接続セクションに移動し、[接続]を選択して接続を選択します。
複数のバルク接続が選択されたら、[続行]を選択してワークフローで使用します。
[新しい接続]の画面で、以下の関連するフィールドに入力します。
接続の詳細: 接続名を入力します。
データソース: データソース名とその他の必要なデータソース固有の情報を入力します(詳細については、データソースを参照してください)。
資格情報: 認証方法を選択し、選択した認証方法に必要な資格情報(クライアントID、シークレットキー、ユーザー名、パスワードなど)を入力します。
必要な情報を入力したら、[保存]を選択して接続を作成します。接続の詳細が表示されます。[接続]を選択して、ワークフローで接続を使用します。
外部保管庫
[外部保管庫]タブを使用して、DCMから外部保管庫にアクセスするか設定します。詳細と手順については、DCM外部保管庫を参照してください。
[外部保管庫]タブには、以前に作成された保管庫のリスト(保管庫名、テクノロジー、最終更新情報を含む)と、新しい保管庫を作成するオプションが表示されます。
同期
DCMを使用すると、Alteryxアプリ間で資格情報を同期できます。詳細については、Designer DCMを参照してください。
DCMを使用しない接続
重要
非DCMワークフローは、Workspace Executionではサポートされていません。そのため、データ入力ツール内で接続を作成する場合、この方法は推奨されません。
以下の手順では、データ接続マネージャー(DCM)を無効にした場合のプロセスについて説明します。
キャンバス上のデータ入力ツールを使用して、次の手順に従います。
[設定]ウィンドウの[ファイルまたはデータベースを接続する]セクションで、入力ファイルパスを入力するか、次のいずれかを選択できます。
ファイルを開く: ローカルまたはネットワークディレクトリ内のファイルを参照して接続します。以下の「ファイル」セクションを参照してください。
接続先: [データ接続]ウィンドウを開きます。
データ接続マネージャー(DCM)の使用: このチェックボックスをオンにして、DCMを使用してデータに接続します。これにより、入力ツールの設定がリセットされることに注意してください。上記の「DCMを使用した接続」セクションを参照してください。
[接続先]を選択すると、Designerに[データ接続]ウィンドウが表示されます。データ接続の設定には、[最近]、[保存済み]、[ファイル]、[データソース]、[Server]のいずれかのタブを使用します。
最近(非DCM)
[最近の接続]セクションには、最近設定されたファイルとデータ接続が含まれています。最近の接続を選択するか、[リストの消去]を選択して最近の接続を削除できます。
保存済み
[保存済み]の接続を選択します。接続の名前を変更および編集するには、保存された接続の管理 を使用します。
ファイル
ローカルディレクトリまたはネットワークディレクトリ内のファイルに接続するには、いくつかのオプションがあります。
ツール設定の[ファイルまたはデータベースを接続]セクションにある[ファイルを開く]を選択してファイルを参照します。
コネクタのセットアップウィンドウ(DCM): [最近]タブで、[ローカルストレージのファイルを選択]を使用します。
データ接続ウィンドウ(DCM以外):
[ファイル接続]で、[ファイルを選択]ボタンを選択してファイルを参照します。
ファイルを[ファイル接続]のドラッグアンドドロップ領域にドラッグします。
[サポートされているすべてのファイルタイプ]セクションで、その種類のファイルを参照するファイルタイプ拡張子を選択します。
または、ファイルを直接キャンバスにドラッグします。
ファイル参照ウィンドウで、ファイルパスの一部としてワイルドカードを入力します。
次のようなデータファイルが複数ある場合を考慮してください。
フィールドの数が同じで、各フィールドのデータ型が同じ
同じディレクトリ内の類似の名前
ワイルドカードに関する考慮事項
すべてのファイルのフィールド数が同じで、各フィールドのデータ型が同じであれば、1つのデータ入力ツールで、*.csvや2019*.csvなどのワイルドカード形式を使用して複数のファイルを読み取ることができます。
Designer では、最初に読み取ったファイルに基づいて、フィールド数とファイルタイプを設定します。後続の一致しないファイルはスキップされ、警告が表示されます。*.csvなどのワイルドカード構文を使用する場合、どのファイルを先に読み込むかを指定することはできません。どのファイルを最初にするかは、システムに委ねられています。
複数のファイルに共通するファイル名を入力し、後続のすべての文字の代わりであれば「* (アスタリスク)」を、1文字の代わりであれば「?」を追加します。ファイル名を指定するときは、共通のファイル拡張子を含めます。
例1
このパスでは、data\datafilesディレクトリ内の、ファイル名がABCDで始まるすべての.csvファイルが含まれます。
data\datafiles\ABCD*.csv
ABCD_4.csvやABCD_012.csvが含まれます。
例2
このパスでは、data\datafilesディレクトリ内の、ファイル名がABCD_で始まり、さらに1文字がつくすべての.csvファイルが含まれます。
data\datafiles\ABCD_?.csv
Excel入力を選択 で、Excel 入力のいずれかを選択します。
シートを選択: Excelファイルで使用可能なシートを選択します。
範囲 (セル、行、列) を選択: 必要に応じて、シート内のセル、行、列の範囲を選択します。
名前付き範囲を選択: Excelファイルで使用可能な名前付き範囲を選択します。
シート名のリストのみをインポート: シート名を値として含む1つの列で出力を作成します。このオプションを選択すると、関連データは出力されません。
選択したExcelシートが開いている場合は、エラーメッセージが表示され、続行できません。シートを閉じ、Excel入力を選択 ダイアログで 更新 ボタンを選択し、入力プロセスを終了します。
データ入力ツールは、定義されていない列をスキップします。定義された列とは、データを含んでいるか、ユーザーによってクリアされたデータを以前に含んでいた列です。定義されていない列を含めるには、[Excel入力を選択] ダイアログの [範囲 (セル、行、列) を選択] オプションで範囲を指定します。
.gz、.tgz、.zipファイルを選択すると、[ファイルの抽出]ウィンドウが表示されます。詳細については、GzipファイルサポートとZipファイルサポートを参照してください。
[抽出するファイルタイプを選択]ドロップダウンを使用して、ファイルの種類を選択します。
ファイルの選択: 抽出するファイルの横にあるチェックボックスをオンにします。
Alteryxでサポートされていないファイルを含め、GzipファイルまたはZipファイル内のすべてのファイルを表示するには、次の手順に従います。ファイルの種類を選択して、 他のファイルを解析 します。
[抽出するファイルタイプを選択]ドロップダウンを使用して、[その他のファイル]を選択します。
ファイルの種類を選択して、 他のファイルを解析 します。
続行するには、[開く]を選択します。
重要
Alteryx はGalleryでは GzipとZipファイルをサポートしていません。
ファイルの種類 | ファイル拡張子 |
|---|---|
.cydb | |
.yxdb | |
Alteryx Spatial Zip | .sz |
.avro | |
コンマ区切り値(CSV) | .csv |
dBase | .dbf |
ESRI Personal GeoDatabase | .mdb |
ESRI Shapefile | .shp |
Extensible Markup Language | .xml |
.flat | |
GIS | .grc、.grd |
Google Earth/Google Maps | .kml |
.gz、.tgz | |
IBM SPSS | .sav |
.json | |
MapInfo Professional Table | .tab |
Microsoft Access 2000-2003 | .mdb |
Microsoft Access 2007、2010、2013、2016 | .accdb |
Microsoft Excelバイナリ | .xlsb |
Microsoft Excel 1997-2003 | .xls |
.xlsx | |
Microsoft Excel Macro-Enabled | .xlsm |
QlikView | .qvx |
SAS | .sas7bdat |
SQLite | .sqlite |
テキスト | .txt、.asc |
.zip |
不明なファイルタイプには、Alteryxがネイティブで読み取れないその他のファイルタイプを含みます。データ入力ツールを使用して不明な種類のファイルを読み取ると、[ファイルの種類を解決する]ウィンドウに次のオプションが表示されます。
組み込み型として読み込む: ファイルの構造が似ているファイルタイプを選択します。
固定幅のテキストファイルとして読み込む: このオプションを選択すると、スライド式ルーラーを使用して列を割り当てることができます。このオプションの詳細については、フラットファイルレイアウト を参照してください。
区切りテキストファイルとして読み込む: データの列区切りとなる単一の区切り記号がある場合は、このオプションを選択します。適切な区切り文字タイプを選択し、オプションでデータに最初の行にフィールド名が含まれているかどうかを選択します。
データソース
[データソース]ウィンドウには、サポートされているデータソースと頻繁に使用されるデータソースが表示されます。
ツール: インストールされていないツールに対して [クイック接続] を選択すると、Alteryx コミュニティのそのツールをダウンロードしてインストールする手順を表示するブラウザーが開きます。ページの指示をよくお読みください。ツールをインストールすると、キャンバス上のデータ入力ツールが[データソース]タブで選択したツールに変わります。
データソース:
ODBC: ODBC接続ウィンドウを起動します。特定のドライバーを使用するシステムにあるDSNのフィルタリングされたリストが表示されます。
OleDB: ネイティブのWindows OleDBマネージャーを起動します。
OCI: ネイティブのOracle OCI接続マネージャーを起動します。ここから、この接続に使用する、
tnsnames.oraファイルで定義されているネットサービス名と、ユーザー名とパスワードの資格情報を選択します。バルクは、選択した接続タイプのバルク接続を設定できるようにする特別なダイアログを開きます。
クイック接続: SQLまたはOracleクイック接続の場合、既存の保存済み接続を使用するか、または新規の保存済み接続を作成できます。詳細については、以下のページを参照してください。
他のすべてのクイック接続は、別のツールを使用します。
サポートされているデータソース
サポートされているデータソースの詳細なリストは、データソースを参照してください。
Server
Serverには、ローカルコンピューターに追加されている各Alteryx Server UIとそのURLが表示されます。各 Server 名の下のリストには、利用可能な Server に保存されている保存済みの接続が含まれています。
[+ Server] を選択して、別の Alteryx Server を追加します。
オプション
このセクションを使用して、ファイル形式オプションを設定します。これらのオプションは、接続するファイルまたはデータベースによって異なります。ファイル固有のオプションや説明については、ファイル形式オプションを参照してください。
データレイアウトのプレビュー
データ入力ツールの設定ウィンドウの[プレビュー]セクションでデータレイアウトをプレビューします。データレイアウトのプレビューは、ワイドファイルでは 100 レコード以下に制限されています。データに1500列が含まれている場合であれば、少なくとも1レコード、最大2行が表示されます。すべてのデータを表示するには、閲覧ツール を使用します。
重複した列名
入力ファイルに同じ名前の列が複数含まれている場合、Designer は次のルールに従って重複した列の名前を自動的に変更します。
重複する列名の最後の文字が 1 または 9 の場合、Designer は重複する列名にアンダースコア「_」と 2 で始まる数字を追加します。
元の列名 | 重複列 (Designer によって変更された名前) |
|---|---|
A1 | A1_2 |
A9 | A9_2 |
重複する列名の最後の文字が 2 と 8 の間 (両端を含む) の数字の場合、Designer はその数字をインクリメントして重複する列名を変更します。
ただし、最後から2番目の文字も数字である場合、Designer は重複する列名にアンダースコア「_」と 2 で始まる数字を追加します。
元の列名 | 重複列 (Designer によって変更された名前) |
|---|---|
A2 | A3 |
A5 | A6 |
A22 | A22_2 |
重複する列の最後の文字が英文字または特殊文字の場合、Designer は 2 で始まる数字を追加して、重複する列名を変更します。
元の列名 | 重複列 (Designer によって変更された名前) |
|---|---|
age | age2 |
registered? | registered?2 |
注記
Visual Query Builderではマルチバイト文字を正しく表示できません。テーブルタブを代わりに使用してください。
データ出力ツールをデータ入力ツールに変換
データ出力ツールをデータ入力ツールに変換できます。次の手順を実行してください:
ワークフローキャンバスで、データ入力ツールに変換したいデータ出力ツールを右クリックします。
[データ入力に変換]を選択します。
データ出力ツールがデータ入力ツールになります。