diff --git a/docs/en/sql-reference/sql-functions/table-functions/files.md b/docs/en/sql-reference/sql-functions/table-functions/files.md index fc4e61c86f447..6b94bb12cfde7 100644 --- a/docs/en/sql-reference/sql-functions/table-functions/files.md +++ b/docs/en/sql-reference/sql-functions/table-functions/files.md @@ -123,6 +123,29 @@ You must set detailed options for specific data file formats. When `list_files_only` is set to `true`, you do not need to specify `data_format`. +##### Parquet + +Example of the Parquet format: + +```SQL +"format"="parquet", +"parquet.use_legacy_encoding" = "true" -- for unloading only +``` + +###### parquet.use_legacy_encoding + +Whether to use legacy encoding for DATETIME and DECIMAL data types. Valid values: `true` and `false` (default). This property is only supported for data unloading. + +If this item is set to `true`: + +- For DATETIME type, the system uses `INT96` encoding. +- For DECIMAL type, the system uses `fixed_len_byte_array` encoding. + +If this item is set to `false`: + +- For DATETIME type, the system uses `INT64` encoding. +- For DECIMAL type, the system uses `INT32` or `INT64` encoding. + ##### CSV Example for the CSV format: diff --git a/docs/ja/sql-reference/sql-functions/table-functions/files.md b/docs/ja/sql-reference/sql-functions/table-functions/files.md index 79c5d69e6e66a..325b8317cdcc8 100644 --- a/docs/ja/sql-reference/sql-functions/table-functions/files.md +++ b/docs/ja/sql-reference/sql-functions/table-functions/files.md @@ -121,6 +121,29 @@ FILES( data_location , [data_format] [, schema_detect ] [, StorageCredentialPara `list_files_only` が `true` に設定されている場合、`data_format` を指定する必要はありません。 +##### Parquet + +Parquet フォーマットの例: + +```SQL +"format"="parquet", +"parquet.use_legacy_encoding" = "true" -- アンロード専用 +``` + +###### parquet.use_legacy_encoding + +DATETIME および DECIMAL データ型にレガシーエンコーディングを使用するかどうか。有効な値: 有効な値: `true` および `false` (デフォルト)。このプロパティはデータのアンロードでのみサポートされる。 + +この項目が `true` に設定されている場合: + +- DATETIME 型の場合、システムは `INT96` エンコーディングを使用する。 +- DECIMAL 型の場合、システムは `fixed_len_byte_array` エンコーディングを使用する。 + +この項目が `false` に設定されている場合: + +- DATETIME 型の場合、システムは `INT64` エンコーディングを使用する。 +- DECIMAL 型の場合、システムは `INT32` または `INT64` エンコーディングを使用する。 + ##### CSV CSV 形式の例: diff --git a/docs/zh/sql-reference/sql-functions/table-functions/files.md b/docs/zh/sql-reference/sql-functions/table-functions/files.md index 967fe08e9787b..634a325101182 100644 --- a/docs/zh/sql-reference/sql-functions/table-functions/files.md +++ b/docs/zh/sql-reference/sql-functions/table-functions/files.md @@ -122,6 +122,29 @@ FILES( data_location , [data_format] [, schema_detect ] [, StorageCredentialPara `list_files_only` 设置为 `true` 时,无需指定 `data_format`。 +##### Parquet + +Parquet 格式示例: + +```SQL +"format"="parquet", +"parquet.use_legacy_encoding" = "true" -- 仅用于数据导出 +``` + +###### parquet.use_legacy_encoding + +是否为 DATETIME 和 DECIMAL 数据类型使用旧有的编码方式。有效值:`true` 和 `false`(默认)。该属性仅支持数据导出。 + +如果设置为 `true`: + +- 对于 DATETIME 类型,系统使用 `INT96` 编码方式。 +- 对于 DECIMAL 类型,系统使用 `fixed_len_byte_array` 编码方式。 + +如果设置为 `false`: + +- 对于 DATETIME 类型,系统使用 `INT64` 编码方式。 +- 对于 DECIMAL 类型,系统使用 `INT32` 或 `INT64` 编码方式。 + ##### CSV CSV 格式示例: