Partilhar via

Comando .create-or-alter ingestion mapping

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

Cria ou altera 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 o mapeamento de ingestão não existir, o comando o criará. Se o mapeamento de ingestão já existir, o comando irá modificá-lo.

Observação

Novas colunas introduzidas em um mapeamento de ingestão, que não estão presentes na tabela de origem, serão adicionadas à tabela durante a ingestão inicial de dados para essa coluna. Esse comportamento só tem suporte para ingestão enfileirada e depende da especificação de um tipo de dados válido para a coluna.

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

.create-or-altertable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.create-or-alterdatabase 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á uma 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á.

Exemplo

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
'    { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
'    { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'

Saída

Nome Tipo Mapeamento Backup de banco de dados Tabela
mapeamento1 JSON [{"Propriedades":{"Caminho":"$.rownumber"},"coluna":"número da linha","tipo de dados":"int"},{"Propriedades":{"Caminho":"$.rowguid"},"coluna":"rowguid","tipo de dados":""}] MyDatabase MyTable

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.