Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL Database w Microsoft Fabric
Projekty SQL zawierają pliki deklaratywne (instrukcja CREATE) dla wszystkich obiektów w bazie danych, takich jak tabele, widoki i procedury składowane. Te pliki mogą służyć do tworzenia nowych baz danych, aktualizowania istniejących baz danych, a nawet śledzenia bazy danych w kontroli źródła. Często zaczynamy od projektu SQL, gdy mamy istniejącą bazę danych i chcemy utworzyć obiekty w projekcie SQL, które są zgodne z bazą danych przy minimalnym nakładzie pracy.
Niektóre narzędzia projektów SQL obejmują jeden krok tworzenia nowego projektu SQL z istniejącej bazy danych. Inne narzędzia wymagają wykonania kilku kroków w celu utworzenia nowego projektu SQL, a następnie zaimportowania obiektów z istniejącej bazy danych. Z wyjątkiem instrukcji programu Visual Studio (SQL Server Data Tools), przewodnik koncentruje się na projektach SQL w stylu zestawu SDK.
Dla opcji 1 w tym samouczku:
Krok 1: utworzyć nowy projekt SQL na podstawie istniejącej bazy danych Krok 2: skompilować projekt SQL
Jeśli wybierzesz opcję 2 w tym samouczku, wykonasz następujące czynności:
- Krok 1: utworzyć nowy pusty projekt SQL
- Krok 2: importować obiekty z istniejącej bazy danych
- Krok 3: skompilować projekt SQL
Warunki wstępne
- .NET 8 SDK
- Visual Studio 2022 Community, Professional lub Enterprise
- SQL Server Data Tools, zestaw SDK (wersja zapoznawcza) zainstalowany w programie Visual Studio 2022
- SqlPackage interfejs wiersza poleceń
# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage
- SDK .NET 8
- VS Code
- rozszerzenie SQL Database Projects dla programu Azure Data Studio lub rozszerzenia SQL Database Projects dla programu VS Code
# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage
# install Microsoft.Build.Sql.Templates
dotnet new install Microsoft.Build.Sql.Templates
Notatka
Aby ukończyć samouczek, musisz mieć dostęp do instancji Azure SQL lub SQL Server. Możesz programować lokalnie bezpłatnie za pomocą programu SQL Server Developer Edition w systemie Windows lub w kontenerach .
Opcja 1. Tworzenie nowego projektu SQL z istniejącej bazy danych
Krok 1. Tworzenie nowego projektu SQL z istniejącej bazy danych
W eksploratorze obiektów programu SQL Server w programie Visual Studio kliknij prawym przyciskiem myszy bazę danych, z której chcesz utworzyć projekt, a następnie wybierz pozycję Utwórz nowy projekt....
W oknie dialogowym tworzenie nowego projektu podaj nazwę projektu, która nie musi być zgodna z nazwą bazy danych. Zweryfikuj i zmodyfikuj lokalizację projektu zgodnie z potrzebami. Domyślne ustawienia importu importują obiekty do folderów najpierw według schematu, a następnie według typu obiektu. Możesz zmodyfikować ustawienia importu, aby zmienić strukturę folderów lub uwzględnić uprawnienia do importowanych obiektów. Rozpocznij import.
Podczas importowania postęp jest wyświetlany w formie komunikatów w oknie dialogowym Importowanie bazy danych. Po zakończeniu importowania zaimportowane obiekty są widoczne w eksploratorze rozwiązań , a dzienniki są przechowywane w pliku w katalogu projektu w Import Schema Logs. Wybierz pozycję Zakończ.
Opcja 1 nie jest dostępna dla wiersza polecenia. Zamiast tego użyj opcji 2.
W widoku eksploratora obiektów bazy danych w programie VS Code lub usłudze Azure Data Studio wybierz bazę danych, z której chcesz utworzyć projekt. Kliknij prawym przyciskiem myszy bazę danych i wybierz pozycję Utwórz projekt z bazy danych.
W narzędziu Azure Data Studio okno dialogowe tworzenia projektu z bazy danych wymaga wybrania nazwy i lokalizacji projektu. Domyślne ustawienia importu importują obiekty do folderów najpierw według schematu, a następnie według typu obiektu. Możesz wybrać inną strukturę folderów lub dołączyć uprawnienia do importowanych obiektów przed wybraniem Utwórz.
W programie VS Code wiersze polecenia pytają o nazwę i lokalizację projektu. Domyślne ustawienia importu importują obiekty do folderów najpierw według schematu, a następnie według typu obiektu. Możesz wybrać inną strukturę folderów lub dołączyć uprawnienia do importowanych obiektów przed rozpoczęciem importowania.
Otwórz widok Database Projects, aby wyświetlić nowy projekt i zaimportowane definicje obiektów.
Opcja 1 nie jest dostępna dla wiersza polecenia. Zamiast tego użyj opcji 2.
Krok 2. Kompilowanie projektu SQL
Proces kompilacji weryfikuje relacje między obiektami i składnią względem platformy docelowej określonej w pliku projektu. Dane wyjściowe artefaktu z procesu kompilacji to plik .dacpac, którego można użyć do wdrożenia projektu w docelowej bazie danych i zawiera skompilowany model schematu bazy danych.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Build.
Zostanie automatycznie otwarte okno danych wyjściowych w celu wyświetlenia procesu kompilacji. Jeśli występują błędy lub ostrzeżenia, są one wyświetlane w oknie danych wyjściowych. W przypadku pomyślnej kompilacji artefakt kompilacji (plik.dacpac) jest tworzony, a jego lokalizacja jest uwzględniona w danych wyjściowych kompilacji (wartość domyślna to bin\Debug\projectname.dacpac).
Opcja 1 nie jest dostępna dla wiersza polecenia. Zamiast tego użyj opcji 2.
W widoku Database Projects programu VS Code lub Azure Data Studio kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Build.
Zostanie automatycznie otwarte okno danych wyjściowych w celu wyświetlenia procesu kompilacji. Jeśli występują błędy lub ostrzeżenia, są one wyświetlane w oknie danych wyjściowych. W przypadku pomyślnej kompilacji artefakt kompilacji (plik.dacpac) jest tworzony, a jego lokalizacja jest uwzględniona w danych wyjściowych kompilacji (wartość domyślna to bin/Debug/projectname.dacpac).
Opcja 1 nie jest dostępna dla wiersza polecenia. Zamiast tego użyj opcji 2.
Opcja 2. Tworzenie nowego pustego projektu SQL i importowanie obiektów z istniejącej bazy danych
Alternatywnie można wykonać kroki tworzenia projektu i importowania obiektów oddzielnie.
Krok 1. Tworzenie nowego pustego projektu SQL
Rozpoczynamy projekt od utworzenia nowego projektu bazy danych SQL przed zaimportowaniem do niego obiektów.
Wybierz pozycję Plik, Nowy, a następnie Projekt.
W oknie dialogowym Nowy projekt użyj terminu SQL Server w polu wyszukiwania. Najlepszym wynikiem powinno być projekt bazy danych programu SQL Server.
Wybierz pozycję Dalej, aby przejść do następnego kroku. Podaj nazwę projektu, która nie musi być zgodna z nazwą bazy danych. Zweryfikuj i zmodyfikuj lokalizację projektu zgodnie z potrzebami.
Wybierz pozycję Utwórz, aby utworzyć projekt. Pusty projekt jest otwierany i widoczny w Eksploratorze rozwiązań do edycji.
Wybierz pozycję Plik, Nowy, a następnie Projekt.
W oknie dialogowym Nowy projekt użyj terminu SQL Server w polu wyszukiwania. Najlepszym wynikiem powinien być Projekt bazy danych SQL Server w stylu SDK (wersja zapoznawcza).
Wybierz pozycję Dalej, aby przejść do następnego kroku. Podaj nazwę projektu, która nie musi być zgodna z nazwą bazy danych. Zweryfikuj i zmodyfikuj lokalizację projektu zgodnie z potrzebami.
Wybierz pozycję Utwórz, aby utworzyć projekt. Pusty projekt jest otwierany i widoczny w Eksploratorze rozwiązań do edycji.
W widoku Database Projects programu VS Code lub Azure Data Studio wybierz przycisk Nowy projekt.
Pierwszy monit określa, który szablon projektu ma być używany, głównie na podstawie tego, czy platforma docelowa jest programem SQL Server, czy usługą Azure SQL. Jeśli zostanie wyświetlony monit o wybranie określonej wersji programu SQL, wybierz wersję zgodną z docelową bazą danych, ale jeśli docelowa wersja bazy danych jest nieznana, wybierz najnowszą wersję, ponieważ wartość można zmodyfikować później.
Wprowadź nazwę projektu w wyświetlonym tekście, który nie musi być zgodny z nazwą bazy danych.
W wyświetlonym oknie dialogowym "Wybierz folder" wybierz katalog, w którym znajdą się folder projektu, plik .sqlproj oraz inne treści.
Po wyświetleniu monitu o utworzenie projektu w stylu zestawu SDK wybierz pozycję Tak.
Po zakończeniu pusty projekt zostanie otwarty i widoczny w widoku Database Projects do edycji.
Po zainstalowaniu szablonów platformy .NET dla projektów Microsoft.Build.Sql można utworzyć nowy projekt bazy danych SQL z poziomu wiersza polecenia. Opcja -n określa nazwę projektu, a opcja -tp określa platformę docelową projektu.
Użyj opcji -h, aby wyświetlić wszystkie dostępne opcje.
# install Microsoft.Build.Sql.Templates
dotnet new sqlproject -n MyDatabaseProject
Krok 2. Importowanie obiektów z istniejącej bazy danych
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Importuj —> Database.... Jeśli ta opcja jest wyłączona, projekt bazy danych może zawierać obiekty utworzone w nim. Możesz usunąć obiekty lub utworzyć nowy projekt.
W oknie dialogowym Importuj bazę danych wybierz połączenie z bazą danych, z której chcesz zaimportować obiekty. Jeśli nawiązaliśmy połączenie z bazą danych w Eksploratorze obiektów programu SQL Server, znajduje się ona na liście historii.
Domyślne ustawienia importu importują obiekty do folderów najpierw według schematu, a następnie według typu obiektu. Możesz zmodyfikować ustawienia importu, aby zmienić strukturę folderów lub uwzględnić uprawnienia do importowanych obiektów. Rozpocznij import.
Podczas importowania postęp jest wyświetlany w formie komunikatów w oknie dialogowym Importowanie bazy danych. Po zakończeniu importowania zaimportowane obiekty są widoczne w eksploratorze rozwiązań , a dzienniki są przechowywane w pliku w katalogu projektu w Import Schema Logs. Wybierz Zakończ, aby powrócić do projektu.
Użyjemy interfejsu wiersza polecenia sqlPackage do zaimportowania obiektów z istniejącej bazy danych do nowego projektu bazy danych SQL utworzonego w programie Visual Studio w kroku 1. Następujące polecenie SqlPackage importuje schemat bazy danych do folderu MyDatabaseProject, zorganizowanego według zagnieżdżonych folderów zgodnie ze schematem i typem obiektu.
sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
Gdy te foldery są umieszczane w folderze projektu bazy danych SQL w stylu zestawu SDK, są one automatycznie dołączane do projektu bez konieczności importowania ich lub modyfikowania pliku projektu SQL.
Notatka
Rozszerzenie SQL Database Projects w programie VS Code nie obsługuje importowania obiektów z bazy danych do projektu. Użyj rozszerzenia SQL Database Projects w narzędziu Azure Data Studio, aby zaimportować obiekty z bazy danych lub skorzystać z opcji 1, aby utworzyć nowy projekt z istniejącej bazy danych w programie VS Code.
W rozszerzeniu SQL Database Projects w narzędziu Azure Data Studio otwórz widok „Database Projects”. Kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Aktualizuj projekt z bazy danych.
W oknie dialogowym Update Database wybierz połączenie z bazą danych, z której chcesz zaimportować obiekty. Jeśli nawiązałeś połączenie z bazą danych w widoku połączeń, znajduje się ona na liście historii.
Wybierz pozycję Wyświetl zmiany w schemacie compare, aby przejrzeć i wybrać podzbiór obiektów do zaimportowania lub Zastosuj wszystkie zmiany, aby zaimportować wszystkie obiekty.
Interfejs wiersza polecenia sqlPackage może służyć do wyodrębniania schematu istniejącej bazy danych do pliku .dacpac lub pojedynczych plików .sql. Następujące polecenie SqlPackage wyodrębnia schemat bazy danych do plików .sql zorganizowanych w zagnieżdżone foldery według schematów i typów obiektów.
sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SchemaObjectType
Gdy te foldery są umieszczane w folderze projektu bazy danych SQL w stylu zestawu SDK, są one automatycznie dołączane do projektu bez konieczności importowania ich lub modyfikowania pliku projektu SQL.
Krok 3. Kompilowanie projektu SQL
Proces kompilacji weryfikuje relacje między obiektami i składnią względem platformy docelowej określonej w pliku projektu. Dane wyjściowe artefaktu z procesu kompilacji to plik .dacpac, którego można użyć do wdrożenia projektu w docelowej bazie danych i zawiera skompilowany model schematu bazy danych.
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Build.
Zostanie automatycznie otwarte okno danych wyjściowych w celu wyświetlenia procesu kompilacji. Jeśli występują błędy lub ostrzeżenia, są one wyświetlane w oknie danych wyjściowych. W przypadku pomyślnej kompilacji artefakt kompilacji (plik.dacpac) jest tworzony, a jego lokalizacja jest uwzględniona w danych wyjściowych kompilacji (wartość domyślna to bin\Debug\projectname.dacpac).
W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Build.
Zostanie automatycznie otwarte okno danych wyjściowych w celu wyświetlenia procesu kompilacji. Jeśli występują błędy lub ostrzeżenia, są one wyświetlane w oknie danych wyjściowych. W przypadku pomyślnej kompilacji artefakt kompilacji (plik.dacpac) jest tworzony, a jego lokalizacja jest uwzględniona w danych wyjściowych kompilacji (wartość domyślna to bin\Debug\projectname.dacpac).
W widoku Database Projects programu VS Code lub Azure Data Studio kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Build.
Zostanie automatycznie otwarte okno danych wyjściowych w celu wyświetlenia procesu kompilacji. Jeśli występują błędy lub ostrzeżenia, są one wyświetlane w oknie danych wyjściowych. W przypadku pomyślnej kompilacji artefakt kompilacji (plik.dacpac) jest tworzony, a jego lokalizacja jest uwzględniona w danych wyjściowych kompilacji (wartość domyślna to bin/Debug/projectname.dacpac).
Projekty bazy danych SQL można tworzyć z poziomu wiersza polecenia przy użyciu polecenia dotnet build.
dotnet build
# optionally specify the project file
dotnet build MyDatabaseProject.sqlproj
Dane wyjściowe kompilacji zawierają błędy lub ostrzeżenia oraz określone pliki i numery wierszy, w których występują. W przypadku pomyślnej kompilacji artefakt kompilacji (plik.dacpac) jest tworzony, a jego lokalizacja jest uwzględniona w danych wyjściowych kompilacji (wartość domyślna to bin/Debug/projectname.dacpac).