.alter 擷取對應命令

改變與特定資料表/資料庫相關聯的現有擷取對應，以及特定格式 (完整對應取代)。

注意

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

權限

變更資料庫擷取對應的命令至少需要資料庫擷取 器 許可權，而變更數據表擷取對應的命令至少需要 數據表擷取器 許可權。

Syntax

.altertableTableNameingestionMappingKindmappingMappingNameArrayOfMappingObjects

.alterdatabaseDatabaseNameingestionMappingKindmappingMappingNameArrayOfMappingObjects

注意

擷取命令可以依名稱來參考此對應，而不需要在命令中指定完整的對應。

深入瞭解 語法慣例。

參數

名稱	類型	必要	描述
TableName	string	✔️	資料表的名稱。
DatabaseName	string	✔️	資料庫的名稱。
MappingKind	string	✔️	對應的類型。 有效值為 CSV、JSON、avro、parquet 和 orc。
MappingName	string	✔️	對應的名稱。
ArrayOfMappingObjects	string	✔️	已定義一或多個對應物件的串行化數位。

範例

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

.alter table MyTable ingestion json mapping "Mapping1"
```
[
    { "column" : "rownumber", "DataType" : "int", "Properties":{"Path":"$.rownumber"}},
    { "column" : "rowguid", "DataType":"string", "Properties":{"Path":"$.rowguid"}}
]
```

.alter 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}]
mapping2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]