Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
platí pro:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric
Projekty SQL obsahují deklarativní soubory (příkaz CREATE) pro všechny objekty v databázi, jako jsou tabulky, zobrazení a uložené procedury. Tyto soubory lze použít k vytváření nových databází, aktualizaci existujících databází nebo dokonce ke sledování databáze ve správě zdrojového kódu. Často začínáme projektem SQL, když máme existující databázi a chceme vytvořit objekty v projektu SQL, které odpovídají databázi s minimálním úsilím.
Některé nástroje projektů SQL zahrnují jeden krok pro vytvoření nového projektu SQL z existující databáze. Další nástroje vyžadují několik kroků k vytvoření nového projektu SQL a následnému importu objektů z existující databáze. S výjimkou pokynů sady Visual Studio (SQL Server Data Tools) se průvodce zaměřuje na projekty SQL ve stylu sady SDK.
S možností 1 v tomto kurzu:
krok 1: vytvoření nového projektu SQL z existující databáze krok 2: sestavení projektu SQL
Použitím volby 2 v tomto návodu:
- krok 1: vytvoření nového prázdného projektu SQL
- Krok 2: import objektů z existující databáze
- krok 3: sestavení projektu SQL
Prerequisites
- Sada .NET 8 SDK
- Visual Studio 2022 Community, Professional nebo Enterprise
- SQL Server Data Tools, sada SDK (preview) nainstalovaná v sadě Visual Studio 2022
- SqlPackage CLI
# 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
K dokončení kurzu potřebujete přístup k instanci Azure SQL nebo SQL Serveru. Můžete vyvíjet místně zdarma s SQL Server developer edition ve Windows nebo v kontejnerech .
Možnost 1: Vytvoření nového projektu SQL z existující databáze
Krok 1: Vytvoření nového projektu SQL z existující databáze
V průzkumníku objektů SQL Serveru v sadě Visual Studio klikněte pravým tlačítkem na databázi, ze které chcete vytvořit projekt, a vyberte Vytvořit nový projekt....
V dialogovém okně Vytvořit nový projekt zadejte název projektu, který nemusí odpovídat názvu databáze. Podle potřeby ověřte a upravte umístění projektu. Výchozí nastavení importu importuje objekty do složek podle schématu, a poté podle typu objektu. Nastavení importu můžete upravit tak, aby změnila strukturu složek nebo aby zahrnovala oprávnění do importovaných objektů. Spusťte import.
Během importu se průběh zobrazuje jako zprávy v dialogovém okně Import databáze. Po dokončení importu se importované objekty zobrazí v Průzkumníku řešení a protokoly se ukládají do souboru v adresáři projektu v části Import Schema Logs. Vyberte Dokončit.
Možnost 1 není pro příkazový řádek dostupná. Místo toho použijte možnost 2.
V zobrazení Průzkumníka databázových objektů ve VS Code nebo Azure Data Studiu vyberte databázi, ze které chcete vytvořit projekt. Klikněte pravým tlačítkem myši na databázi a vyberte Vytvořit projekt z databáze.
V nástroji Azure Data Studio vyžaduje dialogové okno Vytvořit projekt z databáze název a umístění projektu. Výchozí nastavení importu importuje objekty do složek podle schématu, a poté podle typu objektu. Před výběrem možnosti Vytvořitmůžete vybrat jinou strukturu složek nebo zahrnout oprávnění do importovaných objektů.
V nástroji VS Code příkazový řádek požádá o název a umístění projektu. Výchozí nastavení importu importuje objekty do složek podle schématu, a poté podle typu objektu. Můžete vybrat jinou strukturu složek nebo zahrnout oprávnění k importovaným objektům před zahájením importu.
Otevřete zobrazení Databázových projektů a zobrazte nové definice projektu a importovaných objektů.
Možnost 1 není pro příkazový řádek dostupná. Místo toho použijte možnost 2.
Krok 2: Sestavení projektu SQL
Proces sestavení ověří vztahy mezi objekty a syntaxí s cílovou platformou zadanou v souboru projektu. Výstup artefaktu z procesu sestavení je soubor .dacpac, který lze použít k nasazení projektu do cílové databáze a obsahuje zkompilovaný model schématu databáze.
V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Sestavit.
Automaticky se otevře okno výstupu pro zobrazení procesu sestavení. Pokud dojde k chybám nebo upozorněním, zobrazí se ve výstupním okně. Při úspěšném sestavení je vytvořen artefakt sestavení (soubor.dacpac) a jeho umístění je zahrnuto ve výstupu sestavení (výchozí je bin\Debug\projectname.dacpac).
Možnost 1 není pro příkazový řádek dostupná. Místo toho použijte možnost 2.
V databázových projektech zobrazení nástroje VS Code nebo Azure Data Studio klikněte pravým tlačítkem na uzel projektu a vyberte Sestavení.
Automaticky se otevře okno výstupu pro zobrazení procesu sestavení. Pokud dojde k chybám nebo upozorněním, zobrazí se ve výstupním okně. Při úspěšném sestavení je vytvořen artefakt sestavení (soubor.dacpac) a jeho umístění je zahrnuto ve výstupu sestavení (výchozí je bin/Debug/projectname.dacpac).
Možnost 1 není pro příkazový řádek dostupná. Místo toho použijte možnost 2.
Možnost 2: Vytvoření nového prázdného projektu SQL a import objektů z existující databáze
Případně je možné kroky vytvoření projektu a importu objektů provést samostatně.
Krok 1: Vytvoření nového prázdného projektu SQL
Projekt zahájíme tak, že před importem objektů do něj vytvoříme nový projekt databáze SQL.
Vyberte soubor, novýa pak projekt.
V dialogovém okně Nový projekt použijte výraz SQL Server ve vyhledávacím poli. Nejvyšší výsledek by měl být projekt databáze SQL Serveru .
Pokud chcete pokračovat k dalšímu kroku, vyberte Další. Zadejte název projektu, který se nemusí shodovat s názvem databáze. Podle potřeby ověřte a upravte umístění projektu.
Vyberte Vytvořit a vytvořte projekt. Prázdný projekt se otevře a zobrazí v průzkumníku řešení pro úpravy.
Vyberte soubor, novýa pak projekt.
V dialogovém okně Nový projekt použijte výraz SQL Server ve vyhledávacím poli. Hlavní výsledek by měl být Databázový projekt SQL Serveru, ve stylu SDK (preview).
Pokud chcete pokračovat k dalšímu kroku, vyberte Další. Zadejte název projektu, který se nemusí shodovat s názvem databáze. Podle potřeby ověřte a upravte umístění projektu.
Vyberte Vytvořit a vytvořte projekt. Prázdný projekt se otevře a zobrazí v průzkumníku řešení pro úpravy.
V zobrazení Databázové projekty ve VS Code nebo Azure Data Studio vyberte tlačítko Nový projekt.
První výzva určuje, která šablona projektu se má použít, a primárně na základě toho, jestli je cílovou platformou SQL Server nebo Azure SQL. Pokud se zobrazí výzva k výběru konkrétní verze SQL, zvolte verzi, která odpovídá cílové databázi, ale pokud je verze cílové databáze neznámá, zvolte nejnovější verzi, protože hodnotu lze později upravit.
Do zobrazeného textového vstupu zadejte název projektu, který nemusí odpovídat názvu databáze.
V dialogovém okně Vybrat složku, které se zobrazí, vyberte adresář pro složku projektu, .sqlproj soubor a další obsah, ve kterém se má nacházet.
Po zobrazení výzvy, zda chcete vytvořit projekt ve stylu sady SDK, vyberte Ano.
Po dokončení se prázdný projekt otevře a zobrazí v zobrazení Databázových projektů pro úpravy.
Pomocí šablon .NET pro projekty Microsoft.Build.Sql můžete vytvořit nový projekt databáze SQL z příkazového řádku. Možnost -n určuje název projektu a možnost -tp určuje cílovou platformu projektu.
Pomocí možnosti -h zobrazíte všechny dostupné možnosti.
# create a new SQL database project
dotnet new sqlproj -n MyDatabaseProject
Krok 2: Import objektů z existující databáze
V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Importovat –> Databáze.... Pokud je tato možnost zakázaná, váš databázový projekt může mít v něm vytvořené objekty. Objekty můžete odstranit nebo vytvořit nový projekt.
V dialogovém okně Importovat databázi vyberte připojení k databázi, ze které chcete importovat objekty. Pokud jste se k databázi připojili v Průzkumníku objektů SQL Serveru, nachází se v seznamu historie.
Výchozí nastavení importu importuje objekty do složek podle schématu, a poté podle typu objektu. Nastavení importu můžete upravit tak, aby změnila strukturu složek nebo aby zahrnovala oprávnění do importovaných objektů. Spusťte import.
Během importu se průběh zobrazuje jako zprávy v dialogovém okně Import databáze. Po dokončení importu se importované objekty zobrazí v Průzkumníku řešení a protokoly se ukládají do souboru v adresáři projektu v části Import Schema Logs. Vyberte Dokončit a vraťte se do projektu.
Rozhraní příkazového řádku SqlPackage použijeme k importu objektů z existující databáze do nového projektu databáze SQL, který jsme vytvořili v sadě Visual Studio v kroku 1. Následující příkaz SqlPackage naimportuje schéma databáze do složky MyDatabaseProject uspořádané podle vnořeného schématu a složek typu objektu.
sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
Když jsou tyto složky umístěné ve složce projektu databáze SQL ve stylu sady SDK, budou automaticky zahrnuty do projektu bez nutnosti je importovat nebo upravovat soubor projektu SQL.
Note
Rozšíření SQL Database Projects ve VS Code nepodporuje import objektů z databáze do projektu. Pomocí rozšíření SQL Database Projects v Nástroji Azure Data Studio naimportujte objekty z databáze nebo postupujte podle možnosti 1 a vytvořte nový projekt z existující databáze ve VS Code.
V rozšíření SQL Database Projects v Nástroji Azure Data Studio otevřete zobrazení Databázových projektů. Pravým tlačítkem myši klikněte na uzel projektu a vyberte Aktualizovat projekt z databáze.
V dialogovém okně Aktualizovat databázi vyberte připojení k databázi, ze které chcete importovat objekty. Pokud jste se k databázi připojili v zobrazení Connections, je v seznamu historie.
Vyberte Zobrazit změny v porovnání schématu a zvolte podmnožinu objektů, které chcete importovat, nebo Použít všechny změny pro import všech objektů.
Rozhraní příkazového řádku SqlPackage lze použít k extrahování schématu existující databáze do souboru .dacpac nebo jednotlivých .sql souborů. Následující příkaz SqlPackage extrahuje schéma databáze do .sql souborů uspořádaných podle vnořeného schématu a složek typu objektu.
sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
Když jsou tyto složky umístěné ve složce projektu databáze SQL ve stylu sady SDK, budou automaticky zahrnuty do projektu bez nutnosti je importovat nebo upravovat soubor projektu SQL.
Krok 3: Sestavení projektu SQL
Proces sestavení ověří vztahy mezi objekty a syntaxí s cílovou platformou zadanou v souboru projektu. Výstup artefaktu z procesu sestavení je soubor .dacpac, který lze použít k nasazení projektu do cílové databáze a obsahuje zkompilovaný model schématu databáze.
V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Sestavit.
Automaticky se otevře okno výstupu pro zobrazení procesu sestavení. Pokud dojde k chybám nebo upozorněním, zobrazí se ve výstupním okně. Při úspěšném sestavení je vytvořen artefakt sestavení (soubor.dacpac) a jeho umístění je zahrnuto ve výstupu sestavení (výchozí je bin\Debug\projectname.dacpac).
V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Sestavit.
Automaticky se otevře okno výstupu pro zobrazení procesu sestavení. Pokud dojde k chybám nebo upozorněním, zobrazí se ve výstupním okně. Při úspěšném sestavení je vytvořen artefakt sestavení (soubor.dacpac) a jeho umístění je zahrnuto ve výstupu sestavení (výchozí je bin\Debug\projectname.dacpac).
V databázových projektech zobrazení nástroje VS Code nebo Azure Data Studio klikněte pravým tlačítkem na uzel projektu a vyberte Sestavení.
Automaticky se otevře okno výstupu pro zobrazení procesu sestavení. Pokud dojde k chybám nebo upozorněním, zobrazí se ve výstupním okně. Při úspěšném sestavení je vytvořen artefakt sestavení (soubor.dacpac) a jeho umístění je zahrnuto ve výstupu sestavení (výchozí je bin/Debug/projectname.dacpac).
Projekty databáze SQL je možné sestavit z příkazového řádku pomocí příkazu dotnet build.
dotnet build
# optionally specify the project file
dotnet build MyDatabaseProject.sqlproj
Výstup sestavení obsahuje všechny chyby nebo upozornění a konkrétní soubory a čísla řádků, ve kterých k nim dochází. Při úspěšném sestavení je vytvořen artefakt sestavení (soubor.dacpac) a jeho umístění je zahrnuto ve výstupu sestavení (výchozí je bin/Debug/projectname.dacpac).