Comando .create ingestion mapping

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 um mapeamento com o mesmo nome no escopo fornecido já existir, .create falhará. Use o .create-or-alter em vez disso.

Permissões

Pelo menos as permissões do Database Ingestor são necessárias para criar um mapeamento de ingestão de banco de dados, e pelo menos as permissões do Table Ingestor são necessárias para criar um mapeamento de ingestão de tabela.

Sintaxe

.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.createdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

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.
MapeamentoFormattedAsJson	string	✔️	A definição de mapeamento de ingestão formatada como um valor JSON.

Observação

• Uma vez 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á uma prioridade mais alta.
• Ao ingerir em uma tabela e fazer referência a um mapeamento cujo esquema não corresponde ao esquema de tabela ingerida, a operação de ingestão falhará.

Exemplos

.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

Exemplo: mapeamento de ingestão .create com 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}'
']'

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.