Zdieľať cez


Integrácia knižnice premenných s kanálmi

Knižnica premenných je nový typ položky v Microsoft Fabric, ktorý umožňuje používateľom definovať a spravovať premenné na úrovni pracovného priestoru, takže ich možno čoskoro používať v rôznych položkách pracovného priestoru, ako sú kanály, poznámkové bloky, Skratka pre jazero a ďalšie. Poskytuje jednotný a centralizovaný spôsob spravovania konfigurácií, ktorý znižuje potrebu pevne zakódovaných hodnôt a zjednodušuje procesy CI/CD, čo uľahčuje správu konfigurácií v rôznych prostrediach.

Ako používať knižnicu premenných s kanálmi

  1. Prejdite do svojho pracovného priestoru a vytvorte novú položku.

    Snímka obrazovky, ktorá znázorňuje, kam sa má pridať nová položka v pracovnom priestore služby Fabric zvýraznená.

  2. Pomocou filtra nájdite knižnicu premenných alebo sa posuňte nadol do časti Vyvinúť údaje.

    Snímka obrazovky zobrazujúca filter pre novú položku knižnice premenných.

  3. Vyberte položku Knižnica premenných a vytvorte novú knižnicu premenných. Vyberte názov a stlačte tlačidlo Vytvoriť.

    Snímka obrazovky zobrazujúca novú položku knižnice premenných so skupinou názvov a zvýrazneným tlačidlom Vytvoriť.

  4. Po vytvorení knižnice Premenná sa dostanete na domovskú stránku. Kliknutím na + Nový pridáte novú premennú.

    Snímka obrazovky zobrazujúca úvodnú stránku pre novú položku knižnice premenných.

  5. Po pridaní novej premennej môžete túto premennú nakonfigurovať a nastaviť množinu hodnôt Name (Názov), Type (Typ) a Default (Predvolená hodnota). Môžete tiež pridať Poznámky.

    Snímka obrazovky zobrazujúca konfigurácie nastavené pre novú premennú.

  6. Pridajte alternatívne množiny hodnôt podľa potreby (napríklad rôzne hodnoty pre rôzne prostredia kanálov nasadenia). Po nastavení názvu a kliknutí na tlačidlo Vytvoriť môžete upraviť hodnoty premenných a vybrať hodnotu nastavenú na aktiváciu.

    Snímka obrazovky so zvýraznením miesta pridania novej množiny hodnôt pre premennú.

    Snímka obrazovky, ktorá znázorňuje, ako pridať názov pre novú množinu hodnôt.

  7. Po dokončení uložte zmeny.

Snímka obrazovky znázorňujúca tlačidlo Uložiť zvýraznené v ľavom hornom rohu.

Používanie premenných knižnice premenných v kanáli

  1. Ak chcete v kanáli použiť premennú knižnice premennej, vytvorte nový kanál alebo prejdite do existujúceho kanála.

    Snímka obrazovky zvýrazňujúca tlačidlo vytvoriť novú položku v ľavom hornom rohu a zvýraznenú položku kanála.

  2. V kanáli musíte vytvoriť odkaz na premennú knižnice premenných na spodnom paneli.

    Snímka obrazovky zvýrazňujúca kartu Premenné knižnice a tlačidlo +Nové na spodnom paneli plátna kanála.

  3. Po kliknutí na tlačidlo + Nové sa otvorí kontextové okno so všetkými knižnicami premenných. Pomocou tohto výberu môžete vybrať premennú knižnice premenných a kliknúť na tlačidlo OK.

    Zvýraznená snímka obrazovky zobrazujúca tlačidlo +Nové na karte Premenná knižnice.

    Snímka obrazovky zobrazujúca premennú knižnice vybratú vo výbere premennej.

    Snímka obrazovky zobrazujúca konfiguráciu množiny pre nový odkaz na premennú knižnice.

  4. Po pridaní odkazov na premenné knižnice pridajte aktivity kanála. V nastaveniach aktivity kliknite na položku Pridať dynamický obsah pre nastavenie, ktoré chcete parametrizovať.

    Snímka obrazovky znázorňujúca položku Pridať dynamický obsah zvýraznený v nastaveniach aktivity vyhľadávania.

  5. Otvorí sa zostavovač výrazov. Ak sa položka Premenné knižnice nezobrazuje, kliknite na 3 bodky vedľa položky Funkcie a vyberte položku Premenné knižnice.

    Snímka obrazovky zobrazujúca 3 bodky vedľa položky Funkcie v nástroji na tvorbu výrazov a zvýraznenú kartu Premenné knižnice.

  6. Kliknutím na odkaz na premennú knižnice pridáte nový výraz do zostavovača výrazov. Potom kliknutím na tlačidlo OK pridajte výraz.

    Snímka obrazovky znázorňujúca odkaz na premennú knižnice zvýraznený na pridanie do zostavovača výrazov.

    Snímka obrazovky zobrazujúca množinu výrazov v zostavovači výrazov.

  7. Teraz uvidíte, že dynamický obsah sa pridá do nastavenia aktivity.

    Snímka obrazovky zobrazujúca výraz nastavený ako dynamický obsah v nastaveniach aktivity vyhľadávania.

  8. Ukážku údajov si môžete pozrieť kliknutím na položku Ukážka údajov. Otvorí sa nová tabla, ktorá zobrazuje hodnotu premennej knižnice. Kliknutím na tlačidlo OK zobrazíte ukážku svojich údajov.

    Snímka obrazovky zobrazujúca možnosť ukážky údajov.

    Snímka obrazovky zobrazujúca tablu s údajmi ukážky.

  9. Uložte a spustite kanál tak, ako by ste to urobili za normálnych okolností. V knižnici Premenná uvidíte, že odovzdaná hodnota je nastavená ako Aktívna.

    Snímka obrazovky zobrazujúca nastavenia Uložiť a Spustiť zvýraznené na plátne kanála.

Známe obmedzenia

Na integráciu knižnice Variable v kanáloch služby Data Factory v službe Microsoft Fabric sa vzťahujú tieto známe obmedzenia:

  • Knižnica premenných podporuje booleovskú hodnotu, dátum a čas, identifikátor GUID, celé číslo, číslo a reťazec ako typy údajov. Vo vašom kanáli uvidíte Boolean ako typ Bool, Datetime ako typ reťazca, Guid ako typ reťazca, Celé číslo ako typ Int a Reťazec ako typ reťazca. Typy čísel nie sú v kanáloch podporované.
  • Parametrizácia externého pripojenia je podporovaná premennou knižnicou integrovanou s pipelines. V nastaveniach však musíte vyhľadať identifikátor GUID pre vaše pripojenie | Spravujte pripojenia a brány. Tam nájdete identifikátor GUID pripojenia výberom položky Nastavenia vedľa názvu pripojenia.