Proprietà di inserimento dati di Azure Esplora dati
L'inserimento dei dati è il processo in base al quale i dati vengono aggiunti a una tabella e sono resi disponibili per la query in Azure Esplora dati. Aggiungere proprietà al comando di inserimento dopo la with
parola chiave.
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, diventa più frammentata l'inserimento, che può causare una riduzione delle prestazioni.
La tabella seguente elenca le proprietà supportate da Azure Esplora dati, le descrive e fornisce 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 format valore 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 format valore 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 di ISO8601) da usare al momento della creazione degli extent 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 Lookback proprietà nel criterio di unione Extents 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 includono colonne aggiuntive alla fine della tabella. |
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 valida |
folder |
Per i comandi ingest-from-query , la cartella da assegnare alla tabella. Se la tabella esiste già, questa proprietà eseguirà l'override della cartella della tabella. | with (folder="Tables/Temporary") |
format |
Formato 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 inserimento-by: tag. |
Le proprietà with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') indicano che se i dati con il tag ingest-by:Part0001 esistono già, non completare l'inserimento corrente. Se non esiste già, questa nuova inserimento deve avere questo set di tag (nel caso in cui un inserimento futuro tenti di inserire di nuovo gli stessi dati). |
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 è i nomi di colonna. Per impostazione predefinita, false si presuppone. |
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 .set-or-replace comando. Questa proprietà ha la precedenza sulla extend_schema proprietà se entrambi sono impostati. |
with (recreate_schema=true) |
tags |
Elenco di tag da associare ai dati inseriti, formattati come stringa JSON | with (tags="['Tag1', 'Tag2']") |
validationPolicy |
Stringa JSON che indica quali convalida eseguire durante l'inserimento dei dati rappresentati usando il formato CSV. Per una spiegazione delle diverse opzioni, vedere Inserimento dati. | with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (questo è effettivamente il criterio predefinito) |
zipPattern |
Usare questa proprietà durante l'inserimento di dati dall'archiviazione con un archivio ZIP. Si tratta di un valore stringa che indica l'espressione regolare da usare quando si selezionano i file nell'archivio ZIP da inserire. Tutti gli altri file nell'archivio verranno ignorati. | with (zipPattern="*.csv") |
Contenuti correlati
- Altre informazioni sull'inserimento dei dati.
- Altre informazioni sui formati di dati supportati.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere:Invia e visualizza il feedback per