Herstellen einer Verbindung mit einer Datenbank mit der MSSQL-Erweiterung für Visual Studio Code

Die MSSQL-Erweiterung für Visual Studio Code konzentriert sich auf Ihre Verbindungen zu SQL Server, Azure SQL und SQL-Datenbank in Microsoft Fabric. In diesem Artikel erfahren Sie, wie Sie Verbindungen mit dem Verbindungsdialogfeld erstellen und welche Authentifizierungstypen die Erweiterung unterstützt. Außerdem wird erläutert, wie gespeicherte Verbindungen im Objekt-Explorer organisiert werden und wie Sie die Verbindung auswählen, die die Erweiterung verwendet, wenn Sie eine neue SQL-Datei öffnen.

Nachdem Sie eine Verbindung hergestellt haben, lesen Sie die Schnellstartanleitung: Führen Sie Ihre erste Abfrage mit der MSSQL-Erweiterung für Visual Studio Code aus, um eine Datenbank zu erstellen, Daten hinzuzufügen und Transact-SQL Anweisungen auszuführen.

Verbindungsdialog

Das Verbindungsdialogfeld ist die primäre Möglichkeit zum Erstellen oder Bearbeiten einer Verbindung. Öffnen Sie es, indem Sie "Verbindung hinzufügen" in der Objekt-Explorer auswählen oder den BEFEHL "MS SQL: Verbindung hinzufügen" aus der Befehlspalette ausführen.

Das Dialogfeld umfasst drei Hauptbereiche:

Ein Formularbereich in der Mitte, in dem Sie Verbindungsdetails eingeben.
Ein Bereich "Gespeicherte Verbindungen " und " Zuletzt verwendete Verbindungen " auf der rechten Seite, in dem Verbindungen aufgelistet werden, die Sie schnell erneut öffnen oder bearbeiten können.
Eine Fußzeile mit der Erweiterten, Testverbindung, "Speichern ohne Verbindung" und " Verbinden" -Aktionen.

Eingabetypen

Am oberen Rand des Formulars steuert die Eingabetypauswahl , wie Verbindungsdetails eingegeben werden. Verwenden Sie den Eingabetyp, der am besten dem entspricht, was Sie bereits über den Zielserver wissen.

Parameter: Füllen Sie einzelne Felder wie Servername, Datenbankname, Authentifizierungstyp, Benutzername und Kennwort aus. Dieser Eingabetyp ist die Standardeinstellung und ist die einfachste Option für die meisten Szenarien.
Connection String: Einfügen eines vollständigen ADO.NET-Verbindungszeichenfolge. Dieser Eingabetyp ist nützlich, wenn Ihnen bereits ein Verbindungszeichenfolge bereitgestellt wurde (z. B. aus dem Azure-Portal oder von einem Administrator), oder wenn Sie Optionen konfigurieren müssen, die in der Parameteransicht nicht verfügbar gemacht werden.
Durchsuchen Sie Azure: Melden Sie sich bei Azure an, und wählen Sie einen Server und eine Datenbank aus Ihren Abonnements aus. Sie können nach Abonnement und Ressourcengruppe filtern, um die gewünschte Datenbank zu finden. Diese Option funktioniert für Azure SQL-Datenbank und Azure SQL Managed Instance (sowohl private als auch öffentliche Endpunkte sind aufgeführt). Sie können Abonnements als Favoriten festlegen, damit sie oben in der Liste angezeigt und automatisch geladen werden.
Durchsuchen Sie Fabric: Melden Sie sich bei Microsoft Fabric an, und wählen Sie eine SQL-Datenbank aus einem Ihrer Arbeitsbereiche aus. Das Dialogfeld listet Arbeitsbereiche auf, auf die Sie Zugriff haben, und die DARIN enthaltenen SQL-Datenbanken. Wie beim Durchsuchen von Azure können Sie arbeitsbereiche als Favoriten festlegen, sodass sie oben in der Liste angezeigt und automatisch geladen werden.

Sowohl "Durchsuchen" Azure als auch "Durchsuchen" Fabric verwenden die Microsoft Konten, mit denen Sie sich bei Visual Studio Code anmelden. Sie können sich mit so vielen Microsoft Konten anmelden, wie Sie möchten, und zwischen Konten und ihren Mandanten wechseln, indem Sie die Dropdowns oben im Bereich "Durchsuchen" verwenden. GitHub Konten können nicht zum Durchsuchen von Azure und Fabric Datenbanken verwendet werden.

Datenbank auswählen

Mit dem Feld "Datenbank " können Sie eine Verbindung mit der Standarddatenbank des Servers oder mit einer bestimmten Datenbank herstellen.

Lassen Sie das Feld auf <"Standard> " festgelegt, um eine Verbindung mit der Standarddatenbank herzustellen, die der Server Ihre Anmeldung zuweist. Dies ist die einfachste Option, und Sie können Datenbanken später noch aus dem Editor wechseln.
Wählen Sie in der Dropdownliste eine bestimmte Datenbank aus. Nachdem Sie genügend Details zur Authentifizierung ausgefüllt haben, versucht die Erweiterung, die Liste der Datenbanken auf dem Server im Hintergrund abzurufen. Wenn die Liste erfolgreich geladen wird, können Sie sie auswählen.
Wenn die Datenbankliste nicht geladen werden kann , z. B. wenn Ihre Anmeldung nicht über die Berechtigung zum Aufzählen von Datenbanken auf dem Server verfügt, können Sie den Datenbanknamen weiterhin direkt in das Feld eingeben.

Erweiterte Einstellungen

Wählen Sie in der Fußzeile "Erweitert" aus, um einen seitlichen Bereich mit den vollständigen Verbindungsoptionen zu öffnen, z. B. "Always Encrypted", "Command Timeout" und "Application Intent " (schreibgeschützt oder schreibgeschützt). Dies sind die gleichen Optionen, die Sie in einer Verbindungszeichenfolge finden, gruppiert in Kategorien wie Sicherheit, Verbindungsresilienz und Pooling. Verwenden Sie das Suchfeld oben im Bereich, um schnell eine bestimmte Einstellung zu finden.

Die Schaltflächen im Fußzeilensteuerelement, was passiert, wenn Sie mit dem Ausfüllen des Formulars fertig sind.

Verbinden: Stellt eine Verbindung mit der Datenbank her und fügt die Verbindung zur Liste der gespeicherten Verbindungen hinzu.
Testverbindung: Versucht, eine Verbindung mit den aktuellen Formularwerten herzustellen, ohne etwas zu speichern. Verwenden Sie diese Einstellung, um zu überprüfen, ob der Server, die Anmeldeinformationen und andere Einstellungen korrekt sind, bevor ein Commit für eine Verbindung ausgeführt wird.
Speichern ohne Herstellen einer Verbindung: Speichert das Verbindungsprofil in Ihrer Liste der gespeicherten Verbindungen, öffnet aber keine Sitzung. Dies ist nützlich, wenn Sie Im Voraus Verbindungen einrichten oder eine vorhandene Verbindung umbenennen möchten, ohne eine Verbindung herzustellen.

Arbeiten mit vorhandenen Verbindungen

Die Listen "Gespeicherte Verbindungen " und " Zuletzt verwendete Verbindungen " auf der rechten Seite des Dialogfelds erleichtern das Starten von einer bereits verwendeten Verbindung.

Zeigen Sie mit der Maus auf eine gespeicherte Verbindung, um ein Aktionsmenü anzuzeigen. Von dort aus können Sie die Details der Verbindung bearbeiten , eine neue Verbindung basierend auf einer vorhandenen Verbindung erstellen (eine nützliche Verknüpfung, wenn mehrere Verbindungen denselben Server, aber unterschiedliche Datenbanken oder Anmeldeinformationen gemeinsam nutzen), oder die Verbindung aus der Liste entfernen.
Zuletzt verwendete Verbindungen funktionieren auf die gleiche Weise, sind jedoch auf Verbindungen beschränkt, die Sie zuletzt verwendet haben, auch wenn sie nicht gespeichert werden.

Unterstützte Authentifizierungstypen

Die MSSQL-Erweiterung unterstützt mehrere Authentifizierungstypen. Wählen Sie die Option aus, die der Konfiguration Ihres Servers entspricht.

Geben Sie einen Benutzernamen und ein Kennwort ein, die für die SQL Server selbst definiert sind. SQL-Anmeldung funktioniert für SQL Server, Azure SQL-Datenbank und Azure SQL Managed Instance.

Sie können das Kennwort optional speichern, damit Sie es nicht jedes Mal erneut eingeben müssen, wenn Sie eine Verbindung herstellen.

Windows-Authentifizierung

Verwenden Sie Ihr aktuelles Windows Konto, um sich beim Server anzumelden, ohne dass Benutzername oder Kennwort erforderlich ist. Windows Authentifizierung funktioniert nur, wenn Sie eine Verbindung mit einer SQL Server Instanz herstellen, die für die Annahme konfiguriert ist, in der Regel in einem in eine Domäne eingebundenen Netzwerk oder auf demselben Computer wie der Server.

Diese Option wird manchmal als integrierte Authentifizierung bezeichnet. Sie ist für Azure SQL-Datenbank, Azure SQL Managed Instance oder SQL-Datenbank in Fabric nicht verfügbar.

Microsoft Entra ID – Universell mit MFA

Melden Sie sich mit einem Microsoft Entra ID Konto an. Diese Option unterstützt die mehrstufige Authentifizierung (MFA), Richtlinien für bedingten Zugriff und persönliche Microsoft Konten, die Gäste in einem Microsoft Entra Mandanten sind.

Wenn Sie diese Option auswählen, fordert das Dialogfeld Sie auf, ein Microsoft Entra ID Konto auszuwählen oder hinzuzufügen, und einen Mandanten auszuwählen, wenn das Konto Zugriff auf mehrere hat.

Die Erweiterung verwendet die Microsoft Konten, mit denen Sie sich bei Visual Studio Code angemeldet haben (die gleichen Konten, die im Menü "Konten" in der unteren linken Ecke des Fensters angezeigt werden). Wenn Sie noch nicht bei Visual Studio Code angemeldet sind oder noch nicht über die MSSQL-Erweiterungsberechtigung für die Verwendung von Konten verfügen, werden Sie aufgefordert, sich bei der Verbindung anzumelden.

Note

Wenn Sie sich zuvor bei der MSSQL-Erweiterung mit dem eigenen Kontosystem der Erweiterung (verwendet in MSSQL 1.42.2 und früher) angemeldet haben, werden Sie aufgefordert, sich bei Visual Studio Code (sofern Sie noch nicht angemeldet sind) anzumelden, wenn Sie das nächste Mal eine Verbindung mit einer Ihrer gespeicherten Verbindungen herstellen.

Wenn Sie Visual Studio Code Kontosystem verwenden, funktioniert es nicht, dass Sie uns mitteilen. Sie können auf den vorherigen Anmeldemechanismus zurückgreifen, indem mssql.preview.useVscodeAccountsForEntraMFA Sie auf false.

Microsoft Entra ID – Standard

Diese Option verwendet Microsoft Entra ID Standardauthentifizierung. Der treiber Microsoft Data SQL (MDS) wählt automatisch eine verfügbare Microsoft Entra ID Identität von Anmeldeinformationsanbietern aus, die auf Ihrem System installiert sind. Dieser Authentifizierungstyp ist nützlich, wenn Sie bestimmte Authentifizierungsanforderungen haben, die von der MSSQL-Erweiterung nicht direkt unterstützt werden.

Identitäten können aus verschiedenen Quellen stammen, z. B. aus einer angemeldeten Azure CLI Sitzung (az login) oder Umgebungsvariablen, und Sie können eine bestimmte Identität leiten, die verwendet werden soll, indem Sie das User name Feld festlegen. Weitere Informationen dazu, wie die Standardauthentifizierung eine Identität auswählt, finden Sie unter DefaultAzureCredential in der Azure Identity-Clientbibliothek

Microsoft Entra ID – Dienstprinzipal

Authentifizieren als Microsoft Entra ID Dienstprinzipal (eine Anwendungsidentität anstelle eines Benutzers). Verwenden Sie diese Option für Automatisierungsszenarien, freigegebene Arbeitsstationen oder in jedem Fall, in denen es vorzuziehen ist, datenbankzugriff auf eine Anwendungsidentität anstelle einer Person zu gewähren.

Wenn Sie diese Option auswählen, werden die Felder "Benutzername " und "Kennwort " erneut verwendet:

Geben Sie die Anwendungs-ID (Client) des Dienstprinzipals als Benutzernamen ein.
Geben Sie den geheimen Clientschlüssel des Dienstprinzipals als Kennwort ein.

Weitere Informationen zur Verwendung eines Dienstprinzipals mit SQL finden Sie unter Dienstprinzipal in der Azure Identity-Clientbibliothek

Verbindungen im Objekt-Explorer

Jede Verbindung, die Sie aus dem Verbindungsdialogfeld erstellen (unabhängig davon, ob Sie sofort eine Verbindung herstellen oder ohne Verbindung speichern) wird in der Objekt-Explorer in der MSSQL-Ansicht angezeigt. Die Objekt-Explorer ist der Ort, an dem Sie serverinhalte durchsuchen, Aktionen wie Sicherungen ausführen und eine erneute Verbindung mit Datenbanken herstellen, die Sie zuvor verwendet haben.

Verbindungsgruppen

Verbindungen können in Verbindungsgruppen organisiert werden. Gruppen fungieren wie Ordner: Sie können sie benennen, eine Farbe zuweisen und Verbindungen darin platzieren, um Umgebungen visuell voneinander getrennt zu halten (z. B. "Produktion", "Staging" und "Lokal").

Erstellen Sie eine Gruppe: Verwenden Sie den Befehl "Neue Verbindungsgruppe ", oder weisen Sie beim Erstellen oder Bearbeiten einer Verbindung eine neue Gruppe zu.
Ziehen Und ablegen, um sie zu organisieren: Ziehen Sie eine Verbindung auf eine Gruppe, um sie in diese Gruppe zu verschieben. Ziehen Sie eine Gruppe auf eine andere Gruppe, um sie zu verschachteln. Sie können geschachtelte Gruppen mehrere Ebenen tief erstellen.
Erweitern und reduzieren: Verwenden Sie die Chevrons neben jeder Gruppe, um sie zu erweitern und zu reduzieren, sodass nur die Verbindungen angezeigt werden, mit denen Sie gerade arbeiten. Um immer mit Gruppen zu beginnen, die beim Starten Visual Studio Code reduziert wurden, aktivieren Sie die mssql.collapseConnectionGroupsOnStartup Einstellung.

Klicken Sie mit der rechten Maustaste auf eine Serververbindung im Objekt-Explorer, um Aktionen anzuzeigen, die für die Verbindung selbst gelten. Zu den am häufigsten verwendeten Verbindungsoptionen gehören:

Verbinden / Verbindung trennen: Starten oder Beenden einer Sitzung mit dem Server.
Verbindung bearbeiten: Öffnen Sie das Verbindungsdialogfeld, in dem das Verbindungsprofil geladen wurde, um die Parameter zu bearbeiten.
Kopieren Sie Connection String: Kopieren Sie eine Verbindungszeichenfolge für die gespeicherte Verbindung in die Zwischenablage. Dies ist praktisch, wenn Sie die Verbindung mit einem anderen Tool teilen oder in Anwendungscode einfügen müssen. Kennwörter und geheime Schlüssel sind nicht enthalten.
Verbindung entfernen: Löschen Sie die Verbindung aus Ihrer gespeicherten Liste.

Firewallregeln für Azure SQL

Wenn Sie eine Verbindung mit einem Azure SQL-Datenbank oder Azure SQL Managed Instance von einer Client-IP-Adresse herstellen, die von der Firewall des Servers nicht zulässig ist, können Sie die MSSQL-Erweiterung verwenden, um eine Firewallregel über das Dialogfeld "Firewallregel hinzufügen" hinzuzufügen.

Melden Sie sich im Dialogfeld "Firewallregel hinzufügen" mit einer Microsoft-Konto an, die über die Berechtigung zum Verwalten des Servers verfügt, geben Sie der Regel einen Namen, und wählen Sie aus, ob sie nur Ihre aktuelle IP-Adresse oder einen Bereich zulassen möchten. Nachdem Sie die Regel gespeichert haben, wird die Verbindung automatisch wiederholt.

Workspace-Verbindungen

Gespeicherte Verbindungen und Verbindungsgruppen werden in Ihrem Visual Studio Code settings.jsongespeichert. Die Erweiterung liest Verbindungen aus zwei Bereichen:

Benutzereinstellungen (global): Hier werden neue Verbindungen gespeichert. Sie sind in allen Ihren Visual Studio Code Sitzungen verfügbar, unabhängig davon, welcher Ordner geöffnet ist.
Arbeitsbereichseinstellungen: Auf Arbeitsbereichsebene gespeicherte Verbindungen sind nur verfügbar, wenn dieser Arbeitsbereich geöffnet ist. Dieser Bereich ist nützlich für projektspezifische Verbindungen, die Sie für Mitarbeiter freigeben möchten, indem Sie die Arbeitsbereichsdatei .code-workspace in die Quellcodeverwaltung überprüfen.

Um eine Verbindung von den Benutzereinstellungen in Arbeitsbereichseinstellungen zu verschieben, kopieren Sie den JSON-Eintrag der Verbindung von Ihrem Benutzer settings.json in den Arbeitsbereich settings.json, und löschen Sie sie dann aus der Benutzerkonfiguration.

Note

Die Erweiterung liest keine Verbindungen aus einzelnen Arbeitsbereichsordnereinstellungen (der Ordner pro Ordner .vscode/settings.json innerhalb eines Mehrstammarbeitsbereichs). Wenn eine Verbindung auf ein bestimmtes Projekt angewendet werden soll, speichern Sie sie stattdessen auf Arbeitsbereichsebene.

Wenn Sie eine Verbindung mit einem Kennwort oder geheimen Schlüssel speichern, wird das Kennwort nicht gespeichert settings.json. Kennwörter werden separat im sicheren Anmeldeinformationsspeicher Visual Studio Code gespeichert.

Verbindungsauswahl beim Öffnen einer neuen SQL-Datei oder eines neuen Editors

Wenn Sie eine .sql Datei öffnen oder einen neuen SQL-Editor erstellen, kann die Erweiterung entweder den Editor getrennt lassen oder automatisch eine Verbindung herstellen.

Dieses Verhalten wird durch die mssql.newEditorConnectionBehavior Einstellung gesteuert, die drei Modi unterstützt:

Modus	Description
`none`	Neue SQL-Editoren werden ohne Verbindung geöffnet. Sie werden aufgefordert, beim ersten Ausführen einer Abfrage eine Verbindung zu wählen, oder Sie können den Befehl "SQL: Verbinden" verwenden, um eine Verbindung manuell anzufügen.
`transferActive` (Standardwert)	Neue SQL-Editoren werden automatisch mit derselben Datenbank verbunden wie der aktuell aktive SQL-Editor. Dies ist praktisch, wenn Sie an mehreren Dateien für dieselbe Datenbank arbeiten und nicht jede datenbank erneut verbinden möchten. Wenn derzeit kein SQL-Editor aktiv ist, wird der neue Editor ohne Verbindung geöffnet.
`defaultConnection`	Neue SQL-Editoren werden automatisch mit einer bestimmten Verbindung verbunden, die Sie als Standard festgelegt haben. Die Standardverbindung wird durch die `mssql.defaultConnectionId` Einstellung identifiziert. Um diesen Modus zu verwenden, müssen Sie auch die ID einer Ihrer gespeicherten Verbindungen festlegen `mssql.defaultConnectionId` . Sie finden die ID, indem Sie ihre gespeicherten Verbindungen in `settings.json`. Wenn `mssql.defaultConnectionId` nicht festgelegt oder nicht mehr mit einer gespeicherten Verbindung übereinstimmt, werden Sie von der Erweiterung aufgefordert, beim nächsten Öffnen eines neuen SQL-Editors eine Standardverbindung auszuwählen.

Sie können diese Einstellungen über die Visual Studio Code Einstellungs-UI ändern, indem Sie nach mssql.newEditorConnectionBehavior oder .mssql.defaultConnectionId

Feedback

War diese Seite hilfreich?

Last updated on 2026-06-23