.create ingestion mapping command (Comando de mapeamento de ingestão de .create)
Cria um mapeamento de ingestão que pode ser associado a um formato específico e a uma tabela ou base de dados específica.
Se já existir um mapeamento com o mesmo nome no âmbito especificado, .create
falhará. Em vez disso, utilize .create-or-alter
.
Permissões
Pelo menos são necessárias permissões do Ingestor de Bases de Dados para criar um mapeamento de ingestão de bases de dados e, pelo menos, são necessárias permissões do Ingestor de Tabelas para criar um mapeamento de ingestão de tabelas.
Syntax
.create
table
TableNameingestion
MappingKindmapping
MappingNameMappingFormattedAsJson
.create
database
DatabaseNameingestion
MappingKindmapping
MappingNameMappingFormattedAsJson
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
TableName | string |
✔️ | O nome da tabela. |
DatabaseName | string |
✔️ | O nome da base 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. |
Nota
- Depois de criado, o mapeamento pode ser referenciado pelo respetivo nome nos comandos de ingestão, em vez de especificar o mapeamento completo como parte do comando.
- Se for criado um mapeamento com o mesmo nome no âmbito da tabela e no âmbito da base de dados, o mapeamento no âmbito da tabela terá uma prioridade mais alta.
- Ao ingerir numa tabela e referenciar um mapeamento cujo esquema não corresponde ao esquema da 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
Name | Tipo | Mapeamento | Base 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: .create ingestion mapping with escape characters (Mapeamento de ingestão de .create com carateres 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, veja Mapeamentos de dados.
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários