Comando .create ingestion mapping
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Cria um mapeamento de ingestão que pode ser associado a um formato específico e a uma tabela ou banco de dados específico.
Se já existir um mapeamento com o mesmo nome no escopo fornecido, .create falhará. Use o .create-or-alter em vez disso.
Permissões
Pelo menos as permissões do Gestor de banco de dados são necessárias para criar um mapeamento de assimilação de banco de dados e pelo menos as permissões do Gestor de tabela são necessárias para criar um mapeamento de assimilação de tabela.
Sintaxe
.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson
.createdatabase Mapeamento de Nome ingestion do Banco de DadosMapeamento de TipoMapeamento mapping de NomeFormatadoComoJson
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. |
| MappingFormattedAsJson | string |
✔️ | A definição de mapeamento de ingestão formatada como um valor JSON. |
Observação
- Depois de criado, o mapeamento pode ser referenciado por seu nome em comandos de ingestão, em vez de especificar o mapeamento completo como parte do comando.
- Se um mapeamento com o mesmo nome for criado no escopo da tabela e no escopo do banco de dados, o mapeamento no escopo da tabela terá prioridade mais alta.
- Ao ingerir em uma tabela e fazer referência a um mapeamento cujo esquema não corresponde ao esquema da tabela ingerida, a operação de ingestão falhará.
Exemplos
Criar uma tabela e um banco de dados com mapeamento de ingestão de CSV
O exemplo a seguir cria uma tabela, MyTable com mapeamento Mapping1 de ingestão de CSV e um banco de dados, MyDatabase com mapeamento Mapping2de ingestão 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"}}'
']'
Saída
| Nome | Tipo | Mapeamento | Backup de banco de dados | Tabela |
|---|---|---|---|---|
| mapeamento1 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
MyDatabase | MyTable |
| mapeamento2 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
MyDatabase |
Criar mapeamento de ingestão com caracteres de escape
O exemplo a seguir cria uma tabela, test_table com mapeamento de test_mapping_nameingestão JSON. Para evitar erros, barras invertidas são usadas para escapar de aspas simples nas strings de caminho 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}'
']'
Conteúdo relacionado
- Para obter descrições detalhadas de vários formatos de mapeamento de ingestão, como CSV, JSON, Avro, Parquet e Orc, consulte Mapeamentos de dados.
- Para saber mais sobre o mapeamento JSON como uma fonte de ingestão, consulte Mapeamento JSON