Freigeben über


Lokaler SQL Server-Container

Das Feature "Lokaler SQL Server-Container" in der MSSQL-Erweiterung für Visual Studio Code vereinfacht die lokale Entwicklung, indem Entwickler vollständig konfigurierte SQL Server-Container bereitstellen können, ohne einen einzelnen Docker-Befehl zu schreiben. Sie können Container direkt in der Ansicht "Verbindungen" bereitstellen und verwalten. Diese neue Funktion eignet sich perfekt für die Prototyperstellung, Entwicklung oder das Testen von Workloads mit derselben Datenbank-Engine, die in Produktionsumgebungen verfügbar ist.

Ein Screenshot zeigt die Animation des Assistenten für lokale Container, Element eins.

Standardmäßig verwendet der Container-Assistent SQL Server 2025 (17.x), der KI-fähige Funktionen wie Vektordatentypen und JSON-Funktionen enthält. Sie können auch je nach Testanforderungen aus SQL Server 2022 (16.x), SQL Server 2019 (15.x) oder SQL Server 2017 (14.x) wählen.

Ein Screenshot zeigt die Animation des Assistenten für lokale Container, zweites Element.

Hinweis

Die Umgebung des lokalen SQL Server-Containers funktioniert unter macOS, Windows und Linux, solange Docker Desktop (oder eine entsprechung) im Linux-Containermodus ausgeführt wird.

Funktionen

Der lokale SQL Server-Container in der MSSQL-Erweiterung bietet die folgenden Funktionen:

  • Erstellen Sie einen lokalen SQL Server-Container, ohne Docker-Befehle zu schreiben.
  • Wählen Sie aus mehreren SQL Server-Versionen (SQL Server 2025 (17.x) (Standard), SQL Server 2022 (16.x), SQL Server 2019 (15.x) und SQL Server 2017 (14.x)).
  • Passen Sie den Containernamen, den Hostnamen und den Port an.
  • Überprüfen Sie die Docker-Installation und den Status vor der Bereitstellung automatisch.
  • Weisen Sie automatisch einen verfügbaren Port zu, wenn 1433 bereits verwendet wird.
  • Automatische Verbindung und Beibehaltung der Verbindungseinstellungen bei Neustarts des Containers.
  • Verwalten des Containerlebenszyklus (Start, Beenden, Löschen) aus dem Kontextmenü in der Connections-Ansicht.
  • Wird mit allen kernen MSSQL-Erweiterungsfeatures verwendet, einschließlich Objekt-Explorer, Tabellen-Designer, Schema-Designer, Abfrage-Editor und GitHub Copilot.

Von Bedeutung

Lokale Container sind nur für die Entwicklung vorgesehen. Die Bereitstellung in der Produktion wird nicht unterstützt.

Erstellen eines lokalen Containers

So erstellen Sie einen lokalen SQL Server-Container:

  1. Wählen Sie in der Ansicht "Verbindungen " im Menü die Option " Lokalen SQL-Container erstellen " aus.

    Screenshot, der zeigt, wie Sie die lokale SQL Server-Containeroption in der MSSQL-Erweiterung erstellen.

  2. Sehen Sie sich den Übersichtsbildschirm an, der hervorhebung, was Sie von der lokalen SQL Server-Containererfahrung erwarten können.

    Wenn Sie fertig sind, wählen Sie "Erste Schritte " aus, um den Vorgang fortzusetzen.

    Screenshot des Übersichtsbildschirms für die lokale SQL Server-Containerbereitstellung mit hilfreichen Links und Schaltfläche

  3. Die MSSQL-Erweiterung sucht vor der Bereitstellung automatisch nach Docker:

    • Wenn Docker nicht installiert ist, wird eine Meldung mit einem Installationslink angezeigt. Sie müssen es installieren, bevor Sie fortfahren.
    • Wenn Docker installiert, aber nicht ausgeführt wird, werden Sie aufgefordert, es zu starten. Wenn Das Starten von Docker fehlschlägt, versuchen Sie es erneut, oder brechen Sie den Vorgang ab.

    Sobald alle Voraussetzungen erfüllt sind, wählen Sie "Weiter" aus, um mit der Bereitstellung fortzufahren.

    Screenshot der MsSQL-Erweiterung für die Docker-Voraussetzungsprüfung.

  4. Im Bereich "Bereitstellungseinstellungen":

    1. Wählen Sie die SQL Server-Version (SQL Server 2025 (17.x) ist standardmäßig ausgewählt.
    2. Geben Sie ein Kennwort für das sa Konto ein.
    3. Geben Sie einen Namen für Ihr Verbindungsprofil ein (optional).
    4. Optional die erweiterten Optionen abschließen:
      • Containername
      • Hafen
      • Rechnername
    5. Akzeptieren Sie die Lizenzbedingungen.
    6. Wählen Sie "Container erstellen" aus.

    Screenshot des Konfigurationsformulars für die Containereinrichtung.

Funktionsweise der SQL-Containerbereitstellung

Nachdem Sie " Container erstellen" ausgewählt haben, behandelt die Erweiterung alles für Sie:

  • Ruft das ausgewählte SQL Server-Image ab (sofern noch nicht zwischengespeichert)
  • Erstellt einen SQL Server-Container mit den ausgewählten Einstellungen.
  • Überwacht die Protokolle, um sicherzustellen, dass alle Datenbanken vollständig wiederhergestellt und bereit sind.
  • Erstellt ein Verbindungsprofil und stellt eine Verbindung mit Ihrem Container bereit.

Nach Abschluss der Bereitstellung wird der Container gestartet, und die MSSQL-Erweiterung wird automatisch mit der neuen Datenbank verbunden.

Verwalten Ihres Containers

Um den Container zu verwalten, klicken Sie in der Verbindungsansicht mit der rechten Maustaste auf den Namen des Verbindungsprofils. Im Kontextmenü haben Sie folgende Möglichkeiten:

Starten eines angehaltenen Containers

Die Erweiterung überprüft, ob Docker ausgeführt wird, bevor der Container gestartet wird. Wenn Docker nicht ausgeführt wird, werden Sie aufgefordert, es zu starten.

Einen laufenden Container stoppen

Mit dieser Option wird der Container beendet, während der Datenbankstatus beibehalten wird. Sie können sie jederzeit über dasselbe Menü neu starten.

Löschen des Containers

Mit dieser Option wird der Container und die zugehörigen Daten dauerhaft entfernt. Sie werden aufgefordert, die Bestätigung zu bestätigen, bevor Sie fortfahren.

Screenshot, der zeigt, wie der Containerlebenszyklus in der MSSQL-Erweiterung verwaltet wird.

Von Bedeutung

Durch das Löschen eines Containers wird auch das zugehörige Verbindungsprofil entfernt.

Automatische Wiederverbindungserfahrung

Wenn Ihr Container oder Docker nicht ausgeführt wird, wenn Sie die Verbindung wiederherstellen, fordert die Erweiterung Sie auf, sie zu starten. Es ist keine manuelle Problembehandlung erforderlich.

Unterstützte Szenarien

Sie können lokalen SQL Server-Container mit allen Kernfunktionen der MSSQL-Erweiterung verwenden:

  • Abfrage-Editor und IntelliSense
  • Tabellen-Designer und Schema-Designer
  • GitHub Copilot (eine KI-gestützte Programmierhilfe)
  • Objekt-Explorer und Verbindungsverwaltung

Dieses Feature macht den lokalen SQL Server-Container ideal für:

  • Erstellen von Prototypen neuer Funktionen
  • Testen von Schemaänderungen
  • Ausführen automatisierter Tests in isolierten Umgebungen
  • Experimentieren mit SQL Server 2025-Features (17.x)

Einschränkungen

  • Erfordert, dass Docker Desktop (oder gleichwertig) installiert und ausgeführt wird.
  • Nur Linux-basierte SQL Server-Container werden unterstützt (SQL Server 2017 (14.x) und höhere Versionen).
  • Keine Unterstützung für Podman.
  • Sicherung/Wiederherstellung, Clustering, Skriptinitialisierung und Docker Compose werden nicht über den integrierten Assistenten unterstützt, aber Sie können diese Aufgaben manuell mit externen Tools oder Befehlen ausführen.
  • Entwickelt ausschließlich für die lokale Entwicklung – nicht für den Produktionseinsatz.
  • Probleme mit der Docker-Installation, -Konfiguration oder -Laufzeit müssen vom Benutzer behoben werden.
  • Stellen Sie sicher, dass Ihr Computer über ausreichende Ressourcen verfügt, oder passen Sie die Speicherzuweisung von Docker und die Ressourcenbeschränkungen des Containers über Docker-Einstellungen an, um eine stabile Leistung sicherzustellen.
  • Speicheranforderungen:
    • SQL Server benötigt mindestens 2 GB Arbeitsspeicher, um einen Linux-basierten Container zu starten.
    • Sql Server unter Linux verwendet standardmäßig ca. 80% des für den Container verfügbaren Arbeitsspeichers.