Configurer des paramètres SQL Server à l’aide de variables d’environnement sur Linux

S’applique à :SQL Server sur Linux

Vous pouvez utiliser plusieurs variables d’environnement différentes pour configurer SQL Server sur Linux. Ces variables sont utilisées dans deux scénarios :

• Pour configurer l’installation initiale à l’aide de la commande mssql-conf setup.
• Pour configurer une nouvelle image de conteneur SQL Server Linux.

Conseil

Si vous devez configurer SQL Server après ces scénarios d’installation, consultez Configurer SQL Server sur Linux avec l’outil mssql-conf.

Variables d'environnement

Variable d’environnement	Descriptif
ACCEPT_EULA	Attribuez une valeur quelconque à la variable ACCEPT_EULA pour confirmer votre acceptation du contrat de licence d’utilisateur final. Paramètre obligatoire pour l’image de SQL Server.
MSSQL_SA_PASSWORD	Configurez le mot de passe sa. La variable d’environnement SA_PASSWORD est obsolète. Utilisez MSSQL_SA_PASSWORD à la place.
MSSQL_PID	Définissez l’édition sql Server ou la clé de produit. Les valeurs possibles sont répertoriées dans le tableau d’éditions SQL Server suivant. Si vous spécifiez une clé de produit, elle doit être sous la forme , #####-#####-#####-#####-#####où # se trouve un nombre ou une lettre.
MSSQL_LCID	Définit l’ID de langue à utiliser pour SQL Server. Par exemple, 1036 correspond au français.
MSSQL_COLLATION	Définit le classement par défaut pour SQL Server. Cela remplace le mappage par défaut de l’ID de langue (LCID) par le classement.
MSSQL_MEMORY_LIMIT_MB	Définit la quantité maximale de mémoire (en Mo) que SQL Server peut utiliser. Par défaut, elle correspond à 80 % de la mémoire physique totale.
MSSQL_TCP_PORT	Configurez le port TCP sur lequel SQL Server écoute (par défaut 1433).
MSSQL_IP_ADDRESS	Définissez l’adresse IP. Actuellement, l’adresse IP doit être de type IPv4 (0.0.0.0).
MSSQL_BACKUP_DIR	Définissez l’emplacement du répertoire de sauvegarde par défaut.
MSSQL_DATA_DIR	Modifiez l'annuaire dans lequel les nouveaux fichiers de données de la base de données SQL Server (.mdf) sont créés.
MSSQL_LOG_DIR	Modifiez l'annuaire dans lequel les nouveaux fichiers journaux de base de données SQL Server (.ldf) sont créés.
MSSQL_DUMP_DIR	Modifiez le répertoire où SQL Server dépose par défaut les vidages mémoire et d'autres fichiers de dépannage.
MSSQL_ENABLE_HADR	Activez le groupe de disponibilité. Par exemple, « 1 » est activé et « 0 » est désactivé.
MSSQL_AGENT_ENABLED	Activer l’agent SQL Server. Par exemple, « true » est activé et « false » est désactivé. Par défaut, l’agent est désactivé.
MSSQL_MASTER_DATA_FILE	Définit l'emplacement du fichier de données de la base de données master. Doit être nommé master.mdf jusqu'à la première exécution de SQL Server.
MSSQL_MASTER_LOG_FILE	Définit l'emplacement du fichier journal de la base de données master. Doit être nommé mastlog.ldf jusqu'à la première exécution de SQL Server.
MSSQL_ERROR_LOG_FILE	Définit l’emplacement des fichiers errorlog. Par exemple : /var/opt/mssql/log/errorlog.

Éditions de SQL Server

MSSQL_PID	Édition
Evaluation	Édition d’évaluation DE SQL Server
Express	Édition SQL Server Express
StandardDeveloper (Pour les conteneurs, utilisez DeveloperStandard)	SQL Server Standard Developer Édition
Standard	SQL Server Standard édition
EnterpriseDeveloper (Pour les conteneurs, utilisez Developer)	SQL Server Enterprise Developer Edition
Enterprise	Cette option héritée représente les licences basées sur Enterprise Edition Server + Licence d’accès client (CAL) et est limitée à un maximum de 20 cœurs par instance SQL Server. Enterprise n’est pas disponible pour les nouveaux contrats. Vous devez choisir EnterpriseCore quand vous souhaitez le déploiement de l’édition Entreprise.
EnterpriseCore	SQL Server Enterprise Core Edition. EnterpriseCore représente le modèle de licence de serveur basé sur les cœurs, sans limites de cœurs. Pour plus d’informations, voir Limites de capacité de calcul par édition de SQL Server.
A product key	Si vous spécifiez une clé de produit, elle doit être sous la forme , #####-#####-#####-#####-#####où # se trouve un nombre ou une lettre.

Pour plus d’informations sur ces éditions, consultez les éditions de SQL Server.

Utiliser avec l’installation initiale

Cet exemple exécute mssql-conf setup avec des variables d’environnement configurées. Les variables d’environnement suivantes sont spécifiées :

• ACCEPT_EULA accepte le contrat de licence d’utilisateur final.

• MSSQL_PID spécifie l’édition SQL Server Developer sous licence gratuite pour une utilisation hors production.

• MSSQL_SA_PASSWORD crée un mot de passe fort. Votre mot de passe doit suivre la politique de mot de passe par défaut de SQL Server. Par défaut, le mot de passe doit avoir au moins huit caractères appartenant à trois des quatre groupes suivants : lettres majuscules, lettres minuscules, chiffres de base 10 et symboles. Les mots de passe peuvent comporter jusqu'à 128 caractères. Utilisez des mots de passe aussi longs et complexes que possible.

• MSSQL_TCP_PORT définit le port TCP que SQL Server écoute sur 1234.

sudo ACCEPT_EULA='Y' MSSQL_PID='Developer' MSSQL_SA_PASSWORD='<password>' MSSQL_TCP_PORT=1234 /opt/mssql/bin/mssql-conf setup

Utiliser avec Docker

Cet exemple de commande docker utilise les variables d'environnement suivantes pour créer un conteneur SQL Server :

• ACCEPT_EULA accepte le contrat de licence d’utilisateur final.

• MSSQL_PID spécifie l’édition SQL Server Developer sous licence gratuite pour une utilisation hors production.

  Lorsque vous déployez un conteneur pour SQL Server 2025 (17.x) ou une version ultérieure, utilisez-le MSSQL_PID=DeveloperStandard pour l’édition Développeur Standard et MSSQL_PID=Developer pour l’édition Enterprise Developer.

• MSSQL_SA_PASSWORD crée un mot de passe fort. Votre mot de passe doit suivre la politique de mot de passe par défaut de SQL Server. Par défaut, le mot de passe doit avoir au moins huit caractères appartenant à trois des quatre groupes suivants : lettres majuscules, lettres minuscules, chiffres de base 10 et symboles. Les mots de passe peuvent comporter jusqu'à 128 caractères. Utilisez des mots de passe aussi longs et complexes que possible.

• MSSQL_TCP_PORT définit le port TCP que SQL Server écoute sur 1234. Cela signifie qu’au lieu de mapper le port 1433 (par défaut) à un port hôte, le port TCP personnalisé doit être mappé avec la commande -p 1234:1234 dans cet exemple.

Si vous exécutez Docker sur Linux, utilisez la syntaxe suivante avec des guillemets simples :

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest

Si vous exécutez Docker sur Windows, utilisez la syntaxe suivante avec des guillemets doubles :

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest

Lorsque vous déployez un conteneur pour SQL Server 2025 (17.x) ou une version ultérieure, utilisez-le MSSQL_PID=DeveloperStandard pour l’édition Développeur Standard et MSSQL_PID=Developer pour l’édition Enterprise Developer.

Attention

Votre mot de passe doit suivre la politique de mot de passe par défaut de SQL Server. Par défaut, le mot de passe doit avoir au moins huit caractères appartenant à trois des quatre groupes suivants : lettres majuscules, lettres minuscules, chiffres de base 10 et symboles. Les mots de passe peuvent comporter jusqu'à 128 caractères. Utilisez des mots de passe aussi longs et complexes que possible.

Contenu connexe

• Configurer SQL Server sur Linux avec l’outil mssql-conf
• Conseils d’installation pour SQL Server sur Linux

Contribuer à la documentation SQL

Saviez-vous que vous pouvez modifier le contenu SQL vous-même ? Dans ce cas, non seulement vous nous aidez à améliorer notre documentation, mais vous êtes également cité en tant que contributeur à la page.

Pour plus d’informations, consultez Modifier la documentation Microsoft Learn.