Partilhar via

Propriedades de ingestão de dados no Azure Synapse Data Explorer (Pré-visualização)

Importante

O Azure Synapse Analytics Data Explorer (Visualização) será desativado em 7 de outubro de 2025. Após essa data, as cargas de trabalho em execução no Synapse Data Explorer serão excluídas e os dados do aplicativo associados serão perdidos. É altamente recomendável migrar para o Eventhouse no Microsoft Fabric.

O programa Microsoft Cloud Migration Factory (CMF) foi projetado para ajudar os clientes na migração para o Fabric. O programa oferece recursos práticos de teclado sem nenhum custo para o cliente. Estes recursos são atribuídos por um período de 6-8 semanas, com um âmbito pré-definido e acordado. As nomeações de clientes são aceites pela equipa da conta Microsoft ou diretamente através do envio de um pedido de ajuda à equipa CMF.

A ingestão de dados é o processo pelo qual os dados são adicionados a uma tabela e disponibilizados para consulta no Explorador de Dados. Adiciona-se propriedades ao comando de ingestão após a with palavra-chave.

Propriedades de ingestão

A tabela seguinte lista as propriedades suportadas pelo Data Explorer, descreve-as e fornece exemplos:

Propriedade Description Example
ingestionMapping Um valor de cadeia que indica como mapear dados do ficheiro de origem para as colunas reais na tabela. Defina o format valor com o tipo de mapeamento relevante. Veja mapeamentos de dados. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(obsoleto: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Um valor de cadeia que indica como mapear dados do ficheiro fonte para as colunas reais na tabela usando um objeto de política de mapeamento nomeado. Defina o format valor com o tipo de mapeamento relevante. Veja mapeamentos de dados. with (format="csv", ingestionMappingReference = "Mapping1")
(obsoleto: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime O valor de data-hora (formatado como uma cadeia de caracteres no formato ISO8601) a usar no momento da criação dos conjuntos de dados ingeridos. Se não especificado, o valor atual (now()) será utilizado. Anular o padrão é útil ao ingerir dados mais antigos, para que a política de retenção seja aplicada corretamente. Quando especificado, certifique-se de que a Lookback propriedade na política de fusão efetiva de Extents da tabela alvo está alinhada com o valor especificado. with (creationTime="2017-02-13")
extend_schema Um valor booleano que, se especificado, instrui o comando a estender o esquema da tabela (por defeito false). Esta opção aplica-se apenas aos comandos .append e .set-or-append. As únicas extensões de esquema permitidas têm colunas adicionais adicionadas à tabela no final. Se o esquema original da tabela for (a:string, b:int), uma extensão de esquema válida seria (a:string, b:int, c:datetime, d:string), mas (a:string, c:datetime) não seria válida
folder Para comandos ingest-from-query, o diretório a atribuir à tabela. Se a tabela já existir, esta propriedade substituirá o diretório da tabela. with (folder="Tables/Temporary")
format O formato de dados (ver formatos de dados suportados). with (format="csv")
ingestIfNotExists Um valor de cadeia que, se especificado, impede que a ingestão tenha sucesso se a tabela já tiver dados etiquetados com uma ingest-by: etiqueta com o mesmo valor. Isto garante a ingestão de dados idempotentes. Para mais informações, veja tags ingest-by. As propriedades with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') indicam que, se os dados com a etiqueta ingest-by:Part0001 já existirem, então não completem a ingestão atual. Se ainda não existir, esta nova ingestão deve ter esta etiqueta definida (caso uma ingestão futura tente ingerir novamente os mesmos dados).
ignoreFirstRecord Um valor booleano que, se definido para true, indica que a ingestão deve ignorar o primeiro registo de cada ficheiro. Esta propriedade é útil para ficheiros em formatos como CSV e semelhantes, se o primeiro registo no ficheiro forem os nomes das colunas. Por padrão, false é assumido. with (ignoreFirstRecord=false)
persistDetails Um valor booleano que, se especificado, indica que o comando deve persistir os resultados detalhados (mesmo que bem-sucedido) para que o comando .show operation details possa recuperá-los. O padrão é false. with (persistDetails=true)
policy_ingestiontime Um valor booleano que, se especificado, descreve se deve ativar a Política de Tempo de Ingestão numa tabela criada por este comando. A predefinição é true. with (policy_ingestiontime=false)
recreate_schema Um valor booleano que, se especificado, descreve se o comando pode recriar o esquema da tabela. Esta propriedade aplica-se apenas ao .set-or-replace comando. Esta propriedade tem precedência sobre a extend_schema propriedade se ambas forem definidas. with (recreate_schema=true)
tags Uma lista de etiquetas a associar aos dados ingeridos, formatada como uma string JSON with (tags="['Tag1', 'Tag2']")
validationPolicy Uma cadeia JSON que indica que validações deve executar durante o processo de ingestão. Consulte Ingestão de dados para uma explicação das diferentes opções. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (esta é, na verdade, a política padrão)
zipPattern Use esta propriedade ao ingerir dados de armazenamento que tenha um arquivo ZIP. Este é um valor de cadeia que indica a expressão regular a usar ao selecionar quais ficheiros no arquivo ZIP ingerir. Todos os outros ficheiros no arquivo serão ignorados. with (zipPattern="*.csv")

Próximos passos

  • Last updated on