Comando .create ingestion mapping
Crea una asignación de ingesta que se puede asociar a un formato específico y una tabla o base de datos específica.
Si ya existe una asignación con el mismo nombre en el ámbito especificado, .create
se producirá 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 necesitan al menos permisos de ingesta de tablas para crear una asignación de ingesta de tabla.
Syntax
.create
table
Tablenameingestion
MappingKindmapping
MappingNameMappingFormattedAsJson
.create
database
Databasenameingestion
MappingKindmapping
MappingNameMappingFormattedAsJson
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
Nombre | Tipo | Requerido | 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 |
✔️ | 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 más alta.
- 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
.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 | Kind | 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 |
Ejemplo: asignación de ingesta .create con caracteres de escape
.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.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de