Ajánlott eljárások az U-SQL-szerelvények CI/CD-folyamatokban való kezeléséhez

  • Cikk

Ebből a cikkből megtudhatja, hogyan kezelheti az U-SQL-szerelvény forráskódját az újonnan bevezetett U-SQL-adatbázisprojekttel. Azt is megtudhatja, hogyan állíthat be egy folyamatos integrációs és üzembehelyezési (CI/CD) folyamatot a szerelvényregisztrációhoz az Azure DevOps használatával.

Fontos

Az Azure Data Lake Analytics 2024. február 29-én megszűnt. További információ ezzel a bejelentéssel.

Az adatelemzéshez a szervezet használhatja a Azure Synapse Analyticset vagy a Microsoft Fabricet.

Az U-SQL-adatbázisprojekt használata a szerelvény forráskódjának kezeléséhez

Az U-SQL-adatbázisprojekt a Visual Studio egyik projekttípusa, amely segít a fejlesztőknek az U-SQL-adatbázisok gyors és egyszerű fejlesztésében, kezelésében és üzembe helyezésében. Az U-SQL-adatbázisprojekttel (a hitelesítő adatok kivételével) az összes U-SQL-adatbázisobjektumot kezelheti.

A C#-szerelvény forráskódjának és szerelvényregisztrációs DDL U-SQL-szkriptjeinek kezeléséhez használja a következőt:

  • U-SQL-adatbázisprojekt a szerelvényregisztrációs U-SQL-szkriptek kezeléséhez.
  • Osztálykódtár (U-SQL-alkalmazás esetén) a C#-forráskód és a felhasználó által definiált operátorok, függvények és összesítők (UGO-k, UDF-ek és UDF-ek) függőségeinek kezeléséhez.
  • U-SQL-adatbázisprojekt az Osztálytár projektre való hivatkozáshoz.

Az U-SQL-adatbázisprojektek hivatkozhatnak egy Osztálytár (U-SQL-alkalmazás) projektre. Az U-SQL-adatbázisban regisztrált szerelvényeket a class library (For U-SQL Application) projekt hivatkozott C#-forráskódjának használatával hozhatja létre.

Kövesse ezeket a lépéseket projektek létrehozásához és hivatkozások hozzáadásához.

  1. Hozzon létre egy osztálytár -projektet (U-SQL-alkalmazáshoz) azÚj>projekt fájl> lehetőséget választva. A projekt az Azure Data Lake > U-SQL-csomópont alatt található.

    Data Lake Tools for Visual Studio – C#-osztálykódtár létrehozása projekt

  2. Adja hozzá a felhasználó által definiált C#-kódot a Class Library (For U-SQL Application) projektben.

  3. Hozzon létre egy U-SQL-projektet a Fájl>új>projekt elem kiválasztásával. A projekt az Azure Data Lake>U-SQL-csomópont alatt található.

    Data Lake Tools for Visual Studio –U-SQL-adatbázisprojekt létrehozása

  4. Adjon hozzá egy hivatkozást az U-SQL-adatbázisprojekt C#-osztálykódtár-projektéhez.

    Data Lake Tools for Visual Studio – Referencia hozzáadása

    Data Lake Tools for Visual Studio – U-SQL-adatbázis projektreferenciájának hozzáadása

  5. Hozzon létre egy szerelvényszkriptet az U-SQL-adatbázisprojektben. Ehhez kattintson a jobb gombbal a projektre, és válassza az Új elem hozzáadása lehetőséget.

    Data Lake Tools for Visual Studio – Szerelvényszkript hozzáadása

  6. Nyissa meg a szerelvényszkriptet a szerelvénytervező nézetben. Válassza ki a hivatkozott szerelvényt a Szerelvény létrehozása a referencia legördülő menüből .

    Data Lake Tools for Visual Studio – szerelvény létrehozása referencia alapján

  7. Ha vannak ilyenek, adjon hozzá felügyelt függőségeket és további fájlokat. Ha további fájlokat ad hozzá, az eszköz a relatív elérési utat használja annak érdekében, hogy később megtalálja a szerelvényeket a helyi gépen és a buildelési gépen.

@_DeployTempDirectory a szerkesztőablak alján egy előre definiált változó, amely az eszközt a build kimeneti mappájára helyezija. A build kimeneti mappájában minden szerelvénynek van egy nevű almappája a szerelvény nevével. Az almappában minden DLL és további fájl található.

U-SQL-adatbázisprojekt létrehozása

Egy U-SQL-adatbázisprojekt buildkimenete egy U-SQL-adatbázis üzembehelyezési csomagja. A neve a utótaggal .usqldbpackvan elnevezve. A .usqldbpack csomag egy .zip fájl, amely egyetlen U-SQL-szkriptben tartalmazza az összes DDL-utasítást a DDL mappában. Az összes beépített .dll fájl és a szerelvényekhez tartozó további fájlok a Temp mappában találhatók.

U-SQL-adatbázis üzembe helyezése

A .usqldbpack csomag üzembe helyezhető egy helyi fiókban vagy egy Azure Data Lake Analytics-fiókban. Használja a Visual Studiót vagy az üzembehelyezési SDK-t.

U-SQL-adatbázis üzembe helyezése a Visual Studióban

U-SQL-adatbázist U-SQL-adatbázisprojekt vagy .usqldbpack csomag használatával helyezhet üzembe a Visual Studióban.

Üzembe helyezés U-SQL-adatbázisprojekt használatával

  1. Kattintson a jobb gombbal az U-SQL-adatbázisprojektre, majd válassza az Üzembe helyezés parancsot.

  2. Az U-SQL Database üzembe helyezése varázslóban válassza ki azt az ADLA-fiókot, amelyre telepíteni szeretné az adatbázist. A helyi és az ADLA-fiókok is támogatottak.

  3. Az adatbázis-forrás automatikusan ki van töltve. A projekt build kimeneti mappájában található .usqldbpack csomagra mutat.

  4. Adjon meg egy nevet az Adatbázis neve mezőben az adatbázis létrehozásához. Ha már létezik ilyen nevű adatbázis a cél Azure Data Lake Analytics-fiókban, az adatbázis-projektben definiált összes objektum az adatbázis újbóli létrehozása nélkül jön létre.

  5. Az U-SQL-adatbázis üzembe helyezéséhez válassza a Küldés lehetőséget. A rendszer feltölt minden erőforrást, például szerelvényeket és további fájlokat. A rendszer elküld egy U-SQL-feladatot, amely tartalmazza az összes DDL-utasítást.

    Data Lake Tools for Visual Studio –U-SQL-adatbázisprojekt üzembe helyezése

    Data Lake Tools for Visual Studio – U-SQL-adatbázisprojekt üzembe helyezése varázsló

U-SQL-adatbázis üzembe helyezése az Azure DevOpsban

PackageDeploymentTool.exe biztosítja az U-SQL-adatbázisok üzembe helyezését segítő programozási és parancssori felületeket. Az SDK a következő helyen build/runtime/PackageDeploymentTool.exetalálható U-SQL SDK NuGet-csomag része: .

Az Azure DevOpsban egy parancssori feladat és ez az SDK használatával állíthat be egy automatizálási folyamatot az U-SQL-adatbázis frissítéséhez. További információ az SDK-ról és egy CI/CD-folyamat beállításáról az U-SQL-adatbázis üzembe helyezéséhez.

Következő lépések