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 especificado já existir, .create falhará. Use .create-or-alter em vez disso.

Permissões

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

Syntax

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
TableName	string	✔️	O nome da tabela.
DatabaseName	string	✔️	O nome do banco de dados.
MappingKind	string	✔️	O tipo de mapeamento. Os valores válidos são: csv, json, avro, parquet e orc.
Mappingname	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á 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 ingerido, 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	Banco de dados	Tabela
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

Exemplo: .create ingestion mapping with escape characters

.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.