Skip to main content

Microsoft Excel - Alteryxドライバー

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形式で表示されます。日付データ型は、列内のデータの分析に基づいてフォーマットされます。

  • 列のすべての値が日付のみ(例えば、2014/11/04または5月4日、時間コンポーネントなし)の場合、データ型はYYYY-MM-DDとして日付に設定されます。

  • 列のすべての値に日付コンポーネントのない時刻情報のみが含まれている場合、データ型はHH:MM:SSとして時刻に設定されます。

  • 列のデータ値がデータコンポーネントと時間コンポーネントの両方で構成される場合、データ型は日付時刻にYYYY-MM-DD HH:MM:SSとして設定されます。

  • カスタム日付形式は無視されます。Excelの日付に適用されるカスタム書式は無視されます。実際のデータ値のみがAlteryxによって分析されます。例えば、セルに日付と時刻の値が完全に含まれていても、日付または時間のみを表示するように書式設定されている場合、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ドライバーは、シート名リストの読み取りをサポートしています。

Dates and Excel

Date-Time Precision

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.

Dates Prior to 1900

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.

FileTableのサポート

Alteryxドライバーは、Microsoft SQL Server FileTableにあるExcelファイルの読み取りと書き込みをサポートします。FileTableのUNCパスを参照し、ネットワークドライブに保存されているファイルと同様にファイル内でマッピングを行います。ExcelファイルをMicrosoft SQL Server FileTableに書き込むには、出力ツールで形式固有の [SQL Server FileTable Supportを有効にする] オプションをオンにする必要があります。

XLSX書き込みサポートの出力オプション

  • 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.

範囲によるXLSX書き込みサポートの追加情報

シートの作成/ファイルの上書き

シートの追加

シートの上書き

明示的な範囲を使用できます。

名前付き範囲はシートに結び付けられており、シートは存在しないため、名前付き範囲は使用できません。

明示的範囲と名前付き範囲の両方を使用できます。

名前付き範囲は、シートに対して以前に定義されていなければなりません。

明示的範囲と名前付き範囲の両方を使用できます。

名前付き範囲は、シートに対して以前に定義されていなければなりません。

データは指定された範囲より多くの列を含むことはできませんが、少ない列数であれば許容されます。

範囲を埋めるのに十分な着信データがない場合、列はNULLで埋められます。

データは指定された範囲より多くの列を含むことはできませんが、少ない列数であれば許容されます。

範囲内の入力列が少なければ、マッピングされていない列はNULLで埋められます。

データは指定された範囲より多くの列を含むことはできませんが、少ない列数であれば許容されます。

範囲を埋めるのに十分な入力データがない場合、列はNULLで埋められます。

データは、指定された範囲の最初の行の左上のセルから書き込まれます。

データは、元のデータの後の最初の利用可能な行から追加されます。追加すると、既存のデータは上書きされません。

マージされたセルを含むシートにデータを書き込むことはできません。

列名は範囲に含める必要があります。範囲内の最初の行が空の場合、データを含む範囲の最初の行が列名として使用されます。列名が入力されたデータと一致しない場合は、データ出力ツールのカスタム付加マッパーを使用して、列名を出力名に手動でマップする必要があります。

データは、指定された範囲の最初の行の左上のセルから書き込まれます。

マージされたセルを含むシートにデータを書き込むことはできません

データには、指定された範囲より多くの行が含まれている可能性があります。

以下の条件に合うまで、データは指定された範囲を超えて書き込まれます:

  • すべてのデータが書き込まれる

  • 最大行数(1,048,575)を超える

データには、指定された範囲より多くの行が含まれている可能性があります。

以下の条件に合うまで、データは指定された範囲を超えて書き込まれます:

  • すべてのデータが書き込まれる

  • 最大行数(1,048,575)を超える

データには、指定された範囲より多くの行が含まれている可能性があります。

以下の条件に合うまで、データは指定された範囲を超えて書き込まれます:

  • すべてのデータが書き込まれる

  • 最大行数(1,048,575)を超える

  • 既存のデータが見つかる