Lokaal bouwen met Azure SQL Database-container en SQL Server-container

Maak een lokale database aan en beheer deze zonder containercommando's te schrijven met behulp van de MSSQL-extensie voor Visual Studio Code. Kies een Azure SQL Database-container (Preview) om te bouwen tegen de Azure SQL Database-engine op uw eigen computer, of een SQL Server-container voor SQL Server-ontwikkeling. Start, stop, maak opnieuw verbinding met en verwijder je container uit de extensie.

Voor een nieuwe applicatie gericht op Azure SQL Database, start je met de Azure SQL Database-container. Het is gratis voor lokale ontwikkeling en testen, vereist geen Azure-abonnement of creditcard, en werkt met de drivers en object-relationele mappers (ORM's) die u gebruikt voor Azure SQL Database.

Opmerking

Azure SQL Database-container is in openbare preview. Het ondersteunt zowel x64- als ARM-apparaten.

Wat is een Azure SQL Database container?

Een container verpakt de database-engine zodat een container-runtime deze op uw computer kan uitvoeren. De MSSQL-extensie begeleidt u door de installatie, downloadt de image, start de engine en slaat een verbinding op. Uw toepassing maakt verbinding met een lokaal adres, zoals localhost,1433, in plaats van met een Azure SQL-logische server.

De Azure SQL Database-container draait de Azure SQL Database-engine, niet de SQL Server-containerafbeelding. Het ondersteunt Azure SQL Database T-SQL en het TDS-protocol (Tabular Data Stream) dat wordt gebruikt door SQL-stuurprogramma's. SERVERPROPERTY('EngineEdition') retourneert bijvoorbeeld 5, waarmee de Azure SQL Database-engine wordt geïdentificeerd. Systeemeigen vectoren, vectorzoekopdrachten en JSON helpen u bij het lokaal verkennen van ai-gereede gegevensscenario's.

De container biedt de beheerde cloudservice niet. Azure beheerde back-ups, hoge beschikbaarheid, elastische pools en serverloze automatische pauze zijn cloudmogelijkheden, niet lokale containerfuncties. Test vóór implementatie tegen Azure SQL Database in Azure: preview-beperkingen, standaardinstellingen en functieondersteuning kunnen verschillen. Zie bekende beperkingen.

Uw ontwikkelingsdatabase kiezen

Gebruik de optie die overeenkomt met het doel van uw applicatie, in plaats van de twee containerafbeeldingen als uitwisselbaar te behandelen.

Option Kies deze wanneer Vereisten voor kosten en accounts
Azure SQL Database-container (Preview) U wilt SQL leren of een applicatie bouwen en testen die gericht is op Azure SQL Database, lokaal. Ondersteunt X64 en ARM. Aanbevolen voor deze lokale ontwikkelworkflow. Gratis voor lokale ontwikkeling en testen. Er is geen Azure-abonnement of creditcard vereist.
SQL Server-container Uw applicatie richt zich op SQL Server of heeft SQL Server-specifiek gedrag nodig. Ondersteunt alleen X64. Gebruik een editie die voor jouw situatie is gelicenseerd. Geen Azure-abonnement vereist voor lokale ontwikkeling.
Azure SQL Database gratis laag U wilt een beheerde database in Azure, cloudintegratie of een cloudvalidatieomgeving. Hiervoor is een Azure-abonnement vereist. Maandelijkse quota, toelatingseisen en het gedrag bij onderbreking of betaalde overschrijding zijn van toepassing.

Belangrijk

Azure SQL Database containers zijn bedoeld voor ontwikkeling, testen, CI en demo's, niet voor productie. Voor productie implementeert u uw toepassing en database in Azure SQL Database in Azure. De gratis lokale container en de gratis Azure SQL Database-laag zijn aparte opties.

Prerequisites

Voor de Azure SQL Database-container hebt u nodig:

  • Visual Studio Code.
  • Een actuele MSSQL-extensierelease die de Azure SQL Database-container (Preview) bevat.
  • Een ondersteunde container-runtime die geïnstalleerd is en Linux-containers draait. De wizard van de Azure SQL Database detecteert beschikbare engines en controleert hun vereisten. Opties zijn onder andere Docker, Podman, containerd met nerdctl, en WSL-containers op Windows.
  • Genoeg resources voor de database-engine. Wijs ten minste 4 GB geheugen en twee CPU-cores toe aan de containerruntime, en houd minimaal 10 GB vrije schijfruimte voor de image en een kleine database. Grotere datasets vereisen meer schijfruimte.
  • Internettoegang voor het eerste downloaden van de afbeelding. Nadat u de image hebt gecachet, vereisen lokale queries geen clouddatabase meer. Externe AI-eindpunten en andere onlineservices vereisen nog steeds verbinding.

De Azure SQL Database-image biedt native linux/amd64 en linux/arm64 varianten voor x64- en ARM64-hosts. Je kunt ontwikkelen op macOS, Linux of Windows met WSL2. SQL Server-containers hebben aparte image- en runtime-vereisten.

Een Azure SQL Database-container maken

  1. Selecteer in de Connections-weergave van de MSSQL-extensie Nieuwe implementatie en vervolgens Azure SQL Database-container (Preview).

    Screenshot van de weergave Verbindingen met de werkbalkactie Nieuwe implementatie gemarkeerd.

    Screenshot van de pagina Nieuwe SQL-database met de lokale Azure SQL Database-containervoorbeschouwingsoptie gemarkeerd.

  2. Bekijk het overzicht van de ontwikkelaarcontainer en selecteer Volgende. De wizard controleert de engine die je hebt geïnstalleerd. Als de wizard geen engine vindt, gebruik dan de meegeleverde installatielinks om een engine te installeren en probeer daarna de controles opnieuw. Wanneer de vereistecontroles slagen, selecteert u Volgende.

    Schermopname van het overzicht van de Azure SQL Database-container waarin lokale ontwikkeling, systeemeigen ARM- en x64-images en opties voor de container-engine worden beschreven.

    Screenshot van de pagina met vereisten voor de containerengine waarop te zien is dat Docker is gedetecteerd en de installatie-, opstart- en configuratiecontroles zijn voltooid.

  3. Stel uw verbinding in met een sterk wachtwoord van ten minste acht tekens (hoofdletters, kleine letters, cijfers en symbolen). Bekijk en accepteer de Algemene Voorwaarden en selecteer Volgende om de container te implementeren.

    Schermopname van de containerconfiguratie met SQL-aanmelding, een gemaskeerd wachtwoord, een profielnaam, geavanceerde opties, poort 1436 en het selectievakje voor de licentievoorwaarden.

  4. Wacht tot het downloaden van de image, het aanmaken van de container, het gereedkomen van de engine en het tot stand brengen van de verbinding zijn voltooid.

    Screenshot van provisioning waarbij de stappen voor het downloaden van afbeeldingen, het aanmaken van containers, gereedheid en verbinding voltooid zijn.

  5. Zoek de opgeslagen verbinding in Objectverkenner in de Connections-weergave.

    Screenshot van de draaiende Azure SQL DB-containerverbinding in Objectverkenner met databases en beveiligingsnodes.

De extensie maakt een opgeslagen verbindingsprofiel aan. Een container, een verbindingsprofiel en een applicatiedatabase zijn verschillende bronnen: het starten van de engine betekent niet dat de database van uw applicatie al bestaat. Ga verder met de volgende stappen om er expliciet een te maken.

De wizard biedt ook Microsoft Entra-authenticatie voor meer geavanceerde scenario's. Het vereist extra identiteits- en certificaatconfiguratie.

Maak een database aan en voer uw eerste query uit

Gebruik appdb als voorbeeldnaam voor de database. Vervang consequent de databasenaam van uw project als u een andere naam kiest.

  1. Klik in Objectverkenner met de rechtermuisknop op uw containerverbinding en selecteer Database aanmaken.

  2. Voer in het dialoogvenster appdb in bij Databasenaam.

    Screenshot van het dialoogvenster Database aanmaken voor de lokale Azure SQL Database-container, met Databasenaam en geavanceerde instellingen.

  3. Gebruik Verbinding toevoegen om verbinding te maken met dezelfde lokale server en poort, waarbij Database is ingesteld op appdb. Open een nieuwe query-editor met deze verbinding en voer uit:

    SELECT DB_NAME() AS current_database,
        SERVERPROPERTY('EngineEdition') AS engine_edition,
        SERVERPROPERTY('Edition') AS edition;
    

    Verwacht dat current_databaseappdb is, engine_edition5 is en editionSQL Azure is. Als de editie verschilt, controleer dan of u de Azure SQL Database-container hebt geselecteerd, niet SQL Server. Selecteer de database in de verbindingsinstellingen, niet met USE appdb. Azure SQL Database-gebruikersdatabasesessies ondersteunen het wisselen van databases met USE niet.

  4. Voer elk van deze instructies afzonderlijk uit in appdb. Stop als een instructie mislukt. Als dbo.Tasks deze al bestaat, kies dan consequent een andere tabelnaam of een andere ontwikkeldatabase; overschrijf deze niet.

    CREATE TABLE dbo.Tasks
    (
        TaskId INT IDENTITY (1, 1) NOT NULL PRIMARY KEY,
        Title NVARCHAR (200) NOT NULL,
        IsComplete BIT NOT NULL DEFAULT (0)
    );
    
    INSERT INTO dbo.Tasks (Title)
    VALUES (N'Create a local Azure SQL Database'),
           (N'Connect an application');
    
    SELECT TaskId, Title, IsComplete
    FROM dbo.Tasks
    ORDER BY TaskId;
    

    Na één geslaagde invoeging kunt u twee rijen met TaskId-waarden 1 en 2 verwachten, en IsComplete ingesteld op 0.

Als u SQL prefereert voor databasecreatie, sluit dan een query-editor aan op master en voer CREATE DATABASE appdb; uit in plaats van het dialoogvenster Database aanmaken te gebruiken.

Gebruik master voor het inrichten van databases en uw gebruikersdatabase voor toepassingsquery's. Verbinding maken met een database die niet bestaat, maakt deze niet aan, en de container voert niet automatisch initialisatiescripts uit vanuit /docker-entrypoint-initdb.d.

Uw schema en gegevens importeren

Als u al een databasepakket heeft, gebruik dan de DACPAC- en BACPAC-operaties van de extensie in plaats van het schema handmatig opnieuw op te bouwen.

Package Wat het bevat Operation
.dacpac Databaseschema. Het bevat niet je tabelgegevens. Publiceer DACPAC om het schema te implementeren in een nieuwe of bestaande ontwikkeldatabase.
.bacpac Database-schema en tabelgegevens. Importeer BACPAC naar een nieuwe of lege ontwikkeldatabase.
  1. Klik met de rechtermuisknop op uw containerverbinding in Objectverkenner en selecteer DACPAC/BACPAC Operations....

    Screenshot van het containerverbindingsmenu met DACPAC/BACPAC-bewerkingen gemarkeerd en de acties Stop SQL Container en SQL Container verwijderen zichtbaar.

  2. Kies de bewerking die overeenkomt met uw pakket, selecteer het pakketbestand en bevestig de verbinding met de doelcontainer en database.

  3. Bekijk het doel en de voorgestelde wijzigingen voordat je verder gaat. Wacht tot de bewerking is voltooid, vernieuw vervolgens databases en maak direct verbinding met de doelgebruikersdatabase om het schema en de gegevens te bekijken.

Importeer geen BACPAC in appdb nadat je de voorbeeldtabel dbo.Tasks hebt aangemaakt: die database is niet leeg. Kies in plaats daarvan een nieuwe of lege ontwikkelingsdatabase. Publiceer alleen schema's die compatibel zijn met Azure SQL Database en bekijk wijzigingen voordat je ze toepast op een database met de data die je nodig hebt.

Opmerking

SQL Server-bestanden .bak zijn geen BACPAC-bestanden; BACKUP DATABASE en RESTORE DATABASE worden niet ondersteund door de Azure SQL Database-container.

Verbind uw toepassing

Gebruik het lokale serveradres, de door de wizard geselecteerde hostpoort, uw databasenaam en uw inloggegevens met een Azure SQL-compatibele driver. Bijvoorbeeld: deze ADO.NET-stijl verbindingsreeks is gericht op appdb:

Server=localhost,<host-port>;Database=appdb;User ID=sa;Password=<your-password>;Encrypt=True;TrustServerCertificate=True;

Vervang beide placeholders voordat je verbinding maakt. TrustServerCertificate=True is alleen bedoeld voor het zelfondertekende certificaat van de lokale container. Gebruik certificaatvalidatie en een passende authenticatiemethode, zoals Microsoft Entra-authenticatie, voor Azure SQL Database in Azure.

Sla verbindingsreeksen op in omgevingsvariabelen of uw opslag voor ontwikkelingsgeheimen, niet in broncodebeheer of AI-prompts. Andere drivers gebruiken een andere verbindingstekstsyntaxis; zie de quickstarts voor Python en .NET.

Ontwikkelen met AI

U kunt GitHub Copilot gebruiken in de MSSQL-extensie om SQL uit te leggen, query's te ontwerpen en schemawijzigingen te plannen tegen uw lokale database. Controleer gegenereerde SQL en de geselecteerde database voordat je deze uitvoert. Containergebruik is gratis; GitHub Copilot en externe modelservices hebben hun eigen toegangs- en prijsvereisten.

Geef bijvoorbeeld na het maken van dbo.Tasks deze prompt aan Copilot:

I'm developing against an Azure SQL Database container, not SQL Server.
Use my existing appdb connection. First confirm the active database and
EngineEdition = 5. Explain the dbo.Tasks schema, then draft a parameterized
query to insert a task and a query to list incomplete tasks.
Don't execute changes, delete data, or create cloud resources.
Don't request or display passwords. Don't use USE to switch databases.

Voor code-first-werkstromen bieden de Azure SQL Database containeragentvaardigheden installatie-, verbinding-, migratie- en local-to-cloud-richtlijnen voor ondersteunde AI-coderingsagenten.

Probeer vectorgelijkenis zonder embeddingservice

Voer dit voorbeeld uit op je appdb verbinding om native vectoren en exacte similariteitszoekopdrachten te verkennen. Het gebruikt illustratieve driedimensionale vectoren, maakt geen tabel aan en roept geen betaald model-eindpunt aan.

DECLARE @query VECTOR(3) = '[1.0, 0.0, 0.0]';

SELECT TOP (2)
       v.Label,
       VECTOR_DISTANCE('cosine', CAST(v.Embedding AS VECTOR(3)), @query) AS distance
FROM (VALUES
    (N'Closest', '[1.0, 0.0, 0.0]'),
    (N'Perpendicular', '[0.0, 1.0, 0.0]')
) AS v(Label, Embedding)
ORDER BY distance;

Verwacht Closest eerst met afstand 0, gevolgd door Perpendicular afstand 1. In een echte applicatie genereer je embeddings met hetzelfde model voor opgeslagen data en queries en gebruik je de embeddingafmetingen van het model. VECTOR_DISTANCE voert exact zoekgedrag uit; het gebruikt geen vectorindex. Controleer de previewbeperkingen voordat u een indexerings- of embeddingstrategie kiest.

Kenmerken

De lokale containerervaringen bieden de volgende mogelijkheden:

  • Maak een Azure SQL Database- of SQL Server-container aan via een begeleide wizard.
  • Pas de containernaam, hostnaam en poort aan.
  • Controleer de vereisten voor de container-runtime vóór implementatie.
  • Automatisch een beschikbare poort toewijzen als 1433 al in gebruik is.
  • Sla verbindingsinstellingen op voor herverbinding.
  • Beheer de containerlevenscyclus vanuit de weergave Verbindingen .

Maak een SQL Server-container aan

De volgende screenshots illustreren de SQL Server-wizard, niet de Azure SQL Database-wizard.

  1. Open de uitrolwizard en kies SQL Server-container onder Lokaal uitvoeren. U kunt ook Create local SQL Container gebruiken vanuit het menu Verbindingen.

    Screenshot met de optie voor het aanmaken van SQL Server-container in de MSSQL-extensie.

  2. Bekijk het overzichtsscherm en selecteer Aan de slag.

    Screenshot van het overzichtsscherm voor lokale SQL Server-containerimplementatie met nuttige links en de knop Aan de slag.

  3. De MSSQL-extensie controleert automatisch op Docker vóór de implementatie:

    • Als Docker niet is geïnstalleerd, wordt er een bericht met een installatiekoppeling weergegeven. U moet deze installeren voordat u doorgaat.
    • Als Docker is geïnstalleerd maar niet wordt uitgevoerd, wordt u gevraagd deze te starten. Als docker starten mislukt, probeert u het opnieuw of annuleert u het.

    Wanneer aan alle vereisten wordt voldaan, selecteert u Volgende.

    Screenshot van de controle van de Docker-vereisten van de SQL Server-wizard in de MSSQL-extensie.

  4. In het deelvenster Implementatie-instellingen :

    1. Selecteer de SQL Server-versie (SQL Server 2025 (17.x) is standaard geselecteerd.
    2. Voer een wachtwoord in voor het sa account.
    3. Voer een naam in voor uw verbindingsprofiel (optioneel).
    4. Stel optioneel de containernaam, poort en hostnaam in onder de geavanceerde opties.
    5. Accepteer de licentievoorwaarden.
    6. Selecteer Container maken.

    Screenshot van het configuratieformulier voor containerconfiguratie.

Hoe sql-containerimplementatie werkt

Voor SQL Server, nadat u Container aanmaken hebt geselecteerd, dient de extensie:

  • Hiermee wordt de geselecteerde SQL Server-installatiekopie opgehaald (als deze nog niet in de cache is opgeslagen).
  • Hiermee maakt u een SQL Server-container met de gekozen instellingen.
  • Controleert de logboeken om te controleren of alle databases volledig zijn hersteld en gereed zijn.
  • Hiermee maakt u een verbindingsprofiel en maakt u verbinding met uw container.

Wanneer de implementatie is voltooid, maakt de MSSQL-extensie verbinding met de container. Maak een gebruikersdatabase aan of selecteer deze voordat u applicatiequery's uitvoert.

Uw container beheren

Klik voor elk containertype met de rechtermuisknop op het opgeslagen verbindingsprofiel in de weergave Verbindingen om de levenscyclus te beheren.

De volgende screenshot toont een gestopte Azure SQL Database-container. Het menu biedt Start SQL Container en SQL Container verwijderen. Wanneer de container draait, biedt het menu in plaats daarvan Stop SQL Container aan.

Screenshot van een stilgevallen Azure SQL Database-container met SQL Container starten en SQL Container verwijderen in het verbindingsmenu.

Een gestopte container starten

Selecteer SQL-container starten. De extensie controleert de bijbehorende runtime en start de container voordat verbinding wordt gemaakt. Als de runtime niet wordt uitgevoerd, volg dan de aanwijzing om deze te starten.

Een actieve container stoppen

Selecteer SQL Container stoppen om de resources van de draaiende container vrij te maken zonder deze te verwijderen. Databasebestanden blijven beschikbaar wanneer u dezelfde container opnieuw opstart. Deze actie stopt de container, niet de serverloze automatische pauzefunctie van Azure SQL Database.

De container verwijderen

Selecteer SQL Container verwijderen en bekijk de bevestiging voordat je verdergaat. Verwijdering verwijdert de container en het geselecteerde verbindingsprofiel. Data die alleen binnen de container is opgeslagen, gaat verloren; afzonderlijk beheerde volumes hebben hun eigen levenscyclus. Bewaar alle gegevens die u nodig heeft vóór verwijdering.

Belangrijk

Verwijder een container of zijn opslag niet om een verbinding te troubleshooten, tenzij je de data kunt weggooien. Als je alleen de ontwikkeling wilt pauzeren, stop deze dan.

Ondersteunde scenario’s

Gebruik de Azure SQL Database-container om applicaties te prototypen, migraties te testen, T-SQL te leren en vectoren en JSON te verkennen vóór cloudimplementatie. U kunt de containerafbeelding ook gebruiken in CI, applicatie-sidecars of offline labs; die runtime-specifieke workflows worden niet geconfigureerd door de VS Code-wizard.

Gebruik de SQL Server-container om SQL Server-schema's en -functies te testen. Ga er niet vanuit dat een SQL Server-specifieke functie werkt in Azure SQL Database alleen omdat deze werkt in een SQL Server-container.

Problemen met lokale ontwikkeling oplossen

Symptom Wat u moet controleren
De Azure SQL Database-containeroptie ontbreekt. Werk de MSSQL-extensie bij naar een release die de wizard voor public-preview bevat en selecteer opnieuw New Deployment.
Controles van runtimevereisten mislukken. Bevestig dat de geselecteerde runtime is geïnstalleerd, draaiend en geconfigureerd voor Linux-containers. Corrigeer het gemelde probleem en probeer het opnieuw.
Afbeeldingsdownload mislukt. Controleer de registerfout in het register en controleer connectiviteit en runtimeconfiguratie. Vervang de SQL Server-image niet door Azure SQL Database.
De container start op, maar verbindingen mislukken. Wacht op de engine-gereedheid en inspecteer vervolgens foutdetails en containerlogboeken. Controleer de complexiteit van het wachtwoord en geheugentoewijzing. Een draaiend containerproces bewijst niet dat de database klaar is.
Een applicatie kan de database niet bereiken. Gebruik de daadwerkelijke hostpoort die door de wizard is geselecteerd, niet een veronderstelde 1433. localhost verwijst naar de eigen host van de applicatie; een applicatie in een andere container heeft een passend container-netwerkadres nodig.
De database bestaat niet. Maak verbinding met master, maak de database aan en maak er direct opnieuw verbinding mee.
USE appdb mislukt. Selecteer appdb in de verbindingsinstellingen. Wissel niet van database in een Azure SQL Database-gebruikersdatabasesessie met USE.
Een SQL Server-beheeroperatie mislukt. Controleer of de operatie wordt ondersteund door Azure SQL Database. Bijvoorbeeld, BACKUP DATABASE en RESTORE DATABASE worden niet ondersteund.

Zie bekende beperkingen voor huidige preview-gaten en workarounds.

Voorbeeldgegevens opschonen

Bevestig bij je SELECT DB_NAME()-verbinding dat appdbappdb teruggeeft. Als u dbo.Tasks in deze walkthrough hebt aangemaakt en deze niet meer nodig hebt, verwijder dan alleen die voorbeeldtabel:

DROP TABLE dbo.Tasks;

Voer deze instructie niet uit op een tabel van een ander project. Stop de container om er later mee verder te werken, of verwijder hem pas wanneer je de gegevens ervan niet meer nodig hebt.

Overstappen van lokaal naar cloud

  • Door de MSSQL-extensie te gebruiken, kunt u uw lokale database naar de cloud uitrollen. Lees meer over Local to Cloud.