Comando .alter ingestion mapping

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

Altera um mapeamento de ingestão existente associado a uma tabela/banco de dados específico e a um formato específico (substituição completa do mapeamento).

Observação

Novas colunas introduzidas em um mapeamento de ingestão, que não estão presentes na tabela de origem, serão adicionadas à tabela durante a ingestão inicial de dados para essa coluna. Esse comportamento só tem suporte para ingestão enfileirada e depende da especificação de um tipo de dados válido para a coluna.

Permissões

O comando para alterar o mapeamento de assimilação de banco de dados requer pelo menos permissões do Database Ingestor , e o comando para alterar o mapeamento de assimilação de tabela requer pelo menos permissões de Table Ingestor .

Sintaxe

.altertable TableName ingestion MappingKind mapping MappingName ArrayOfMappingObjects

.alterdatabase Mapeamento de Nome ingestion do Banco de DadosKind mapping MapeamentoNome ArrayOfMappingObjects

Observação

Esse mapeamento pode ser referenciado por seu nome por comandos de ingestão, em vez de especificar o mapeamento completo como parte do comando.

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
TableName	string	✔️	O nome da tabela.
DatabaseName	string	✔️	O nome do banco de dados.
MapeamentoTipo	string	✔️	O tipo de mapeamento. Os valores válidos são: CSV, JSON, avro, parquet e orc.
Nome do mapeamento	string	✔️	O nome do mapeamento.
ArrayOfMappingObjects	string	✔️	Uma matriz serializada com um ou mais objetos de mapeamento definidos.

Exemplos

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

Saída

Nome	Tipo	Mapeamento
mapeamento1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]
mapeamento2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]