Configurer Azure SQL Edge

Important

Azure SQL Edge ne prend plus en charge la plateforme ARM64.

Azure SQL Edge prend en charge la configuration par le biais d'une deux options suivantes :

• Variables d'environnement
• Un fichier mssql.conf placé dans le dossier /var/opt/mssql

Remarque

La définition de variables d’environnement remplace les paramètres spécifiés dans le fichier mssql.conf.

Configurer à l'aide des variables d’environnement

Azure SQL Edge expose plusieurs variables d’environnement qui peuvent être utilisées pour configurer le conteneur SQL Edge. Ces variables d’environnement correspondent à un sous-ensemble de celles disponibles pour SQL Server sur Linux. Pour plus d’informations sur les variables d’environnement SQL Server sur Linux, consultez Variables d’environnement.

Les nouvelles variables d’environnement suivantes ont été ajoutées à Azure SQL Edge.

Variable d’environnement	Description	Valeurs
PlanId	Spécifie la référence SKU Azure SQL Edge à utiliser lors de l'initialisation. Cette variable d'environnement est uniquement requise lors du déploiement d'Azure SQL Edge à l'aide d'Azure IoT Edge.	asde-developer-on-iot-edge ou asde-premium-on-iot-edge
MSSQL_TELEMETRY_ENABLED	Activez ou désactivez la collecte des données d’utilisation et de diagnostic.	TRUE ou FALSE
MSSQL_TELEMETRY_DIR	Définit le répertoire cible pour les fichiers d’audit de la collecte des données d’utilisation et de diagnostic.	Emplacement du dossier dans le conteneur SQL Edge. Ce dossier peut être mappé à un volume hôte à l’aide de points de montage ou de volumes de données.
MSSQL_PACKAGE	Spécifie l'emplacement du package dacpac ou bacpac à déployer.	Dossier, fichier ou URL SAP contenant les packages dacpac ou bacpac. Pour plus d’informations, consultez Déployer des packages DACPAC et BACPAC SQL Database dans SQL Edge.

La variable d’environnement SQL Server sur Linux suivante n’est pas prise en charge par Azure SQL Edge. Si elle est définie, cette variable d’environnement est ignorée lors de l’initialisation du conteneur.

Variable d’environnement	Description
MSSQL_ENABLE_HADR	Activez le groupe de disponibilité. Par exemple, 1 est activé et 0 est désactivé.

Important

La variable d’environnement MSSQL_PID pour SQL Edge accepte uniquement Premium et Developer en tant que valeurs valides. Azure SQL Edge ne prend pas en charge l’initialisation à l’aide d’une clé de produit.

Spécifier les variables d’environnement

Spécifiez les variables d’environnement pour SQL Edge lorsque vous déployez le service via le portail Azure. Vous pouvez les ajouter dans la section Variables d’environnement du déploiement de module ou dans le cadre des Options de création de conteneur.

Ajoutez les valeurs dans des Variables d’environnement.

Ajoutez des valeurs dans Options de création de conteneur.

Remarque

En mode de déploiement déconnecté, les variables d'environnement peuvent être spécifiées à l'aide de l'option -e, --env ou --env-file de la commande docker run.

Configurer à l’aide d’un fichier mssql.conf

Azure SQL Edge n’inclut pas l’utilitaire de configuration mssql-conf comme le fait SQL Server sur Linux. Vous devez configurer manuellement le fichier mssql.conf et le placer dans le lecteur de stockage persistant qui est mappé au dossier /var/opt/mssql/ dans le module SQL Edge. Lors du déploiement de SQL Edge à partir de la Place de marché Azure, ce mappage est spécifié en tant qu’option Mounts dans les Options de création de conteneur.

{
  "Mounts": [
    {
      "Type": "volume",
      "Source": "sqlvolume",
      "Target": "/var/opt/mssql"
    }
  ]
}

Les nouvelles options MSSQL. conf suivantes ont été ajoutées pour Azure SQL Edge.

Option	Description
customerfeedback	Choisissez si SQL Server envoie des commentaires à Microsoft. Pour plus d'informations, consultez Désactiver la collecte des données d'utilisation et de diagnostic
userrequestedlocalauditdirectory	Définit le répertoire cible pour les fichiers d’audit de la collecte des données d’utilisation et de diagnostic. Pour plus d'informations, consultez Audit local de la collecte des données d'utilisation et de diagnostic

Les options mssql.conf suivantes ne s’appliquent pas à SQL Edge :

Option	Description
Feedback des clients	Choisissez si SQL Server envoie des commentaires à Microsoft.
Profil Database Mail	Définir le profil de messagerie de base de données par défaut pour SQL Server sur Linux.
Haute disponibilité	Activer les groupes de disponibilité.
Microsoft Distributed Transaction Coordinator	Configurer et dépanner MSDTC sur Linux. Les autres options de configuration liées aux transactions distribuées ne sont pas prises en charge par SQL Edge. Pour plus d’informations sur ces options de configuration supplémentaires, consultez Configurer MSDTC.
CLUF ML Services	Accepter les CLUF R et Python pour les packages Azure Machine Learning. S'applique à SQL Server 2019 uniquement.
outboundnetworkaccess	Activez l'accès réseau sortant pour les extensions Machine Learning Services R, Python et Java.

L’exemple suivant de fichier mssql.conf fonctionne pour SQL Edge. Pour plus d’informations sur le format d’un fichier , consultez mssql.confFormat mssql.conf.

[EULA]
accepteula = Y

[coredump]
captureminiandfull = true
coredumptype = full

[filelocation]
defaultbackupdir = /var/opt/mssql/backup/
defaultdatadir = /var/opt/mssql/data/
defaultdumpdir = /var/opt/mssql/data/
defaultlogdir = /var/opt/mssql/log/

[language]
lcid = 1033

[memory]
memorylimitmb = 6144

[sqlagent]
errorlogfile = /var/opt/mssql/log/sqlagentlog.log
errorlogginglevel = 7

[traceflag]
traceflag0 = 3604
traceflag1 = 3605
traceflag2 = 1204

Exécutez Azure SQL Edge en tant qu’utilisateur non racine

Par défaut, les conteneurs Azure SQL Edge s'exécutent avec un utilisateur/groupe non racine. Lorsqu’ils sont déployés via le Place de marché Azure (ou à l’aidedocker run), sauf si un autre utilisateur/groupe est spécifié, les conteneurs SQL Edge démarrent en tant qu’utilisateur mssql (non racine). Pour spécifier un autre utilisateur non racine pendant le déploiement, ajoutez la paire clé-valeur *"User": "<name|uid>[:<group|gid>]"* sous les options de création de conteneur. Dans l’exemple suivant, SQL Edge est configuré pour démarrer en tant qu’utilisateur *IoTAdmin*.

{
    ..
    ..
    ..
    "User": "IoTAdmin",
    "Env": [
        "MSSQL_AGENT_ENABLED=TRUE",
        "ClientTransportType=AMQP_TCP_Only",
        "MSSQL_PID=Premium"
    ]
}

Pour permettre à l’utilisateur non racine d’accéder aux fichiers de base de données qui se trouvent sur des volumes montés, vérifiez que l’utilisateur/le groupe sous lequel vous exécutez le conteneur dispose des autorisations de lecture et d’écriture sur le stockage de fichiers persistant. Dans l’exemple suivant, nous définissons l’utilisateur non racine avec user_id celui-ci 10001 comme propriétaire des fichiers.

chown -R 10001:0 <database file dir>

Mise à niveau à partir des versions antérieures de CTP

Les CTP précédentes d'Azure SQL Edge étaient configurées de manière à s'exécuter en tant qu'utilisateurs racine. Les options suivantes sont disponibles lors de la mise à niveau à partir de CTP antérieures.

• Continuer à utiliser l’utilisateur racine - Pour continuer à utiliser l’utilisateur racine, ajoutez la paire clé-valeur *"User": "0:0"* sous les options de création de conteneur.

• Utilisez l’utilisateur mssql par défaut : pour utiliser l’utilisateur mssql par défaut, procédez comme suit :

  • Ajoutez un utilisateur nommé mssql sur l’hôte Docker. Dans l’exemple ci-dessous, nous ajoutons un utilisateur MSSQL avec l’ID 10001. Cet utilisateur est également ajouté au groupe racine.

    sudo useradd -M -s /bin/bash -u 10001 -g 0 mssql
    

  • Modifier l'autorisation sur le répertoire/volume de montage dans lequel se trouve le fichier de base de données

    sudo chgrp -R 0 /var/lib/docker/volumes/kafka_sqldata/
    sudo chmod -R g=u /var/lib/docker/volumes/kafka_sqldata/
    

• Utiliser un autre compte d’utilisateur non racine - Pour utiliser un autre compte d’utilisateur non racine

  • Mettez à jour les options de création de conteneur pour spécifier l’ajout d’une paire clé-valeur *"User": "user_name | user_id* sous les options de création de conteneur. Remplacez user_name ou user_id par un user_name réel ou user_id de votre hôte Docker.
  • Modifiez les autorisations sur le répertoire/volume de montage.

Rendre vos données persistantes

Vos changements de configuration et fichiers de base de données Azure SQL Edge sont conservés dans le conteneur même si vous redémarrez le conteneur avec docker stop et docker start. Toutefois, si vous supprimez le conteneur avec docker rm, tout ce qui se trouve dans le conteneur est supprimé, y compris Azure SQL Edge et vos bases de données. La section suivante explique comment utiliser des volumes de données pour conserver les fichiers de votre base de données même si les conteneurs associés sont supprimés.

Important

Pour Azure SQL Edge, il est essentiel de comprendre la persistance des données dans Docker. En plus de la discussion de cette section, consultez la documentation de Docker pour savoir comment gérer les données dans les conteneurs Docker.

Monter un répertoire hôte en tant que volume de données

La première option consiste à monter un répertoire sur votre hôte en tant que volume de données dans votre conteneur. Pour ce faire, utilisez la commande docker run avec l'indicateur -v <host directory>:/var/opt/mssql. Cela permet de restaurer les données entre les exécutions de conteneur.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1433:1433 -v <host directory>/data:/var/opt/mssql/data -v <host directory>/log:/var/opt/mssql/log -v <host directory>/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/azure-sql-edge

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1433:1433 -v <host directory>/data:/var/opt/mssql/data -v <host directory>/log:/var/opt/mssql/log -v <host directory>/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/azure-sql-edge

Cette technique vous permet également de partager et d’afficher les fichiers sur l’ordinateur hôte en dehors de Docker.

Important

Le mappage de volume hôte pour Docker sur Windows ne prend actuellement pas en charge le mappage du répertoire complet /var/opt/mssql . Toutefois, vous pouvez mapper un sous-répertoire comme /var/opt/mssql/data à votre ordinateur hôte.

Important

Le mappage de volume hôte pour Docker sur macOS avec l’image Azure SQL Edge n’est pas pris en charge pour l’instant. Utilisez des conteneurs de volume de données à la place. Cette restriction est spécifique au répertoire /var/opt/mssql. La lecture à partir d’un répertoire monté fonctionne bien. Par exemple, vous pouvez monter un répertoire hôte à l’aide -v de macOS et restaurer une sauvegarde à partir d’un .bak fichier qui réside sur l’hôte.

Utiliser des conteneurs de volume de données

La deuxième option consiste à utiliser un conteneur de volume de données. Vous pouvez créer un conteneur de volume de données en spécifiant un nom de volume à la place d’un répertoire hôte avec le paramètre -v. L’exemple suivant crée un volume de données partagé nommé sqlvolume.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

Remarque

Cette technique pour créer implicitement un volume de données dans la commande d’exécution ne fonctionne pas avec les versions antérieures de Docker. Dans ce cas, utilisez les étapes explicites décrites dans la documentation de Docker, Création et montage d’un conteneur de volume de données.

Même si vous arrêtez et supprimez ce conteneur, le volume de données persiste. Vous pouvez l’afficher avec la commande docker volume ls.

docker volume ls

Si vous créez ensuite un autre conteneur avec le même nom de volume, le nouveau conteneur utilise les données Azure SQL Edge contenues dans le volume.

Pour supprimer un conteneur de volume de données, utilisez la commande docker volume rm.

Avertissement

Si vous supprimez le conteneur de volume de données, toutes les données Azure SQL Edge dans le conteneur sont définitivement supprimées.

Étapes suivantes

• Se connecter à Azure SQL Edge
• Générer une solution IoT de bout en bout avec SQL Edge