Dodawanie połączenia z usługą Azure SQL Database

Program Visual Studio umożliwia połączenie dowolnej z następujących funkcji z usługą Azure SQL Database przy użyciu funkcji Połączenie ed Services:

  • Aplikacja konsolowa .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (w tym aplikacja konsolowa, WPF, Windows Forms, biblioteka klas)
  • Rola procesu roboczego platformy .NET Core
  • Azure Functions
  • aplikacja platforma uniwersalna systemu Windows
  • Xamarin
  • Cordova

Funkcja połączonej usługi dodaje wszystkie wymagane odwołania i kod połączenia do projektu oraz odpowiednio modyfikuje pliki konfiguracji.

Uwaga

Ten temat dotyczy programu Visual Studio w systemie Windows. Aby uzyskać Visual Studio dla komputerów Mac, zobacz usługi Połączenie w Visual Studio dla komputerów Mac.

Wymagania wstępne

Połączenie do usługi Azure SQL Database przy użyciu usług Połączenie

  1. Otwórz projekt w programie Visual Studio.

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł usługi Połączenie, a następnie z menu kontekstowego wybierz polecenie Dodaj, aby otworzyć menu dostępnych usług.

    Screenshot showing Connected Services context menu options.

  3. Wybierz pozycję Baza danych programu SQL Server. Zostanie wyświetlona strona Połączenie zależności. Powinna zostać wyświetlona kilka opcji:

    • SQL Server Express LocalDB, wbudowana oferta usługi SQL Database zainstalowana w programie Visual Studio
    • Baza danych programu SQL Server w lokalnym kontenerze na maszynie
    • Sql Server Database — lokalny program SQL Server w sieci lokalnej
    • Usługa Azure SQL Database dla usługi SQL Database uruchomiona jako usługa platformy Azure

    Możesz zmniejszyć koszty i uprościć wczesne programowanie, zaczynając od lokalnej bazy danych. Możesz przeprowadzić migrację do usługi na żywo na platformie Azure później, powtarzając te kroki i wybierając inną opcję. Jeśli tworzysz bazę danych lokalnie, którą chcesz ponownie utworzyć na platformie Azure, możesz przeprowadzić migrację bazy danych na platformę Azure w tym czasie.

    Screenshot showing SQL Database choices.

    Jeśli chcesz nawiązać połączenie z usługą platformy Azure, przejdź do następnego kroku lub jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure przed kontynuowaniem. Jeśli nie masz konta platformy Azure, możesz skorzystać z bezpłatnej wersji próbnej.

  4. Na ekranie Konfigurowanie usługi Azure SQL Database wybierz istniejącą usługę Azure SQL Database, a następnie wybierz pozycję Dalej.

    Jeśli musisz utworzyć nowy składnik, przejdź do następnego kroku. W przeciwnym razie przejdź do kroku 7.

    Screenshot showing

  5. Aby utworzyć bazę danych Azure SQL Database:

    1. Wybierz pozycję Utwórz nowy przy użyciu zielonego znaku plusa.

    2. Wypełnij pole Azure SQL Database: Utwórz nowy ekran i wybierz pozycję Utwórz.

      Screenshot showing

    3. Po wyświetleniu ekranu Konfigurowanie usługi Azure SQL Database na liście zostanie wyświetlona nowa baza danych. Wybierz nową bazę danych z listy, a następnie wybierz pozycję Dalej.

  6. Wprowadź nazwę parametry połączenia lub wybierz wartość domyślną, a następnie wybierz, czy parametry połączenia przechowywany w lokalnym pliku wpisów tajnych, czy w usłudze Azure Key Vault.

    Screenshot showing

  7. Na ekranie Podsumowanie zmian zostaną wyświetlone wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz przycisk Zakończ.

    Screenshot showing

    Jeśli zostanie wyświetlony monit o ustawienie reguł zapory, wybierz pozycję Tak.

    Screenshot showing firewall rules.

  8. W Eksplorator rozwiązań kliknij dwukrotnie węzeł usługi Połączenie, aby otworzyć kartę usługi Połączenie ed. Połączenie zostanie wyświetlone w sekcji Zależności usługi:

    Screenshot showing

    Jeśli klikniesz trzy kropki obok dodanej zależności, zobaczysz różne opcje, takie jak Połączenie, aby ponownie otworzyć kreatora i zmienić połączenie. Możesz również kliknąć trzy kropki w prawym górnym rogu okna, aby wyświetlić opcje uruchamiania zależności lokalnych, zmiany ustawień i nie tylko.

Uzyskiwanie dostępu do parametry połączenia

Dowiedz się, jak bezpiecznie przechowywać wpisy tajne, postępując zgodnie z Sejf przechowywaniem wpisów tajnych aplikacji podczas programowania w usłudze ASP.NET Core. W szczególności, aby odczytać parametry połączenia z magazynu wpisów tajnych, można dodać kod, jak w temacie Odczyt wpisu tajnego za pośrednictwem interfejsu API konfiguracji. Zobacz również wstrzykiwanie zależności w ASP.NET Core.

Migracje programu Entity Framework

Praca z lokalnym magazynem danych podczas wczesnego programowania może być wygodna, ale gdy wszystko będzie gotowe do przejścia do chmury, możesz użyć obsługi programu Visual Studio w celu przeniesienia bazy danych lub scalenia zmian ze zdalnym magazynem danych. Zobacz Omówienie migracji.

Na karcie usługi Połączenie można znaleźć polecenia migracji, klikając trzy kropki, jak pokazano na zrzucie ekranu:

Screenshot showing migration commands.

Dostępne są polecenia służące do tworzenia nowych migracji, stosowania ich bezpośrednio lub generowania skryptów SQL, które stosują migracje.

Dodawanie migracji

Po wprowadzeniu zmiany modelu danych można użyć narzędzi Platformy Entity Framework Core, aby dodać odpowiednią migrację, która opisuje w kodzie aktualizacje niezbędne do synchronizacji schematu bazy danych. Program Entity Framework Core porównuje bieżący model z migawką starego modelu w celu określenia różnic i generuje pliki źródłowe migracji. Pliki są dodawane do projektu, zwykle w folderze o nazwie Migrations (Migracje ) i mogą być śledzone w kontroli źródła projektu, podobnie jak w przypadku dowolnego innego pliku źródłowego.

Po wybraniu tej opcji zostanie wyświetlona prośba o podanie nazwy klasy kontekstowej reprezentującej schemat bazy danych, który chcesz przeprowadzić migrację.

Screenshot showing adding an Entity Framework migration.

Aktualizowanie bazy danych

Po utworzeniu migracji można ją zastosować do bazy danych. Program Entity Framework aktualizuje bazę danych i schemat wraz ze zmianami określonymi w kodzie migracji. Po wybraniu tej opcji zostanie wyświetlona prośba o podanie nazwy klasy kontekstowej reprezentującej schemat bazy danych, który chcesz przeprowadzić migrację.

Generowanie skryptu SQL

Zalecanym sposobem wdrażania migracji do produkcyjnej bazy danych jest generowanie skryptów SQL. Zalety tej strategii obejmują następujące elementy:

  • Skrypty SQL można przeglądać pod kątem dokładności; Jest to ważne, ponieważ stosowanie zmian schematu w produkcyjnych bazach danych jest potencjalnie niebezpieczną operacją, która może obejmować utratę danych.
  • W niektórych przypadkach skrypty można dostosować do określonych potrzeb produkcyjnej bazy danych.
  • Skrypty SQL mogą być używane w połączeniu z technologią wdrażania, a nawet mogą być generowane w ramach procesu ciągłej integracji.
  • Skrypty SQL mogą być udostępniane administratorowi bazy danych i mogą być zarządzane i archiwizowane oddzielnie.

W przypadku korzystania z tej opcji zostanie wyświetlona prośba o klasę kontekstu bazy danych i lokalizację pliku skryptu.

Screenshot showing the Generate SQL script option.

Otwórz w programie SQL Server Eksplorator obiektów

Dla wygody to polecenie umożliwia przejście do Eksplorator obiektów programu SQL Server, dzięki czemu można wyświetlać tabele i inne jednostki bazy danych oraz pracować bezpośrednio z danymi. Zobacz Eksplorator obiektów.

Screenshot showing SQL Server Object Explorer.

Następne kroki

Możesz kontynuować pracę z przewodnikami Szybki start dla usługi Azure SQL Database, ale zamiast rozpoczynać się od początku, możesz rozpocząć od momentu skonfigurowania początkowego połączenia. Jeśli używasz programu Entity Framework, możesz rozpocząć od sekcji Dodawanie kodu w celu nawiązania połączenia z usługą Azure SQL Database. Jeśli używasz SqlClient klas danych lub ADO.NET, możesz rozpocząć od sekcji Dodawanie kodu w celu nawiązania połączenia z usługą Azure SQL Database.

Kod nie będzie dokładnie zgodny z tym, co jest używane w przewodnikach Szybki start, które używają innego sposobu uzyskiwania parametry połączenia. Parametry połączenia są wpisami tajnymi i są bezpiecznie przechowywane zgodnie z opisem w Sejf przechowywania wpisów tajnych aplikacji podczas programowania w usłudze ASP.NET Core. W szczególności, aby odczytać parametry połączenia z magazynu wpisów tajnych, można dodać kod, jak w temacie Odczyt wpisu tajnego za pośrednictwem interfejsu API konfiguracji. W projektach ASP.NET Core parametry połączenia utworzone przez usługi Połączenie są dostępne w obiekcie konfiguracji. Dostęp do niego można uzyskać za pomocą właściwości WebApplicationBuilder klasy (builder w wielu szablonach projektów), jak w poniższym przykładzie:

var connection = builder.Configuration["ConnectionStrings:ConnectionString1"];