Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:
SQL ServerAzure SQL DatabaseFelügyelt Azure SQL-példánySQL-adatbázis a Microsoft Fabricben
Az SQL-projektek deklaratív (CREATE utasítás) fájlokat tartalmaznak az adatbázis összes objektumához, például táblákhoz, nézetekhez és tárolt eljárásokhoz. Ezek a fájlok felhasználhatók új adatbázisok létrehozására, meglévő adatbázisok frissítésére vagy akár csak az adatbázis forráskövetésben való nyomon követésére. Gyakran egy SQL-projekttel kezdünk, amikor már rendelkezünk egy meglévő adatbázissal, és olyan objektumokat szeretnénk létrehozni az SQL-projektben, amelyek minimális erőfeszítéssel megfelelnek az adatbázisnak.
Egyes SQL-projektek eszközei egyetlen lépést tartalmaznak egy új SQL-projekt meglévő adatbázisból való létrehozásához. Más eszközökhöz szükség van néhány lépésre egy új SQL-projekt létrehozásához, majd objektumok importálásához egy meglévő adatbázisból. A Visual Studio (SQL Server Data Tools) utasításain kívül az útmutató az SDK-stílusú SQL-projektekre összpontosít.
Ebben az oktatóanyagban a(z) 1. lehetőség esetében Ön:
1. lépés: új SQL-projekt létrehozása meglévő adatbázisból 2. lépés: sql-projekt létrehozása
Ezzel az oktatóanyaggal, a 2. lehetőséggel :
- 1. lépés: új üres SQL-projekt létrehozása
- 2. lépés: objektumok importálása meglévő adatbázisból
- 3. lépés: az SQL-projekt létrehozása
Prerequisites
- .NET 8 SDK
- Visual Studio 2022 Community, Professional vagy Enterprise kiadás
- Visual Studio 2022-ben telepített SDK-stílusú (előzetes verziójú) SQL Server Data Tools
- SqlPackage parancssori felület
# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage
# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage
# install Microsoft.Build.Sql.Templates
dotnet new install Microsoft.Build.Sql.Templates
Note
Az oktatóanyag elvégzéséhez hozzá kell férnie egy Azure SQL- vagy SQL Server-példányhoz. Helyileg ingyenesen fejleszthet SQL Server fejlesztői kiadással Windowson vagy tárolókban.
1. lehetőség: Új SQL-projekt létrehozása meglévő adatbázisból
1. lépés: Új SQL-projekt létrehozása meglévő adatbázisból
A Visual Studióban SQL Server objektumkezelő kattintson a jobb gombbal arra az adatbázisra, amelyből projektet szeretne létrehozni, és válassza Új projekt létrehozása...lehetőséget.
Az Új projekt létrehozása párbeszédpanelen adjon meg egy projektnevet, amelynek nem kell egyeznie az adatbázis nevével. Szükség szerint ellenőrizze és módosítsa a projekt helyét. Az alapértelmezett importálási beállítások séma alapján importálják az objektumokat mappákba, majd az objektum típusát. Módosíthatja az importálási beállításokat a mappastruktúra módosításához vagy az importálandó objektumok engedélyeinek belefoglalásához. Indítsa el az importálást.
Amíg az importálás folytatódik, a folyamat üzenetként jelenik meg az Adatbázis importálása párbeszédpanelen. Ha az importálás befejeződött, az importált objektumok láthatók a Megoldáskezelő, a naplókat pedig a Import Schema Logsalatti projektkönyvtár egyik fájljában tárolja. Válassza ki a Befejezésopciót.
Az 1. lehetőség nem érhető el a parancssorhoz. Ehelyett használja 2. lehetőséget.
A VS Code vagy az Azure Data Studio adatbázis-objektumkezelő nézetében válassza ki azt az adatbázist, amelyből projektet szeretne létrehozni. Kattintson a jobb gombbal az adatbázisra, és válassza a Projekt létrehozása adatbázisbóllehetőséget.
Az Azure Data Studióban a Projekt létrehozása adatbázisból párbeszédpanelen meg kell adni a projekt nevét és helyét. Az alapértelmezett importálási beállítások séma alapján importálják az objektumokat mappákba, majd az objektum típusát. A Létrehozáskiválasztása előtt választhat egy másik mappastruktúrát, vagy engedélyeket vehet fel az importált objektumokba.
A VS Code-ban a parancssor kérni fogja a projekt nevét és helyét. Az alapértelmezett importálási beállítások séma alapján importálják az objektumokat mappákba, majd az objektum típusát. Választhat egy másik mappastruktúrát, vagy az importálás megkezdése előtt engedélyeket vehet fel az importált objektumokba.
Nyissa meg az Adatbázisprojektek nézetet az új projekt és az importált objektumdefiníciók megtekintéséhez.
Az 1. lehetőség nem érhető el a parancssorhoz. Ehelyett használja 2. lehetőséget.
2. lépés: Az SQL-projekt létrehozása
A létrehozási folyamat ellenőrzi az objektumok és a szintaxis közötti kapcsolatokat a projektfájlban megadott célplatformon. A buildelési folyamat összetevő-kimenete egy .dacpac fájl, amely a projekt céladatbázisban való üzembe helyezésére használható, és tartalmazza az adatbázisséma lefordított modelljét.
A Megoldáskezelőkattintson a jobb gombbal a projektcsomópontra, és válassza a Buildlehetőséget.
A kimeneti ablak automatikusan megnyílik a buildelési folyamat megjelenítéséhez. Ha hibák vagy figyelmeztetések vannak, azok megjelennek a kimeneti ablakban. Sikeres build esetén a build artefaktum (.dacpac fájl) létrejön, és a helye szerepel a build kimenetében (alapértelmezés szerint bin\Debug\projectname.dacpac).
Az 1. lehetőség nem érhető el a parancssorhoz. Ehelyett használja 2. lehetőséget.
Az Database Projects VS Code vagy Azure Data Studio nézetében kattintson a jobb gombbal a projektcsomópontra, és válassza a Buildlehetőséget.
A kimeneti ablak automatikusan megnyílik a buildelési folyamat megjelenítéséhez. Ha hibák vagy figyelmeztetések vannak, azok megjelennek a kimeneti ablakban. Sikeres build esetén a build artefaktum (.dacpac fájl) létrejön, és a helye szerepel a build kimenetében (alapértelmezés szerint bin/Debug/projectname.dacpac).
Az 1. lehetőség nem érhető el a parancssorhoz. Ehelyett használja 2. lehetőséget.
2. lehetőség: Új üres SQL-projekt létrehozása és objektumok importálása meglévő adatbázisból
Másik lehetőségként a projekt létrehozásának és az objektumok importálásának lépései külön is elvégezhetők.
1. lépés: Új üres SQL-projekt létrehozása
A projektet úgy indítjuk el, hogy létrehozunk egy új SQL Database-projektet, mielőtt importálnánk az objektumokat.
Válassza Fájl, Új, majd Projectlehetőséget.
Az Új projekt párbeszédpanelen használja az SQL Server kifejezést a keresőmezőben. A legjobb eredménynek a SQL Server Database Projectkell lennie.
A következő lépéshez válassza a Tovább lehetőséget. Adjon meg egy projektnevet, amelynek nem kell egyeznie az adatbázis nevével. Szükség szerint ellenőrizze és módosítsa a projekt helyét.
Válassza a Create lehetőséget a projekt létrehozásához. Az üres projekt megnyílik, és látható a Megoldáskezelő-ben szerkesztés céljából.
Válassza Fájl, Új, majd Projectlehetőséget.
Az Új projekt párbeszédpanelen használja az SQL Server kifejezést a keresőmezőben. Az első helyezettnek a(z) SQL Server Database Project, SDK-stílusú (előzetes)kell lennie.
A következő lépéshez válassza a Tovább lehetőséget. Adjon meg egy projektnevet, amelynek nem kell egyeznie az adatbázis nevével. Szükség szerint ellenőrizze és módosítsa a projekt helyét.
Válassza a Create lehetőséget a projekt létrehozásához. Az üres projekt megnyílik, és látható a Megoldáskezelő-ben szerkesztés céljából.
Az Database Projects VS Code vagy Azure Data Studio nézetében válassza az Új projekt gombot.
Az első kérdés meghatározza a használni kívánt projektsablont, elsősorban attól függően, hogy a célplatform az SQL Server vagy az Azure SQL. Ha a rendszer az SQL egy adott verziójának kiválasztására kéri, válassza ki a céladatbázisnak megfelelő verziót, de ha a céladatbázis verziója ismeretlen, válassza ki a legújabb verziót, mert az érték később módosítható.
Adjon meg egy projektnevet a megjelenő szövegbevitelben, amelynek nem kell egyeznie az adatbázis nevével.
A megjelenő "Mappa kiválasztása" párbeszédpanelen válassza ki a projekt mappájának, .sqlproj fájljának és egyéb tartalmainak könyvtárát.
Amikor a rendszer megkérdezi, hogy szeretne-e SDK-stílusú projektet létrehozni, válassza Igenlehetőséget.
Miután elkészült, az üres projekt megnyílik és látható lesz az Adatbázis-projektek nézetben szerkesztésre.
Ha telepítve vannak a Microsoft.Build.Sql-projektek .NET-sablonjai, létrehozhat egy új SQL-adatbázisprojektet a parancssorból. A -n beállítás megadja a projekt nevét, a -tp beállítás pedig a projekt célplatformját.
A -h beállítással megtekintheti az összes elérhető lehetőséget.
# create a new SQL database project
dotnet new sqlproj -n MyDatabaseProject
2. lépés: Objektumok importálása meglévő adatbázisból
A Megoldáskezelőbenkattintson a jobb gombbal a projektcsomópontra, és válassza Importálás –> Adatbázis...lehetőséget. Ha ez a beállítás le van tiltva, előfordulhat, hogy az adatbázisprojekt objektumokat hozott létre benne. Törölheti az objektumokat, vagy létrehozhat egy új projektet.
Az Adatbázis importálása párbeszédpanelen válassza ki az adatbáziskapcsolatot, amelyhez az objektumokat szeretne importálni. Ha az SQL Server Objektumkezelőben csatlakozott az adatbázishoz, az előzménylista jelenik meg.
Az alapértelmezett importálási beállítások séma alapján importálják az objektumokat mappákba, majd az objektum típusát. Módosíthatja az importálási beállításokat a mappastruktúra módosításához vagy az importálandó objektumok engedélyeinek belefoglalásához. Indítsa el az importálást.
Amíg az importálás folytatódik, a folyamat üzenetként jelenik meg az Adatbázis importálása párbeszédpanelen. Ha az importálás befejeződött, az importált objektumok láthatók a Megoldáskezelő, a naplókat pedig a Import Schema Logsalatti projektkönyvtár egyik fájljában tárolja. Válassza a Befejezés gombot, hogy visszatérjen a projekthez.
Az SqlPackage CLI használatával importálunk objektumokat egy meglévő adatbázisból a Visual Studióban az 1. lépésben létrehozott új SQL Database-projektbe. Az alábbi SqlPackage parancs egy adatbázis sémáját importálja egy olyan mappába, MyDatabaseProject beágyazott séma- és objektumtípus-mappák szerint rendezve.
sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
Ha ezek a mappák egy SDK-stílusú SQL Database-projektmappába kerülnek, a rendszer automatikusan belefoglalja őket a projektbe anélkül, hogy importálnia kellene őket, vagy módosítania kellene az SQL-projektfájlt.
Note
A VS Code SQL Database Projects bővítménye nem támogatja az objektumok adatbázisból projektbe való importálását. Az Azure Data Studio SQL Database Projects bővítményével importálhat objektumokat egy adatbázisból, vagy 1. lehetőséget követve új projektet hozhat létre egy meglévő adatbázisból a VS Code-ban.
Az Azure Data Studio SQL Database Projects bővítményében nyissa meg a Database Projects nézetet. Kattintson a jobb gombbal a projektcsomópontot, és válassza a A projekt frissítése az adatbázisbóllehetőséget.
Az Adatbázis frissítése párbeszédpanelen válassza ki az adatbázishoz a csatlakozást, amelyből objektumokat szeretne importálni. Ha a Kapcsolatok nézetben csatlakozott az adatbázishoz, akkor az az előzménylistában szerepel.
Válassza a Séma összehasonlítás változásainak megtekintése lehetőséget az importálandó objektumok részhalmazának áttekintéséhez és kiválasztásához, vagy az Összes változtatás alkalmazása a minden objektum importálásához.
Az SqlPackage parancssori felülettel kinyerheti egy meglévő adatbázis sémáját egy .dacpac fájlba vagy egyéni .sql fájlokba. Az alábbi SqlPackage parancs kinyeri egy adatbázis sémáját egy beágyazott séma- és objektumtípus-mappák által rendezett .sql fájlokba.
sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
Ha ezek a mappák egy SDK-stílusú SQL Database-projektmappába kerülnek, a rendszer automatikusan belefoglalja őket a projektbe anélkül, hogy importálnia kellene őket, vagy módosítania kellene az SQL-projektfájlt.
3. lépés: Az SQL-projekt létrehozása
A létrehozási folyamat ellenőrzi az objektumok és a szintaxis közötti kapcsolatokat a projektfájlban megadott célplatformon. A buildelési folyamat összetevő-kimenete egy .dacpac fájl, amely a projekt céladatbázisban való üzembe helyezésére használható, és tartalmazza az adatbázisséma lefordított modelljét.
A Megoldáskezelőkattintson a jobb gombbal a projektcsomópontra, és válassza a Buildlehetőséget.
A kimeneti ablak automatikusan megnyílik a buildelési folyamat megjelenítéséhez. Ha hibák vagy figyelmeztetések vannak, azok megjelennek a kimeneti ablakban. Sikeres build esetén a build artefaktum (.dacpac fájl) létrejön, és a helye szerepel a build kimenetében (alapértelmezés szerint bin\Debug\projectname.dacpac).
A Megoldáskezelőkattintson a jobb gombbal a projektcsomópontra, és válassza a Buildlehetőséget.
A kimeneti ablak automatikusan megnyílik a buildelési folyamat megjelenítéséhez. Ha hibák vagy figyelmeztetések vannak, azok megjelennek a kimeneti ablakban. Sikeres build esetén a build artefaktum (.dacpac fájl) létrejön, és a helye szerepel a build kimenetében (alapértelmezés szerint bin\Debug\projectname.dacpac).
Az Database Projects VS Code vagy Azure Data Studio nézetében kattintson a jobb gombbal a projektcsomópontra, és válassza a Buildlehetőséget.
A kimeneti ablak automatikusan megnyílik a buildelési folyamat megjelenítéséhez. Ha hibák vagy figyelmeztetések vannak, azok megjelennek a kimeneti ablakban. Sikeres build esetén a build artefaktum (.dacpac fájl) létrejön, és a helye szerepel a build kimenetében (alapértelmezés szerint bin/Debug/projectname.dacpac).
Az SQL-adatbázisprojektek a parancssorból hozhatók létre a dotnet build paranccsal.
dotnet build
# optionally specify the project file
dotnet build MyDatabaseProject.sqlproj
A build kimenete tartalmazza az esetleges hibákat vagy figyelmeztetéseket, valamint az adott fájlokat és sorszámokat, ahol azok előfordulnak. Sikeres build esetén a build artefaktum (.dacpac fájl) létrejön, és a helye szerepel a build kimenetében (alapértelmezés szerint bin/Debug/projectname.dacpac).