Comando .alter ingestion mapping

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Modifica una asignación de ingesta existente asociada a una tabla o base de datos específica y un formato específico (reemplazo de asignación completa).

Nota:

Las nuevas columnas introducidas en una asignación de ingesta, que no están presentes en la tabla de origen, se agregarán a la tabla durante la ingesta de datos inicial para esa columna. Este comportamiento solo se admite para la ingesta en cola y depende de especificar un tipo de datos válido para la columna.

Permisos

El comando para modificar la asignación de ingesta de base de datos requiere al menos permisos de ingestión de base de datos y el comando para modificar la asignación de ingesta de tablas requiere al menos permisos de ingesta de tablas.

Sintaxis

.altertable TableName ingestion MappingKind mapping MappingName ArrayOfMappingObjects

.alterdatabase DatabaseName ingestion MappingKind mapping MappingName ArrayOfMappingObjects

Nota:

Los comandos de ingesta pueden hacer referencia a esta asignación por su nombre, en lugar de especificar la asignación completa como parte del comando.

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
TableName	string	✔️	Nombre de la tabla.
DatabaseName	string	✔️	El nombre de la base de datos.
MappingKind	string	✔️	Tipo de asignación. Los valores válidos son: CSV, JSON, avro, parquet y orc.
MappingName	string	✔️	El nombre de la asignación.
ArrayOfMappingObjects	string	✔️	Matriz serializada con uno o varios objetos de asignación definidos.

Ejemplos

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

Salida

Nombre	Clase	Asignación
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}]