adatbetöltési tulajdonságok Azure Synapse Data Explorer (előzetes verzió)

Az adatbetöltés az a folyamat, amellyel adatokat ad hozzá egy táblához, és elérhetővé válik a lekérdezéshez Data Explorer. A kulcsszó után tulajdonságokat adhat hozzá a betöltési parancshoz with .

Betöltési tulajdonságok

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

Tulajdonság	Leírás	Példa
ingestionMapping	Egy 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	Egy 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	Az (ISO8601-sztringként formázott) datetime érték, amelyet a betöltött adat kiterjedéseinek létrehozásakor kell használni. 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 effektív Extents egyesítési 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ény végén további oszlopok vannak hozzáadva a táblához.	Ha az eredeti táblaséma , (a:string, b:int)az é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	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 (arra az esetre, ha egy jövőbeli betöltési kísérlet újra megkísérli ugyanazokat az adatokat betöltésre).)
ignoreFirstRecord	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 hasonló formátumú fájlokat használ CSV, ha a fájl első rekordja az oszlopnevek. Alapértelmezés szerint a false rendszer feltételezi.	with (ignoreFirstRecord=false)
persistDetails	Logikai érték, amely ha meg van adva, azt jelzi, hogy a parancsnak meg kell őriznie a részletes eredményeket (még ha sikeres is), hogy a .show művelet részletei parancs lekérhesse őket. Az alapértelmezett érték: false.	with (persistDetails=true)
policy_ingestiontime	Egy logikai érték, amely, ha meg van adva, leírja, hogy engedélyezi-e a betöltési idő szabályzatát 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	Logikai érték, amely ha meg van adva, azt írja le, hogy a parancs újra létrehozhatja-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 a betöltés során mely ellenőrzések fussanak. A különböző lehetőségek magyarázatáért lásd: Adatbetöltés .	with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (valójában ez 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 betöltendő fájlok kiválasztásakor kell használni. Az archívumban lévő összes többi fájl figyelmen kívül lesz hagyva.	with (zipPattern="*.csv")

Következő lépések

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