Alteryxには、Microsoft Excel用のネイティブの読み取りおよび書き込みドライバーが組み込まれています。Alteryx Designerで.xlsx シートを読み書きするために、ドライバーのインストールなどのシステム設定は不要です。
Alteryxドライバーを介してMicrosoft Excel (.xlsx)ファイルに使用できる データ出力ツール の ファイル形式オプション では、次の機能を使用できます。
新しいシートの作成
ファイルの上書き(削除)
シートの上書き(ドロップ)
既存のシートへの追加
Alteryxドライバーは、.xlsxファイルの読み込みおよび書き込みをする際に、文書化されたExcelの行と列の制限を完全にサポートしています。
行の最大数(Excelで指定された制限) | 1,048,575 |
列の最大数(Excelで指定された制限) | 16,384 |
列名の長さとフィールド名の制限 | 他の形式との互換性のために256を推奨 |
レコード制限を超える(1,048,575行と16,384列) | 列の制限を超えるとエラーが発生し、行の制限を超えると、切り捨てられたファイルになります |
ファイルサイズの上限を超える(4,294,967,295バイト、~4GB) | 次のエラーメッセージが表示されます。「このシートに書き込まれているデータが大きすぎます。プロセスを中止しています。」 |
Alteryxドライバーはシートデータを分析して、各列のデータ型とフィールド名を決定します。
データ型を構文解析 | 列にデータ型が混在している場合、列のデータ型はString/WStringに設定されます。 |
文字列の値 | 可能な場合は、狭い文字列が返されます。 |
数字の四捨五入 | セルに割り当てられた書式は無視されます。例えば、セルに値1.27952が含まれていて、セルが小数点以下2桁を表示するように書式設定されている場合、1.28の代わりに1.27952の完全な値が返されます。 |
日付、時刻、および日時 | すべての日付と時刻はAlteryx形式で表示されます。日付データ型は、列内のデータの分析に基づいてフォーマットされます。
|
Duplicate field/column names: The following column names in the original Excel file: abc, abc, abc, 123, 123, and 123 are read as: abc, abc2, abc3, 123, 123_2, and 123_3.
Column names formatted as dates: Column names formatted as dates in the original Excel file (for example, 1/1/2014, 2/1/2014, 3/1/2014) generate column names formatted using the default Alteryx date format: 2014-01-01, 2014-02-01, 2014-03-01.
Special characters in sheet and range names: Alteryx now supports all characters supported by Excel for sheet names. If Excel allows a character to be used when naming a sheet, the new driver can read it and does not convert or change any characters.
These characters are not valid for sheet names:
\
,/
,?
,*
,[
, and]
.
Formatting in Empty Column Cells
Formatting (for example, borders) applied to empty cells can make a row appear present in Alteryx. This affects column header detection. Use the "Start Data Import on Line" option or ensure consistent formatting and avoid unexpected behavior.
シート内の式がエラーで失敗すると、Alteryxは非文字列型のフィールドにはNULL値を返し、文字列型のフィールドには実際のエラー文字列を返します。
Microsoft Excel用のAlteryxドライバーには、次の機能があります。
名前付き範囲と明示的な範囲の読み取りサポート。
明示的な範囲の書き込みサポート。名前付き範囲の上書きをサポートしますが、新規作成はできません。
注記
Alteryxでは、テンプレートを除いて、上書き時のセルフォーマットの保持がサポートされています。
Microsoft Excel用のAlteryxドライバーは、シート名リストの読み取りをサポートしています。
While Alteryx now supports date-time precision to sub-seconds, the same high-precision date-time (date-time data with a higher resolution than seconds) is not supported in XLSX. If you attempt to write high-precision date-time data from Alteryx to XLSX, you will receive a Field Conversion Error that indicates that your high-precision date is truncated to seconds, for example:
High precision Time is not supported in XLSX and values are truncated to seconds: field "@1".
There are a couple of options you might consider:
As a potential workaround, you might consider formatting your date-time data as a string before you write to XLSX. This allows Excel formulas to work with the data, though fractional seconds are ignored.
Alternatively, you can use a Select tool to truncate your date-time data and avoid triggering the above warning in Alteryx.
Excel does not support dates before 1900. Calculations involving dates from Jan 1, 1900, to Mar 1, 1900, produce incorrect results. For more information on this issue, go to Microsoft documentation.
Alteryxドライバーは、Microsoft SQL Server FileTableにあるExcelファイルの読み取りと書き込みをサポートします。FileTableのUNCパスを参照し、ネットワークドライブに保存されているファイルと同様にファイル内でマッピングを行います。ExcelファイルをMicrosoft SQL Server FileTableに書き込むには、出力ツールで形式固有の [SQL Server FileTable Supportを有効にする] オプションをオンにする必要があります。
Create New Sheet
If a file exists, a new sheet is created. If there is already a sheet with the same name, an error displays.
If a file doesn't exist, a new file and sheet are created.
Append to Existing Sheet
If a file exists, data is written in the specified sheet. If the specified sheet doesn’t exist, there is an error.
If a file doesn't exist, data is not written.
Overwrite Sheet or Range
If a file exists, the specified sheet is deleted if it exists, and then data is written in a new sheet with the specified name.
If a file doesn't exist, a new file and sheet are created.
Overwrite File (Remove)
If a file exists, the file is deleted, and data is written in a new sheet in a new file.
If a file doesn't exist, a new file and sheet are created.
シートの作成/ファイルの上書き | シートの追加 | シートの上書き |
---|---|---|
明示的な範囲を使用できます。 名前付き範囲はシートに結び付けられており、シートは存在しないため、名前付き範囲は使用できません。 | 明示的範囲と名前付き範囲の両方を使用できます。 名前付き範囲は、シートに対して以前に定義されていなければなりません。 | 明示的範囲と名前付き範囲の両方を使用できます。 名前付き範囲は、シートに対して以前に定義されていなければなりません。 |
データは指定された範囲より多くの列を含むことはできませんが、少ない列数であれば許容されます。 範囲を埋めるのに十分な着信データがない場合、列はNULLで埋められます。 | データは指定された範囲より多くの列を含むことはできませんが、少ない列数であれば許容されます。 範囲内の入力列が少なければ、マッピングされていない列はNULLで埋められます。 | データは指定された範囲より多くの列を含むことはできませんが、少ない列数であれば許容されます。 範囲を埋めるのに十分な入力データがない場合、列はNULLで埋められます。 |
データは、指定された範囲の最初の行の左上のセルから書き込まれます。 | データは、元のデータの後の最初の利用可能な行から追加されます。追加すると、既存のデータは上書きされません。 マージされたセルを含むシートにデータを書き込むことはできません。 列名は範囲に含める必要があります。範囲内の最初の行が空の場合、データを含む範囲の最初の行が列名として使用されます。列名が入力されたデータと一致しない場合は、データ出力ツールのカスタム付加マッパーを使用して、列名を出力名に手動でマップする必要があります。 | データは、指定された範囲の最初の行の左上のセルから書き込まれます。 マージされたセルを含むシートにデータを書き込むことはできません |
データには、指定された範囲より多くの行が含まれている可能性があります。 以下の条件に合うまで、データは指定された範囲を超えて書き込まれます:
| データには、指定された範囲より多くの行が含まれている可能性があります。 以下の条件に合うまで、データは指定された範囲を超えて書き込まれます:
| データには、指定された範囲より多くの行が含まれている可能性があります。 以下の条件に合うまで、データは指定された範囲を超えて書き込まれます:
|