Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
PLATÍ PRO:
Azure Data Factory 
Azure Synapse Analytics
Tip
Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat přes následné zpracování dat, analýzy v reálném čase, podnikovou inteligenci a reporting. Přečtěte si, jak začít používat novou zkušební verzi zdarma.
Aktivita poznámkového bloku Azure Synapse v pipeline spouští poznámkový blok Synapse ve vašem pracovním prostředí Azure Synapse Analytics. Tento článek vychází z článku o aktivitách transformace dat, který představuje obecný přehled transformace dat a podporovaných transformačních aktivit.
Aktivitu poznámkového bloku Azure Synapse Analytics můžete vytvořit přímo prostřednictvím uživatelského rozhraní nástroje Azure Data Factory Studio. Podrobný návod, jak vytvořit aktivitu poznámkového bloku Synapse pomocí uživatelského rozhraní, najdete v následujících tématech.
Přidání aktivity poznámkového bloku pro Synapse do kanálu s uživatelským rozhraním
Pokud chcete v potrubí použít aktivitu Notebooku pro Synapse, proveďte následující kroky:
Obecné nastavení
- Vyhledejte poznámkový blok v podokně Aktivity kanálu a přetáhněte aktivitu poznámkového bloku pod Synapse na plátno kanálu.
- Pokud ještě není vybraná, vyberte na plátně novou aktivitu poznámkového bloku.
- V obecných nastaveních zadejte vzorek pro Název.
- (Možnost) Můžete také zadat popis.
- Časový limit: Maximální doba, po kterou může aktivita běžet. Výchozí hodnota je 12 hodin a maximální povolená doba je 7 dní. Formát je ve formátu D.HH:MM:SS.
- Opakování: Maximální počet pokusů o opakování
- Interval opakování (s): Počet sekund mezi jednotlivými pokusy o opakování.
- Zabezpečený výstup: Při kontrole se výstup z aktivity nezachytí v protokolování.
- Zabezpečený vstup: Při kontrole se vstup z aktivity nezachytí v protokolování.
Nastavení Služby Azure Synapse Analytics (artefakty)
Výběrem karty Azure Synapse Analytics (Artefakty) vyberte nebo vytvořte novou propojenou službu Azure Synapse Analytics, která spustí aktivitu poznámkového bloku.
Karta Nastavení
Vyberte novou aktivitu poznámkového bloku Synapse na plátně, pokud ještě není vybraná.
Vyberte kartu Nastavení.
Rozbalte seznam poznámkových bloků a vyberte existující poznámkový blok v propojené službě Azure Synapse Analytics (Artefakty).
Kliknutím na tlačítko Otevřít otevřete stránku propojené služby, ve které se nachází vybraný poznámkový blok.
Poznámka:
Pokud je ID prostředku pracovního prostoru v propojené službě prázdné, tlačítko Otevřít bude deaktivováno.
Vyberte kartu Nastavení a vyberte poznámkový blok a volitelné základní parametry, které mají být předány poznámkovému bloku.
(Volitelné) Můžete vyplnit informace o poznámkovém bloku Synapse. Pokud jsou následující nastavení prázdná, použijí se ke spuštění nastavení samotného poznámkového bloku Synapse. Pokud následující nastavení nejsou prázdná, nahradí tato nastavení nastavení samotného poznámkového bloku Synapse.
Vlastnost Popis fond úloh Sparku Odkaz na fond Spark. V seznamu můžete vybrat fond Apache Spark. Velikost exekutoru Počet jader a paměti, které se mají použít pro výkonné jednotky přidělené v zadaném fondu Apache Spark během relace. U dynamického obsahu jsou platné hodnoty Small/Medium/Large/XLarge/XXLarge. Dynamicky přidělovat exekutory Toto nastavení se mapuje na vlastnost dynamického přidělení v konfiguraci Spark pro přidělení exekutorů aplikace Spark. Minimální počet exekutorů Minimální počet exekutorů, které se mají přidělit v zadaném fondu Sparku pro úlohu. Maximální počet exekutorů Maximální počet vykonavatelů, které se mají přidělit ve fondu Spark zadaném pro úkol. Velikost ovladače Počet jader a paměti, které budou použity pro řadič, uvedené ve specifikovaném Apache Spark poolu pro úlohu.
Definice aktivity poznámkového bloku Azure Synapse Analytics
Tady je ukázková definice JSON aktivity poznámkového bloku Azure Synapse Analytics:
{
"activities": [
{
"name": "demo",
"description": "description",
"type": "SynapseNotebook",
"dependsOn": [],
"policy": {
"timeout": "7.00:00:00",
"retry": 0,
"retryIntervalInSeconds": 30,
"secureOutput": false,
"secureInput": false
},
"userProperties": [
{
"name": "testproperties",
"value": "test123"
}
],
"typeProperties": {
"notebook": {
"referenceName": {
"value": "Notebookname",
"type": "Expression"
},
"type": "NotebookReference"
},
"parameters": {
"test": {
"value": "testvalue",
"type": "string"
}
},
"snapshot": true,
"sparkPool": {
"referenceName": {
"value": "SampleSpark",
"type": "Expression"
},
"type": "BigDataPoolReference"
}
},
"linkedServiceName": {
"referenceName": "AzureSynapseArtifacts1",
"type": "LinkedServiceReference"
}
}
]
}
Vlastnosti aktivit poznámkového bloku Azure Synapse Analytics
Následující tabulka popisuje vlastnosti JSON použité v definici JSON:
| Vlastnost | Popis | Povinné |
|---|---|---|
| název | Název aktivity v potrubí. | Ano |
| popis | Text popisující, co aktivita dělá. | Ne |
| typ | U aktivity poznámkového bloku Azure Synapse Analytics je typ aktivity SynapseNotebook. | Ano |
| poznámkový blok | Název poznámkového bloku, který se má spustit v Azure Synapse Analytics. | Ano |
| SparkPool | Prostředí Spark vyžadované ke spuštění poznámkového bloku Azure Synapse Analytics. | Ne |
| parametr | Parametr vyžadovaný ke spuštění poznámkového bloku Azure Synapse Analytics Další informace najdete v tématu Transformace dat spuštěním poznámkového bloku Synapse. | Ne |
Určení buňky parametrů
Azure Data Factory hledá buňku parametrů a používá hodnoty jako výchozí hodnoty parametrů předaných v době provádění. Prováděcí modul přidá novou buňku pod buňku parametrů se vstupními parametry pro přepsání výchozích hodnot. Můžete se odkázat na transformaci dat spuštěním poznámkového bloku Synapse.
Přečíst výstupní hodnotu buňky poznámkového bloku Synapse
Výstupní hodnotu buňky poznámkového bloku si můžete přečíst v aktivitě. Pro tento panel můžete přečíst část Transformace dat spuštěním poznámkového bloku Synapse.
Spusťte další poznámkový blok Synapse
Na jiné poznámkové bloky v aktivitě poznámkového bloku Synapse můžete odkazovat prostřednictvím volání nástroje poznámkového bloku %run magic nebo mssparkutils. Obě podporují volání vnoření funkcí. Hlavní rozdíly těchto dvou metod, které byste měli zvážit na základě vašeho scénáře, jsou:
-
%run magic zkopíruje všechny buňky z odkazovaného poznámkového bloku do buňky %run a sdílí kontext proměnné. Když poznámkový blok1 odkazuje na poznámkový blok2 prostřednictvím
%run notebook2a poznámkový blok2 volá funkci mssparkutils.notebook.exit, zastaví se spuštění buňky v poznámkovém bloku1. %run magic doporučujeme použít, když chcete zahrnout soubor poznámkového bloku. -
Nástroje poznámkového bloku mssparkutils volá odkazovaný poznámkový blok jako metodu nebo funkci. Kontext proměnné se nesdílí. Když poznámkový blok1 odkazuje na poznámkový blok 2 prostřednictvím
mssparkutils.notebook.run("notebook2")a poznámkový blok2 volá funkci mssparkutils.notebook.exit , provádění buněk v poznámkovém bloku1 bude pokračovat. Doporučujeme používat nástroje pro poznámkový blok mssparkutils, pokud chcete poznámkový blok importovat.
Zobrazení historie spuštění aktivit poznámkového bloku Azure Synapse Analytics
Na záložce Monitor přejděte na spuštění kanálů, zobrazí se kanál, který jste spustili. Otevřete kanál, který obsahuje aktivitu poznámkového bloku, abyste viděli historii spuštění.
V případě snímku otevřeného poznámkového bloku se tato funkce v současné době nepodporuje.
Vstup nebo výstup aktivity poznámkového bloku můžete zobrazit výběrem vstupního nebo výstupního tlačítka. Pokud vaše zpracovatelská linka selhala kvůli uživatelské chybě, vyberte výstup pro ověření pole výsledků a prohlédněte si podrobné trasování uživatelské chyby.
