Compilar localement avec le conteneur Azure SQL Database et le conteneur SQL Server

Créez et gérez une base de données locale sans écrire de commandes conteneurs en utilisant l’extension MSSQL pour Visual Studio Code. Choisissez un conteneur Azure SQL Database (Preview) à construire sur le moteur Azure SQL Database sur votre propre ordinateur, ou un conteneur SQL Server pour le développement SQL Server. Démarrez, arrêtez, reconnectez-vous et supprimez votre conteneur de l’extension.

Pour une nouvelle application ciblant Azure SQL Database, commencez par le conteneur Azure SQL Database. Il est gratuit pour le développement et les tests locaux, ne nécessite ni abonnement Azure ni carte de crédit, et fonctionne avec les pilotes et les mapper object-relationnels (ORM) que vous utilisez pour Azure SQL Database.

Remarque

Le conteneur Azure SQL Database est en préversion publique. Il supporte à la fois les périphériques x64 et ARM.

Qu’est-ce qu’un conteneur Azure SQL Database ?

Un conteneur empaquete le moteur de base de données afin qu’un runtime de conteneur puisse l’exécuter sur votre ordinateur. L’extension MSSQL vous guide dans l’installation, télécharge l’image, lance le moteur et enregistre une connexion. Votre application se connecte à une adresse locale telle que localhost,1433, plutôt qu’à un serveur logique Azure SQL.

Le conteneur Azure SQL Database exécute le moteur Azure SQL Database, et non l’image du conteneur SQL Server. Il prend en charge Azure SQL Database T-SQL et le protocole TDS (Tabular Data Stream) utilisé par les pilotes SQL. Par exemple, SERVERPROPERTY('EngineEdition') renvoie 5, identifiant le moteur Azure SQL Database. Les vecteurs natifs, la recherche vectorielle et JSON vous aident à explorer les scénarios de données prêts pour l’IA localement.

Le conteneur ne fournit pas le service cloud managé. les sauvegardes gérées par Azure, la haute disponibilité, les pools élastiques et la pause automatique serverless sont des fonctionnalités cloud, et non des fonctionnalités de conteneur local. Avant le déploiement, testez avec Azure SQL Database dans Azure : les restrictions de prévisualisation, les paramètres par défaut et le support des fonctionnalités peuvent différer. Voir les limitations connues.

Choisir votre base de données de développement

Utilisez l’option correspondant à la cible de votre application, plutôt que de traiter les deux images conteneurs comme interchangeables.

Option Choisissez cette option lorsque Coût et conditions requises du compte
Conteneur Azure SQL Database (Aperçu) Vous souhaitez apprendre SQL ou créer et tester localement une application ciblant Azure SQL Database. Prend en charge X64 et ARM. Recommandé pour ce flux de travail de développement local. Gratuit pour le développement et les tests locaux. Aucun abonnement Azure ou carte de crédit n’est requis.
Conteneur SQL Server Votre application cible SQL Server ou nécessite un comportement spécifique à SQL Server. Prend en charge uniquement X64. Utilisez une édition sous licence pour votre scénario. Aucun abonnement Azure n'est requis pour le développement local.
Azure SQL Database niveau gratuit Vous voulez une base de données gérée dans Azure, une intégration cloud ou un environnement de validation cloud. Nécessite un abonnement Azure. Des allocations mensuelles, des conditions d’éligibilité et des comportements de pause ou de dépassement payant s’appliquent.

Importante

Les conteneurs Azure SQL Database sont destinés au développement, aux tests, à l’intégration continue et aux démonstrations, et non à la production. Pour la production, déployez votre application et votre base de données sur Azure SQL Database dans Azure. Le conteneur local gratuit et le niveau gratuit Azure SQL Database sont des options distinctes.

Prerequisites

Pour le conteneur Azure SQL Database, vous avez besoin de :

  • Visual Studio Code.
  • Une version actuelle de l’extension MSSQL incluant le conteneur Azure SQL Database (Preview).
  • Un environnement d’exécution de conteneurs pris en charge installé et exécutant des conteneurs Linux. L’assistant Azure SQL Database détecte les moteurs disponibles et vérifie leurs prérequis. Les options comprennent Docker, Podman, containerd avec nerdctl et les conteneurs WSL sur Windows.
  • Assez de ressources pour le moteur de base de données. Allouez au moins 4 Go de mémoire et deux cœurs CPU au runtime du conteneur, et conservez au moins 10 Go d’espace disque libre pour l’image et une petite base de données. Les ensembles de données plus volumineux nécessitent plus d’espace disque.
  • Accès Internet pour le téléchargement initial de l’image. Après avoir mis l’image en cache, les requêtes locales ne nécessitent pas de base de données cloud. Les points de terminaison d’IA externes et d’autres services en ligne nécessitent toujours une connectivité.

L’image Azure SQL Database fournit des versions natives linux/amd64 et linux/arm64 variantes pour les hôtes x64 et ARM64. Vous pouvez développer sur macOS, Linux ou Windows avec WSL2. Les conteneurs SQL Server ont des exigences distinctes pour l’image et l’exécution.

Créer un conteneur Azure SQL Database

  1. Dans la vue Connexions de l'extension MSSQL, sélectionnez Nouveau déploiement et conteneur Azure SQL Database (Prévision).

    Capture d’écran de la vue Connexions avec l’action Nouveau déploiement de la barre d’outils mise en évidence.

    Capture d’écran de la page Nouvelle base de données SQL avec l’option d’aperçu du conteneur Azure SQL Database local surligne.

  2. Examinez la vue d’ensemble du conteneur de développement, puis sélectionnez Suivant. L’assistant vérifie le moteur que vous avez installé. Si l’assistant ne trouve pas de moteur, utilisez les liens d’installation fournis pour installer un moteur, puis réessayez les vérifications. Lorsque les vérifications préalables ont réussi, sélectionnez Suivant.

    Capture d’écran de l’aperçu du conteneur Azure SQL Database décrivant le développement local, les images ARM et x64 natives, ainsi que les options du moteur de conteneurs.

    Capture d’écran de la page des prérequis du moteur de conteneurs montrant Docker détecté et les vérifications d’installation, de démarrage et de configuration terminées.

  3. Configurez votre connexion avec un mot de passe fort d’au moins huit caractères (lettres majuscules, lettres minuscules, chiffres et symboles). Examinez et acceptez les Conditions générales, puis sélectionnez Suivant pour provisionner le conteneur.

    Capture d’écran de la configuration du conteneur avec la connexion SQL, un mot de passe masqué, un nom de profil, des options avancées, le port 1436 et la case à cocher des conditions de licence.

  4. Attendez que le téléchargement de l’image, la création du conteneur, la préparation du moteur et la connexion soient terminés.

    Capture d’écran du provisionnement avec téléchargement d’images, création de conteneurs, préparation et étapes de connexion terminées.

  5. Trouvez la connexion enregistrée dans Explorateur d'objets dans la vue Connexions.

    Capture d’écran de la connexion de conteneur Azure SQL DB en cours d’exécution dans Explorateur d'objets avec les nœuds Bases de données et sécurité.

L’extension crée un profil de connexion enregistré. Un conteneur, un profil de connexion et une base de données d’application sont des ressources différentes : démarrer le moteur ne signifie pas que la base de données de votre application existe déjà. Poursuivez les étapes suivantes pour en créer un explicitement.

L’assistant propose également l’authentification Microsoft Entra pour des scénarios plus avancés. Cela nécessite une configuration supplémentaire d’identité et de certificat.

Créez une base de données et exécutez votre première requête

Utilisez appdb comme exemple de nom de base de données. Remplacez systématiquement le nom de base de données de votre projet si vous choisissez un autre nom.

  1. Dans Explorateur d'objets, faites un clic droit sur votre connexion de conteneur et sélectionnez Créer une base de données.

  2. Dans la boîte de dialogue Créer une base de données, saisissez appdb dans Nom de la base.

    Capture d’écran de la boîte de dialogue Créer une base de données pour le conteneur local Azure SQL Database, avec le nom de la base de données et les paramètres avancés.

  3. Utilisez Ajouter une connexion pour vous connecter au même serveur local et au même port avec Database réglé sur appdb. Ouvrez un nouvel éditeur de requêtes avec cette connexion et exécutez :

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

    Attendez-vous à ce que current_database soit appdb, engine_edition soit 5 et edition soit SQL Azure. Si l’édition diffère, vérifiez que vous avez sélectionné le conteneur Azure SQL Database, et non SQL Server. Sélectionnez la base de données dans les paramètres de connexion, et non avec USE appdb. Les sessions de base de données utilisateur Azure SQL Database ne prennent pas en charge le changement de base de données avec USE.

  4. Exécutez chacune de ces instructions séparément dans appdb. Arrêtez si une instruction échoue. Si dbo.Tasks existe déjà, choisissez systématiquement un autre nom de table ou une autre base de données de développement ; ne l’écrasez pas.

    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;
    

    Après une insertion réussie, attendez-vous à deux lignes avec TaskId des valeurs 1 et 2, et IsComplete réglez sur 0.

Si vous préférez SQL pour la création de base de données, connectez un éditeur de requêtes à master et exécutez CREATE DATABASE appdb; au lieu d’utiliser la boîte de dialogue Créer une base de données.

Utiliser master pour le provisionnement de base de données et votre base de données utilisateur pour les requêtes d’application. Se connecter à une base de données qui n’existe pas ne la crée pas, et le conteneur n’exécute pas automatiquement les scripts d’initialisation depuis /docker-entrypoint-initdb.d.

Importer votre schéma et vos données

Si vous disposez déjà d’un package de base de données, utilisez les opérations DACPAC et BACPAC de l’extension au lieu de reconstruire manuellement le schéma.

Package Qu’est-ce qu’il contient ? Operation
.dacpac Schéma de base de données. Il n’inclut pas les données de votre table. Publiez un DACPAC pour déployer le schéma dans une base de données de développement nouvelle ou existante.
.bacpac Schéma de base de données et données de table. Importer un BACPAC dans une base de données de développement nouvelle ou vide.
  1. Faites un clic droit sur votre connexion de conteneur dans Explorateur d'objets, puis sélectionnez DACPAC/BACPAC Operations....

    Capture d’écran du menu de connexion du conteneur avec les opérations DACPAC/BACPAC surlignées et les actions Arrêter le conteneur SQL et Supprimer le conteneur SQL visibles.

  2. Choisissez l’opération correspondant à votre package, sélectionnez le fichier package, puis confirmez la connexion et la base de données du conteneur cible.

  3. Examinez la cible et les modifications proposées avant de poursuivre. Attendez que l’opération se termine, puis actualisez les bases de données et connectez-vous directement à la base de données utilisateur cible pour inspecter son schéma et ses données.

N’importez pas de BACPAC dans appdb après avoir créé la table d’exemple dbo.Tasks : cette base de données n’est pas vide. Choisissez plutôt une base de données de développement nouvelle ou vide. Publiez uniquement les schémas compatibles avec Azure SQL Database, et examinez les modifications avant de les appliquer à une base de données dont vous avez besoin.

Remarque

Les fichiers SQL Server .bak ne sont pas des fichiers BACPAC ; BACKUP DATABASE et RESTORE DATABASE ne sont pas pris en charge par le conteneur Azure SQL Database.

Connectez votre application

Utilisez l'adresse du serveur local, le port hôte sélectionné par l'assistant, le nom de votre base de données et vos identifiants avec un pilote compatible Azure SQL. Par exemple, ce chaîne de connexion de style ADO.NET cible appdb:

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

Remplacez les deux paramètres fictifs avant de vous connecter. TrustServerCertificate=True est destiné uniquement au certificat auto-signé du conteneur local. Utilisez la validation des certificats et une méthode d’authentification appropriée, telle que l’authentification Microsoft Entra, pour Azure SQL Database dans Azure.

Stockez des chaînes de connexion dans des variables d’environnement ou votre magasin de secrets de développement, et non pas les invites d’IA ou le contrôle de version. D’autres pilotes utilisent une syntaxe de chaîne de connexion différente ; voir les démarrages rapides pour Python et .NET.

Développer avec l’IA

Vous pouvez utiliser GitHub Copilot dans l’extension MSSQL pour expliquer le SQL, rédiger des requêtes et planifier les modifications de schéma dans votre base de données locale. Examinez le SQL généré et la base de données sélectionnée avant de l’exécuter. L’utilisation des conteneurs est gratuite ; GitHub Copilot et les services de modèles externes ont leurs propres exigences d’accès et de prix.

Par exemple, après avoir créé dbo.Tasks, donnez à Copilot cette invite :

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.

Pour les flux de travail code-first, les compétences de l’agent de conteneur Azure SQL Database fournissent des conseils d’installation, de connexion, de migration et du local vers le cloud pour les agents de codage IA pris en charge.

Essayez la similarité vectorielle sans service d’embarquement

Exécutez cet exemple sur votre appdb connexion pour explorer les vecteurs natifs et la recherche par similarité exacte. Il utilise des vecteurs illustratifs en trois dimensions, ne crée pas de tableau, et n’appelle pas de point final payant du modèle.

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;

Attendez-vous à Closest d’abord à une distance de 0, suivi de Perpendicular à une distance de 1. Dans une application réelle, générez des embeddings avec le même modèle pour les données stockées et les requêtes, et utilisez les dimensions d’embedding du modèle. VECTOR_DISTANCE effectue une recherche exacte ; il n’utilise pas d’index vectoriel. Examinez les limitations de l’aperçu avant de choisir une stratégie d’indexation ou d’embedding.

Fonctionnalités

Les expériences conteneurs locales offrent les fonctionnalités suivantes :

  • Créez un conteneur Azure SQL Database ou SQL Server via un assistant guidé.
  • Personnalisez le nom du conteneur, le nom d’hôte et le port.
  • Vérifiez les prérequis d’exécution du conteneur avant le déploiement.
  • Affectez automatiquement un port disponible si 1433 est déjà utilisé.
  • Enregistrez les paramètres de connexion pour la reconnexion.
  • Gérez le cycle de vie du conteneur depuis la vue Connexions .

Créer un conteneur SQL Server

Les captures d’écran suivantes illustrent l’assistant SQL Server, et non l’assistant Azure SQL Database.

  1. Ouvrez l’assistant de déploiement et choisissez conteneur SQL Server sous Exécuter localement. Vous pouvez également utiliser Créer un conteneur SQL local depuis le menu Connexions .

    Capture d’écran montrant l’option de création de conteneur SQL Server dans l’extension MSSQL.

  2. Consultez l’écran d’aperçu et sélectionnez Get Started.

    Capture d’écran de l’écran d’aperçu du déploiement local de conteneurs SQL Server avec des liens utiles et le bouton Démarrer.

  3. L’extension MSSQL recherche automatiquement Docker avant le déploiement :

    • Si Docker n’est pas installé, un message avec un lien d’installation s’affiche. Vous devez l’installer avant de continuer.
    • Si Docker est installé, mais pas en cours d’exécution, vous êtes invité à le démarrer. Si le démarrage de Docker échoue, réessayez ou annulez.

    Lorsque toutes les conditions préalables sont remplies, sélectionnez Suivant.

    Capture d'écran de la vérification des prérequis Docker de l'assistant SQL Server dans l'extension MSSQL.

  4. Dans le panneau Paramètres de déploiement :

    1. Sélectionnez la version de SQL Server (SQL Server 2025 (17.x) est sélectionnée par défaut.
    2. Entrez un mot de passe pour le sa compte.
    3. Entrez un nom pour votre profil de connexion (facultatif).
    4. Définissez optionnellement le nom du conteneur, le port et le nom d’hôte sous les options avancées.
    5. Acceptez les termes du contrat de licence.
    6. Sélectionnez Créer un conteneur.

    Capture d’écran du formulaire de configuration de configuration du conteneur.

Fonctionnement du déploiement de conteneurs SQL

Pour SQL Server, après avoir sélectionné Créer un conteneur, l’extension :

  • Extrait l’image SQL Server sélectionnée (si elle n’est pas déjà mise en cache).
  • Crée un conteneur SQL Server avec les paramètres choisis.
  • Surveille les journaux pour vérifier que toutes les bases de données sont entièrement récupérées et prêtes.
  • Crée un profil de connexion et se connecte à votre conteneur.

Lorsque le déploiement est terminé, l’extension MSSQL se connecte au conteneur. Créez ou sélectionnez une base de données utilisateur avant d’exécuter des requêtes d’application.

Gérer votre conteneur

Pour l’un ou l’autre type de conteneur, faites un clic droit sur son profil de connexion enregistré dans la vue Connexions pour gérer son cycle de vie.

La capture d’écran suivante montre un conteneur Azure SQL Database arrêté. Son menu propose Démarrer le conteneur SQL et Supprimer le conteneur SQL. Lorsque le conteneur est en cours d’exécution, le menu propose plutôt Arrêter le conteneur SQL .

Capture d’écran d’un conteneur Azure SQL Database arrêté avec Start SQL Container et Delete SQL Container dans son menu de connexion.

Démarrer un conteneur arrêté

Sélectionnez Démarrer le conteneur SQL. L’extension vérifie l’environnement d’exécution associé et démarre le conteneur avant de se connecter. Si le runtime n’est pas en cours d’exécution, suivez l’invite pour le démarrer.

Arrêter un conteneur en cours d’exécution

Sélectionnez Arrêter le conteneur SQL pour libérer les ressources du conteneur en cours d’exécution sans le supprimer. Les fichiers de base de données restent disponibles lorsque vous redémarrez le même conteneur. Cette action arrête le conteneur, et non la mise en pause automatique serverless d’Azure SQL Database.

Supprimer le conteneur

Sélectionnez Supprimer le conteneur SQL, puis consultez la confirmation avant de continuer. La suppression entraîne celle du conteneur et du profil de connexion sélectionné. Les données stockées uniquement à l’intérieur du conteneur sont perdues ; les volumes gérés séparément ont leur propre cycle de vie. Conservez toutes les données dont vous avez besoin avant de supprimer.

Importante

Ne supprimez pas un conteneur ni son stockage pour dépanner une connexion, sauf si vous pouvez vous permettre de perdre ses données. Si vous voulez seulement mettre le développement en pause, arrêtez-le à la place.

Scénarios pris en charge

Utilisez le conteneur Azure SQL Database pour prototyper des applications, tester des migrations, apprendre T-SQL et explorer les vecteurs et le JSON avant le déploiement cloud. Vous pouvez également utiliser l’image du conteneur dans les interfaces CI, les sidecars d’application ou les laboratoires hors ligne ; ces workflows spécifiques à l’exécution ne sont pas configurés par l’assistant VS Code.

Utilisez le conteneur SQL Server pour tester les schémas et fonctionnalités de SQL Server. Ne supposez pas qu'une fonctionnalité spécifique à SQL Server fonctionne dans Azure SQL Database simplement parce qu'elle fonctionne dans un conteneur SQL Server.

Résoudre les problèmes de développement local

Problème Que vérifier
L’option conteneur Azure SQL Database est absente. Mettez à jour l’extension MSSQL vers une version incluant l’assistant d’aperçu public, puis sélectionnez à nouveau Nouveau déploiement .
Les vérifications des prérequis à l’exécution échouent. Confirmez que l’environnement d’exécution sélectionné est installé, en cours d’exécution et configuré pour les conteneurs Linux. Corrigez le problème signalé et réessayez.
Le téléchargement de l’image échoue. Examinez l’erreur du registre et vérifiez la connectivité et la configuration d’exécution. Ne remplacez pas l'image SQL Server par Azure SQL Database.
Le conteneur démarre mais les connexions échouent. Attendez la préparation du moteur, puis inspectez les détails des erreurs et les journaux du conteneur. Vérifiez la complexité du mot de passe et l’allocation de mémoire. Un processus conteneur en cours de cours ne prouve pas que la base de données est prête.
Une application ne peut pas accéder à la base de données. Utilisez le port hôte réel sélectionné par l’assistant, et non un 1433 supposé. localhost fait référence à l’hôte propre de l’application ; une application dans un autre conteneur nécessite une adresse réseau du conteneur appropriée.
La base de données n’existe pas. Connectez-vous à master, créez la base de données, puis reconnectez-vous directement à celle-ci.
USE appdb échoue. Sélectionnez appdb dans les paramètres de connexion. Ne changez pas de base de données dans une session de base de données utilisateur Azure SQL Database avec USE.
Une opération de gestion SQL Server échoue. Vérifiez si l’opération est prise en charge par Azure SQL Database. Par exemple, BACKUP DATABASE et RESTORE DATABASE ne sont pas pris en charge.

Voir les limitations connues des lacunes actuelles dans les prévisualisations et des solutions de contournement.

Nettoyer les données d’exemple

Sur votre appdb connexion, confirmez SELECT DB_NAME() les retours appdb. Si vous avez créé dbo.Tasks dans cette procédure pas à pas et n’en avez plus besoin, supprimez uniquement cette table d’exemple :

DROP TABLE dbo.Tasks;

N’exécutez pas cette instruction sur une table d’un autre projet. Arrêtez le conteneur pour pouvoir continuer à travailler dessus plus tard, ou supprimez-le uniquement lorsque vous n’avez plus besoin de ses données.

Passer du local au cloud

  • En utilisant l’extension MSSQL, vous pouvez déployer votre base de données locale dans le cloud. En savoir plus sur Local to Cloud.