Verziókövetés a Synapse Stúdióban

Alapértelmezés szerint a Synapse Studio közvetlenül a Synapse szolgáltatással szemben ír. Ha együttműködésre van szüksége a Gittel a forráskezeléshez, a Synapse Studio lehetővé teszi a munkaterület git-adattárhoz, Azure DevOpshoz vagy GitHubhoz való társítást.

Ez a cikk azt ismerteti, hogyan konfigurálhat és dolgozhat a Synapse-munkaterületen, ha engedélyezve van a Git-adattár. Emellett kiemelünk néhány ajánlott eljárást és egy hibaelhárítási útmutatót is.

Megjegyzés:

Ha a GitHubot az Azure Gov-ban és a 21Vianet által üzemeltetett Microsoft Azure-ban szeretné használni, saját GitHub OAuth-alkalmazást is használhat a Synapse Studióban a Git-integrációhoz. A konfigurálási élmény az ADF-ben is megegyezik. Tekintse meg a bejelentési blogot.

Előfeltételek

A felhasználóknak azure-közreműködői (Azure RBAC) vagy magasabb szerepkörrel kell rendelkezniük a Synapse-munkaterületen a beállítások konfigurálásához, szerkesztéséhez és a Git-adattár synapse-nal való leválasztásához.

Git-adattár konfigurálása a Synapse Studióban

A Synapse Studio elindítása után konfigurálhat egy git-adattárat a munkaterületen. A Synapse Studio-munkaterületek egyszerre csak egy Git-adattárhoz társíthatók.

1. konfigurációs módszer: globális sáv

A Synapse Studio globális sávjában válassza a Synapse Live legördülő menüt, majd válassza a Kódtár beállítása lehetőséget.

2. konfigurációs módszer: Központ kezelése

Nyissa meg a Synapse Studio Felügyeleti központját. Válassza a Git-konfigurációt a Forrásvezérlő szakaszban. Ha nincs csatlakoztatva adattár, kattintson a Konfigurálás gombra.

Csatlakoztathatja az Azure DevOps vagy a GitHub Git-adattárat a munkaterületen.

Csatlakozás az Azure DevOps Gittel

A Synapse-munkaterületeket hozzárendelheti egy Azure DevOps-adattárhoz a forrásvezérlés, az együttműködés, a verziószámozás és így tovább. Ha nem rendelkezik Azure DevOps-adattárral, kövesse ezeket az utasításokat az adattár erőforrásainak létrehozásához.

Az Azure DevOps Git-adattár beállításai

A git-adattárhoz való csatlakozáskor először válassza ki az adattár típusát Azure DevOps gitként, majd válasszon ki egy Microsoft Entra-bérlőt a legördülő listából, és kattintson a Folytatás gombra.

A konfigurációs panel a következő Azure DevOps git-beállításokat jeleníti meg:

Beállítás	Description	Value
Adattár típusa	Az Azure Repos-kódtár típusa.	Azure DevOps Git vagy GitHub
Bérlőközi bejelentkezés	A bérlők közötti fiókkal való bejelentkezéshez jelölje be a jelölőnégyzetet.	nincs kijelölve (alapértelmezett)
Microsoft Entra-azonosító	A Microsoft Entra-bérlő neve.	<your tenant name>
Azure DevOps-fiók	Az Azure Repos-szervezet neve. Az Azure Repos-szervezet nevét a következő helyen https://{organization name}.visualstudio.comtalálja: . Az Azure Repos-szervezetbe bejelentkezve hozzáférhet a Visual Studio-profiljához, és megtekintheti az adattárait és projektjeit.	<your organization name>
ProjectName	Az Azure Repos-projekt neve. Az Azure Repos-projekt nevét a következő helyen https://{organization name}.visualstudio.com/{project name}találja: .	<your Azure Repos project name>
Adattár neve	Az Azure Repos-kódtár neve. Az Azure Repos-projektek Git-adattárakat tartalmaznak a forráskódnak a projekt növekedésével való kezeléséhez. Létrehozhat egy új adattárat, vagy használhat egy meglévő adattárat, amely már szerepel a projektben.	<your Azure Repos code repository name>
Együttműködési ág	A közzétételhez használt Azure Repos együttműködési ág. Alapértelmezés szerint a saját master. Módosítsa ezt a beállítást, ha egy másik ágból szeretne erőforrásokat közzétenni. Kiválaszthatja a meglévő ágakat, vagy újakat hozhat létre	<your collaboration branch name>
Gyökérmappa	A gyökérmappa az Azure Repos együttműködési ágában.	<your root folder name>
Meglévő erőforrások importálása az adattárba	Megadja, hogy importálja-e a meglévő erőforrásokat a Synapse Studióból egy Azure Repos Git-adattárba. Jelölje be a jelölőnégyzetet, ha a munkaterület erőforrásait (a készletek kivételével) JSON formátumban szeretné importálni a társított Git-adattárba. Ez a művelet egyenként exportálja az egyes erőforrásokat. Ha ez a jelölőnégyzet nincs bejelölve, a rendszer nem importálja a meglévő erőforrásokat.	Bejelölve (alapértelmezett)
Erőforrás importálása ebbe az ágba	Válassza ki, hogy melyik ágba importálja a rendszer az erőforrásokat (SQL-szkript, jegyzetfüzet, Spark-feladatdefiníció, adathalmaz, adatfolyam stb.).

Az adattár hivatkozásával gyorsan rámutathat arra a git-adattárra, amelyhez csatlakozni szeretne.

Megjegyzés:

Az Azure Synapse nem támogatja a Prem Azure DevOps-adattárral való kapcsolatot.

Másik Microsoft Entra-bérlő használata

Az Azure Repos Git-adattár egy másik Microsoft Entra-bérlőben lehet. Egy másik Microsoft Entra-bérlő megadásához rendszergazdai engedélyekkel kell rendelkeznie a használt Azure-előfizetéshez. További információ: az előfizetés-rendszergazda módosítása

Fontos

Egy másik Microsoft Entra-azonosítóhoz való csatlakozáshoz a bejelentkezett felhasználónak az active directory egy részének kell lennie.

A személyes Microsoft-fiók használata

Ha személyes Microsoft-fiókot szeretne használni a Git-integrációhoz, csatolhatja személyes Azure-adattárát a szervezet Active Directoryjához.

1. Vegye fel a személyes Microsoft-fiókját a szervezet Active Directoryjába vendégként. További információ: Microsoft Entra B2B együttműködési felhasználók hozzáadása az Azure Portalon.

2. Jelentkezzen be az Azure Portalra személyes Microsoft-fiókjával. Ezután váltson a szervezet Active Directoryjára.

3. Nyissa meg az Azure DevOps szakaszt, ahol most már láthatja a személyes adattárát. Válassza ki az adattárat, és csatlakozzon az Active Directoryhoz.

A konfigurációs lépések után a személyes adattár a Git-integráció Synapse Studióban való beállításakor érhető el.

Az Azure-adattáraknak a szervezet Active Directoryhoz való csatlakoztatásáról további információt a szervezet Csatlakozás a Microsoft Entra-azonosítóhoz című témakörben talál.

Bérlők közötti Azure DevOps-fiók használata

Ha az Azure DevOps nem ugyanabban a bérlőben van, mint a Synapse-munkaterület, konfigurálhatja a munkaterületet bérlők közötti Azure DevOps-fiókkal.

1. Válassza a Bérlőközi bejelentkezés lehetőséget, és kattintson a Folytatás gombra

   

2. Válassza az OK gombot a párbeszédpanelen.

   

3. kattintson a Másik fiók használata elemre, és jelentkezzen be az Azure DevOps-fiókjával.

   

4. Bejelentkezés után válassza ki a könyvtárat és az adattárat, és ennek megfelelően konfigurálja.

   

   Megjegyzés:

   A munkaterület bejelentkezéséhez az első bejelentkezéssel kell bejelentkeznie a Synapse-munkaterület felhasználói fiókjába. A bérlők közötti Azure DevOps-fiók csak a Synapse-munkaterülethez társított Azure DevOps-adattárba való bejelentkezéshez és hozzáféréshez használható.

Csatlakozás a GitHubbal

A munkaterületeket hozzárendelheti egy GitHub-adattárhoz a forráskövetéshez, az együttműködéshez és a verziószámozáshoz. Ha nincs GitHub-fiókja vagy adattára, kövesse az alábbi utasításokat az erőforrások létrehozásához.

A GitHub és a Synapse Studio integrációja egyaránt támogatja a nyilvános GitHubot (vagyis https://github.com) és a GitHub Enterprise-t. Mind a nyilvános, mind a privát GitHub-adattárakat használhatja mindaddig, amíg olvasási és írási engedéllyel rendelkezik a GitHub adattárához.

GitHub-beállítások

A Git-adattárhoz való csatlakozáskor először válassza ki az adattár típusát GitHubként, majd adja meg a GitHub-fiókját, a GitHub Enterprise Server URL-címét, ha GitHub Enterprise Servert használ, vagy a GitHub Enterprise-szervezet nevét, ha a GitHub Enterprise Cloudot használja. Válassza a Folytatás lehetőséget.

Megjegyzés:

Ha GitHub Enterprise Cloudot használ, hagyja üresen a GitHub Enterprise Server használata jelölőnégyzetet.

A konfigurációs panel a következő GitHub-adattár-beállításokat jeleníti meg:

Beállítás	Ismertetés	Érték
Adattár típusa	Az Azure Repos-kódtár típusa.	GitHub
A GitHub Enterprise használata	Jelölőnégyzet a GitHub Enterprise kiválasztásához	nincs kijelölve (alapértelmezett)
GitHub Enterprise URL-címe	A GitHub Enterprise gyökér URL-címe (a helyi GitHub Enterprise-kiszolgálóhoz HTTPS-nek kell lennie). For example: https://github.mydomain.com. Csak akkor szükséges, ha a GitHub Enterprise használata ki van választva	<your GitHub enterprise url>
GitHub-fiók	A GitHub-fiók neve. Ez a név a name}/{repository name} fájlból https://github.com/{account származik. A lapra lépve a GitHub OAuth hitelesítő adatainak megadását kéri a GitHub-fiókba.	<your GitHub account name>
Adattár neve	A GitHub-kódtár neve. A GitHub-fiókok Git-adattárakat tartalmaznak a forráskód kezeléséhez. Létrehozhat egy új adattárat, vagy használhat egy meglévő adattárat, amely már szerepel a fiókjában.	<your repository name>
Együttműködési ág	A közzétételhez használt GitHub-együttműködési ág. Alapértelmezés szerint a főkiszolgáló. Módosítsa ezt a beállítást, ha egy másik ágból szeretne erőforrásokat közzétenni.	<your collaboration branch>
Gyökérmappa	A GitHub együttműködési ág gyökérmappája.	<your root folder name>
Meglévő erőforrások importálása az adattárba	Megadja, hogy importálja-e a meglévő erőforrásokat a Synapse Studióból egy Git-adattárba. Jelölje be a jelölőnégyzetet, ha a munkaterület erőforrásait (a készletek kivételével) JSON formátumban szeretné importálni a társított Git-adattárba. Ez a művelet egyenként exportálja az egyes erőforrásokat. Ha ez a jelölőnégyzet nincs bejelölve, a rendszer nem importálja a meglévő erőforrásokat.	Kiválasztva (alapértelmezett)
Erőforrás importálása ebbe az ágba	Válassza ki, hogy melyik ágba importálja az erőforrásokat (SQL-szkript, jegyzetfüzet, Spark-feladatdefiníció, adatkészlet, adatfolyam stb.).

GitHub-szervezetek

Csatlakozás GitHub-szervezethez való hozzáféréshez a szervezetnek engedélyt kell adnia a Synapse Studiónak. A szervezet rendszergazdai engedélyekkel rendelkező felhasználójának végre kell hajtania az alábbi lépéseket.

Connecting to GitHub for the first time

Ha első alkalommal csatlakozik a GitHubhoz a Synapse Studióból, az alábbi lépéseket követve csatlakozhat egy GitHub-szervezethez.

1. A Git konfigurációs paneljén adja meg a szervezet nevét a GitHub-fiók mezőben. Megjelenik egy parancssor a GitHubra való bejelentkezéshez.

2. Jelentkezzen be a felhasználói hitelesítő adatokkal.

3. A rendszer arra kéri, hogy engedélyezze a Synapse-t egy Azure Synapse nevű alkalmazásként. Ezen a képernyőn megjelenik egy lehetőség, amely engedélyt ad a Synapse számára a szervezethez való hozzáféréshez. Ha nem látja az engedély megadásának lehetőségét, kérje meg a rendszergazdát, hogy manuálisan adja meg az engedélyt a GitHubon keresztül.

Miután követte ezeket a lépéseket, a munkaterület képes csatlakozni a szervezeten belüli nyilvános és privát adattárakhoz is. Ha nem tud csatlakozni, próbálja meg törölni a böngésző gyorsítótárát, és próbálkozzon újra.

Már csatlakozott a GitHubhoz egy személyes fiók használatával

Ha már csatlakozott a GitHubhoz, és csak személyes fiók elérésére adott engedélyt, az alábbi lépéseket követve adjon engedélyeket egy szervezetnek.

1. Nyissa meg a GitHubot, és nyissa meg a Gépház.

   

2. Válassza az Alkalmazások lehetőséget. Az Engedélyezett OAuth-alkalmazások lapon látnia kell az Azure Synapse-t.

   

3. Válassza ki az Azure Synapse-t , és adjon hozzáférést a szervezetnek.

   

Miután elvégezte ezeket a lépéseket, a munkaterület képes csatlakozni a szervezet nyilvános és privát adattáraihoz is.

Verziókövetés

A verziókövetési rendszerek (más néven forrásvezérlők) lehetővé teszik a fejlesztők számára, hogy együttműködjenek a kóddal és nyomon kövessék a módosításokat. A forráskontroll a többfejlesztős projektek alapvető eszköze.

Szolgáltatáságak létrehozása

A Synapse Studióhoz társított összes Git-adattár rendelkezik együttműködési ággal. (main vagy master ez az alapértelmezett együttműködési ág). A felhasználók funkcióágakat is létrehozhatnak, ha az ág legördülő menüjében az + Új ág elemre kattintanak.

Az új ág panel megjelenése után adja meg a szolgáltatáság nevét, és válasszon ki egy ágat, amelyből a munka ki van kapcsolva.

Ha készen áll a funkcióág módosításainak az együttműködési ágba való egyesítésére, kattintson az ág legördülő listájára, és válassza a Lekéréses kérelem létrehozása lehetőséget. Ez a művelet a Git-szolgáltatóhoz nyitja meg, ahol lekéréses kérelmeket kezdeményezhet, kódvizsgálatokat végezhet, és egyesítheti az együttműködési ág módosításait. Csak az együttműködési ágból tehet közzé a Synapse szolgáltatásban.

Közzétételi beállítások konfigurálása

Alapértelmezés szerint a Synapse Studio létrehozza a munkaterületsablonokat, és menti őket egy úgynevezett workspace_publishágba. Egyéni közzétételi ág konfigurálásához adjon hozzá egy publish_config.json fájlt az együttműködési ág gyökérmappájába. Közzétételkor a Synapse Studio felolvassa ezt a fájlt, megkeresi a mezőt publishBranch, és a munkaterületsablonfájlokat a megadott helyre menti. Ha az ág nem létezik, a Synapse Studio automatikusan létrehozza. Az alábbi példa a fájl megjelenésére:

{
    "publishBranch": "workspace_publish"
}

A Synapse Studio egyszerre csak egy közzétételi ággal rendelkezhet. Ha új közzétételi ágat ad meg, az eredeti közzétételi ág nem lesz törölve. Ha el szeretné távolítani az előző közzétételi ágat, törölje manuálisan.

Kódmódosítások közzététele

Az együttműködési ág módosításainak egyesítése után a Közzététel gombra kattintva manuálisan közzéteheti a kódmódosításokat az együttműködési ágban a Synapse szolgáltatásban.

Megnyílik egy oldalpanel, ahol meggyőződhet arról, hogy a közzétételi ág és a függőben lévő módosítások helyesek. A módosítások ellenőrzése után kattintson az OK gombra a közzététel megerősítéséhez.

Fontos

Az együttműködési ág nem reprezentatív a szolgáltatásban üzembe helyezett szolgáltatásokra. Az együttműködési ág módosításait manuálisan kell közzétenni.

Váltás másik Git-adattárra

Ha másik Git-adattárra szeretne váltani, nyissa meg a Git konfigurációs lapját a felügyeleti központban a Forrás vezérlőelem alatt. Válassza a Leválasztás lehetőséget.

Adja meg a munkaterület nevét, és kattintson a Leválasztás gombra a munkaterülethez társított Git-adattár eltávolításához.

Miután eltávolította az aktuális adattárral való társításokat, konfigurálhatja a Git-beállításokat egy másik adattár használatára, majd importálhatja a meglévő erőforrásokat az új adattárba.

Fontos

A Git-konfiguráció munkaterületről való eltávolítása nem töröl semmit az adattárból. A Synapse-munkaterület az összes közzétett erőforrást tartalmazza. A munkaterületet továbbra is szerkesztheti közvetlenül a szolgáltatáson.

Ajánlott eljárások a Git-integrációhoz

• Engedélyek. Miután csatlakozott a munkaterülethez egy Git-adattár, bárki, aki bármilyen szerepkörrel hozzáfér a git-adattárhoz, frissítheti az összetevőket, például sql-szkriptet, jegyzetfüzetet, spark-feladatdefiníciót, adathalmazt, adatfolyamot és folyamatot Git módban. Általában nem szeretné, hogy minden csapattag rendelkezzen engedélyekkel a munkaterület frissítéséhez. Csak a Git-adattár engedélyét adja a Synapse-munkaterület-összetevők szerzőinek.
• Együttműködés. Javasoljuk, hogy ne engedélyezze a közvetlen bejelentkezést az együttműködési ágba. Ez a korlátozás segíthet megelőzni a hibákat, mivel minden bejelentkezés egy lekéréses kérelem felülvizsgálati folyamatán megy keresztül, amelyet a funkcióágak létrehozása című szakaszban ismertet.
• Synapse élő mód. A git módban való közzététel után minden módosítás a Synapse élő módban jelenik meg. Synapse élő módban a közzététel le van tiltva. Élő módban is megtekintheti és futtathatja az összetevőket, ha megkapta a megfelelő engedélyt.
• Összetevők szerkesztése a Studióban. A Synapse Studio az egyetlen hely, ahol engedélyezheti a munkaterület forráskezelését, és automatikusan szinkronizálhatja a módosításokat a gitre. Az SDK-val, a PowerShell-lel történő módosítások nincsenek szinkronizálva a Git szolgáltatással. Javasoljuk, hogy a Git engedélyezése esetén mindig szerkessze az összetevőt a Studióban.

Git-integráció hibaelhárítása

Hozzáférés a git módhoz

Ha engedélyt kapott a munkaterülethez társított GitHub Git-adattárra, de nem fér hozzá a Git módhoz:

1. Törölje a gyorsítótárat, és frissítse a lapot.

2. Jelentkezzen be a GitHub-fiókjába.

Elavult közzétételi ág

Ha a közzétételi ág nincs szinkronizálva az együttműködési ággal, és a legutóbbi közzététel ellenére elavult erőforrásokat tartalmaz, próbálkozzon az alábbi lépésekkel:

1. Az aktuális Git-adattár eltávolítása

2. Konfigurálja újra a Gitet ugyanazokkal a beállításokkal, de győződjön meg arról, hogy a meglévő erőforrások importálása az adattárba be van jelölve, és ugyanazt az ágat választja.

3. Lekéréses kérelem létrehozása a változások együttműködési ágba való egyesítéséhez

Nem támogatott funkciók

• A Synapse Studio nem teszi lehetővé a véglegesítések kiválasztását vagy az erőforrások szelektív közzétételét.
• A Synapse Studio nem támogatja az önszabású véglegesítési üzenetet.
• A studio törlési művelete tervezés szerint közvetlenül a Gitre van kötelezve

Következő lépések

• A folyamatos integráció és üzembe helyezés implementálásához lásd: Folyamatos integráció és teljesítés (CI/CD).