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.
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 pomáhá integrovat vývoj 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é postupy vývoje. V nástroji SSMS můžete pomocí Microsoft.Build.Sql projektů ve verzi Preview implementovat, spravovat a spolupracovat na změnách databáze tím, že poskytnete místní definici databázových objektů.
Tento článek popisuje, jak používat projekty databáze SQL v sadě SQL Server Management Studio (SSMS) jako součást pracovních postupů DevOps nebo k ukotvení databázových pracovních postupů DevOps. Další informace o projektech databáze SQL naleznete v tématu Projekty databáze SQL.
Předpoklady
Vytvoření nového projektu
Pokud chcete pracovat s projekty databáze SQL v nástroji SSMS, potřebujete místní složku obsahující soubory projektu. Projekt můžete zahájit extrahováním objektů z existující databáze nebo vytvořením nových souborů objektů od začátku.
Poznámka:
SSMS vás může při otevření souboru z Průzkumníka řešení vyzvat k připojení k serveru. Vývoj projektu databáze SQL můžete provádět offline bez připojení k databázi.
Přidání objektů z existující databáze
SqlPackage slouží k extrakci schématu z existující databáze do jednotlivých .sql souborů uspořádaných podle typu objektu. Spuštěním následujícího příkazu vytvořte strukturu složek s databázovými objekty:
sqlpackage /Action:Extract /SourceConnectionString:"<connection-string>" /TargetFile:"<temp-folder>" /p:ExtractTarget=SchemaObjectType
Parametr /p:ExtractTarget=SchemaObjectType uspořádá extrahované soubory do podsložek na základě schématu a typu objektu (například dbo/Tables, dbo/StoredProcedures). Extrahujte do dočasné složky mimo adresář projektu a potom pomocí Průzkumníka Windows zkopírujte požadovaný obsah do složky projektu.
Další informace o možnostech extrakce SqlPackage naleznete v tématu SqlPackage extract.
Vytváření nových objektů
Přidejte do projektu nové databázové objekty vytvořením .sql souborů ve složce projektu. Každý soubor by měl obsahovat jeden CREATE příkaz pro jeden databázový objekt. Například definice tabulky:
CREATE TABLE [dbo].[Products]
(
[ProductId] INT NOT NULL PRIMARY KEY,
[ProductName] NVARCHAR (100) NOT NULL,
[Price] DECIMAL (10, 2) NOT NULL
);
Uspořádání souborů podle schématu a typu objektu pomocí podsložek, například dbo/Tables nebo Sales/StoredProcedures. Tato struktura odpovídá výstupu extrakce SqlPackage a usnadňuje vyhledání objektů při růstu projektu. Proces sestavení projektu SQL obsahuje ve výchozím nastavení všechny .sql soubory ve složce projektu a její podsložky.
SSMS poskytuje šablony pro běžné položky, které vám pomůžou začít. Pokud chcete přidat novou položku, klikněte pravým tlačítkem na projekt v Průzkumníku řešení, vyberte Přidat>novou položku a vyberte ze seznamu šablon objektů SQL.
Otevření existujících projektů
Pokud chcete otevřít existující projekt databáze SQL v nástroji SSMS , vyberte>Soubor otevřít>projekt nebo řešení a přejděte k .sqlproj souboru.
Důležité
SSMS podporuje pouze projekty ve stylu Microsoft.Build.Sql sady SDK. Minimální podporovaná verze sady SDK je 2.1.0. Pokud máte původní projekt SQL vytvořený v sadě Visual Studio, musíte ho před otevřením převést na formát ve stylu sady SDK.
Pokyny k převodu původních projektů SQL do formátu stylu sady SDK najdete v tématu Převod původního projektu SQL na projekt ve stylu sady SDK.
Sestavování projektů a nasazování změn
Pracovní postup projektu SQL se skládá ze dvou hlavních kroků: sestavení projektu pro ověření a kompilaci schématu a nasazení kompilovaného výstupu do cílové databáze.
Sestavení projektu
Sestavení projektu SQL ověřuje vztahy mezi objekty a kontroluje syntaxi T-SQL na zadané cílové platformě. Proces sestavení vytvoří .dacpac soubor, který obsahuje zkompilovaný model schématu databáze.
Pokud chcete vytvořit projekt v nástroji SSMS, klikněte pravým tlačítkem myši na projekt v Průzkumníku řešení a vyberte Sestavit.
Výstup sestavení zobrazí všechny chyby nebo upozornění. Chyby značí problémy, které brání nasazení, například zobrazení odkazující na tabulku, která neexistuje. Upozornění zvýrazňují potenciální problémy, jako je nekonzistentní velikost písmen v názvech objektů.
Při úspěšném sestavení je soubor .dacpac vytvořen ve složce bin\Debug v adresáři projektu.
Další informace o řešení potíží s sestavením najdete v tématu Řešení chyb sestavení projektu SQL.
Nasazení změn
Po sestavení projektu nasaďte .dacpac do cílové databáze pomocí dialogového okna Publikovat v aplikaci SSMS. Proces nasazení porovná .dacpac k cílové databázi a vygeneruje potřebné CREATE, ALTER, nebo DROP příkazy pro synchronizaci databáze s vašim projektem.
Pokud chcete projekt nasadit, klikněte pravým tlačítkem na projekt v Průzkumníku řešení a vyberte Publikovat. V dialogovém okně Publikovat nakonfigurujte připojení cílové databáze a vyberte možnost Publikovat , aby se použily změny nebo vygenerovat skript pro kontrolu skriptu nasazení před spuštěním.
Proces publikování je idempotentní, takže můžete stejný .dacpac proces nasadit několikrát, aniž by to způsobilo problémy. Tento přístup umožňuje nasazení do více prostředí (vývoj, příprava, produkční prostředí) pomocí stejného zkompilovaného artefaktu.
Podrobné informace o možnostech nasazení a konfiguraci najdete v tématu Začínáme s projekty databáze SQL.