Változókódtárak automatizálása API-k és Azure DevOps használatával (előzetes verzió)

A Microsoft Fabric REST API-kkal teljes mértékben automatizálhatja a változótár-kezelést.

Ha az API-kat az életciklus-felügyelet részeként használja, a Git Update és az üzembe helyezési folyamat üzembe helyezése során ellenőrzi az elemhivatkozási engedélyeket.

Előfeltételek

Az API-k használatához a következőkre van szüksége:

• Ugyanazok az előfeltételek, mint a változótárelem esetében.
• Egy Microsoft Entra-jogkivonat a Fabric szolgáltatáshoz. Használja a tokent az API-hívás engedélyezési fejlécében. A token beszerzésének módjáról a Fabric API rövid útmutatójában olvashat.

Változókönyvtár API-k

A változótár REST API-kkal a következő függvényeket hajthatja végre:

• Változótár létrehozása: Változótár létrehozása a megadott munkaterületen.
• Változótár lekérése: Változótár tulajdonságainak lekérése. Az aktív értékkészletet a VariableLibraryProperties paraméterrel is lekérheti.
• Változótár frissítése: Változótár tulajdonságainak frissítése. Az aktív értékkészletet a VariableLibraryProperties paraméterrel is frissítheti.
• Változótár törlése: Törölje a megadott változótárat.
• Változótárak listázása: Változótárak listázása a megadott munkaterületen.
• Változótár definíciójának lekérése: A változótár nyilvános definíciójának lekérése.
• Változótár definíciójának frissítése: A változótár definíciójának felülbírálása.

A VÁLTOZÓ kódtár elem REST API-k támogatják a szolgáltatás alapelveit.

Példák

Az API-k használatának néhány példáját az egyes API-k REST API-dokumentációjában találja. A változókódtár definícióstruktúrájának részletezéséért lásd a változótár definícióját.

Megfontolások és korlátok

Méretkorlátozások

• Legfeljebb 1000 változó és legfeljebb 1000 értékhalmaz lehet, amennyiben az alternatív értékhalmazokban lévő cellák teljes száma 10 000 cella alatt van, és az elem mérete nem nagyobb 1 MB-nál. Ez akkor lesz érvényesítve, amikor a felhasználó menti a módosításokat.
• A jegyzetmező legfeljebb 2048 karakter hosszúságú lehet.
• Az értékhalmaz leírásmezője legfeljebb 2048 karakter hosszúságú lehet.

Alternatív értékkészlet korlátozásai

• A változótár alternatív értékhalmazai a hozzáadásuk sorrendjében jelennek meg. Jelenleg nem rendezheti át őket a felhasználói felületen. A sorrend módosításához szerkessze közvetlenül a JSON-fájlt.
• Az egyes értékhalmazok nevének egyedinek kell lennie a változótárban.
• A változóneveknek egyedinek kell lenniük a változótárakban. Egy munkaterületen két azonos nevű változót is használhat, ha különböző elemeket tartalmaz.
• A változótárakban egyszerre mindig egy és csak egy aktív érték van beállítva. Az aktív értékkészlet nem törölhető. A törléshez először állítson be egy másik értékkészletet aktívnak. Az üzembehelyezési folyamat egyes szakaszaihoz eltérő aktív értékkészletet állíthat be.