.create ingestion mapping 命令
可建立與特定格式和特定資料表或資料庫相關聯的內嵌對應。
如果指定範圍中具有相同名稱的對應已經存在, .create
將會失敗。 請改用 .create-or-alter
。
權限
至少需要 資料庫 擷取器許可權才能建立資料庫擷取對應,而且至少需要數據表擷取 器 許可權才能建立數據表擷取對應。
Syntax
.create
table
TableNameingestion
MappingKindmapping
MappingNameMappingFormattedAsJson
.create
database
DatabaseNameingestion
MappingKindmapping
MappingNameMappingFormattedAsJson
深入瞭解 語法慣例。
參數
名稱 | 類型 | 必要 | 描述 |
---|---|---|---|
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 database MyDatabase ingestion csv mapping "Mapping2"
'['
' { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
' { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'
輸出
名稱 | 種類 | 對應 | 資料庫 | 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 |
範例:具有逸出字元的 .create ingestion mapping
.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,請參閱 數據對應。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應