Comando .create ingestion mapping
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
Crea 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 ya existe una asignación con el mismo nombre en el ámbito especificado, .create se produce un error. En su lugar, use .create-or-alter.
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
.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson
.createdatabase 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á mayor prioridad.
- 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.
Ejemplos
Creación de una tabla y una base de datos con asignación de ingesta de CSV
En el ejemplo siguiente se crea una tabla, MyTable con la asignación Mapping1 de ingesta de CSV y una base de datos, MyDatabase con asignación de Mapping2ingesta de CSV .
.create table MyTable ingestion csv mapping "Mapping1"
'['
' { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
' { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'
.create 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 | Base de datos | Tabla |
|---|---|---|---|---|
| mapping1 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
MyDatabase | MyTable |
| mapping2 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
MyDatabase |
Creación de una asignación de ingesta con caracteres de escape
En el ejemplo siguiente se crea una tabla, test_table con asignación test_mapping_namede ingesta JSON . Para evitar errores, las barras diagonales inversas se usan para escapar comillas simples en las cadenas de ruta de acceso JSON.
.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'
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.
- Para más información sobre la asignación de JSON como origen de ingesta, consulte Asignación de JSON.