Bouw met Azure SQL Database-container

Van toepassing op:Azure SQL Database

In deze quickstart start je met de Azure SQL Database-container, maakt u een lokale database aan en voert u uw eerste query uit. Gebruik vervolgens Azure SQL Dev Hub om een applicatie te bouwen met voorbeelden, prompts en AI-codeeragentvaardigheden.

Note

Azure SQL Database container is in openbare preview.

Wat is de Azure SQL Database-container?

Een container verpakt de database-engine zodat u deze op uw computer kunt draaien met een container-runtime. De Azure SQL Database-container draait de Azure SQL Database-engine, niet de SQL Server-containerafbeelding. Uw applicatie maakt verbinding met een lokaal adres, zoals localhost,1433, in plaats van met een database in Azure.

Gebruik de container om T-SQL te leren, applicaties te ontwikkelen, schemawijzigingen te testen of continue integratietests (CI) uit te voeren. Je kunt ook native vectors, vectorzoekopdrachten en JSON voor AI-toepassingen verkennen. Het werkt met de drivers en object-relationele mappers (ORM's) die u gebruikt voor Azure SQL Database.

De container is gratis beschikbaar voor lokale ontwikkeling en testen. Je hebt geen Azure-abonnement of creditcard nodig om het lokaal te draaien.

Important

De container is bedoeld voor ontwikkeling, testen, CI en demo's, niet voor productie. Het biedt geen Azure-beheerde diensten zoals geautomatiseerde back-ups, hoge beschikbaarheid of elastische pools. Voor productie, implementeer je database en applicatie naar Azure-services, niet naar de lokale container.

Voor meer informatie, zie Wat is de Azure SQL Database-container?.

Prerequisites

  • Een container-runtime die is geïnstalleerd en Linux-containers uitvoert. Kies Docker, Podman, WSL-containers of de tool van Apple container zoals beschreven in de volgende sectie.
  • Een ondersteunde x64- of ARM64-computer waarop macOS, Linux of Windows wordt uitgevoerd met Windows-subsysteem voor Linux 2 (WSL2). De image biedt native linux/amd64- en linux/arm64-varianten.
  • Ten minste twee CPU-cores, 4 GB geheugen beschikbaar voor de container-runtime, en 10 GB vrije schijfruimte voor het image en een kleine database.
  • Internettoegang voor het eerste downloaden van de afbeelding. Lokale query's kunnen daarna offline worden uitgevoerd; externe services vereisen nog steeds connectiviteit.
  • Een beschikbare hostpoort, zoals 1433, en een unieke containernaam. In de voorbeelden wordt sqldb gebruikt. Kies een andere naam of hostpoort als een van beide al in gebruik is.

Controleer de vereisten voor containers voor de huidige vereisten voor platform en runtime.

Selecteer een containerruntime

Gebruik de runtime die bij uw besturingssysteem past. Deze voorbeelden gebruiken native images voor je hostarchitectuur; ze configureren emulatie niet.

Runtime Instellen
Docker Installeer Docker Desktop of Docker Engine en zorg ervoor dat deze met ondersteuning voor Linux-containers draait.
Podman Installeer Podman. Initialiseer op macOS en Windows indien nodig een Podman-machine en start deze vervolgens met podman machine start.
WSL-containers Installeer of werk WSL bij zodat wslc.exe beschikbaar is. Voer wslc uit vanuit PowerShell op de Windows-host. Gebruik vanuit Bash binnen een WSL-distributie wslc.exe; WSL-interoperabiliteit moet ingeschakeld zijn en wslc.exe moet op uw PATH. De gepubliceerde port staat op de Windows-host.
Apple container Installeer Apple's containertool op een Apple silicon Mac met macOS 26. Start de service met container system start.

Andere OCI-compatibele runtimes, zoals containerd met nerdctl of Rancher Desktop, kunnen de image ook uitvoeren. Gebruik de documentatie van uw runtime voor de commando's en configuratie.

Haal de openbare previewafbeelding op

De referentie van de publieke previewafbeelding is mcr.microsoft.com/mssql/azure-sql-db-server:latest. Haal afbeeldingsinformatie op uit de Microsoft Artifact Registry-lijst. Voor openbare images is geen privé-preview-registryaccount of inloggen bij de registry nodig.

De volgende commando's downloaden de image automatisch als deze niet lokaal is gecachet. Om het apart met Docker te downloaden, voer het volgende uit:

docker pull mcr.microsoft.com/mssql/azure-sql-db-server:latest

Gebruik voor Podman-, WSL-containers of Apple-containers podman pull, wslc pull of container image pull, respectievelijk, met dezelfde afbeeldingsreferentie.

De container starten

Vervang <your-strong-password> door een uniek, sterk wachtwoord voor de sa-authenticatie. Gebruik ten minste acht tekens met tekens uit ten minste drie van deze groepen: hoofdletters, kleine letters, cijfers en symbolen. Houd wachtwoorden buiten versiebeheer en gedeelde terminaluitvoer. Het wachtwoord is ook zichtbaar in de containerconfiguratie.

Kies je runtime en voer vervolgens het commando uit. De instelling ACCEPT_EULA=Y accepteert de licentievoorwaarden van de image. Elk voorbeeld wijst 2 GiB geheugen en twee CPU's toe aan de container en publiceert de databasepoort 1433 op het loopbackadres van de host.

docker run --name sqldb --memory 2g --cpus 2 -e ACCEPT_EULA=Y -e "MSSQL_SA_PASSWORD=<your-strong-password>" -p 127.0.0.1:1433:1433 -d mcr.microsoft.com/mssql/azure-sql-db-server:latest

Een draaiende container betekent niet per se dat de database-engine klaar is. Gebruik het sqlcmd hulpprogramma dat bij de container is meegeleverd om te controleren of er een succesvolle SQL-verbinding is:

docker exec sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -l 5 -t 5 -Q "SELECT @@VERSION;"

Vervang docker door podman, wslc (of wslc.exe binnen WSL), of container voor je runtime. Probeer het opnieuw terwijl de engine start. Succesvolle uitvoer bevat Microsoft SQL Azure. De -b optie geeft een foutexitcode voor SQL-fouten; -l 5 en -t 5 beperk inlog- en querywachttijd tot elk vijf seconden. -C vertrouwt op het zelfondertekende certificaat van de container voor deze lokale verbinding; gebruik correcte certificaatvalidatie buiten lokale ontwikkeling.

Deze controle maakt verbinding binnen de container, niet via de gepubliceerde hostpoort. Gebruik server 127.0.0.1,1433, SQL-authenticatie, inlog sa en het door u geconfigureerde wachtwoord om verbinding te maken met uw editor of applicatie. Pas de poort aan als je de hostmapping hebt gewijzigd.

Als SQL geen verbindingen accepteert, inspecteer dan de logs met docker logs --tail 80 sqldb, podman logs --tail 80 sqldb, wslc logs --tail 80 sqldb, of container logs -n 80 sqldb. Controleer het wachtwoordbeleid en beschikbare bronnen voordat je het opnieuw probeert.

Als u liever een grafische installatie gebruikt, volg dan Build locally with Azure SQL Database container and SQL Server container in de MSSQL-extensie voor Visual Studio Code, of Connect and Query an Azure SQL Database Container | Microsoft Learn voor SSMS.

Maak een database aan en voer een query uit

Gebruik een SQL-client, zoals het sqlcmd hulpprogramma dat bij de container wordt gebundeld, of het queryvenster van uw editor. Open bijvoorbeeld een interactieve master verbinding met het volgende commando, waarbij u docker vervangt door de CLI van uw runtime en uw geconfigureerde wachtwoord gebruikt:

docker exec -it sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -d master

Voer in een interactieve sqlcmd sessie na elke SQL-instructie of query een nieuwe regel in GO om deze uit te voeren. Enter EXIT om de sessie te sluiten.

  1. Maak verbinding met de master-database van de lokale container met de door u geconfigureerde inloggegevens en voer uit:

    CREATE DATABASE appdb;
    

    De naam appdb is een voorbeeld; u kunt een andere databasenaam kiezen. Als uw installatietool al een gebruikersdatabase heeft aangemaakt, gebruik dan die database en sla deze stap over.

  2. Open een nieuwe verbinding direct naar appdb. Specificeer de database in de verbindingsinstellingen van uw client of met -d appdb in sqlcmd. Gebruik niet USE om databases te wisselen in een Azure SQL Database-gebruikersdatabasesessie.

    Voor het interactieve commando dat aan deze stap voorafgaat, sluit u de master sessie af en voer het commando vervolgens opnieuw uit met -d appdb in plaats van -d master.

  3. Voer deze query uit op de appdb verbinding:

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

    Verwacht current_database te zijn appdb, engine_edition te zijn 5, edition te zijn SQL Azure, en connected te zijn 1. Deze waarden bevestigen dat u verbinding hebt gemaakt met uw gebruikersdatabase via de Azure SQL Database-engine. Als de editie verschilt, controleer dan of u de Azure SQL Database-image hebt gestart in plaats van de SQL Server-image.

Je hebt nu een lokale database voor applicatieontwikkeling. Gebruik dezelfde databasenaam in de verbindingsreeks van uw applicatie.

Bouw met Azure SQL Dev Hub

Bezoek Azure SQL Dev Hub om een applicatiescenario te kiezen en te beginnen met prompts, voorbeelden en agentvaardigheden. U kunt een taakvolgingsapp bouwen, een API maken of vectorzoekopdrachten verkennen voor een retrieval-augmented generation (RAG)-applicatie.

Sommige Dev Hub-prompts, zoals de JavaScript-appprompt, richten zich op clouddatabases en vereisen Microsoft Entra-authenticatie. Voordat u een prompt lokaal uitvoert, past u zowel de instructies als de verbindingsconfiguratie aan aan de server van uw container, gekoppelde poort, databasenaam en authenticatiemethode. Als u het standaard SQL-authenticatiepad van de installatiegids gebruikt, vervang dan cloud-only authenticatievereisten door uw geconfigureerde SQL-inloggegevens, houd de inloggegevens buiten de bronbeheer en vertrouw het zelfondertekende certificaat alleen voor de lokale containerverbinding. Controleer gegenereerde SQL-, machtigings- en schemawijzigingen voordat u ze uitvoert.

Wanneer u klaar bent om over te stappen naar Azure, maak dan een database aan in Azure SQL Database, implementeer uw schema en data en werk de verbindingsconfiguratie van uw applicatie bij. Een Azure-abonnement is vereist voor cloudbronnen. De Azure SQL Database met gratis servicelaag is een aparte cloudoptie met eigen toelagen en limieten.

Test vóór de implementatie op Azure SQL Database in Azure. Preview-beperkingen, standaardinstellingen en functieondersteuning kunnen verschillen van de cloudservice. Bekijk de bekende beperkingen.

De hulpbronnen opschonen

Als je klaar bent, stop je de container met je runtime- of ontwikkeltool.

Runtime De container stoppen Verwijder de gestopte container
Docker docker stop sqldb docker rm sqldb
Podman podman stop sqldb podman rm sqldb
WSL-containers wslc stop sqldb wslc rm sqldb
Apple-container container stop sqldb container delete sqldb

De run-commando's in deze quickstart configureren geen persistente opslag. Het verwijderen van de container kan de databasebestanden verwijderen, dus bewaar eerst alle data die je nodig hebt. Als u een datavolume apart configureert, verwijder het dan alleen als u van plan bent de data te verwijderen.