Azure Synapse Data Explorer vlastností příjmu dat (Preview)

  • Článek

Příjem dat je proces, kterým se data přidávají do tabulky a jsou k dispozici pro dotazy v Data Explorer. Vlastnosti přidáte do příkazu pro příjem dat za with klíčové slovo.

Vlastnosti příjmu dat

Následující tabulka uvádí vlastnosti, které Data Explorer podporuje, popisuje je 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 použije při vytváření rozsahů přijatých dat. Pokud není zadáno, použije se aktuální hodnota (now()). Přepsání výchozího nastavení je užitečné při ingestování starších dat, aby se správně použily zásady uchovávání informací. Pokud je zadáno, ujistěte se, že Lookback je vlastnost v efektivních zásadách sloučení Rozsahů cílové tabulky zarovnaná se zadanou hodnotou. with (creationTime="2017-02-13")
extend_schema Logická hodnota, která při zadání dává příkazu pokyn k rozšíření schématu tabulky (výchozí hodnota je false). Tato možnost platí jenom pro .append příkazy a .set-or-append . Jediná povolená rozšíření schématu mají na konci tabulky přidané další sloupce. Pokud je (a:string, b:int)původní schéma tabulky , platné rozšíření schématu bude (a:string, b:int, c:datetime, d:string), ale (a:string, c:datetime) nebude platné.
folder Pro příkazy ingest-from-query je to 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á při zadání brání úspěšnému příjmu dat, pokud už tabulka 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 ingest-by: značky. Vlastnosti with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') označují, že pokud už data se značkou ingest-by:Part0001 existují, nedokončí se aktuální příjem dat. Pokud tento nový příjem dat ještě neexistuje, měl by mít tuto značku nastavenou (pro případ, že se budoucí příjem dat pokusí znovu ingestovat stejná data).
ignoreFirstRecord Logická hodnota, která je nastavená na true, 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 CSVpodobných formátech, pokud jsou prvním záznamem v souboru názvy sloupců. Ve výchozím nastavení se false předpokládá. with (ignoreFirstRecord=false)
persistDetails Logická hodnota, která, pokud je zadaná, označuje, že příkaz by měl zachovat podrobné výsledky (i když jsou úspěšné), aby je příkaz .show podrobnosti operace mohl načíst. Výchozí hodnota je false. with (persistDetails=true)
policy_ingestiontime Logická hodnota, která, pokud je zadána, popisuje, zda se má povolit zásady doby příjmu dat v tabulce vytvořené tímto příkazem. Výchozí formát je true. with (policy_ingestiontime=false)
recreate_schema Logická hodnota, která, pokud je zadána, 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é chcete přidružit k ingestovaným datům, formátovaný jako řetězec JSON with (tags="['Tag1', 'Tag2']")
validationPolicy Řetězec JSON, který označuje, která ověření se mají spustit během příjmu dat. Vysvětlení různých možností najdete v tématu Příjem dat. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (toto je ve skutečnosti výchozí zásada)
zipPattern Tuto vlastnost použijte při ingestování dat z úložiště, které má archiv 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 budou ignorovány. with (zipPattern="*.csv")

Další kroky