Az Azure Data Explorer adatbetöltés tulajdonságai

Az adatbetöltés az a folyamat, amellyel az adatok hozzáadva lesznek egy táblához, és elérhetővé válnak az Azure Data Explorer lekérdezéséhez. A kulcsszó után tulajdonságokat adhat hozzá a betöltési parancshoz with .

Betöltési tulajdonságok

Fontos

• A várólistán lévő betöltési adatok kötegelése a Betöltési tulajdonságok használatával történik. Minél több különböző betöltési leképezési tulajdonságot használ, például különböző ConstValue értékeket, annál töredezettebbé válik a betöltési folyamat, ami teljesítménycsökkenéshez vezethet.

Az alábbi táblázat felsorolja az Azure Data Explorer által támogatott tulajdonságokat, ismerteti őket, és példákat tartalmaz:

Tulajdonság	Leírás	Példa
ingestionMapping	Sztringérték, amely azt jelzi, hogyan képezheti le az adatokat a forrásfájlból a tábla tényleges oszlopaiba. Adja meg az format értéket a megfelelő leképezési típussal. Lásd: adatleképezések.	with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]") (elavult: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference	Sztringérték, amely azt jelzi, hogyan képezheti le az adatokat a forrásfájlból a tábla tényleges oszlopaiba egy elnevezett leképezési szabályzatobjektum használatával. Adja meg az format értéket a megfelelő leképezési típussal. Lásd: adatleképezések.	with (format="csv", ingestionMappingReference = "Mapping1") (elavult: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime	A dátum/idő érték (ISO8601 sztringként formázva), amelyet a betöltött adat kiterjedésének létrehozásakor használhat. Ha nincs meghatározva, a rendszer az aktuális értéket (now()) használja. Az alapértelmezett érték felülírása hasznos a régebbi adatok betöltésekor, hogy a megőrzési szabályzat megfelelően legyen alkalmazva. Ha meg van adva, győződjön meg arról, hogy a Lookback céltábla hatályos Extents merge szabályzatának tulajdonsága igazodik a megadott értékhez.	with (creationTime="2017-02-13")
extend_schema	Egy logikai érték, amely, ha meg van adva, arra utasítja a parancsot, hogy terjessze ki a tábla sémáját (alapértelmezés szerint a értékre false). Ez a beállítás csak a és .set-or-append parancsokra .append vonatkozik. Az egyetlen engedélyezett sémabővítmények végén további oszlopok vannak hozzáadva a táblához.	Ha az eredeti táblaséma , (a:string, b:int)akkor érvényes sémabővítmény lenne (a:string, b:int, c:datetime, d:string), de (a:string, c:datetime) nem lenne érvényes
folder	A lekérdezési parancsok betöltéséhez a táblához rendelendő mappa. Ha a tábla már létezik, ez a tulajdonság felülbírálja a tábla mappáját.	with (folder="Tables/Temporary")
format	Az adatformátum (lásd a támogatott adatformátumokat).	with (format="csv")
ingestIfNotExists	Olyan sztringérték, amely ha meg van adva, megakadályozza a betöltés sikerességét, ha a táblában már vannak azonos értékű címkével ingest-by: ellátott adatok. Ez biztosítja az idempotens adatbetöltést. További információ: betöltési címkék.	A tulajdonságok azt jelzik with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') , hogy ha a címkével ingest-by:Part0001 rendelkező adatok már léteznek, akkor ne fejezze be az aktuális betöltési elemet. Ha még nem létezik, ennek az új betöltési műveletnek rendelkeznie kell ezzel a címkekészlettel (abban az esetben, ha egy jövőbeli betöltési kísérlet újra betölti ugyanazokat az adatokat.)
ignoreFirstRecord	Egy logikai érték, amely ha a értékre truevan állítva, azt jelzi, hogy a betöltésnek figyelmen kívül kell hagynia minden fájl első rekordját. Ez a tulajdonság akkor hasznos, ha a fájl CSVelső rekordja az oszlopnév. Alapértelmezés szerint a false rendszer feltételezi.	with (ignoreFirstRecord=false)
policy_ingestiontime	Egy logikai érték, amely, ha meg van adva, azt írja le, hogy engedélyezi-e a betöltési időszabályzatot egy olyan táblán, amelyet ez a parancs hoz létre. A mező alapértelmezett értéke: true.	with (policy_ingestiontime=false)
recreate_schema	Egy logikai érték, amely, ha meg van adva, leírja, hogy a parancs újra létrehozza-e a tábla sémáját. Ez a tulajdonság csak a .set-or-replace parancsra vonatkozik. Ez a tulajdonság elsőbbséget élvez a extend_schema tulajdonságnál, ha mindkettő be van állítva.	with (recreate_schema=true)
tags	A betöltött adatokhoz társítandó címkék listája JSON-sztringként formázva	with (tags="['Tag1', 'Tag2']")
validationPolicy	Egy JSON-sztring, amely azt jelzi, hogy mely érvényesítéseket kell futtatni a CSV-formátummal ábrázolt adatok betöltése során. A különböző lehetőségek magyarázatát lásd: Adatbetöltés .	with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (ez valójában az alapértelmezett szabályzat)
zipPattern	Ezt a tulajdonságot akkor használja, ha zip-archívummal rendelkező tárolóból betölt adatokat. Ez egy sztringérték, amely azt a reguláris kifejezést jelzi, amelyet a ZIP-archívumban a betöltendő fájlok kiválasztásakor kell használni. A rendszer figyelmen kívül hagyja az archívumban lévő összes többi fájlt.	with (zipPattern="*.csv")

Kapcsolódó tartalom

• További információ az adatbetöltésről.
• További információ a támogatott adatformátumokról.