Comando .create-or-alter ingestion mapping
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
Crea o modifica una asignación de ingesta que se puede asociar a un formato específico y a una tabla o base de datos específica.
Si la asignación de ingesta no existe, el comando lo creará. Si la asignación de ingesta ya existe, el comando lo modificará.
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
Se requieren al menos permisos de ingestión de base de datos para crear una asignación de ingesta de base de datos y se requieren al menos permisos de ingesta de tablas para crear una asignación de ingesta de tablas.
Sintaxis
.create-or-altertable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson
.create-or-alterdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson
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. |
| MappingFormattedAsJson | string |
✔️ | Definición de asignación de ingesta con formato JSON. |
Nota:
- Una vez creada, se puede hacer referencia a la asignación por su nombre en los comandos de ingesta, en lugar de especificar la asignación completa como parte del comando.
- Si se crea una asignación con el mismo nombre tanto en el ámbito de tabla como en el ámbito de la base de datos, la asignación en el ámbito de tabla tendrá una prioridad mayor.
- Al ingerir en una tabla y hacer referencia a una asignación cuyo esquema no coincide con el esquema de tabla ingerida, se producirá un error en la operación de ingesta.
Ejemplo
.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"}}'
']'
Salida
| Nombre | Clase | Asignación | Base de datos | Tabla |
|---|---|---|---|---|
| mapping1 | JSON | [{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}] | MyDatabase | MyTable |
Contenido relacionado
- Para obtener descripciones detalladas de varios formatos de asignación de ingesta, como CSV, JSON, Avro, Parquet y Orc, consulte Asignaciones de datos.