.create-or-alter ingestion 對應命令

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

如果擷取對應不存在，命令將會建立它。 如果擷取對應已經存在，命令將會修改它。

注意

在源數據表中不存在的擷取對應中引進的新數據行，將會在該數據行的初始數據擷取期間新增至數據表。 此行為僅支援佇列擷取，而且取決於為數據行指定有效的數據類型。

權限

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

Syntax

.create-or-altertableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.create-or-alterdatabaseDatabaseNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

深入瞭解 語法慣例。

參數

名稱	類型	必要	描述
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"}}'
']'

輸出

名稱	種類	對應	資料庫	Table
mapping1	JSON	[{“Properties”：{“Path”：“$.rownumber”}，“column”：“rownumber”，“datatype”：“int”}，{“Properties”：{“Path”：“$.rowguid”}，“column”：“rowguid”，“datatype”：“”}]	MyDatabase	MyTable

相關內容

• 如需各種擷取對應格式的詳細描述，例如 CSV、JSON、Avro、Parquet 和 Orc，請參閱 數據對應。