U-SQL-adatbázisprojekt használata U-SQL-adatbázis fejlesztéséhez az Azure Data Lake-hez
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ázis strukturált nézeteket biztosít a strukturálatlan adatokhoz és a felügyelt strukturált adatokhoz a táblákban. Emellett általános metaadatkatalógus-rendszert is biztosít a strukturált adatok és az egyéni kód rendszerezéséhez. Az adatbázis az a fogalom, amely csoportosítja ezeket a kapcsolódó objektumokat.
További információ az U-SQL-adatbázisról és az adatdefiníciós nyelvről (DDL).
Az U-SQL-adatbázisprojekt a Visual Studio egyik projekttípusa, amely segít a fejlesztőknek a U-SQL-adatbázisok gyors és egyszerű fejlesztésében, kezelésében és üzembe helyezésében.
U-SQL-adatbázisprojekt létrehozása
Az Azure Data Lake Tools for Visual Studio a 2.3.3000.0-s verzió után hozzáadott egy U-SQL-adatbázisprojekt nevű új projektsablont. U-SQL-projekt létrehozásához válassza az Új > projekt fájlja >lehetőséget. Az U-SQL Database Project az Azure Data Lake > U-SQL csomópont alatt található.
U-SQL-adatbázisobjektumok fejlesztése adatbázisprojekt használatával
Kattintson a jobb gombbal az U-SQL-adatbázisprojektre. Válassza az Új elem hozzáadása >lehetőséget. Az összes új támogatott objektumtípust megtalálhatja az Új elem hozzáadása varázslóban.
Nem szerelvényobjektumok (például táblaértékű függvények) esetén új U-SQL-szkript jön létre egy új elem hozzáadása után. A szerkesztőben megkezdheti az objektum DDL-utasításának fejlesztését.
Szerelvényobjektumok esetén az eszköz egy felhasználóbarát felhasználói felületi szerkesztőt biztosít, amely segít a szerelvény regisztrálásában és a DLL-fájlok és más fájlok üzembe helyezésében. Az alábbi lépések bemutatják, hogyan adhat hozzá szerelvényobjektum-definíciót az U-SQL-adatbázisprojekthez:
Adjon hozzá olyan C#-projektre mutató hivatkozásokat, amelyek tartalmazzák az UDO/UDAG/UDF fájlt az U-SQL-adatbázisprojekthez.
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 .
Adjon hozzá felügyelt függőségeket és további fájlokat , ha vannak ilyenek. Ha további fájlokat ad hozzá, az eszköz a relatív elérési út használatával biztosítja, hogy a szerelvények a helyi gépen és a buildelési gépen is megtalálhatók legyenek később.
@_DeployTempDirectory 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, amelynek neve szerelvénynévvel rendelkezik. 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, amelynek utótagja .usqldbpack
. A .usqldbpack
csomag egy .zip fájl, amely tartalmazza az összes DDL-utasítást egyetlen U-SQL-szkriptben a DDL mappában, valamint az összes DLL-t és a temp mappában lévő szerelvényekhez tartozó további fájlokat.
További információ arról , hogyan hozhat létre U-SQL-adatbázisprojektet az MSBuild parancssor és egy Azure DevOps Services buildelési feladat használatával.
U-SQL-adatbázis üzembe helyezése
Az .usqldbpack csomag üzembe helyezhető egy helyi fiókban vagy egy Azure Data Lake Analytics-fiókban a Visual Studióval vagy az üzembehelyezési SDK-val.
U-SQL-adatbázis üzembe helyezése a Visual Studióban
U-SQL-adatbázist U-SQL-adatbázisprojekten vagy .usqldbpack csomagon keresztül helyezhet üzembe a Visual Studióban.
Üzembe helyezés U-SQL-adatbázisprojekten keresztül
Kattintson a jobb gombbal az U-SQL-adatbázisprojektre, majd válassza az Üzembe helyezés lehetőséget.
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.
Az adatbázis-forrás automatikusan ki van töltve, és a projekt buildkimeneti mappájában található .usqldbpack csomagra mutat.
Adjon meg egy nevet az Adatbázis neve mezőben egy 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ázisprojektben definiált összes objektum az adatbázis újra létrehozása nélkül jön létre.
Az U-SQL-adatbázis üzembe helyezéséhez válassza a Küldés lehetőséget. A rendszer feltölti az összes erőforrást (szerelvényeket és további fájlokat), és elküld egy U-SQL-feladatot, amely tartalmazza az összes DDL-utasítást.
Üzembe helyezés U-SQL-adatbázis üzembehelyezési csomagon keresztül
Nyissa meg a Kiszolgálókezelőt. Ezután bontsa ki azt az Azure Data Lake Analytics-fiókot, amelyre telepíteni szeretné az adatbázist.
Kattintson a jobb gombbal az U-SQL-adatbázisok elemre, vagy tartsa lenyomva, majd válassza az Adatbázis üzembe helyezése parancsot.
Állítsa az Adatbázis forrása beállítást az U-SQL-adatbázis üzembehelyezési csomagjának (.usqldbpack fájl) elérési útjára.
Adja meg az adatbázis nevét az adatbázis létrehozásához. Ha a cél Azure-Data Lake Analytics-fiókban már létezik egy adatbázis, az adatbázisprojektben definiált összes objektum az adatbázis újra létrehozása nélkül jön létre.
U-SQL-adatbázis üzembe helyezése az SDK használatával
PackageDeploymentTool.exe
A 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.exe
található U-SQL SDK NuGet-csomagban található: .
U-SQL-adatbázisprojektre való hivatkozás
Egy U-SQL-projekt hivatkozhat egy U-SQL-adatbázisprojektre. A hivatkozás két számítási feladatot érint:
- Projekt összeállítása: A hivatkozott adatbázis-környezetek beállítása az U-SQL-szkriptek létrehozása előtt.
- Helyi futtatás (helyi projekt) fiókon: A hivatkozott adatbázis-környezetek az U-SQL-szkript végrehajtása előtt lesznek üzembe helyezve egy (helyi projektbeli) fiókban. Itt talál további információt a helyi futtatásokról, valamint a (helyi gép) és a (helyi projekt) fiók közötti különbségről.
U-SQL-adatbázis referenciáinak hozzáadása
Kattintson a jobb gombbal az U-SQL-projektre a Megoldáskezelő, majd válassza az U-SQL Database hivatkozás hozzáadása... parancsot.
Adatbázis-referenciát konfigurálhat egy U-SQL-adatbázisprojektből az aktuális megoldásban vagy egy U-SQL-adatbáziscsomagfájlban.
Adja meg az adatbázis nevét.