Sdílet prostřednictvím

Jak začít s SQL databázovými projekty

  • Článek

platí pro: SQL Server 2022 (16.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL Database v Microsoft Fabric

Projekt databáze SQL je místní reprezentace objektů SQL, které tvoří schéma pro jednu databázi, jako jsou tabulky, uložené procedury nebo funkce. Vývojový cyklus projektu databáze SQL umožňuje integraci vývoje databází do pracovních postupů kontinuální integrace a průběžného nasazování (CI/CD), které jsou známé jako osvědčený postup vývoje.

Tento článek popisuje vytvoření nového projektu SQL, přidání objektů do projektu a sestavení a nasazení projektu. S výjimkou pokynů sady Visual Studio (SQL Server Data Tools) se průvodce zaměřuje na projekty SQL ve stylu sady SDK.

  1. Vytvoření nového projektu
  2. Přidání objektů do projektu
  3. Sestavení projektu
  4. Nasazení projektu

Požadavky

# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage

# install Microsoft.Build.Sql.Templates
dotnet new install Microsoft.Build.Sql.Templates

Poznámka

K dokončení nasazení projektu databáze SQL 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 .

Krok 1: Vytvoření nového projektu

Projekt zahájíme tak, že před ručním přidáním objektů do něj vytvoříme nový projekt databáze SQL. Existují další způsoby, jak vytvořit projekt, který umožňuje okamžité naplnění projektu objekty z existující databáze, například pomocí nástrojů pro porovnání schémat .

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 Projekt databáze SQL Serveru.

Snímek obrazovky dialogového okna Nový projekt

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 ve vyhledávacím poli výraz SQL Server. Hlavní výsledek by měl být Databázový projekt SQL Serveru, ve stylu SDK (preview).

snímek obrazovky dialogového okna Nový projekt

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 pro vytvoření projektu. 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.

snímek obrazovky nového zobrazení

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.

# install Microsoft.Build.Sql.Templates
dotnet new sqlproject -n MyDatabaseProject

Krok 2: Přidání objektů do projektu

V Průzkumníku řešeníklikněte pravým tlačítkem myši na uzel projektu a vyberte Přidata potom Tabulka. Zobrazí se dialogové okno Přidat novou položku, kde můžete zadat název tabulky. Vyberte Přidat a vytvořte tabulku v projektu SQL.

Tabulka se otevře v návrháři tabulek sady Visual Studio s definicí tabulky šablony, kde můžete přidat sloupce, indexy a další vlastnosti tabulky. Až dokončíte počáteční úpravy, soubor uložte.

Další databázové objekty je možné přidat prostřednictvím dialogového okna Přidat novou položku, jako jsou zobrazení, uložené procedury a funkce. Přejděte do dialogového okna tak, že kliknete pravým tlačítkem na uzel projektu v průzkumníku řešení a vyberete Přidata potom požadovaný typ objektu. Soubory v projektu lze uspořádat do složek prostřednictvím možnosti Nová složka v části Přidat.

V Průzkumníku řešeníklikněte pravým tlačítkem myši na uzel projektu a vyberte možnost Přidat, poté Nová položka. Zobrazí se dialogové okno Přidat novou položku, vyberte Zobrazit všechny šablony a pak tabulka. Zadejte název tabulky jako název souboru a vyberte Přidat a vytvořte tabulku v projektu SQL.

Tabulka se otevře v editoru dotazů sady Visual Studio s definicí tabulky šablony, kde můžete přidat sloupce, indexy a další vlastnosti tabulky. Až dokončíte počáteční úpravy, soubor uložte.

Další databázové objekty je možné přidat prostřednictvím dialogového okna Přidat novou položku, jako jsou zobrazení, uložené procedury a funkce. Otevřete dialogové okno kliknutím pravého tlačítka myši na uzel projektu v Průzkumníku řešení a vyberte Přidat, po zvolení možnosti Zobrazit všechny šablonyvyberte požadovaný typ objektu. Soubory v projektu lze uspořádat do složek prostřednictvím možnosti Nová složka v části Přidat.

V zobrazení databázových projektů v nástroji VS Code nebo Azure Data Studio klikněte pravým tlačítkem myši na uzel projektu a vyberte Přidat tabulku. V zobrazeném dialogovém okně zadejte název tabulky.

Tabulka se otevře v textovém editoru s definicí tabulky šablony, kde můžete přidat sloupce, indexy a další vlastnosti tabulky. Až dokončíte počáteční úpravy, soubor uložte.

Další databázové objekty je možné přidat prostřednictvím místní nabídky v uzlu projektu, jako jsou zobrazení, uložené procedury a funkce. Otevřete dialogové okno tak, že kliknete pravým tlačítkem myši na uzel projektu v zobrazení Databázové projekty v nástroji VS Code nebo Azure Data Studio a poté vyberete požadovaný typ objektu. Soubory v projektu lze uspořádat do složek prostřednictvím možnosti Nová složka v části Přidat.

Soubory lze do projektu přidat tak, že je vytvoříte v adresáři projektu nebo vnořených složkách. Přípona souboru by měla být .sql a organizace podle typu objektu nebo schématu a typu objektu se doporučuje.

Základní šablonu tabulky lze použít jako výchozí bod pro vytvoření nového objektu tabulky v projektu:

CREATE TABLE [dbo].[Table1]
(
    [Id] INT NOT NULL PRIMARY KEY
);

Krok 3: Sestavení projektu

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 myši 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í se vytvoří 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í se artefakt sestavení (soubor.dacpac) vytvoří a jeho umístění je zahrnuto ve výstupu sestavení (výchozí hodnota 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í se vytvoří 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í se vytvoří artefakt sestavení (soubor.dacpac), jehož umístění je zahrnuto ve výstupu sestavení (výchozí hodnota je bin/Debug/projectname.dacpac).

Krok 4: Nasazení projektu

Kompilovaný model schématu databáze v souboru .dacpac lze nasadit do cílové databáze pomocí nástroje příkazového řádku SqlPackage nebo jiných nástrojů pro nasazení. Proces nasazení určuje nezbytné kroky k aktualizaci cílové databáze tak, aby odpovídala schématu definovanému v .dacpac, vytváření nebo změny objektů podle potřeby na základě objektů, které již v databázi existují. V důsledku toho je proces nasazení idempotentní, což znamená, že se může spustit několikrát, aniž by to způsobilo problémy, a můžete nasadit stejný .dacpac do více databází, aniž byste museli předem určit jejich stav.

V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Publikovat....

Otevře se dialogové okno pro publikování, kde vytvoříte připojení k cílové databázi. Pokud nemáte existující instanci SQL pro nasazení, nainstaluje se v sadě Visual Studio LocalDB ((localdb)\MSSQLLocalDB) a dá se použít k testování a vývoji.

Zadejte název databáze a vyberte Publikovat nasadit projekt do cílové databáze nebo Generovat skript vygenerovat skript, který se má před spuštěním zkontrolovat.

V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Publikovat....

Otevře se dialogové okno pro publikování, kde vytvoříte připojení cílové databáze. Pokud nemáte existující instanci SQL pro nasazení, nainstaluje se v sadě Visual Studio LocalDB ((localdb)\MSSQLLocalDB) a dá se použít k testování a vývoji.

Zadejte název databáze a vyberte Publikovat nasadit projekt do cílové databáze nebo Generovat skript vygenerovat skript, který se má před spuštěním zkontrolovat.

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 Publikovat.

Spropitné

Pokud nemáte k dispozici instanci SQL pro nasazení, může rozšíření SQL Database Projects vytvořit místní instanci SQL Serveru pro vás v novém kontejneru. Při spuštění rozhraní kontejneru, jako je Docker Desktop, vyberte Publikovat do nového místního vývojového kontejneru SQL serveru z rozevíracího seznamu.

Pokud máte existující instanci SQL pro nasazení, vyberte Publikovat na existující SQL Serveru a pak Nepoužívat profil, pokud se zobrazí výzva k publikování profilu.

Pokud jste nenakonfigurovali připojení k cílové databázi, zobrazí se výzva k vytvoření nového připojení. Nové vstupy připojení se ptají na název serveru, metodu ověřování a název databáze.

Po nakonfigurování připojení se zahájí proces nasazení. Můžete zvolit automatické spuštění nasazení (publikování) nebo vygenerování skriptu, který se má zkontrolovat před spuštěním (vygenerování skriptu).

CLI SqlPackage slouží k nasazení souboru .dacpac do cílové databáze akcí publikování .

Pokud chcete například nasadit soubor .dacpac do cílové databáze na základě připojovacího řetězce:

sqlpackage /Action:Publish /SourceFile:bin/Debug/projectname.dacpac /TargetConnectionString:{yourconnectionstring}

Získání nápovědy

Související obsah