Azure SQL Edge sera mis hors service le 30 septembre 2025. Pour plus d’informations et pour connaître les options de migration, consultez l’Avis de mise hors service.
Notes
Azure SQL Edge ne prend plus en charge la plateforme ARM64.
Azure SQL Edge est un moteur de base de données relationnelle optimisé pour les déploiements IoT et Azure IoT Edge. Il offre des fonctionnalités permettant de créer une couche de traitement et de stockage des données hautes performances pour les solutions et applications IoT. Ce guide de démarrage rapide vous montre comment prendre en main la création d’un module Azure SQL Edge via Azure IoT Edge à l’aide du portail Azure.
Avant de commencer
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit.
Dans la page Ajouter un module IoT Edge, spécifiez les valeurs souhaitées pour le nom du module IoT Edge, l’URI d’image, la stratégie de redémarrage et l’état souhaité.
Utilisez l’URI d’image suivant en fonction de l’édition que vous souhaitez déployer :
Dans la section Variables d’environnement de la page Mettre à jour le module IoT Edge, spécifiez les valeurs souhaitées pour les variables d’environnement. Pour obtenir la liste complète des variables d’environnement d’Azure SQL Edge, consultez Configurer à l’aide de variables d’environnement.
Définissez la valeur pour spécifier un mot de passe fort pour le compte d’administrateur SQL Edge.
MSSQL_LCID
Définissez la valeur pour définir l’ID de langue souhaitée à utiliser pour SQL Edge. Par exemple, 1036 correspond au français.
MSSQL_COLLATION
Définissez la valeur pour définir le classement par défaut pour SQL Edge. Ce paramètre remplace le mappage par défaut de l’ID de langue (LCID) par le classement.
Dans la section Options de création de conteneur de la page Ajouter un module IoT Edge, définissez les options en fonction des besoins.
Port de l’hôte
Mappez le port d’hôte spécifié au port 1433 (port SQL par défaut) dans le conteneur.
Liaisons et Montages
Si vous devez déployer plusieurs modules SQL Edge, veillez à mettre à jour l’option Montages pour créer une paire source-cible pour le volume persistant. Pour plus d’informations sur les montages et le volume, consultez Utiliser des volumes dans la documentation Docker.
Définissez la variable d’environnement PlanId en fonction de l’édition installée.
Édition Développeur - asde-developer-on-iot-edge
Édition Premium - asde-premium-on-iot-edge
Si cette valeur est définie de manière incorrecte, le conteneur Azure SQL Edge ne parvient pas à démarrer.
Avertissement
Si vous réinstallez le module, n’oubliez pas de supprimer d’abord les liaisons existantes, sinon vos variables d’environnement ne seront pas mises à jour.
Dans la page Ajouter un module IoT Edge, sélectionnez Ajouter.
Dans la page Définir des modules sur l’appareil, sélectionnez Suivant : Itinéraires > si vous devez définir des itinéraires pour votre déploiement. Sinon, sélectionnez Vérifier + créer. Pour plus d’informations sur la configuration d’itinéraires, consultez Déployer des modules et établir des routes dans IoT Edge.
Sur la page Définir des modules sur l’appareil, sélectionnez Créer.
Se connecter à Azure SQL Edge
La procédure suivante utilise l’outil en ligne de commande Azure SQL Edge, sqlcmd, dans le conteneur pour se connecter à Azure SQL Edge.
Notes
Les outils en ligne de commande SQL Server, notamment sqlcmd, ne sont pas disponibles dans la version ARM64 des conteneurs Azure SQL Edge.
Utilisez la commande docker exec -it pour démarrer un interpréteur de commandes bash interactif dans votre conteneur en cours d’exécution. Dans l’exemple suivant, AzureSQLEdge est le nom spécifié par le paramètre Name de votre module IoT Edge.
sudo docker exec -it AzureSQLEdge "bash"
Une fois dans le conteneur, connectez-vous localement avec l’outil sqlcmd. sqlcmd n’est pas dans le chemin par défaut, vous devez spécifier le chemin complet.
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<YourNewStrong@Passw0rd>"
Conseil
Vous pouvez omettre le mot de passe sur la ligne de commande pour être invité à l’entrer.
Si l’opération réussit, vous devez accéder à une invite de commandes sqlcmd : 1>.
Créer et interroger des données
Les sections suivantes vous guident lors de l’utilisation de sqlcmd et Transact-SQL pour créer une base de données, ajouter des données et exécuter une requête.
Créer une base de données
La procédure suivante crée une base de données nommée TestDB.
À partir de l’invite de commandes sqlcmd, collez la commande Transact-SQL suivante pour créer une base de données de test :
CREATE DATABASE TestDB;
GO
Sur la ligne suivante, écrivez une requête pour retourner le nom de toutes les bases de données sur votre serveur :
SELECT name from sys.databases;
GO
Insertion des données
Créez ensuite une table nommée Inventory et insérez deux nouvelles lignes.
À partir de l’invite de commandes sqlcmd, basculez le contexte vers la nouvelle base de données TestDB :
USE TestDB;
Créez une table nommée Inventory :
CREATE TABLE Inventory (id INT, name NVARCHAR(50), quantity INT)
Insérez des données dans la nouvelle table :
INSERT INTO Inventory
VALUES (1, 'banana', 150);
INSERT INTO Inventory
VALUES (2, 'orange', 154);
Tapez GO pour exécuter les commandes précédentes :
GO
Sélectionner les données
Exécutez maintenant une requête pour retourner des données de la table Inventory.
Dans l’invite de commandes sqlcmd, entrez une requête qui retourne les lignes de la table Inventory dont la quantité est supérieure à 152 :
SELECT * FROM Inventory WHERE quantity > 152;
Exécutez la commande :
GO
Quitter l’invite de commandes sqlcmd
Pour mettre fin à votre session sqlcmd, tapez QUIT :
QUIT
Pour quitter l’invite de commandes interactive dans votre conteneur, tapez exit. Le conteneur continue de s’exécuter une fois que vous avez quitté l’interpréteur de commandes bash interactif.
Se connecter en dehors du conteneur
Vous pouvez vous connecter et exécuter des requêtes SQL sur votre instance Azure SQL Edge à partir de n’importe quel outil externe Linux, Windows ou macOS qui prend en charge les connexions SQL. Pour plus d’informations sur la connexion à un conteneur SQL Edge depuis l’extérieur, consultez Connecter et interroger Azure SQL Edge.
Dans ce guide de démarrage rapide, vous avez déployé un module SQL Edge sur un appareil IoT Edge.
Azure SQL Edge est un moteur de base de données relationnelle optimisé et conçu pour les déploiements IoT et IoT Edge. Il offre des fonctionnalités permettant de créer une couche de traitement et de stockage des données hautes performances pour les solutions et applications IoT.
Administrer une infrastructure de base de données SQL Server pour les bases de données relationnelles cloud, locales et hybrides à l’aide des offres de bases de données relationnelles Microsoft PaaS.