Développer avec un conteneur Azure SQL Database

S’applique à :Azure SQL Database

Dans ce démarrage rapide, vous allez prendre en main le conteneur Azure SQL Database, créez une base de données locale et lancez votre première requête. Ensuite, utilisez Azure SQL Dev Hub pour construire une application avec des exemples, des prompts et des compétences d’agent de codage IA.

Note

Le conteneur Azure SQL Database est en préversion publique.

Qu’est-ce que le conteneur Azure SQL Database ?

Un conteneur empaquete le moteur de base de données afin que vous puissiez l’exécuter sur votre ordinateur avec un environnement d’exécution conteneur. Le conteneur Azure SQL Database exécute le moteur Azure SQL Database, et non l’image du conteneur SQL Server. Votre application se connecte à une adresse locale, telle que localhost,1433, au lieu d’une base de données dans Azure.

Utilisez le conteneur pour apprendre T-SQL, développer des applications, tester des modifications de schéma ou exécuter des tests d’intégration continue (CI). Vous pouvez également explorer les vecteurs natifs, la recherche vectorielle et le JSON pour les applications d’IA. Il fonctionne avec les pilotes et les mapper object-relationnels (ORM) que vous utilisez pour Azure SQL Database.

Le conteneur est gratuit pour le développement et les tests locaux. Vous n'avez pas besoin d'un abonnement Azure ni d'une carte de crédit pour le faire fonctionner localement.

Important

Le conteneur sert au développement, aux tests, au CI et aux démonstrations, pas à la production. Il ne propose pas de services gérés Azure tels que les sauvegardes automatisées, la haute disponibilité ou les pools élastiques. Pour la production, déployez votre base de données et votre application sur les services Azure, pas sur le conteneur local.

Pour plus d’informations, voir Qu’est-ce que le conteneur Azure SQL Database ?.

Prerequisites

  • Un runtime de conteneurs installé et exécutant des conteneurs Linux. Choisissez Docker, Podman, les conteneurs WSL ou l’outil container d’Apple comme décrit dans la section suivante.
  • Un ordinateur x64 ou ARM64 supporté exécutant macOS, Linux ou Windows avec Sous-système Windows pour Linux 2 (WSL2). L’image fournit des variantes natives linux/amd64 et linux/arm64.
  • Au moins deux cœurs CPU, 4 Go de mémoire disponibles pour l’environnement d’exécution du conteneur, et 10 Go d’espace disque libre pour l’image et une petite base de données.
  • Accès Internet pour le téléchargement initial de l’image. Les requêtes locales peuvent être exécutées hors ligne par la suite ; les services externes nécessitent toujours la connectivité.
  • Un port hôte disponible, tel que 1433, et un nom de conteneur unique. Les exemples utilisent sqldb. Choisissez un autre nom ou port hôte si l’un ou l’autre est déjà utilisé.

Examinez les prérequis des conteneurs pour connaître les exigences actuelles de votre plateforme et du runtime.

Choisir un environnement d’exécution de conteneur

Utilisez l’environnement d’exécution adapté à votre système d’exploitation. Ces exemples utilisent des images natives pour votre architecture hôte ; ils ne configurent pas l’émulation.

Runtime Configuration
Docker Installez Docker Desktop ou Docker Engine, et assurez-vous qu’il fonctionne avec le support des conteneurs Linux.
Podman Installez Podman. Sur macOS et Windows, initialisez une machine Podman si nécessaire, puis lancez-la avec podman machine start.
Conteneurs WSL Installez ou mettez à jour WSL pour que wslc.exe soit disponible. Exécutez wslc depuis PowerShell sur l’hôte Windows. Depuis Bash à l’intérieur d’une distribution WSL, utilisez wslc.exe; L’interopérabilité WSL doit être activée et wslc.exe doit être sur votre PATH. Le port publié est sur l’hôte Windows.
Apple container Installez l’outil conteneur d’Apple sur un Mac Apple Silicon fonctionnant sous macOS 26. Démarrez son service avec container system start.

D’autres environnements d’exécution compatibles OCI, comme containerd avec nerdctl ou Rancher Desktop, peuvent également exécuter l’image. Utilisez la documentation de votre runtime pour ses commandes et sa configuration.

Obtenir l’image de préversion publique

La référence de l’image en préversion publique est mcr.microsoft.com/mssql/azure-sql-db-server:latest. Obtenez les informations sur les images depuis la liste Microsoft Artifact Registry. Les images publiques ne nécessitent pas un compte de registre privé d’aperçu ni une connexion au registre.

Les commandes suivantes téléchargent automatiquement l’image si elle n’est pas mise en cache localement. Pour le télécharger séparément avec Docker, exécutez :

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

Pour les conteneurs Podman, WSL ou Apple container, utilisez podman pull, wslc pull ou container image pull, respectivement, avec la même référence d’image.

Démarrer le conteneur

Remplacez <your-strong-password> par un mot de passe unique et solide pour l’authentification sa. Utilisez au moins huit caractères avec des caractères appartenant à au moins trois de ces groupes : lettres majuscules, lettres minuscules, chiffres et symboles. Gardez les mots de passe hors du contrôle de version et de la sortie du terminal partagé. Le mot de passe est également visible dans la configuration du conteneur.

Choisissez votre runtime, puis exécutez sa commande. Définir ACCEPT_EULA=Y vaut acceptation des conditions de licence de l’image. Chaque exemple alloue 2 Gi de mémoire et deux processeurs au conteneur et publie le port 1433 de base de données sur l’adresse de boucle de l’hôte.

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

Un conteneur en cours d’exécution ne signifie pas nécessairement que le moteur de base de données est prêt. Utilisez l’utilitaire sqlcmd fourni avec le conteneur pour vérifier la réussite d’une connexion SQL :

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;"

Remplacez docker par podman, wslc (ou wslc.exe à l’intérieur de WSL), ou container pour votre environnement d’exécution. Réessayez pendant que le moteur démarre. La sortie réussie inclut Microsoft SQL Azure. L’option -b renvoie un code de sortie d’erreur pour les erreurs SQL ; -l 5 et -t 5 limite l’attente de connexion et de requête à cinq secondes chacune. -C fait confiance au certificat auto-signé du conteneur pour cette connexion locale ; utilisez une validation de certificat appropriée en dehors du développement local.

Cette vérification se connecte à l’intérieur du conteneur, et non via le port hôte publié. Pour vous connecter depuis votre éditeur ou application, utilisez le serveur 127.0.0.1,1433, l’authentification SQL, l’identifiant sa et le mot de passe que vous avez configuré. Ajustez le port si vous avez modifié le mappage hôte.

Si SQL n’accepte pas les connexions, inspectez les journaux avec docker logs --tail 80 sqldb, podman logs --tail 80 sqldb, wslc logs --tail 80 sqldb, ou container logs -n 80 sqldb. Vérifiez la politique de mot de passe et les ressources disponibles avant de réessayer.

Si vous préférez une expérience de configuration graphique, suivez Build locally with Azure SQL Database container and SQL Server container dans l’extension MSSQL pour Visual Studio Code, ou Connect and Query an Azure SQL Database Container | Microsoft Learn pour SSMS.

Créer une base de données et exécuter une requête

Utilisez un client SQL, tel que l’utilitaire sqlcmd fourni avec le conteneur, ou la fenêtre de requête de votre éditeur. Par exemple, ouvrez une connexion interactive master avec la commande suivante, remplaçant docker par l’interface de commande de votre environnement d’exécution et en utilisant votre mot de passe configuré :

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

Dans une session interactive sqlcmd, saisissez GO sur une nouvelle ligne après chaque instruction ou requête SQL pour l’exécuter. Entrez EXIT pour clôturer la session.

  1. Connectez-vous à la base de données du master conteneur local avec les identifiants que vous avez configurés, et exécutez :

    CREATE DATABASE appdb;
    

    Le nom appdb est un exemple ; vous pouvez choisir un autre nom de base de données. Si votre outil d’installation a déjà créé une base de données utilisateur, utilisez cette base de données et sautez cette étape.

  2. Ouvrez une nouvelle connexion directement à appdb. Spécifiez la base de données dans les paramètres de connexion de votre client ou avec -d appdb dans sqlcmd. Ne pas utiliser USE pour changer de base de données dans une session de base de données utilisateur Azure SQL Database.

    Pour la commande interactive précédant cette étape, quittez la master session, puis exécutez à nouveau la commande avec -d appdb au lieu de -d master.

  3. Exécutez cette requête sur la appdb connexion :

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

    Attendez-vous current_database à être appdb, engine_edition à être 5, edition à être SQL Azure, et connected à être 1. Ces valeurs confirment que vous vous êtes connecté à votre base de données utilisateur sur le moteur Azure SQL Database. Si l’édition diffère, vérifiez que vous avez lancé l’image Azure SQL Database plutôt que l’image SQL Server.

Vous disposez désormais d’une base de données locale pour le développement d’applications. Utilisez le même nom de base de données dans chaîne de connexion de votre application.

Construire avec Azure SQL Dev Hub

Visitez Azure SQL Dev Hub pour choisir un scénario applicatif et commencer avec des suggestions, des exemples et des compétences d’agent. Vous pouvez créer une application de suivi des tâches, créer une API ou explorer la recherche vectorielle pour une application de génération augmentée par récupération (RAG).

Certaines indications Dev Hub, comme l’invite de l’application JavaScript, ciblent les bases de données cloud et nécessitent l’authentification Microsoft Entra. Avant d’exécuter une invite localement, adaptez à la fois ses instructions et sa configuration de connexion au serveur de votre conteneur, au port mappé, au nom de la base de données et à la méthode d’authentification de votre conteneur. Si vous utilisez le chemin d’authentification SQL par défaut du guide d’installation, remplacez les exigences d’authentification uniquement cloud par vos identifiants SQL configurés, gardez les identifiants hors du contrôle de versions, et ne faites confiance au certificat auto-signé que pour la connexion locale au conteneur. Examinez les modifications du SQL, des permissions et du schéma générés avant de les exécuter.

Lorsque vous êtes prêt à passer à Azure, créez une base de données dans Azure SQL Database, déployez votre schéma et vos données, et mettez à jour la configuration de connexion de votre application. Un abonnement Azure est requis pour les ressources cloud. Le niveau gratuit Azure SQL Database est une option cloud distincte avec ses propres limites et allocations.

Avant le déploiement, testez avec Azure SQL Database dans Azure. Les restrictions d’aperçu, les paramètres par défaut et le support des fonctionnalités peuvent différer de ceux du service cloud. Examinez les limitations connues.

Nettoyer les ressources

Lorsque vous avez terminé, arrêtez le conteneur avec votre runtime ou votre outil de développement.

Runtime Arrêter le conteneur Retirez le conteneur arrêté
Docker docker stop sqldb docker rm sqldb
Podman podman stop sqldb podman rm sqldb
Conteneurs WSL wslc stop sqldb wslc rm sqldb
Conteneur Apple container stop sqldb container delete sqldb

Les commandes d’exécution dans ce guide de démarrage rapide ne configurent pas le stockage persistant. Supprimer le conteneur peut supprimer ses fichiers de base de données, donc conservez d’abord toutes les données dont vous avez besoin. Si vous configurez un volume de données séparément, supprimez-le uniquement si vous avez l’intention de supprimer ses données.