Proprietà di inserimento dati

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

L'inserimento dati è il processo in base al quale i dati vengono aggiunti a una tabella e vengono resi disponibili per la query. Aggiungere proprietà al comando di inserimento dopo la parola chiave with.

Proprietà di inserimento

Importante

Nei dati di inserimento in coda viene eseguito il batch usando le proprietà di inserimento. Le proprietà di mapping di inserimento più distinte usate, ad esempio valori ConstValue diversi, diventano più frammentate l'inserimento, il che può causare una riduzione delle prestazioni.

Nella tabella seguente sono elencate e descritte le proprietà supportate e vengono forniti esempi:

Proprietà Descrizione Esempio
ingestionMapping valore stringa che indica come eseguire il mapping dei dati dal file di origine alle colonne effettive della tabella. Definire il valore format con il tipo di mapping pertinente. Vedere Mapping dei dati. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(deprecato: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference valore stringa che indica come eseguire il mapping dei dati dal file di origine alle colonne effettive della tabella tramite un oggetto criteri di mapping denominato. Definire il valore format con il tipo di mapping pertinente. Vedere Mapping dei dati. with (format="csv", ingestionMappingReference = "Mapping1")
(deprecato: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Valore datetime, formattato come stringa ISO8601, da usare come ora di creazione degli extent dei dati inseriti. Se non specificato, viene usato il valore corrente (now()). L'override del valore predefinito è utile quando si inseriscono dati meno recenti, in modo che i criteri di conservazione vengano applicati correttamente. Se specificato, assicurarsi che la proprietà Lookback nel criterio di unione degli extent effettivi della tabella di destinazione sia allineata al valore specificato. with (creationTime="2017-02-13")
extend_schema valore booleano che, se specificato, indica al comando di estendere lo schema della tabella (il valore predefinito è false). Questa opzione è valida solo per i comandi .append e .set-or-append. Le uniche estensioni dello schema consentite hanno più colonne aggiunte alla tabella alla fine. Se lo schema della tabella originale è (a:string, b:int), un'estensione dello schema valida sarebbe (a:string, b:int, c:datetime, d:string), ma (a:string, c:datetime) non sarebbe valido
folder Per i comandi di inserimento da query, la cartella da assegnare alla tabella. Se la tabella esiste già, questa proprietà esegue l'override della cartella della tabella. with (folder="Tables/Temporary")
format Formato dei dati (vedere Formati di dati supportati). with (format="csv")
ingestIfNotExists valore stringa che, se specificato, impedisce il completamento dell'inserimento se la tabella contiene già dati contrassegnati con un tag ingest-by: con lo stesso valore. In questo modo si garantisce un inserimento dati idempotente. Per altre informazioni, vedere Tag ingest-by. Ad esempio, le proprietà with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') indicano che se esistono già dati con il tag ingest-by:Part0001, l'inserimento corrente non viene completato. Se i dati non esistono già, questo nuovo inserimento deve avere questo tag impostato, nel caso in cui un inserimento futuro tenti di inserire nuovamente gli stessi dati in un secondo tempo.
ignoreFirstRecord valore booleano che, se impostato su true, indica che l'inserimento deve ignorare il primo record di ogni file. Questa proprietà è utile per i file in CSV e formati simili, se il primo record nel file è costituito dai nomi di colonna. Per impostazione predefinita, questo valore è false. with (ignoreFirstRecord=false)
policy_ingestiontime valore booleano che, se specificato, indica se abilitare i criteri del tempo di inserimento su una tabella creata da questo comando. Il valore predefinito è true. with (policy_ingestiontime=false)
recreate_schema valore booleano che, se specificato, indica se il comando può ricreare lo schema della tabella. Questa proprietà si applica solo al comando .set-or-replace. Questa proprietà ha la precedenza sulla proprietà extend_schema se sono impostati entrambi. with (recreate_schema=true)
tags Elenco di tag da associare ai dati inseriti, formattati come stringa JSON. with (tags="['Tag1', 'Tag2']")
TreatGzAsUncompressed Valore booleano che, se impostato su true, indica che i file con estensione .gz non vengono compressi. Questo flag è talvolta necessario quando si inserisce da Amazon AWS S3. with (treatGzAsUncompressed=true)
validationPolicy Stringa JSON che indica le convalide da eseguire durante l'inserimento di dati rappresentati usando il formato CSV. Per una spiegazione delle diverse opzioni, vedere Inserimento dati. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (questo è il criterio predefinito)
zipPattern Usare questa proprietà quando si inseriscono dati dall'archivio con un archivio ZIP. Si tratta di un valore di stringa che indica l'espressione regolare da usare per selezionare i file dell'archivio ZIP da inserire. Tutti gli altri file nell'archivio vengono ignorati. with (zipPattern="*.csv")

Contenuto correlato