.create-or-alter ingestion mapping 命令
適用於： ✅Microsoft網狀架構✅Azure 數據總管
建立或改變與特定格式和特定數據表或資料庫相關聯的擷取對應。
如果擷取對應不存在，命令會建立它。 如果擷取對應已經存在，命令將會修改它。
注意
在源數據表中不存在的擷取對應中引進的新數據行，將會在該數據行的初始數據擷取期間新增至數據表。 此行為僅支援佇列擷取，並取決於為數據行指定有效的數據類型。
權限
至少需要資料庫擷取器許可權才能建立資料庫擷取對應，而且至少需要數據表擷取器許可權才能建立數據表擷取對應。
語法
.create-or-altertable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson
.create-or-alterdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| TableName | string |
✔️ | 資料表的名稱。 |
| DatabaseName | string |
✔️ | 資料庫的名稱。 |
| MappingKind | string |
✔️ | 對應的類型。 有效值為 CSV、JSON、avro、parquet 和 orc。 |
| MappingName | string |
✔️ | 對應的名稱。 |
| MappingFormattedAsJson | string |
✔️ | 格式化為 JSON 值的擷取對應定義。 |
注意
- 建立之後，就可以在擷取命令中依名稱參考對應，而不是將完整對應指定為命令的一部分。
- 如果在數據表範圍和資料庫範圍中建立具有相同名稱的對應，則數據表範圍中的對應會具有較高的優先順序。
- 擷取至數據表並參考架構不符合內嵌數據表架構的對應時，擷取作業將會失敗。
範例
.create table MyTable ingestion csv mapping "Mapping1"
'['
' { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
' { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'
.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
' { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
' { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'
輸出
| 名稱 | 種類 | 對應 | Database | Table |
|---|---|---|---|---|
| mapping1 | JSON | [{“Properties”：{“Path”：“$.rownumber”}，“column”：“rownumber”，“datatype”：“int”}，{“Properties”：{“Path”：“$.rowguid”}，“column”：“rowguid”，“datatype”：“”}] | MyDatabase | MyTable |
相關內容
- 如需 CSV、JSON、Avro、Parquet 和 Orc 等各種擷取對應格式的詳細描述，請參閱 數據對應。