Sdílet prostřednictvím


Funkce uživatelských dat, správa zdrojového kódu a nasazení

Tento článek vysvětluje, jak fungují kanály integrace a nasazení Gitu pro funkce uživatelských dat v Microsoft Fabric. Díky integraci s Gitem můžete pracovní prostor Fabric synchronizovat s větví úložiště, což vám umožní provádět verzování funkcí uživatelských dat, spolupracovat pomocí větví a pull requestů, a pracovat s vaším kódem v preferovaných nástrojích Git, jako je Azure DevOps.

Přečtěte si další informace o procesu integrace Gitu s pracovním prostorem Microsoft Fabric v základních konceptech integrace Gitu.

Nastavení připojení

V nastavení pracovního prostoru můžete snadno nastavit připojení k úložišti pro potvrzení a synchronizaci změn. Informace o nastavení připojení najdete v tématu Začínáme s integrací Gitu. Po připojení se položky, včetně funkcí uživatelských dat, zobrazí v podokně Správa zdrojového kódu.

Snímek obrazovky znázorňující položku funkcí uživatelských dat s nepotvrzenými změnami ve správě zdrojového kódu

Po úspěšném potvrzení položek uživatelských datových funkcí do úložiště Git se v úložišti zobrazí složky funkcí uživatelských dat. Nyní můžete spouštět budoucí operace, například vytvořit pull request.

Reprezentace funkcí uživatelských dat v Gitu

Následující obrázek ukazuje příklad struktury souborů jednotlivých položek funkcí uživatelských dat v úložišti.

Snímek obrazovky znázorňující strukturu složek pro položku funkcí uživatelských dat v úložišti

Struktura složek obsahuje následující prvky:

  • .platform: Soubor .platform obsahuje následující atributy:

    Snímek obrazovky zobrazující soubor platformy pro položku funkcí uživatelských dat

    • verze: Číslo verze systémových souborů. Toto číslo se používá k povolení zpětné kompatibility. Číslo verze položky se může lišit.
    • logicalId: Automaticky vygenerovaný identifikátor křížového pracovního prostoru představující položku a jeho reprezentaci správy zdrojového kódu.
    • typ: UserDataFunction je typ definující položku funkcí uživatelských dat.
    • displayName: Představuje název položky. Při přejmenování položky funkcí uživatelských dat se tento displayName aktualizuje.
  • definitions.json: Tento soubor sdílí všechny definice položek položek uživatelských dat, jako jsou připojení, knihovny atd. jako reprezentace vlastností položek uživatelských datových funkcí.

    Snímek obrazovky zobrazující definitions.json soubor pro položku funkcí uživatelských dat

  • function-app.py: Tento soubor je kód funkce. Všechny změny kódu, které provedete v položce funkcí uživatelských dat, se synchronizují do úložiště s tímto souborem. Ke správě cyklu vývoje kódu můžete provádět různé operace Gitu.

    snímek obrazovky zobrazující function-app.py soubor pro položku funkcí uživatelských dat

  • resources: Složka obsahuje soubor functions.json se všemi metadaty, jako jsou připojení, knihovny a funkce v rámci této položky. NEAKTUALIZOVAT TENTO SOUBOR ručně. functions.json umožňuje Funkci vytvořit nebo znovu vytvořit položku funkcí uživatelských dat v pracovním prostoru.

    Snímek obrazovky zobrazující soubor function.json ve složce 'resources' pro funkce uživatelských dat

Další informace o integraci Gitu, včetně podrobností o struktuře složek a systémových souborech, najdete v tématu Formát zdrojového kódu integrace Gitu.

Funkce uživatelských dat v kanálech nasazení

Kanály nasazení můžete použít k nasazení funkcí uživatelských dat v různých prostředích, jako je vývoj, testování a produkce. Kanály nasazení pomáhají zjednodušit proces vývoje, zajistit kvalitu a konzistenci a omezit ruční chyby pomocí jednoduchých operací s nízkým kódem.

Poznámka:

Všechna připojení a knihovny se přidají do nových položek uživatelských datových funkcí vytvořených v jiných prostředích.

Pro nasazení funkcí uživatelských dat pomocí nasazovacího kanálu:

  1. Vytvořte nový kanál nasazení nebo otevřete existující kanál nasazení. Další informace naleznete v části Začínáme s kanály nasazení.

  2. Přiřaďte pracovní prostory k různým fázím podle cílů nasazení.

  3. Vyberte, zobrazte a porovnejte položky včetně položek funkcí uživatelských dat mezi různými fázemi.

  4. Vyberte Nasadit a nasaďte položku funkcí uživatelských dat do testovacího prostředí. Přidáním poznámky můžete zadat podrobnosti o změnách tohoto nasazení. Podobně můžete změny prosadit ve fázích Vývoj, Testování a Produkce.

  5. Monitorování stavu nasazení z historie nasazení.