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

A ingestão de dados é o processo pelo qual os dados são adicionados a uma tabela e são disponibilizados para consulta em Data Explorer. Adicione propriedades ao comando de ingestão após a with palavra-chave.

Propriedades de ingestão

A tabela a seguir lista as propriedades suportadas por Data Explorer, descreve-as e dá exemplos:

Propriedade Descrição Exemplo
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. Consulte os mapeamentos de dados. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(prevadado: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Um valor de cadeia que indica como mapear dados do ficheiro de origem 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. Consulte os mapeamentos de dados. with (format="csv", ingestionMappingReference = "Mapping1")
(prevadado: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime O valor da data (formatado como uma cadeia ISO8601) para utilizar no momento de criação das extensões de dados ingeridos. Se não for especificado, o valor atual (now()) será utilizado. A sobreposição do padrão é útil ao ingerir dados mais antigos, de modo a 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 extensões 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 (predefinição a false). Esta opção aplica-se apenas a .append e .set-or-append comandos. As únicas extensões de esquema permitidas têm colunas adicionais adicionadas à mesa no final. Se o esquema de mesa original for (a:string, b:int), uma extensão de esquema válido seria (a:string, b:int, c:datetime, d:string), mas (a:string, c:datetime) não seria válido
folder Para os comandos de ingestão de consultas , a pasta atribui-se à mesa. Se a tabela já existir, esta propriedade irá sobrepor-se à pasta da mesa. 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 a ingestão de sucesso se a tabela já tiver dados marcados com uma ingest-by: etiqueta com o mesmo valor. Isto garante a ingestão de dados idempotente. Para mais informações, consulte ingest-by: tags. As propriedades with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') indicam que se os dados com a etiqueta ingest-by:Part0001 já existem, então não complete a ingestão atual. Se já não existe, esta nova ingestão deverá ter este conjunto de etiquetas (no caso de uma futura ingestão tentar voltar a ingerir os mesmos dados.)
ignoreFirstRecord Um valor Boolean que, se definido, indica que a trueingestão deve ignorar o primeiro registo de cada ficheiro. Esta propriedade é útil para ficheiros em CSVformatos semelhantes, se o primeiro registo no ficheiro forem os nomes das colunas. Por defeito, false é assumido. with (ignoreFirstRecord=false)
persistDetails Um valor Boolean que, se especificado, indica que o comando deve persistir os resultados detalhados (mesmo que bem sucedidos) para que o comando de detalhes de operação .show possa recuperá-los. Incumprimentos a false. with (persistDetails=true)
policy_ingestiontime Um valor booleano que, se especificado, descreve se permite 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 ambos estiverem definidos. with (recreate_schema=true)
tags Uma lista de tags para associar aos dados ingeridos, formatadas como uma cadeia JSON with (tags="['Tag1', 'Tag2']")
validationPolicy Uma corda JSON que indica quais as validações a executar durante a ingestão. Consulte a ingestão de dados para obter uma explicação das diferentes opções. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (esta é, na verdade, a política por defeito)
zipPattern Utilize esta propriedade ao ingerir dados de armazenamento que tenha um arquivo ZIP. Este é um valor de cadeia que indica a expressão regular a utilizar ao selecionar quais os ficheiros no arquivo ZIP para ingerir. Todos os outros ficheiros do arquivo serão ignorados. with (zipPattern="*.csv")

Passos seguintes