共用方式為

.create ingestion mapping 命令

  • 發行項

適用於： ✅Microsoft網狀架構✅Azure 數據總管

建立擷取對應，可以與特定格式和特定數據表或資料庫相關聯。

如果指定範圍中具有相同名稱的對應已經存在，則 .create 失敗。 請改用 .create-or-alter。

權限

至少需要資料庫擷取器許可權才能建立資料庫擷取對應，而且至少需要數據表擷取器許可權才能建立數據表擷取對應。

語法

.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.createdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
TableName string ✔️ 資料表的名稱。
DatabaseName string ✔️ 資料庫的名稱。
MappingKind string ✔️ 對應的類型。 有效值為 csv、json、avro、parquet 和 orc。
MappingName string ✔️ 對應的名稱。
MappingFormattedAsJson string ✔️ 格式化為 JSON 值的擷取對應定義。

注意

  • 建立之後，就可以在擷取命令中依名稱參考對應，而不是將完整對應指定為命令的一部分。
  • 如果在數據表範圍和資料庫範圍中建立具有相同名稱的對應，則數據表範圍中的對應優先順序會較高。
  • 擷取至數據表並參考架構不符合內嵌數據表架構的對應時，擷取作業將會失敗。

範例

使用 CSV 擷取對應建立數據表和資料庫

下列範例會使用 CSV 擷取對應和資料庫MyDatabase，使用 CSV 擷取對應Mapping2來建立數據表MyTable。Mapping1

.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"}}'
']'

輸出

名稱 種類 對應 Database Table
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 對應