Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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
containerzoals 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- enlinux/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 wordtsqldbgebruikt. 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.
Maak verbinding met de
master-database van de lokale container met de door u geconfigureerde inloggegevens en voer uit:CREATE DATABASE appdb;De naam
appdbis 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.Open een nieuwe verbinding direct naar
appdb. Specificeer de database in de verbindingsinstellingen van uw client of met-d appdbinsqlcmd. Gebruik nietUSEom databases te wisselen in een Azure SQL Database-gebruikersdatabasesessie.Voor het interactieve commando dat aan deze stap voorafgaat, sluit u de
mastersessie af en voer het commando vervolgens opnieuw uit met-d appdbin plaats van-d master.Voer deze query uit op de
appdbverbinding:SELECT DB_NAME() AS current_database, SERVERPROPERTY('EngineEdition') AS engine_edition, SERVERPROPERTY('Edition') AS edition, 1 AS connected;Verwacht
current_databasete zijnappdb,engine_editionte zijn5,editionte zijnSQL Azure, enconnectedte zijn1. 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.