Dela via

Azure Synapse Data Explorer datainmatningsegenskaper (förhandsversion)

  • Artikel

Datainmatning är den process genom vilken data läggs till i en tabell och görs tillgängliga för frågor i Data Explorer. Du lägger till egenskaper i inmatningskommandot efter nyckelordet with .

Inmatningsegenskaper

I följande tabell visas de egenskaper som stöds av Data Explorer, beskriver dem och innehåller exempel:

Egenskap Beskrivning Exempel
ingestionMapping Ett strängvärde som anger hur data ska mappas från källfilen till de faktiska kolumnerna i tabellen. Definiera värdet format med relevant mappningstyp. Se datamappningar. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(inaktuell: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Ett strängvärde som anger hur du mappar data från källfilen till de faktiska kolumnerna i tabellen med hjälp av ett namngivet mappningsprincipobjekt. Definiera värdet format med relevant mappningstyp. Se datamappningar. with (format="csv", ingestionMappingReference = "Mapping1")
(inaktuell: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Datetime-värdet (formaterat som en ISO8601-sträng) som ska användas vid skapandet av inmatade dataomfång. Om det är ospecificerat används det aktuella värdet (now()). Att åsidosätta standardvärdet är användbart när du matar in äldre data, så att kvarhållningsprincipen tillämpas korrekt. När den Lookback har angetts kontrollerar du att egenskapen i måltabellens gällande sammanslagningsprincip för utrymmen är justerad mot det angivna värdet. with (creationTime="2017-02-13")
extend_schema Ett booleskt värde som, om det anges, instruerar kommandot att utöka schemat för tabellen (standardvärdet är false). Det här alternativet gäller endast kommandona .append och .set-or-append . De enda tillåtna schematilläggen har ytterligare kolumner tillagda i tabellen i slutet. Om det ursprungliga tabellschemat är (a:string, b:int)är (a:string, b:int, c:datetime, d:string)ett giltigt schematillägg , men (a:string, c:datetime) skulle inte vara giltigt
folder För kommandon för inmatning från fråga , mappen som ska tilldelas till tabellen. Om tabellen redan finns åsidosätter den här egenskapen tabellens mapp. with (folder="Tables/Temporary")
format Dataformatet (se dataformat som stöds). with (format="csv")
ingestIfNotExists Ett strängvärde som, om det anges, förhindrar inmatning från att lyckas om tabellen redan har data taggade med en ingest-by: tagg med samma värde. Detta säkerställer idempotent datainmatning. Mer information finns i mata in av: taggar. Egenskaperna with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') anger att om det redan finns data med taggen ingest-by:Part0001 slutför du inte den aktuella inmatningen. Om den inte redan finns bör den här nya inmatningen ha den här taggen inställd (om en framtida inmatning försöker mata in samma data igen.)
ignoreFirstRecord Ett booleskt värde som, om det är inställt på true, anger att inmatningen ska ignorera den första posten i varje fil. Den här egenskapen är användbar för filer i CSVoch liknande format, om den första posten i filen är kolumnnamnen. Som standard false antas. with (ignoreFirstRecord=false)
persistDetails Ett booleskt värde som, om det anges, anger att kommandot ska spara detaljerade resultat (även om det lyckas) så att kommandot .show operation details kan hämta dem. Standardvärdet är false. with (persistDetails=true)
policy_ingestiontime Ett booleskt värde som, om det anges, beskriver om inmatningstidsprincipen ska aktiveras för en tabell som skapas med det här kommandot. Standardvärdet är true. with (policy_ingestiontime=false)
recreate_schema Ett booleskt värde som, om det anges, beskriver om kommandot kan återskapa schemat för tabellen. Den här egenskapen gäller endast för .set-or-replace kommandot . Den här egenskapen har företräde framför egenskapen extend_schema om båda anges. with (recreate_schema=true)
tags En lista över taggar som ska associeras med inmatade data, formaterade som en JSON-sträng with (tags="['Tag1', 'Tag2']")
validationPolicy En JSON-sträng som anger vilka valideringar som ska köras under inmatningen. En förklaring av de olika alternativen finns i Datainmatning . with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (detta är faktiskt standardprincipen)
zipPattern Använd den här egenskapen när du matar in data från lagring som har ett ZIP-arkiv. Det här är ett strängvärde som anger det reguljära uttryck som ska användas när du väljer vilka filer i ZIP-arkivet som ska matas in. Alla andra filer i arkivet ignoreras. with (zipPattern="*.csv")

Nästa steg