Hinzufügen einer Verbindung zu Azure SQL Datenbank

In Visual Studio können Sie über das Feature Verbundene Dienste eine Verbindung zwischen jedem der folgenden Elemente und Azure SQL-Datenbank herstellen:

• .NET Framework-Konsolen-App
• ASP.NET Model-View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (einschließlich Konsolen-App, WPF, Windows Forms, Klassenbibliothek)
• .NET Core-Workerrolle
• Azure-Funktionen
• App für Universelle Windows-Plattform
• Xamarin
• Cordova

Mit der Funktion für verbundene Dienste werden die benötigten Verweise und der Verbindungscode zu Ihrem Projekt hinzugefügt und Ihre Konfigurationsdateien entsprechend geändert.

Hinweis

Dieses Thema gilt für Visual Studio unter Windows. Informationen zu Visual Studio für Mac finden Sie unter Verbundene Dienste in Visual Studio für Mac.

Voraussetzungen

• Visual Studio mit installierter Azure-Workload
• Ein Projekt eines unterstützten Typs
• Ein Azure-Konto. Wenn Sie nicht über ein Azure-Konto verfügen, aktivieren Sie Ihre Azure-Nutzen für Visual Studio-Abonnenten oder registrieren Sie sich für eine kostenlose Testversion.

Herstellen einer Verbindung mit Azure SQL-Datenbank mithilfe des Features „Verbundene Dienste“

1. Öffnen Sie Ihr Projekt in Visual Studio.

2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü Hinzufügen aus, um das Menü verfügbarer Dienste zu öffnen.

   

3. Wählen Sie SQL Server-Datenbank aus. Die Seite Mit Abhängigkeit verbinden wird angezeigt. Es sollten mehrere Optionen angezeigt werden:

   • SQL Server Express LocalDB, das integrierte SQL-Datenbankangebot, das mit Visual Studio installiert wird
   • SQL Server-Datenbank in einem lokalen Container auf Ihrem Computer
   • SQL-Server-Datenbank, ein lokaler SQL-Server im lokalen Netzwerk
   • Azure SQL Database, für die SQL-Datenbank, die als Azure-Dienst läuft

   Sie können die Kosten senken und die frühe Entwicklung vereinfachen, indem Sie mit einer lokalen Datenbank beginnen. Sie können später in Azure zum Livedienst migrieren, indem Sie diese Schritte wiederholen und eine andere Option auswählen. Wenn Sie eine Datenbank lokal erstellen, die Sie in Azure neu erstellen möchten, können Sie Ihre Datenbank zu diesem Zeitpunkt nach Azure migrieren.

   

   Wenn Sie eine Verbindung mit dem Azure-Dienst herstellen möchten, fahren Sie mit dem nächsten Schritt fort, oder melden Sie sich bei Ihrem Azure-Konto an, bevor Sie fortfahren, falls Sie noch nicht angemeldet sind. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

4. Wählen Sie im Bildschirm Azure SQL-Datenbank konfigurieren eine vorhandene Azure SQL-Datenbank-Instanz und dann Weiter aus.

   Wenn Sie eine neue Komponente erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Andernfalls fahren Sie mit Schritt 7 fort.

   

5. So erstellen Sie eine Azure SQL-Datenbank:

   1. Wählen Sie neben dem grünen Pluszeichen Neu erstellen aus.

   2. Füllen Sie den Bildschirm Azure SQL-Datenbank: Neu erstellen aus, und wählen Sie Erstellen aus.

      

   3. Wenn das Dialogfeld Azure SQL-Datenbank konfigurieren angezeigt wird, befindet sich die neue Datenbank in der Liste. Wählen Sie die neue Datenbank in der Liste und dann Weiter aus.

6. Geben Sie einen Namen für die Verbindungszeichenfolge ein oder wählen Sie den Standardwert, und wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen Geheimnisdatei oder in Azure Key Vault gespeichert werden soll.

   

7. Auf dem Bildschirm Zusammenfassung der Änderungen werden alle Änderungen angezeigt, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abschließen. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

   

   Wenn Sie zum Festlegen einer Firewallregel aufgefordert werden, wählen Sie Ja aus.

   

8. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste, um die Registerkarte Verbundene Dienste zu öffnen. Die Verbindung wird im Abschnitt Dienstabhängigkeiten angezeigt:

   

   Wenn Sie auf die drei Punkte neben der von Ihnen hinzugefügten Abhängigkeit klicken, werden verschiedene Optionen angezeigt, z. B. Verbinden, um den Assistenten erneut zu öffnen und die Verbindung zu ändern. Sie können auch oben rechts im Fenster auf die drei Punkte klicken, um Optionen zum Starten lokaler Abhängigkeiten, Ändern von Einstellungen und mehr anzuzeigen.

Zugreifen auf die Verbindungszeichenfolge

Informationen zum sicheren Speichern von Geheimnissen finden Sie unter Sichere Speicherung von App-Geheimnissen in der Entwicklung in ASP.NET Core. Um insbesondere die Verbindungszeichenfolge aus dem Geheimnisspeicher zu lesen, können Sie wie in Lesen des Geheimnisses über die Konfigurations-API beschrieben Code hinzufügen. Siehe auch Abhängigkeitsinjektion in ASP.NET Core.

Entity Framework-Migrationen

In der Anfangsphase der Entwicklung mag es bequem sein, mit einem lokalen Datenspeicher zu arbeiten. Aber mit Entity Framework Core können Sie, sobald Sie zum Umstieg auf die Cloud bereit sind, die Unterstützung von Visual Studio für die Entity Framework-Migration nutzen, um Ihre Datenbank zu verschieben oder Änderungen mit einem Remotedatenspeicher zusammenzuführen. Weitere Informationen finden Sie unter Migrationsübersicht.

Auf der Registerkarte Verbundene Dienste finden Sie die Migrationsbefehle, indem Sie, wie im Screenshot gezeigt, auf die drei Punkte klicken:

Es stehen dort Befehle zur Verfügung, um neue Migrationen zu erstellen, sie direkt anzuwenden oder SQL-Skripts zum Anwenden der Migrationen zu generieren.

Migration hinzufügen

Wenn eine Datenmodelländerung eingeführt wird, können Sie Entity Framework Core-Tools verwenden, um eine entsprechende Migration hinzuzufügen, die in Code die erforderlichen Aktualisierungen beschreibt, um das Datenbankschema synchron zu halten. Entity Framework Core vergleicht das aktuelle Modell mit einer Momentaufnahme des alten Modells, um die Unterschiede zu ermitteln, und generiert Migrationsquelldateien. Die Dateien werden Ihrem Projekt hinzugefügt, normalerweise in einem Ordner namens Migrations, und können in der Quellcodeverwaltung Ihres Projekts wie jede andere Quelldatei nachverfolgt werden.

Wenn Sie diese Option auswählen, werden Sie aufgefordert, den Namen der Kontextklasse anzugeben, die das Datenbankschema darstellt, das Sie migrieren möchten.

Aktualisieren der Datenbank

Nachdem eine Migration erstellt wurde, kann sie auf eine Datenbank angewendet werden. Entity Framework aktualisiert Ihre Datenbank und Ihr Schema mit den im Migrationscode angegebenen Änderungen. Wenn Sie diese Option auswählen, werden Sie aufgefordert, den Namen der Kontextklasse anzugeben, die das Datenbankschema darstellt, das Sie migrieren möchten.

SQL-Skript generieren

Die empfohlene Möglichkeit zum Bereitstellen von Migrationen in einer Produktionsdatenbank ist das Generieren von SQL-Skripts. Diese Strategie hat u. a. folgende Vorteile:

• SQL-Skripts können auf Richtigkeit überprüft werden. Dies ist wichtig, da das Ändern von Schemas in Produktionsdatenbanken ein potenziell gefährlicher Vorgang ist, der zu Datenverlust führen kann.
• In einigen Fällen können die Skripts so angepasst werden, dass sie den spezifischen Anforderungen einer Produktionsdatenbank entsprechen.
• SQL-Skripts können in Verbindung mit einer Bereitstellungstechnologie verwendet und sogar als Teil Ihres CI-Prozesses generiert werden.
• SQL-Skripts können für einen Datenbankadministrator bereitgestellt und separat verwaltet und archiviert werden.

Bei Wahl dieser Option werden Sie nach der Datenbankkontextklasse und dem Speicherort der Skriptdatei gefragt.

Im SQL Server-Objekt-Explorer öffnen

Mit diesem Befehl können Sie bequem zum SQL Server-Objekt-Explorer wechseln, um Tabellen und andere Datenbankentitäten zu erkunden und direkt mit Ihren Daten zu arbeiten. Weitere Informationen finden Sie unter Objekt-Explorer.

Nächste Schritte

Sie können mit den Schnellstarts für Azure SQL Database fortfahren, aber anstatt von Anfang an zu beginnen, können Sie nach der Einrichtung der ersten Verbindung beginnen. Wenn Sie Entity Framework verwenden, können Sie unter Hinzufügen des Codes zum Herstellen einer Verbindung mit Azure SQL-Datenbank beginnen. Wenn Sie SqlClient oder ADO.NET-Datenklassen verwenden, können Sie unter Hinzufügen des Codes zum Herstellen einer Verbindung mit Azure SQL-Datenbank beginnen.

Ihr Code entspricht nicht genau dem, der in den Schnellstarts verwendet wird, die eine andere Methode zum Abrufen der Verbindungszeichenfolge verwenden. Die Verbindungszeichenfolgen sind Geheimnisse und werden sicher gespeichert, wie unter Sicheres Speichern von App-Geheimnissen in der Entwicklung in ASP.NET Core erläutert wird. Um insbesondere die Verbindungszeichenfolge aus dem Geheimnisspeicher zu lesen, können Sie wie in Lesen des Geheimnisses über die Konfigurations-API beschrieben Code hinzufügen. In ASP.NET Core-Projekten ist die von Verbundene Dienste erstellte Verbindungszeichenfolge in einem Konfigurationsobjekt verfügbar. Sie können über eine Eigenschaft der WebApplicationBuilder-Klasse (builder in vielen Projektvorlagen) darauf zugreifen, wie im folgenden Beispiel gezeigt:

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

Zugehöriger Inhalt

• Produktseite zu Azure SQL-Datenbank
• Dokumentation zu Azure SQL-Datenbank
• Verbundene Dienste (Visual Studio für Mac)