Sdílet prostřednictvím


Transformace dat pomocí aktivity ForEach

Aktivita ForEach definuje opakující se tok řízení v kanálu Microsoft Fabric. Tato aktivita se používá k opakování v kolekci a spouští zadané aktivity ve smyčce. Implementace smyčky této aktivity je podobná struktuře smyčky ForEach v programovacích jazycích.

Přidání aktivity ForEach do kanálu

Tato část popisuje, jak používat aktivitu ForEach v kanálu.

Požadavky

Abyste mohli začít, musíte splnit následující požadavky:

Vytvoření aktivity

  1. Vytvořte v pracovním prostoru nový kanál.

  2. Vyhledejte forEach v podokně Aktivity kanálu a vyberte ho, abyste ho přidali na plátno kanálu. Pokud ho zpočátku nevidíte, pomocí šipky na pravé straně panelu nástrojů aktivit se posuňte doprava, abyste ho našli.

    Screenshot of the Fabric UI with the Activities pane and ForEach activity highlighted.

  3. Pokud ještě není vybraná, vyberte na plátně novou aktivitu ForEach.

    Screenshot showing the General settings tab of the ForEach activity.

  4. Na kartě Obecné v dolní části plátna zadejte název aktivity ve vlastnosti Name.

  5. (Volitelné) Můžete také zadat popis.

Nastavení ForEach

Vyberte kartu Nastavení, kde můžete určit, jestli má být zpracování položek v dávce sekvenční (nebo jinak paralelně). Můžete také určit maximální počet položek, které se mají zpracovat současně s počtem batch. Nakonec je nutné zadat seznam položek oddělených čárkami, který lze parametrizovat nebo zahrnout dynamický obsah. Přidejte do seznamu Položky několik položek, jak je znázorněno v příkladu.

Screenshot showing the ForEach settings tab with several items added to the Items list.

Aktivity ForEach

V podokně Aktivity forEach také definujete aktivitu nebo aktivity, které se mají provádět u každé položky v seznamu.

Screenshot showing the ForEach activities pane.

+ Výběrem tlačítka přidejte do podokna novou aktivitu. Zobrazí se seznam aktivit, které si můžete vybrat. Do aktivity ForEach můžete přidat více aktivit a každý z nich se spustí u každé položky v seznamu Položek . Bez ohledu na to, jestli je v nastavení ForEach vybraná možnost Sekvenční, každá podřízená aktivita v podokně aktivit ForEach se postupně zpracovává pro každou položku. Pokud ale není vybraná možnost Sekvenční , zpracuje se paralelně více položek, každý z nich se postupně prochází seznamem zadaných podřízených aktivit.

Screenshot showing a ForEach activity with multiple child activities specified, and the + button highlighted showing a list of child activities to choose from when adding new activities to the pane.

Odkazování na položku v rámci aktivity

V podokně Aktivity ForEach vyberte jednu z podřízených aktivit a přepněte na její kartu Nastavení. V tomto příkladu byla vybrána aktivita Uložená procedura. Naplňte nastavení aktivity tak, jak byste normálně vybrali připojení a uloženou proceduru. Pomocí iterátoru @item() můžete odkazovat na aktuální položku zpracovávanou kdekoli v rámci aktivity, která podporuje dynamický obsah. Zde @item () byl použit jako hodnota parametru FruitName, který se předává uložené proceduře.

Screenshot showing a stored procedure child activity with a parameter using the current @item() from the ForEach items list for its value.