通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

.create ingestion mapping 命令

  • 项目

适用于：✅Microsoft Fabric✅Azure 数据资源管理器

创建可与特定格式和特定表或数据库关联的引入映射。

如果给定作用域中具有相同名称的映射已存在， .create 则失败。 请改用 .create-or-alter。

权限

创建数据库引入映射至少需要数据库引入器权限，创建表引入映射至少需要表引入器权限。

语法

.create table TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.create database DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

详细了解语法约定。

参数

客户 类型​​ 必需 说明
TableName string ✔️ 表的名称。
DatabaseName string ✔️ 数据库的名称。
MappingKind string ✔️ 映射的类型。 有效值为 csv、json、avro、parquet 和 orc。
MappingName string ✔️ 映射的名称。
MappingFormattedAsJson string ✔️ 格式化为 JSON 值的引入映射定义。

注意

  • 创建映射后，可在引入命令中按名称引用映射，而不必将完整映射指定为命令的一部分。
  • 如果在表范围和数据库范围中创建具有相同名称的映射，则表范围中的映射将具有更高的优先级。
  • 在将数据引入到表中并引用其架构与所引入的表架构不匹配的映射时，引入操作将失败。

示例

使用 CSV 引入映射创建表和数据库

以下示例创建一个表， MyTable 其中包含 CSV 引入映射 Mapping1 和数据库， MyDatabase 以及 CSV 引入映射 Mapping2。

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

输出

名称 种类 映射 数据库 表
mapping1 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase MyTable
mapping2 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase

使用转义字符创建引入映射

以下示例创建包含 JSON 引入映射test_mapping_name的表test_table。 为了避免错误，反斜杠用于转义 JSON 路径字符串中的单引号。

.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'

相关内容

  • 有关各种引入映射格式（如 CSV、JSON、Avro、Parquet 和 Orc）的详细说明，请参阅 数据映射。
  • 若要了解有关 JSON 映射作为引入源的详细信息，请参阅 JSON 映射