Sdílet prostřednictvím

Vlastnosti příjmu dat

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Příjem dat je proces, pomocí kterého se data přidají do tabulky a jsou k dispozici pro dotazy. Vlastnosti přidáte do příkazu pro příjem dat za with klíčové slovo.

Vlastnosti příjmu dat

Důležité

Ve frontě jsou data příjmu dat dávková pomocí vlastností příjmu dat. Čím více jedinečných vlastností mapování příjmu dat, jako jsou různé hodnoty ConstValue, tím více fragmentovaný příjem dat se stane, což může vést ke snížení výkonu.

Následující tabulka obsahuje seznam podporovaných vlastností a uvádí příklady:

Vlastnost Popis Příklad
ingestionMapping Řetězcová hodnota, která označuje, jak mapovat data ze zdrojového souboru na skutečné sloupce v tabulce. format Definujte hodnotu s příslušným typem mapování. Viz mapování dat. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(zastaralé: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Řetězcová hodnota, která označuje, jak mapovat data ze zdrojového souboru na skutečné sloupce v tabulce pomocí pojmenovaného objektu zásad mapování. format Definujte hodnotu s příslušným typem mapování. Viz mapování dat. with (format="csv", ingestionMappingReference = "Mapping1")
(zastaralé: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Hodnota datetime (formátovaná jako řetězec ISO8601), která se má použít při vytváření ingestovaných rozsahů dat. Pokud není zadáno, použije se aktuální hodnota (now()). Přepsání výchozí hodnoty je užitečné při ingestování starších dat, aby se zásady uchovávání informací použily správně. Po zadání se ujistěte, že Lookback je vlastnost v efektivní zásadě sloučení rozsahů cílové tabulky zarovnaná se zadanou hodnotou. with (creationTime="2017-02-13")
extend_schema Logická hodnota, která v případě zadání dává příkazu pokyn, aby rozšířil schéma tabulky (výchozí hodnota falseje ). Tato možnost platí jenom pro .append příkazy a .set-or-append příkazy. Jediná povolená rozšíření schématu mají na konci přidaných více sloupců do tabulky. Pokud je (a:string, b:int)původní schéma tabulky , platné rozšíření schématu by bylo (a:string, b:int, c:datetime, d:string), ale (a:string, c:datetime) nebylo by platné.
folder Pro příkazy ingest-from-query se složka, která se má přiřadit k tabulce. Pokud tabulka již existuje, tato vlastnost přepíše složku tabulky. with (folder="Tables/Temporary")
format Formát dat (viz podporované formáty dat). with (format="csv")
ingestIfNotExists Řetězcová hodnota, která pokud je zadána, zabrání příjmu dat úspěšně, pokud tabulka již obsahuje data označená značkou ingest-by: se stejnou hodnotou. Tím se zajistí příjem idempotentních dat. Další informace najdete v tématu ingestování podle: značek. Vlastnosti with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') označují, že pokud data se značkou ingest-by:Part0001 již existují, nedokončujte aktuální příjem dat. Pokud ještě neexistuje, tento nový příjem dat by měl mít tuto sadu značek (v případě, že se budoucí příjem dat pokusí znovu ingestovat stejná data.)
ignoreFirstRecord Logická hodnota, která pokud je nastavená na truehodnotu , označuje, že příjem dat by měl ignorovat první záznam každého souboru. Tato vlastnost je užitečná pro soubory v CSVa podobných formátech, pokud první záznam v souboru jsou názvy sloupců. Ve výchozím nastavení false se předpokládá. with (ignoreFirstRecord=false)
policy_ingestiontime Logická hodnota, která pokud je zadána, popisuje, zda povolit zásady času příjmu dat v tabulce vytvořené tímto příkazem. Výchozí hodnota je true. with (policy_ingestiontime=false)
recreate_schema Logická hodnota, která v případě zadání popisuje, zda příkaz může znovu vytvořit schéma tabulky. Tato vlastnost se vztahuje pouze na .set-or-replace příkaz. Tato vlastnost má přednost před extend_schema vlastností, pokud jsou obě nastaveny. with (recreate_schema=true)
tags Seznam značek , které se mají přidružit k přijatým datům, formátované jako řetězec JSON with (tags="['Tag1', 'Tag2']")
TreatGzAsUncompressed Logická hodnota, která pokud je nastavena na true, označuje, že soubory s příponou .gz nejsou komprimovány. Tento příznak je někdy potřeba při ingestování z Amazon AWS S3. with (treatGzAsUncompressed=true)
validationPolicy Řetězec JSON, který označuje, která ověření se mají spustit během příjmu dat reprezentovaných pomocí formátu CSV. Vysvětlení různých možností najdete v tématu Příjem dat. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (toto je výchozí zásada)
zipPattern Tuto vlastnost použijte při ingestování dat z úložiště s archivem ZIP. Jedná se o řetězcovou hodnotu označující regulární výraz, který se má použít při výběru souborů v archivu ZIP k ingestování. Všechny ostatní soubory v archivu se ignorují. with (zipPattern="*.csv")

Související obsah

  • Další informace o příjmu dat