Leer en inglés

Compartir a través de

故障排除：在 Azure Synapse Analytics 中使用无服务器 SQL 池从 CSV 或 Parquet 文件读取 UTF-8 文本

  • Artículo
  • 22/04/2025

本文提供了关于在 Azure Synapse Analytics 中使用无服务器 SQL 池从 CSV 或 Parquet 文件读取 UTF-8 文本的故障排查步骤。

使用无服务器 SQL 池从 CSV 或 PARQUET 文件读取 UTF-8 文本时，如果查询返回带有非 UTF8 排序规则的 varchar 列，则会错误地转换某些特殊字符，例如 ü 和 ö。 这是 SQL Server 和 Azure SQL 中的已知问题。 非 UTF8 排序规则是 Synapse SQL 中的默认排序规则，因此客户查询将受到影响。 使用标准英文字符和某些扩展拉丁字符子集的客户可能不会注意到转换错误。 始终使用 UTF-8 排序规则在无服务器 SQL 池中读取 UTF-8 文本中更详细地介绍了错误转换。

解决方法

此问题的解决方法是在从 CSV 或 PARQUET 文件读取 UTF-8 文本时，始终使用 UTF-8 排序规则。

  • 在许多情况下，只需在数据库上设置 UTF8 排序规则（元数据操作）。

    alter database MyDB
       COLLATE Latin1_General_100_BIN2_UTF8;

  • 可以针对 OPENROWSET 或外部表中的 varchar 列显式定义排序规则：

    select geo_id, cases = sum(cases)
from openrowset(
         bulk 'latest/ecdc_cases.parquet', data_source = 'covid', format = 'parquet'
     ) with ( cases int,
              geo_id VARCHAR(6) COLLATE Latin1_General_100_BIN2_UTF8 ) as rows
group by geo_id

  • 如果未针对读取 UTF8 数据的外部表指定 UTF8 排序规则，则需要重新创建受影响的外部表，并针对 varchar 列设置 UTF8 排序规则（元数据操作）。

相关内容