Configuración de SQL Server en Linux con la herramienta mssql-conf

Se aplica a:SQL Server - Linux

mssql-conf es un script de configuración que se instala con SQL Server para Red Hat Enterprise Linux, SUSE Linux Enterprise Server y Ubuntu. Modifica el archivo mssql.conf donde se almacenan los valores de configuración.

mssql-conf es un script de configuración que se instala con SQL Server en Linux. Puede usar esta utilidad para establecer los siguientes parámetros:

Consejos de uso

• Para los grupos de disponibilidad Always On y los clústeres de discos compartidos, haga siempre los mismos cambios de configuración en cada nodo.

• En el caso del escenario de clúster de disco compartido, no intente reiniciar el servicio mssql-server para aplicar los cambios. SQL Server se ejecuta como una aplicación. En su lugar, desconecte el recurso y vuelva a conectarlo.

• En estos ejemplos se ejecuta mssql-conf especificando la ruta de acceso completa: /opt/mssql/bin/mssql-conf. Si opta por ir a esa ruta de acceso en su lugar, ejecute mssql-conf en el contexto del directorio actual: ./mssql-conf.

• Si desea modificar el archivo mssql.conf dentro de un contenedor, cree un archivo mssql.conf en el host donde tiene el contenedor ejecutándose con su configuración deseada, y a continuación reimplemente su contenedor. Por ejemplo, la siguiente adición al archivo mssql.conf habilita el Agente SQL Server.

  [sqlagent]
  enabled = true
  

  Puede implementar el contenedor con los siguientes comandos:

  docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" \
  -p 5433:1433 --name sql1 \
  -v /container/sql1:/var/opt/mssql \
  -d mcr.microsoft.com/mssql/server:2019-latest
  

  Precaución

  La contraseña debe seguir la directiva de contraseña predeterminada de SQL Server. De forma predeterminada, la contraseña debe tener al menos ocho caracteres y contener caracteres de tres de los siguientes cuatro conjuntos: mayúsculas, minúsculas, dígitos en base 10 y símbolos. Las contraseñas pueden tener hasta 128 caracteres. Use contraseñas lo más largas y complejas posible.

  Para más información, consulte Creación de los archivos de configuración que va a usar el contenedor de SQL Server.

Habilitar el Agente SQL Server

La configuración sqlagent.enabled habilita el Agente SQL Server. De forma predeterminada, el Agente SQL Server está deshabilitado. Si sqlagent.enabled no está en el archivo de configuración mssql.conf, SQL Server asume de forma interna que el Agente SQL Server está deshabilitado.

Para cambiar esta configuración, siga estos pasos:

1. Habilite el Agente SQL Server:

   sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true
   

2. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

Establecimiento del perfil de correo electrónico de base de datos predeterminado para SQL Server en Linux

sqlagent.databasemailprofile permite establecer el perfil de DB Mail predeterminado para las alertas por correo electrónico.

sudo /opt/mssql/bin/mssql-conf set sqlagent.databasemailprofile <profile_name>

Registros de errores del Agente SQL

Las configuraciones sqlagent.errorlogfile y sqlagent.errorlogginglevel permiten establecer el nivel de registro y la ruta del archivo de registro del Agente SQL respectivamente.

sudo /opt/mssql/bin/mssql-conf set sqlagent.errorlogfile <path>

Los niveles de registro del Agente SQL son valores de máscara de bits que son iguales a:

• 1 = errores
• 2 = Advertencias
• 4 = Información

Si desea capturar todos los niveles, utilice 7 como valor.

sudo /opt/mssql/bin/mssql-conf set sqlagent.errorlogginglevel <level>

Configuración de la autenticación de Microsoft Entra

A partir de SQL Server 2022 (16.x), puede configurar Microsoft Entra ID para SQL Server. Para configurar Microsoft Entra ID, debe instalar la extensión de Azure para SQL Server después de la instalación de SQL Server. Para obtener información sobre cómo configurar Microsoft Entra ID, consulte Tutorial: Configuración de la autenticación de Microsoft Entra para SQL Server.

Cambiar la ruta de certificación predeterminada de Microsoft Entra ID

De forma predeterminada, el archivo de certificado de Microsoft Entra se almacena en /var/opt/mssql/aadsecrets/. Puede cambiar esta ruta de acceso si usa un almacén de certificados o una unidad cifrada. Para cambiar la ruta de acceso, puede usar el siguiente comando:

sudo /opt/mssql/bin/mssql-conf set network.aadcertificatefilepath /path/to/new/___location.pfx

En el ejemplo anterior, /path/to/new/___location.pfx es la ruta de acceso preferida que incluye el nombre del certificado.

El certificado para la autenticación de Microsoft Entra, descargado por la extensión de Azure para SQL Server, se almacena en esta ubicación. No puede cambiarlo a /var/opt/mssql/secrets.

Opciones de configuración de Microsoft Entra ID

Las siguientes opciones se usan en la autenticación de Microsoft Entra en una instancia de SQL Server que se ejecuta en Linux.

SQL Server 2022 (16.x) CU 19 presenta una opción para establecer el límite de registros IPv6 para los puntos de conexión de autenticación de Microsoft Entra. Si IPv6 está habilitado en Linux y las direcciones IPv6 de los puntos de conexión de autenticación de Microsoft Entra no son accesibles, puede establecer la opción network.ipv6dnsrecordslimit para que la autenticación de Microsoft Entra funcione. Establecer esta opción en cualquier valor entre 0 y 5 garantiza que al menos una dirección IPv4 se intenta usar para acceder a los puntos de conexión de Microsoft Entra.

Un valor de 0 significa que no se intenta ninguna dirección de punto de conexión IPv6. Un valor de 5 significa que se prueban cinco direcciones AAAA.

Configuración de la autenticación de Windows Active Directory

La opción setup-ad-keytab se puede usar para crear un keytab, pero el usuario y los Nombres Principales de Servicio (SPNs) deben haberse creado para usar esta opción. La utilidad de Active Directory, adutil se puede usar para crear usuarios, SPN y archivos keytab.

Para ver opciones sobre el uso de setup-ad-keytab, ejecute el siguiente comando:

sudo /opt/mssql/bin/mssql-conf setup-ad-keytab --help

La opción validate-ad-config valida la configuración de la autenticación de Active Directory.

Cambio de la intercalación de SQL Server

La opción set-collation cambia el valor de intercalación por cualquiera de las intercalaciones admitidas. Para realizar este cambio, es necesario detener el servicio SQL Server.

1. En primer lugar, realice una copia de seguridad de todas las bases de datos de usuario del servidor.

2. Después, use el procedimiento almacenado sp_detach_db para desasociar las bases de datos de usuario.

3. Ejecute la opción set-collation y siga las indicaciones:

   sudo /opt/mssql/bin/mssql-conf set-collation
   

4. La utilidad mssql-conf intenta cambiar al valor de intercalación especificado y reiniciar el servicio. Si hay algún error, revierte la intercalación al valor anterior.

5. Restaure las copias de seguridad de las bases de datos de usuario.

Para obtener una lista de las intercalaciones admitidas, ejecute la función sys.fn_helpcollations: SELECT Name from sys.fn_helpcollations().

<a id="custom-password-policy>

Directivas de contraseña personalizadas

A partir de la versión preliminar de SQL Server 2025 (17.x) en Linux, puede establecer los siguientes parámetros de configuración en el mssql.conf archivo para aplicar una directiva de contraseña personalizada.

Para más información, consulte la política de contraseña personalizada para inicios de sesión de SQL en SQL Server en Linux.

Configuración de comentarios del cliente

La configuración telemetry.customerfeedback cambia si SQL Server envía comentarios a Microsoft o no. De forma predeterminada, este valor se establece en true en todas las ediciones. Para cambiar el valor, ejecute los siguientes comandos:

1. Ejecute el script mssql-conf como raíz con el comando set para telemetry.customerfeedback. En el siguiente ejemplo se especifica false para desactivar los comentarios del cliente.

   sudo /opt/mssql/bin/mssql-conf set telemetry.customerfeedback false
   

2. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

Para obtener más información, consulte Configuración de la recopilación de datos de uso y diagnóstico para SQL Server en Linux y el complemento de privacidad de SQL Server.

Cambio de la ubicación predeterminada del directorio de registro o los datos

Las configuraciones filelocation.defaultdatadir y filelocation.defaultlogdir cambian la ubicación en la que se crean los archivos de registro y de base de datos. De forma predeterminada, la ubicación es /var/opt/mssql/data. Para cambiar estas configuraciones, siga estos pasos:

1. Cree el directorio de destino de los nuevos archivos de registro y datos de las bases de datos. En el ejemplo siguiente se crea un nuevo directorio /tmp/data:

   sudo mkdir /tmp/data
   

2. Cambie el propietario y el grupo del directorio al usuario mssql:

   sudo chown mssql /tmp/data
   sudo chgrp mssql /tmp/data
   

3. Use mssql-conf para cambiar el directorio de datos predeterminado con el comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdatadir /tmp/data
   

4. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

5. Ahora todos los archivos de base de datos de las nuevas bases de datos creadas se almacenan en esta nueva ubicación. Si quiere cambiar la ubicación de los archivos de registro (.ldf) de las nuevas bases de datos, puede usar el siguiente comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultlogdir /tmp/log
   

6. Este comando también supone que hay un directorio /tmp/log y que está en el usuario y grupo mssql.

Cambio de la ubicación del directorio de archivos de base de datos master predeterminado

Los valores filelocation.masterdatafile y filelocation.masterlogfile cambian la ubicación en la que el Motor de base de datos de SQL Server busca los archivos de base de datos master. De forma predeterminada, la ubicación es /var/opt/mssql/data.

Para cambiar estas configuraciones, siga estos pasos:

1. Cree el directorio de destino de los nuevos archivos de registro de errores. En el ejemplo siguiente se crea un nuevo directorio /tmp/masterdatabasedir:

   sudo mkdir /tmp/masterdatabasedir
   

2. Cambie el propietario y el grupo del directorio al usuario mssql:

   sudo chown mssql /tmp/masterdatabasedir
   sudo chgrp mssql /tmp/masterdatabasedir
   

3. Use mssql-conf para cambiar el directorio de base de datos master predeterminado de los archivos de datos y registro maestros con el comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.masterdatafile /tmp/masterdatabasedir/master.mdf
   sudo /opt/mssql/bin/mssql-conf set filelocation.masterlogfile /tmp/masterdatabasedir/mastlog.ldf
   

   Nota:

   Además de mover los archivos de registro y datos maestros, también mueve la ubicación predeterminada de todas las demás bases de datos del sistema.

4. Detenga el servicio SQL Server:

   sudo systemctl stop mssql-server
   

5. Mueva los archivos master.mdf y mastlog.ldf:

   sudo mv /var/opt/mssql/data/master.mdf /tmp/masterdatabasedir/master.mdf
   sudo mv /var/opt/mssql/data/mastlog.ldf /tmp/masterdatabasedir/mastlog.ldf
   

6. Inicie el servicio SQL Server:

   sudo systemctl start mssql-server
   

   Nota:

   Si SQL Server no encuentra los archivos master.mdf y mastlog.ldf en el directorio especificado, se crea automáticamente una copia con plantilla de las bases de datos del sistema en el directorio especificado y SQL Server se inicia correctamente. En cambio, los metadatos como las bases de datos de usuario, los inicios de sesión del servidor, los certificados del servidor, las claves de cifrado, los trabajos del Agente SQL o la contraseña de sa antigua no se actualizan en la nueva base de datos de master. Tendrá que detener SQL Server y mover los antiguos archivos master.mdf y mastlog.ldf a la nueva ubicación especificada e iniciar SQL Server para seguir usando los metadatos existentes.

Cambio del nombre de los archivos de base de datos master

Los valores filelocation.masterdatafile y filelocation.masterlogfile cambian la ubicación en la que el Motor de base de datos de SQL Server busca los archivos de base de datos master. También puede usarlos para cambiar el nombre de los archivos de registro y de base de datos master.

Para cambiar estas configuraciones, siga estos pasos:

1. Detenga el servicio SQL Server:

   sudo systemctl stop mssql-server
   

2. Use mssql-conf para cambiar los nombres esperados de la base de datos master de los archivos de registro y datos maestros de master con el comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.masterdatafile /var/opt/mssql/data/masternew.mdf
   sudo /opt/mssql/bin/mssql-conf set filelocation.mastlogfile /var/opt/mssql/data/mastlognew.ldf
   

   Importante

   Solo puede cambiar el nombre de los archivos de registro y de base de datos master después de que SQL Server se haya iniciado correctamente. Antes de la ejecución inicial, SQL Server espera que los archivos se denominen master.mdf y mastlog.ldf.

3. Cambio del nombre de los archivos de registro y datos de la base de datos master:

   sudo mv /var/opt/mssql/data/master.mdf /var/opt/mssql/data/masternew.mdf
   sudo mv /var/opt/mssql/data/mastlog.ldf /var/opt/mssql/data/mastlognew.ldf
   

4. Inicie el servicio SQL Server:

   sudo systemctl start mssql-server
   

Cambio de la ubicación predeterminada del directorio de volcado

El valor filelocation.defaultdumpdir cambia la ubicación predeterminada en la que se generan los volcados de memoria y SQL cuando se produce un bloqueo. De forma predeterminada, estos archivos se generan en /var/opt/mssql/log.

Para configurar esta nueva ubicación, use los comandos siguientes:

1. Cree el directorio de destino de los nuevos archivos de volcado. En el ejemplo siguiente se crea un nuevo directorio /tmp/dump:

   sudo mkdir /tmp/dump
   

2. Cambie el propietario y el grupo del directorio al usuario mssql:

   sudo chown mssql /tmp/dump
   sudo chgrp mssql /tmp/dump
   

3. Use mssql-conf para cambiar el directorio de datos predeterminado con el comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdumpdir /tmp/dump
   

4. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

Cambio de la ubicación predeterminada del directorio de los archivos de registro de errores

La configuración filelocation.errorlogfile cambia la ubicación en la que se crean los archivos de registro de errores, seguimiento del generador de perfiles predeterminado, XE de sesión de mantenimiento del sistema y XE de sesión de Hekaton. De forma predeterminada, la ubicación es /var/opt/mssql/log. El directorio en el que se establece el archivo de registro de errores de SQL Server se convierte en el directorio de registro predeterminado para otros registros.

Para cambiar esta configuración:

1. Cree el directorio de destino de los nuevos archivos de registro de errores. En el ejemplo siguiente se crea un nuevo directorio /tmp/logs:

   sudo mkdir /tmp/logs
   

2. Cambie el propietario y el grupo del directorio al usuario mssql:

   sudo chown mssql /tmp/logs
   sudo chgrp mssql /tmp/logs
   

3. Use mssql-conf para cambiar el nombre de archivo predeterminado del registro de errores con el comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.errorlogfile /tmp/logs/errorlog
   

4. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

La configuración errorlog.numerrorlogs permite especificar el número de registros de errores que se mantendrán antes de rotar el registro.

Cambio de la ubicación predeterminada del directorio de copia de seguridad

La configuración filelocation.defaultbackupdir cambia la ubicación predeterminada en la que se generan los archivos de copia de seguridad. De forma predeterminada, estos archivos se generan en /var/opt/mssql/data.

Para configurar esta nueva ubicación, use los comandos siguientes:

1. Cree el directorio de destino de los nuevos archivos de copia de seguridad. En el ejemplo siguiente se crea un nuevo directorio /tmp/backup:

   sudo mkdir /tmp/backup
   

2. Cambie el propietario y el grupo del directorio al usuario mssql:

   sudo chown mssql /tmp/backup
   sudo chgrp mssql /tmp/backup
   

3. Use mssql-conf para cambiar el directorio predeterminado de copia de seguridad con el comando set:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultbackupdir /tmp/backup
   

4. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

Especificación de la configuración de volcado principal

Si se produce una excepción o un bloqueo en uno de los procesos de SQL Server, este crea un volcado de memoria. La captura de un volcado de memoria puede tardar mucho tiempo y ocupar un espacio considerable. Para guardar los recursos y evitar volcados de memoria repetidos, puede deshabilitar la captura automática de volcados de memoria mediante la opción coredump.disablecoredump.

sudo /opt/mssql/bin/mssql-conf set coredump.disablecoredump <true or false>

Los usuarios todavía pueden generar volcados de memoria manualmente cuando el volcado de núcleo automático está deshabilitado (coredump.disablecoredump establecido en true).

Hay dos opciones para controlar el tipo de volcados de memoria que SQL Server recopila: coredump.coredumptype y coredump.captureminiandfull. Estas se relacionan con las dos fases de la captura de volcado principal.

La primera captura de fase se controla mediante la configuración coredump.coredumptype, que determina el tipo de archivo de volcado generado durante una excepción. La segunda fase se habilita con la configuración coredump.captureminiandfull. Si coredump.captureminiandfull se establece en verdadero, se genera el archivo de volcado especificado por coredump.coredumptype y también se genera un segundo minivolcado. Si se establece coredump.captureminiandfull en false, se deshabilita el segundo intento de captura.

1. Decida si se van a capturar volcados de memoria mini y completos con la configuración coredump.captureminiandfull.

   sudo /opt/mssql/bin/mssql-conf set coredump.captureminiandfull <true or false>
   

   Valor predeterminado: false

2. Especifique el tipo de archivo de volcado con la configuración coredump.coredumptype.

   sudo /opt/mssql/bin/mssql-conf set coredump.coredumptype <dump_type>
   

   Valor predeterminado: miniplus

   En la tabla siguiente, se ofrecen los posibles valores de coredump.coredumptype.

   Tipo	Descripción
   mini	Mini es el tipo de archivo de volcado más pequeño. Usa la información del sistema Linux para determinar los subprocesos y los módulos del proceso. El volcado solo contiene los módulos y las pilas de subprocesos del entorno del host. No contiene referencias de memoria indirectas ni elementos globales.
   miniplus	MiniPlus es similar a mini, pero incluye memoria adicional. Comprende los aspectos internos de SQLPAL y el entorno de host, y agrega las siguientes regiones de memoria al volcado: - Varias globales - Toda la memoria superior a 64 TB - Todas las regiones con nombre encontradas en /proc/$pid/maps - Memoria indirecta de los subprocesos y las pilas - Información de subprocesos, incluidos bloques de entorno de subprocesos asociados (TEB) y bloques de entorno de procesos (PEB) - Información del módulo - Árbol de VAD y VMM
   filtered	Filtered usa un diseño basado en la resta en el que se incluye toda la memoria del proceso a menos que se excluya específicamente. El diseño comprende los aspectos internos de SQLPAL y el entorno de host, y excluye determinadas regiones del volcado.
   full	El volcado de proceso completo incluye todas las regiones que están en /proc/$pid/maps. No se controla mediante la configuración coredump.captureminiandfull.

Edición

La edición de SQL Server se puede cambiar mediante la opción set-edition. Para cambiar la edición de SQL Server, primero se debe detener el servicio SQL Server. Para obtener más información sobre las ediciones disponibles de SQL Server en Linux, consulte Ediciones de SQL Server.

Alta disponibilidad

La opción hadr.hadrenabled habilita los grupos de disponibilidad en la instancia de SQL Server. El siguiente comando habilita los grupos de disponibilidad al establecer hadr.hadrenabled en 1. Debe reiniciar SQL Server para que la configuración surta efecto.

sudo /opt/mssql/bin/mssql-conf set hadr.hadrenabled  1
sudo systemctl restart mssql-server

Para información sobre cómo se usa con los grupos de disponibilidad, consulte los dos artículos siguientes.

• Configuración de un grupo de disponibilidad AlwaysOn de SQL Server para alta disponibilidad en Linux
• Configuración de un grupo de disponibilidad de SQL Server para escalado de lectura en Linux

Establecimiento del directorio de auditoría local

La configuración telemetry.userrequestedlocalauditdirectory habilita la auditoría local y le permite establecer el directorio en el que se crean los registros de auditoría local.

1. Cree un directorio de destino para los nuevos registros de Auditoría local. En el ejemplo siguiente se crea un nuevo directorio /tmp/audit:

   sudo mkdir /tmp/audit
   

2. Cambie el propietario y el grupo del directorio al usuario mssql:

   sudo chown mssql /tmp/audit
   sudo chgrp mssql /tmp/audit
   

3. Ejecute el script mssql-conf como raíz con el comando set para telemetry.userrequestedlocalauditdirectory:

   sudo /opt/mssql/bin/mssql-conf set telemetry.userrequestedlocalauditdirectory /tmp/audit
   

4. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

Para obtener más información, consulte Configuración de la recopilación de datos de uso y diagnóstico para SQL Server en Linux.

Cambio de la configuración regional de SQL Server

La configuración language.lcid cambia la configuración regional de SQL Server por cualquier identificador de lenguaje (LCID) admitido.

1. En el ejemplo siguiente se cambia la localidad a francés (1036):

   sudo /opt/mssql/bin/mssql-conf set language.lcid 1036
   

2. Reinicie el servicio SQL Server para aplicar los cambios:

   sudo systemctl restart mssql-server
   

Establecimiento del límite de memoria

El valor memory.memorylimitmb controla la cantidad de memoria física (en MB) disponible para SQL Server. El valor predeterminado es el 80 % de la memoria física, para evitar las condiciones de memoria insuficiente (OOM).

1. Ejecute el script mssql-conf como raíz con el comando set para memory.memorylimitmb. En el ejemplo siguiente se cambia la memoria disponible para SQL Server a 3,25 GB (3328 MB).

   sudo /opt/mssql/bin/mssql-conf set memory.memorylimitmb 3328
   

2. Reinicie el servicio SQL Server para aplicar los cambios:

   sudo systemctl restart mssql-server
   

Configuración de memoria adicional

Las opciones siguientes están disponibles para la configuración de memoria.

Configuración de MSDTC

Los valores network.rpcport y distributedtransaction.servertcpport se usan para configurar el Coordinador de transacciones distribuidas de Microsoft (MSDTC). Para cambiar estas configuraciones, ejecute los siguientes comandos:

1. Ejecute el script mssql-conf como raíz con el comando set para network.rpcport:

   sudo /opt/mssql/bin/mssql-conf set network.rpcport <rcp_port>
   

2. A continuación, establezca el valor distributedtransaction.servertcpport:

   sudo /opt/mssql/bin/mssql-conf set distributedtransaction.servertcpport <servertcpport_port>
   

Además de establecer estos valores, también debe configurar el enrutamiento y actualizar el firewall para el puerto 135. Para obtener más información sobre cómo hacerlo, vea Procedimiento para configurar Microsoft DTC (Coordinador de transacciones distribuidas) en Linux.

Hay algunos otros valores de mssql-conf que puede usar para supervisar y solucionar problemas de MSDTC. En la siguiente tabla se describen brevemente estas configuraciones. Para obtener más información sobre su uso, consulte los detalles en el artículo de soporte técnico de Windows Habilitar el seguimiento de diagnóstico para MS DTC en un ordenador Windows 10.

# For all packages: database engine and mlservices
# Setup prompts for mlservices EULAs, which you need to accept
sudo /opt/mssql/bin/mssql-conf setup

# Add R or Python to an existing installation
sudo /opt/mssql/bin/mssql-conf setup accept-eula-ml

# Alternative valid syntax
# Adds the EULA section to the INI and sets acceptulam to yes
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y

# Rescind EULA acceptance and removes the setting
sudo /opt/mssql/bin/mssql-conf unset EULA accepteulaml

[EULA]
accepteula = Y
accepteulaml = Y

# Adds the extensibility section and property.
# Sets "outboundnetworkaccess" to true.
# This setting is required if you want to access data or operations off the server.
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1

# Turns off network access but preserves the setting
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 0

# Removes the setting and rescinds network access
sudo /opt/mssql/bin/mssql-conf unset extensibility.outboundnetworkaccess

[extensibility]
outboundnetworkaccess = 1

Cambie el nivel de registro del Conector de SQL Server para Azure Key Vault

En SQL Server 2022 (16.x) CU 14 y versiones posteriores, SQL Server en Linux admite la administración extensible de claves de TDE con Azure Key Vault. Puede establecer el nivel de registro en uno de los siguientes valores:

Para cambiar el nivel de registro del Conector de SQL Server, use el ejemplo siguiente:

sudo /opt/mssql/bin/mssql-conf set sqlconnector.logginglevel 1

Para obtener más información, consulte Use SQL Server Connector with SQL Encryption Features(Usar el conector de SQL Server con características de cifrado de SQL).

Cambio del puerto TCP

La configuración network.tcpport cambia el puerto TCP en el que SQL Server escucha las conexiones. De forma predeterminada, este puerto se establece en el 1433. Para cambiar el puerto, ejecute los siguientes comandos:

1. Ejecute el script mssql-conf como raíz con el comando set para network.tcpport:

   sudo /opt/mssql/bin/mssql-conf set network.tcpport <new_tcp_port>
   

2. Reinicie el servicio SQL Server:

   sudo systemctl restart mssql-server
   

3. Al conectarse ahora a SQL Server, debe especificar el puerto personalizado con una coma (,) después del nombre de host o la dirección IP. Por ejemplo, para conectarse con sqlcmd, usaría el siguiente comando:

   sqlcmd -S localhost,<new_tcp_port> -U test -P test
   

Especificación de la configuración de TLS

Las opciones siguientes configuran TLS para una instancia de SQL Server que se ejecuta en Linux.

Para obtener un ejemplo del uso de la configuración de TLS, consulte Cifrar conexiones a SQL Server en Linux.

Configuración de red

Ver Tutorial: Uso de la autenticación de Active Directory con SQL Server en Linux para obtener información completa sobre el uso de la autenticación de Active Directory con SQL Server en Linux.

Las siguientes opciones son configuraciones de red adicionales que se pueden configurar mediante mssql-conf.

Habilitación o deshabilitación de las marcas de seguimiento

La opción traceflag habilita o deshabilita las marcas de seguimiento del inicio del servicio SQL Server. Para habilitar o deshabilitar una marca de seguimiento, use los siguientes comandos:

1. Habilite una marca de seguimiento con el siguiente comando. Por ejemplo, para el indicador de traza 1234:

   sudo /opt/mssql/bin/mssql-conf traceflag 1234 on
   

2. Puede habilitar varias marcas de seguimiento si las especifica por separado:

   sudo /opt/mssql/bin/mssql-conf traceflag 2345 3456 on
   

3. De forma similar, puede deshabilitar una o varias marcas de seguimiento habilitadas si las especifica y agrega el parámetro off:

   sudo /opt/mssql/bin/mssql-conf traceflag 1234 2345 3456 off
   

4. Reinicie el servicio SQL Server para aplicar los cambios:

   sudo systemctl restart mssql-server
   

Eliminación de una configuración

Para anular cualquier configuración que haya hecho con mssql-conf set, llame a mssql-conf con la opción unset y el nombre de la configuración. De esta forma, se borra la configuración y se devuelve a su valor predeterminado.

1. En el siguiente ejemplo se borra la opción network.tcpport.

   sudo /opt/mssql/bin/mssql-conf unset network.tcpport
   

2. Reinicie el servicio SQL Server.

   sudo systemctl restart mssql-server
   

Visualización de la configuración actual

Para ver todas las opciones configuradas, ejecute el siguiente comando para generar el contenido del archivo mssql.conf:

sudo cat /var/opt/mssql/mssql.conf

Cualquier configuración que no se muestre en este archivo usa sus valores predeterminados. En la sección siguiente se proporciona un archivo mssql.conf de ejemplo.

Ver varias opciones

Para ver las distintas opciones que se pueden configurar mediante la utilidad mssql-conf, ejecute el comando help:

sudo /opt/mssql/bin/mssql-conf --help

Los resultados proporcionan varias opciones de configuración y una breve descripción para cada una de las opciones.

Formato de mssql.conf

El siguiente archivo /var/opt/mssql/mssql.conf proporciona un ejemplo de cada valor. Puede usar este formato para realizar cambios manualmente en el archivo mssql.conf según sea necesario. Si cambia el archivo manualmente, debe reiniciar SQL Server antes de que se apliquen los cambios. Para usar el archivo mssql.conf con Docker, debe hacer que Docker conserve sus datos. En primer lugar, agregue un archivo mssql.conf completo al directorio de host y después ejecute el contenedor. Hay un ejemplo de esto en Configuración de la recopilación de datos de uso y diagnóstico para SQL Server en Linux.

[EULA]
accepteula = Y

[coredump]
captureminiandfull = true
coredumptype = full

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

[hadr]
hadrenabled = 0

[language]
lcid = 1033

[memory]
memorylimitmb = 4096

[network]
forceencryption = 0
ipaddress = 10.192.0.0
kerberoskeytabfile = /var/opt/mssql/secrets/mssql.keytab
tcpport = 1401
tlscert = /etc/ssl/certs/mssql.pem
tlsciphers = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
tlskey = /etc/ssl/private/mssql.key
tlsprotocols = 1.2,1.1,1.0

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

[telemetry]
customerfeedback = true
userrequestedlocalauditdirectory = /tmp/audit

[traceflag]
traceflag0 = 1204
traceflag1 = 2345
traceflag = 3456

[EULA]
accepteula = Y
accepteulaml = Y

[coredump]
captureminiandfull = true
coredumptype = full

[distributedtransaction]
servertcpport = 51999

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

[hadr]
hadrenabled = 0

[language]
lcid = 1033

[memory]
memorylimitmb = 4096

[network]
forceencryption = 0
ipaddress = 10.192.0.0
kerberoskeytabfile = /var/opt/mssql/secrets/mssql.keytab
rpcport = 13500
tcpport = 1401
tlscert = /etc/ssl/certs/mssql.pem
tlsciphers = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
tlskey = /etc/ssl/private/mssql.key
tlsprotocols = 1.2,1.1,1.0

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

[telemetry]
customerfeedback = true
userrequestedlocalauditdirectory = /tmp/audit

[traceflag]
traceflag0 = 1204
traceflag1 = 2345
traceflag = 3456

Contenido relacionado

• Configuración de opciones de SQL Server con variables de entorno en Linux
• Seleccione la herramienta adecuada para administrar SQL Server en Linux
• Configuración y personalización de contenedores de Linux de SQL Server

Contribuya a la documentación de SQL

¿Sabía que puede editar el contenido de SQL usted mismo? Si lo hace, no solo contribuirá a mejorar la documentación, sino que también se le reconocerá como colaborador de la página.

Para obtener más información, consulte Editar documentación de Microsoft Learn.