用于引入的 Azure Synapse 数据资源管理器支持的数据格式(预览版)

重要

Azure Synapse Analytics 数据资源管理器(预览版)将于 2025 年 10 月 7 日停用。 在此日期之后,Synapse 数据资源管理器上运行的工作负荷将被删除,关联的应用程序数据将丢失。 强烈建议迁移到 Microsoft Fabric 中的 Eventhouse

Microsoft云迁移工厂(CMF)计划旨在帮助客户迁移到 Fabric。 该计划向客户免费提供动手键盘资源。 这些资源在 6-8 周内分配,并具有预定义和同意的范围。 客户提名可以通过 Microsoft 帐户团队接受,或者直接提交《帮助请求》给 CMF 团队。

数据引入是将数据添加到表的过程,可用于在数据资源管理器中查询。 对于 ingest-from-query 以外的所有引入方法,数据必须采用下述受支持格式中的一种。 下表列出了数据资源管理器支持用于数据引入的格式。

注释

在引入数据之前,请确保数据的格式正确并定义所需字段。 建议使用首选验证程序来确认格式是否有效。 例如,你可能会发现以下验证程序可用于检查 CSV 或 JSON 文件:

有关引入失败的原因的详细信息,请参阅数据资源管理器中的引入失败和引入错误代码。

Format Extension Description
ApacheAvro .avro 一个支持逻辑类型AVRO 格式。 支持以下压缩编解码器:nulldeflatesnappyapacheavro 格式的读取器实现基于官方 Apache Avro 库
Avro .avro 基于 .NET 库AVRO 格式的旧实现。 支持以下压缩编解码器:nulldeflate(对于 snappy,请使用 ApacheAvro 数据格式)。
CSV .csv 一个采用逗号分隔值 (,) 的文本文件。 请参阅 RFC 4180:Common Format and MIME Type for Comma-Separated Values (CSV) Files(RFC 4180:逗号分隔值 (CSV) 文件的常见格式和 MIME 类型)。
JSON .json 一个文本文件,其中包含使用 \n\r\n 分隔的 JSON 对象。 请参阅 JSON Lines (JSONL)
MultiJSON .multijson 一个文本文件,其中包含属性包的 JSON 数组(每个属性包表示一条记录),或者用空格 \n\r\n分隔的任意数量的属性包。 每个属性包可以分布在多个行上。 除非数据不是属性包,否则首选 JSON此格式。
ORC .orc 一个 ORC 文件
Parquet .parquet 一个 Parquet 文件
PSV .psv 一个采用竖线分隔值 (|) 的文本文件。
RAW .raw 一个文本文件,其整个内容就是一个字符串值。
SCsv .scsv 一个采用分号分隔值 (;) 的文本文件。
SOHsv .sohsv 一个采用 SOH 分隔值的文本文件。 (SOH 为 ASCII 代码点 1;此格式由 Hive on HDInsight 使用。)
TSV .tsv 一个采用制表符分隔值 (\t) 的文本文件。
TSVE .tsv 一个采用制表符分隔值 (\t) 的文本文件。 反斜杠字符 (\) 用于转义。
TXT .txt 一个文本文件,使用 \n 分隔的行。 空行将被跳过。
W3CLOGFILE .log 符合 W3C 标准的 Web 日志文件格式。

支持的数据压缩格式

可以使用下面的任何压缩算法来压缩 Blob 和文件:

Compression Extension
GZip .gz
邮政编码 .zip

通过将扩展名追加到 Blob 或文件的名称上来指示压缩。

例如:

  • MyData.csv.zip 指示 Blob 或格式化为 CSV 的文件,已使用 ZIP 压缩(归档或单个文件)
  • MyData.json.gz 指示使用 GZip 压缩的 blob 或格式化为 JSON 的文件。

不包含格式扩展名而只包含压缩名的 Blob 名或文件名(例如 MyData.zip)也受支持。 在这种情况下,必须将文件格式指定为引入属性,因为它无法推断。

注释

  • 某些压缩格式会在压缩的流中记录原始文件扩展名。 在确定文件格式时,通常会忽略此扩展名。 如果不能根据(压缩的)Blob 或文件的名称确定文件格式,则必须通过 format 引入属性指定它。
  • 不要与内部(区块级别)压缩编解码器混淆,比如用于ParquetAVROORC格式的。 内部压缩名称通常在文件格式扩展名之前添加,例如:file1.gz.parquetfile1.snappy.avro 等。

后续步骤