Megosztás a következőn keresztül:

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

  • Cikk

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