Egenskaper för Datainmatning i Azure Data Explorer

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

Inmatningsegenskaper

Viktigt

• I köade data batchas data med hjälp av inmatningsegenskaper. Ju mer distinkta egenskaper för inmatningsmappning som används, till exempel olika ConstValue-värden, desto mer fragmenterad blir inmatningen, vilket kan leda till prestandaförsämring.

I följande tabell visas de egenskaper som stöds av Azure 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 när dataomfången matas in skapas. 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)
policy_ingestiontime	Ett booleskt värde som, om det anges, beskriver om inmatningstidsprincipen ska aktiveras i 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 inmatning av data som representeras med CSV-format. 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")

Relaterat innehåll

• Läs mer om datainmatning.
• Läs mer om dataformat som stöds.