Configuración de SQL Server en Linux con la herramienta mssql-confConfigure SQL Server on Linux with the mssql-conf tool

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) : LinuxSe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) - Linux

mssql-conf es un script de configuración que se instala con SQL Server 2017 para Red Hat Enterprise Linux, SUSE Linux Enterprise Server y Ubuntu.mssql-conf is a configuration script that installs with SQL Server 2017 for Red Hat Enterprise Linux, SUSE Linux Enterprise Server, and Ubuntu. Modifica el archivo mssql.conf donde se almacenan los valores de configuración.It modifies the mssql.conf file where configuration values are stored. Puede usar la utilidad mssql-conf para establecer los parámetros siguientes:You can use mssql-conf utility to set the following parameters:

ParámetroParameter DescripciónDescription
AgentAgent Habilite el Agente SQL Server.Enable SQL Server Agent.
IntercalaciónCollation Establezca una nueva intercalación para SQL Server en Linux.Set a new collation for SQL Server on Linux.
Comentarios del clienteCustomer feedback Elija si SQL Server envía comentarios a Microsoft o no.Choose whether or not SQL Server sends feedback to Microsoft.
Perfil de Correo electrónico de base de datosDatabase Mail Profile Establezca el perfil de correo electrónico de base de datos predeterminado para SQL Server en Linux.Set the default database mail profile for SQL Server on Linux.
Directorio de datos predeterminadoDefault data directory Cambie el directorio predeterminado de los nuevos archivos de datos de la base de datos de SQL Server (.mdf).Change the default directory for new SQL Server database data files (.mdf).
Directorio de registro predeterminadoDefault log directory Cambie el directorio predeterminado de los nuevos archivos de registro de la base de datos de SQL Server (.ldf).Changes the default directory for new SQL Server database log (.ldf) files.
Directorio de base de datos maestra predeterminadoDefault master database directory Cambie el directorio predeterminado de la base de datos maestra y los archivos de registro.Changes the default directory for the master database and log files.
Nombre de archivo de base de datos maestra predeterminadoDefault master database file name Cambie el nombre de los archivos de base de datos maestra.Changes the name of master database files.
Directorio de volcado predeterminadoDefault dump directory Cambie el directorio predeterminado de los nuevos volcados de memoria y otros archivos de solución de problemas.Change the default directory for new memory dumps and other troubleshooting files.
Directorio de registro de errores predeterminadoDefault error log directory Cambie el directorio predeterminado de los nuevos 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 SQL Server.Changes the default directory for new SQL Server ErrorLog, Default Profiler Trace, System Health Session XE, and Hekaton Session XE files.
Directorio de copia de seguridad predeterminadoDefault backup directory Cambie el directorio predeterminado de los nuevos archivos de copia de seguridad.Change the default directory for new backup files.
Tipo de volcadoDump type Elija el tipo de archivo de volcado de memoria que se va a recopilar.Choose the type of dump memory dump file to collect.
Alta disponibilidadHigh availability Habilite los grupos de disponibilidad.Enable Availability Groups.
Directorio de auditoría localLocal Audit directory Establezca un directorio para agregar los archivos de la auditoría local.Set a directory to add Local Audit files.
Configuración regionalLocale Establezca la configuración regional de SQL Server que se va a usar.Set the locale for SQL Server to use.
Límite de memoriaMemory limit Establezca el límite de memoria de SQL Server.Set the memory limit for SQL Server.
Configuración de redNetwork settings Configuración de red adicional para SQL Server.Additional network settings for SQL Server.
Microsoft DTC (Coordinador de transacciones distribuidas)Microsoft Distributed Transaction Coordinator Configure y solucione problemas de MSDTC en Linux.Configure and troubleshoot MSDTC on Linux.
Puerto TCPTCP port Cambie el puerto en el que SQL Server escucha las conexiones.Change the port where SQL Server listens for connections.
TLSTLS Configure la seguridad de nivel de transporte.Configure Transport Level Security.
Marcas de seguimientoTraceflags Establezca las marcas de seguimiento que va a usar el servicio.Set the traceflags that the service is going to use.

mssql-conf es un script de configuración que se instala con SQL Server 2019 (15.x)SQL Server 2019 (15.x) para Red Hat Enterprise Linux, SUSE Linux Enterprise Server y Ubuntu.mssql-conf is a configuration script that installs with SQL Server 2019 (15.x)SQL Server 2019 (15.x) for Red Hat Enterprise Linux, SUSE Linux Enterprise Server, and Ubuntu. Puede usar esta utilidad para establecer los siguientes parámetros:You can use this utility to set the following parameters:

ParámetroParameter DescripciónDescription
AgentAgent Habilitar el Agente SQL ServerEnable SQL Server Agent
IntercalaciónCollation Establezca una nueva intercalación para SQL Server en Linux.Set a new collation for SQL Server on Linux.
Comentarios del clienteCustomer feedback Elija si SQL Server envía comentarios a Microsoft o no.Choose whether or not SQL Server sends feedback to Microsoft.
Perfil de Correo electrónico de base de datosDatabase Mail Profile Establezca el perfil de correo electrónico de base de datos predeterminado para SQL Server en Linux.Set the default database mail profile for SQL Server on Linux.
Directorio de datos predeterminadoDefault data directory Cambie el directorio predeterminado de los nuevos archivos de datos de la base de datos de SQL Server (.mdf).Change the default directory for new SQL Server database data files (.mdf).
Directorio de registro predeterminadoDefault log directory Cambie el directorio predeterminado de los nuevos archivos de registro de la base de datos de SQL Server (.ldf).Changes the default directory for new SQL Server database log (.ldf) files.
Directorio de archivos de base de datos maestra predeterminadoDefault master database file directory Cambie el directorio predeterminado de los archivos de base de datos maestra en la instalación existente de SQL.Changes the default directory for the master database files on existing SQL installation.
Nombre de archivo de base de datos maestra predeterminadoDefault master database file name Cambie el nombre de los archivos de base de datos maestra.Changes the name of master database files.
Directorio de volcado predeterminadoDefault dump directory Cambie el directorio predeterminado de los nuevos volcados de memoria y otros archivos de solución de problemas.Change the default directory for new memory dumps and other troubleshooting files.
Directorio de registro de errores predeterminadoDefault error log directory Cambie el directorio predeterminado de los nuevos 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 SQL Server.Changes the default directory for new SQL Server ErrorLog, Default Profiler Trace, System Health Session XE, and Hekaton Session XE files.
Directorio de copia de seguridad predeterminadoDefault backup directory Cambie el directorio predeterminado de los nuevos archivos de copia de seguridad.Change the default directory for new backup files.
Tipo de volcadoDump type Elija el tipo de archivo de volcado de memoria que se va a recopilar.Choose the type of dump memory dump file to collect.
Alta disponibilidadHigh availability Habilite los grupos de disponibilidad.Enable Availability Groups.
Directorio de auditoría localLocal Audit directory Establezca un directorio para agregar los archivos de la auditoría local.Set a directory to add Local Audit files.
Configuración regionalLocale Establezca la configuración regional de SQL Server que se va a usar.Set the locale for SQL Server to use.
Límite de memoriaMemory limit Establezca el límite de memoria de SQL Server.Set the memory limit for SQL Server.
Microsoft DTC (Coordinador de transacciones distribuidas)Microsoft Distributed Transaction Coordinator Configure y solucione problemas de MSDTC en Linux.Configure and troubleshoot MSDTC on Linux.
CLUF de MLServicesMLServices EULAs Acepte los CLUF de R y Python de los paquetes de mlservices.Accept R and Python EULAs for mlservices packages. Solo se aplica a SQL Server 2019.Applies to SQL Server 2019 only.
Configuración de redNetwork settings Configuración de red adicional para SQL Server.Additional network settings for SQL Server.
outboundnetworkaccessoutboundnetworkaccess Habilite el acceso de red saliente para las extensiones de R, Python y Java de mlservices.Enable outbound network access for mlservices R, Python, and Java extensions.
Puerto TCPTCP port Cambie el puerto en el que SQL Server escucha las conexiones.Change the port where SQL Server listens for connections.
TLSTLS Configure la seguridad de nivel de transporte.Configure Transport Level Security.
Marcas de seguimientoTraceflags Establezca las marcas de seguimiento que va a usar el servicio.Set the traceflags that the service is going to use.

Sugerencia

Algunos de estos valores también se pueden configurar con variables de entorno.Some of these settings can also be configured with environment variables. Para obtener más información, consulte Configuración de opciones de SQL Server con variables de entorno.For more information, see Configure SQL Server settings with environment variables.

Consejos de usoUsage tips

  • 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.For Always On Availability Groups and shared disk clusters, always make the same configuration changes on each node.

  • En el caso del escenario de clúster de disco compartido, no intente reiniciar el servicio mssql-server para aplicar los cambios.For the shared disk cluster scenario, do not attempt to restart the mssql-server service to apply changes. SQL Server se ejecuta como una aplicación.SQL Server is running as an application. En su lugar, desconecte el recurso y vuelva a conectarlo.Instead, take the resource offline and then back online.

  • En estos ejemplos se ejecuta mssql-conf al especificar la ruta de acceso completa: /opt/mssql/bin/mssql-conf.These examples run mssql-conf by specifying the full path: /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.If you choose to navigate to that path instead, run mssql-conf in the context of the current directory: ./mssql-conf.

Habilitación del Agente SQL ServerEnable SQL Server Agent

La configuración sqlagent.enabled habilita el Agente SQL Server.The sqlagent.enabled setting enables SQL Server Agent. De forma predeterminada, el Agente SQL Server está deshabilitado.By default, SQL Server Agent is disabled. 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.If sqlagent.enabled is not present in the mssql.conf settings file, then SQL Server internally assumes that SQL Server Agent is disabled.

Para cambiar esta configuración, siga estos pasos:To change this setting, use the following steps:

  1. Habilite el Agente SQL Server:Enable the SQL Server Agent:

    sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true 
    
  2. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Establecimiento del perfil de correo electrónico de base de datos predeterminado para SQL Server en LinuxSet the default database mail profile for SQL Server on Linux

sqlpagent.databasemailprofile le permite establecer el perfil de correo electrónico de base de datos predeterminado de las alertas por correo electrónico.The sqlpagent.databasemailprofile allows you to set the default DB Mail profile for email alerts.

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

Registros de errores del Agente SQLSQL Agent error logs

La configuración sqlpagent.errorlogfile y sqlpagent.errorlogginglevel permite establecer el nivel de registro y la ruta del archivo de registro del Agente SQL, respectivamente.The sqlpagent.errorlogfile and sqlpagent.errorlogginglevel settings allows you to set the SQL Agent log file path and logging level respectively.

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

Los niveles de registro del Agente SQL son valores de máscara de bits con las siguientes equivalencias:SQL Agent logging levels are bitmask values that equal:

  • 1 = errores1 = Errors
  • 2 = advertencias2 = Warnings
  • 4 = información4 = Info

Si desea capturar todos los niveles, utilice 7 como valor.If you want to capture all levels, use 7 as the value.

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

Cambio de la intercalación de SQL ServerChange the SQL Server collation

La opción set-collation cambia el valor de intercalación por cualquiera de las intercalaciones admitidas.The set-collation option changes the collation value to any of the supported collations.

  1. En primer lugar, realice una copia de seguridad de todas las bases de datos de usuario del servidor.First backup any user databases on your server.

  2. Después, use el procedimiento almacenado sp_detach_db para desasociar las bases de datos de usuario.Then use the sp_detach_db stored procedure to detach the user databases.

  3. Ejecute la opción set-collation y siga las indicaciones:Run the set-collation option and follow the prompts:

    sudo /opt/mssql/bin/mssql-conf set-collation
    
  4. La utilidad mssql-conf intentará cambiar al valor de intercalación especificado y reiniciar el servicio.The mssql-conf utility will attempt to change to the specified collation value and restart the service. Si hay algún error, revierte la intercalación al valor anterior.If there are any errors, it rolls back the collation to the previous value.

  5. Restaure las copias de seguridad de las bases de datos de usuario.Restore your user database backups.

Para obtener una lista de las intercalaciones admitidas, ejecute la función sys.fn_helpcollations: SELECT Name from sys.fn_helpcollations().For a list of supported collations, run the sys.fn_helpcollations function: SELECT Name from sys.fn_helpcollations().

Configuración de comentarios del clienteConfigure customer feedback

La configuración telemetry.customerfeedback cambia si SQL Server envía comentarios a Microsoft o no.The telemetry.customerfeedback setting changes whether SQL Server sends feedback to Microsoft or not. De forma predeterminada, este valor se establece en true en todas las ediciones.By default, this value is set to true for all editions. Para cambiar el valor, ejecute los siguientes comandos:To change the value, run the following commands:

Importante

No puede desactivar los comentarios del cliente en las ediciones gratuitas de SQL Server, Express y Developer.You can not turn off customer feedback for free editions of SQL Server, Express and Developer.

  1. Ejecute el script mssql-conf como raíz con el comando set para telemetry.customerfeedback.Run the mssql-conf script as root with the set command for telemetry.customerfeedback. En el siguiente ejemplo se especifica false para desactivar los comentarios del cliente.The following example turns off customer feedback by specifying false.

    sudo /opt/mssql/bin/mssql-conf set telemetry.customerfeedback false
    
  2. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Para obtener más información, vea Comentarios del cliente para SQL Server en Linux y la Declaración de privacidad de SQL Server.For more information, see Customer Feedback for SQL Server on Linux and the SQL Server Privacy Statement.

Cambio de la ubicación predeterminada del directorio de registro o los datosChange the default data or log directory location

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.The filelocation.defaultdatadir and filelocation.defaultlogdir settings change the location where the new database and log files are created. De forma predeterminada, esta ubicación es /var/opt/mssql/data.By default, this location is /var/opt/mssql/data. Para cambiar estas configuraciones, siga estos pasos:To change these settings, use the following steps:

  1. Cree el directorio de destino de los nuevos archivos de registro y datos de las bases de datos.Create the target directory for new database data and log files. En el ejemplo siguiente se crea un directorio /tmp/data:The following example creates a new /tmp/data directory:

    sudo mkdir /tmp/data
    
  2. Cambie el propietario y el grupo del directorio al usuario mssql:Change the owner and group of the directory to the mssql user:

    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:Use mssql-conf to change the default data directory with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdatadir /tmp/data
    
  4. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    
  5. Ahora todos los archivos de base de datos de las nuevas bases de datos creadas se almacenarán en esta nueva ubicación.Now all the database files for the new databases created will be stored in this new location. Si quiere cambiar la ubicación de los archivos de registro (.ldf) de las nuevas bases de datos, puede usar el siguiente comando "set":If you would like to change the location of the log (.ldf) files of the new databases, you can use the following "set" command:

    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.This command also assumes that a /tmp/log directory exists, and that it is under the user and group mssql.

Cambio de la ubicación del directorio de archivos de base de datos maestra predeterminadoChange the default master database file directory location

Las configuraciones filelocation.masterdatafile y filelocation.masterlogfile cambian la ubicación en la que el motor de SQL Server busca los archivos de base de datos maestra.The filelocation.masterdatafile and filelocation.masterlogfile setting changes the location where the SQL Server engine looks for the master database files. De forma predeterminada, esta ubicación es /var/opt/mssql/data.By default, this location is /var/opt/mssql/data.

Para cambiar estas configuraciones, siga estos pasos:To change these settings, use the following steps:

  1. Cree el directorio de destino de los nuevos archivos de registro de errores.Create the target directory for new error log files. En el ejemplo siguiente se crea un directorio /tmp/masterdatabasedir:The following example creates a new /tmp/masterdatabasedir directory:

    sudo mkdir /tmp/masterdatabasedir
    
  2. Cambie el propietario y el grupo del directorio al usuario mssql:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/masterdatabasedir
    sudo chgrp mssql /tmp/masterdatabasedir
    
  3. Use mssql-conf para cambiar el directorio de base de datos maestra predeterminado de los archivos de registro y datos maestros con el comando set:Use mssql-conf to change the default master database directory for the master data and log files with the set command:

    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.In addition to moving the master data and log files, this also moves the default location for all other system databases.

  4. Detenga el servicio SQL Server:Stop the SQL Server service:

    sudo systemctl stop mssql-server
    
  5. Mueva los archivos master.mdf y masterlog.ldf:Move the master.mdf and masterlog.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:Start the SQL Server service:

    sudo systemctl start mssql-server
    

    Nota

    Si SQL Server no encuentra los archivos master.mdf y mastlog.ldf en el directorio especificado, se creará automáticamente una copia con plantilla de las bases de datos del sistema en el directorio especificado y SQL Server se iniciará correctamente.If SQL Server cannot find master.mdf and mastlog.ldf files in the specified directory, a templated copy of the system databases will be automatically created in the specified directory, and SQL Server will successfully start up. 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 inicio de sesión de SA antigua no se actualizarán en la nueva base de datos maestra.However, metadata such as user databases, server logins, server certificates, encryption keys, SQL agent jobs, or old SA login password will not be updated in the new master database. 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.You will have to stop SQL Server and move your old master.mdf and mastlog.ldf to the new specified location and start SQL Server to continue using the existing metadata.

Cambio del nombre de los archivos de base de datos maestraChange the name of master database files

Las configuraciones filelocation.masterdatafile y filelocation.masterlogfile cambian la ubicación en la que el motor de SQL Server busca los archivos de base de datos maestra.The filelocation.masterdatafile and filelocation.masterlogfile setting changes the location where the SQL Server engine looks for the master database files. También puede usarlas para cambiar el nombre de los archivos de registro y de base de datos maestra.You can also use this to change the name of the master database and log files.

Para cambiar estas configuraciones, siga estos pasos:To change these settings, use the following steps:

  1. Detenga el servicio SQL Server:Stop the SQL Server service:

    sudo systemctl stop mssql-server
    
  2. Use mssql-conf para cambiar los nombres esperados de la base de datos maestra de los archivos de registro y datos maestros con el comando set:Use mssql-conf to change the expected master database names for the master data and log files with the set command:

    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 maestra después de que SQL Server se haya iniciado correctamente.You can only change the name of the master database and log files after SQL Server has started successfully. Antes de la ejecución inicial, SQL Server espera que los archivos se denominen master.mdf y mastlog.ldf.Before the initial run, SQL Server expects the files to be named master.mdf and mastlog.ldf.

  3. Cambio del nombre de los archivos de registro y datos de la base de datos maestraChange the name of the master database data and log files

    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:Start the SQL Server service:

    sudo systemctl start mssql-server
    

Cambio de la ubicación predeterminada del directorio de volcadoChange the default dump directory location

La configuración filelocation.defaultdumpdir cambia la ubicación predeterminada en la que se generan los volcados de memoria y SQL cuando se produce un bloqueo.The filelocation.defaultdumpdir setting changes the default location where the memory and SQL dumps are generated whenever there is a crash. De forma predeterminada, estos archivos se generan en /var/opt/mssql/log.By default, these files are generated in /var/opt/mssql/log.

Para configurar esta nueva ubicación, use los comandos siguientes:To set up this new location, use the following commands:

  1. Cree el directorio de destino de los nuevos archivos de volcado.Create the target directory for new dump files. En el ejemplo siguiente se crea un directorio /tmp/dump:The following example creates a new /tmp/dump directory:

    sudo mkdir /tmp/dump
    
  2. Cambie el propietario y el grupo del directorio al usuario mssql:Change the owner and group of the directory to the mssql user:

    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:Use mssql-conf to change the default data directory with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdumpdir /tmp/dump
    
  4. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Cambio de la ubicación predeterminada del directorio de los archivos de registro de erroresChange the default error log file directory location

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.The filelocation.errorlogfile setting changes the location where the new error log, default profiler trace, system health session XE and Hekaton session XE files are created. De forma predeterminada, esta ubicación es /var/opt/mssql/log.By default, this location is /var/opt/mssql/log. El directorio en el que se establece el archivo de registro de errores de SQL se convierte en el directorio de registro predeterminado para otros registros.The directory in which SQL errorlog file is set becomes the default log directory for other logs.

Para cambiar esta configuración:To change these settings:

  1. Cree el directorio de destino de los nuevos archivos de registro de errores.Create the target directory for new error log files. En el ejemplo siguiente se crea un directorio /tmp/logs:The following example creates a new /tmp/logs directory:

    sudo mkdir /tmp/logs
    
  2. Cambie el propietario y el grupo del directorio al usuario mssql:Change the owner and group of the directory to the mssql user:

    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:Use mssql-conf to change the default errorlog filename with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.errorlogfile /tmp/logs/errorlog
    
  4. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

La configuración errorlog.numerrorlogs permitirá especificar el número de registros de errores mantenidos antes de recorrer el registro.The errorlog.numerrorlogs setting will allow you to specify the number of error logs maintained before cycling the log.

Cambio de la ubicación predeterminada del directorio de copia de seguridadChange the default backup directory location

La configuración filelocation.defaultbackupdir cambia la ubicación predeterminada en la que se generan los archivos de copia de seguridad.The filelocation.defaultbackupdir setting changes the default location where the backup files are generated. De forma predeterminada, estos archivos se generan en /var/opt/mssql/data.By default, these files are generated in /var/opt/mssql/data.

Para configurar esta nueva ubicación, use los comandos siguientes:To set up this new location, use the following commands:

  1. Cree el directorio de destino de los nuevos archivos de copia de seguridad.Create the target directory for new backup files. En el ejemplo siguiente se crea un directorio /tmp/backup:The following example creates a new /tmp/backup directory:

    sudo mkdir /tmp/backup
    
  2. Cambie el propietario y el grupo del directorio al usuario mssql:Change the owner and group of the directory to the mssql user:

    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”:Use mssql-conf to change the default backup directory with the "set" command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultbackupdir /tmp/backup
    
  4. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Especificación de la configuración de volcado principalSpecify core dump settings

Si se produce una excepción en uno de los procesos de SQL Server, este crea un volcado de memoria.If an exception occurs in one of the SQL Server processes, SQL Server creates a memory dump.

Hay dos opciones para controlar el tipo de los volcados de memoria que SQL Server recopila: coredump.coredumptype y coredump.captureminiandfull.There are two options for controlling the type of memory dumps that SQL Server collects: coredump.coredumptype and coredump.captureminiandfull. Estas se relacionan con las dos fases de la captura de volcado principal.These relate to the two phases of core dump capture.

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.The first phase capture is controlled by the coredump.coredumptype setting, which determines the type of dump file generated during an exception. La segunda fase se habilita con la configuración coredump.captureminiandfull.The second phase is enabled when the coredump.captureminiandfull setting. Si coredump.captureminiandfull se establece en true, se genera el archivo de volcado especificado por coredump.coredumptype y también se genera un segundo minivolcado.If coredump.captureminiandfull is set to true, the dump file specified by coredump.coredumptype is generated and a second mini dump is also generated. Si se establece coredump.captureminiandfull en false, se deshabilita el segundo intento de captura.Setting coredump.captureminiandfull to false disables the second capture attempt.

  1. Decida si quiere capturar los minivolcados y los volcados completos con la configuración coredump.captureminiandfull.Decide whether to capture both mini and full dumps with the coredump.captureminiandfull setting.

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

    Valor predeterminado: false.Default: false

  2. Especifique el tipo de archivo de volcado de la configuración coredump.coredumptype.Specify the type of dump file with the coredump.coredumptype setting.

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

    Valor predeterminado: miniplus.Default: miniplus

    En la siguiente tabla se muestran los posibles valores de coredump.coredumptype.The following table lists the possible coredump.coredumptype values.

    TipoType DescripciónDescription
    minimini Mini es el tipo de archivo de volcado más pequeño.Mini is the smallest dump file type. Usa la información del sistema Linux para determinar los subprocesos y los módulos del proceso.It uses the Linux system information to determine threads and modules in the process. El volcado solo contiene los módulos y las pilas de subprocesos del entorno del host.The dump contains only the host environment thread stacks and modules. No contiene referencias de memoria indirectas ni globales.It does not contain indirect memory references or globals.
    miniplusminiplus MiniPlus es similar a mini, pero incluye memoria adicional.MiniPlus is similar to mini, but it includes additional memory. Comprende los aspectos internos de SQLPAL y el entorno de host, y agrega las siguientes regiones de memoria al volcado:It understands the internals of SQLPAL and the host environment, adding the following memory regions to the dump:
    - Varias globales- Various globals
    - Toda la memoria superior a 64 TB- All memory above 64TB
    - Todas las regiones con nombre que están en /proc/$pid/maps- All named regions found in /proc/$pid/maps
    - Memoria indirecta de los subprocesos y las pilas- Indirect memory from threads and stacks
    - Información del subproceso- Thread information
    - Valores de Teb y Peb asociados- Associated Teb's and Peb's
    - Información del módulo- Module Information
    - Árbol de VAD y VMM- VMM and VAD tree
    filteredfiltered 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.Filtered uses a subtraction-based design where all memory in the process is included unless specifically excluded. El diseño comprende los aspectos internos de SQLPAL y el entorno de host, y excluye determinadas regiones del volcado.The design understands the internals of SQLPAL and the host environment, excluding certain regions from the dump.
    fullfull Full es un volcado de proceso completo que incluye todas las regiones que están en /proc/$pid/maps.Full is a complete process dump that includes all regions located in /proc/$pid/maps. No se controla mediante la configuración coredump.captureminiandfull.This is not controlled by coredump.captureminiandfull setting.

Alta disponibilidadHigh Availability

La opción hadr.hadrenabled habilita los grupos de disponibilidad en la instancia de SQL Server.The hadr.hadrenabled option enables availability groups on your SQL Server instance. El siguiente comando habilita los grupos de disponibilidad al establecer hadr.hadrenabled en 1.The following command enables availability groups by setting hadr.hadrenabled to 1. Debe reiniciar SQL Server para que la configuración surta efecto.You must restart SQL Server for the setting to take effect.

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

Para obtener información sobre cómo se usa esto con los grupos de disponibilidad, vea los siguientes dos temas.For information on how this is used with availability groups, see the following two topics.

Establecimiento del directorio de auditoría localSet local audit directory

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.The telemetry.userrequestedlocalauditdirectory setting enables Local Audit and lets you set the directory where the Local Audit logs are created.

  1. Cree un directorio de destino para los nuevos registros de Auditoría local.Create a target directory for new Local Audit logs. En el ejemplo siguiente se crea un nuevo directorio /tmp/audit:The following example creates a new /tmp/audit directory:

    sudo mkdir /tmp/audit
    
  2. Cambie el propietario y el grupo del directorio al usuario mssql:Change the owner and group of the directory to the mssql user:

    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:Run the mssql-conf script as root with the set command for telemetry.userrequestedlocalauditdirectory:

    sudo /opt/mssql/bin/mssql-conf set telemetry.userrequestedlocalauditdirectory /tmp/audit
    
  4. Reinicie el servicio SQL Server:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Para obtener más información, vea Comentarios del cliente para SQL Server en Linux.For more information, see Customer Feedback for SQL Server on Linux.

Cambio de la configuración regional de SQL ServerChange the SQL Server locale

La configuración language.lcid cambia la configuración regional de SQL Server por cualquier identificador de lenguaje (LCID) admitido.The language.lcid setting changes the SQL Server locale to any supported language identifier (LCID).

  1. En el ejemplo siguiente se cambia la configuración regional a Francés (1036):The following example changes the locale to French (1036):

    sudo /opt/mssql/bin/mssql-conf set language.lcid 1036
    
  2. Reinicie el servicio SQL Server para aplicar los cambios:Restart the SQL Server service to apply the changes:

    sudo systemctl restart mssql-server
    

Establecimiento del límite de memoriaSet the memory limit

La configuración memory.memorylimitmb controla la cantidad de memoria física (en MB) disponible para SQL Server.The memory.memorylimitmb setting controls the amount physical memory (in MB) available to SQL Server. El valor predeterminado es el 80 % de la memoria física.The default is 80% of the physical memory.

  1. Ejecute el script mssql-conf como raíz con el comando set para memory.memorylimitmb.Run the mssql-conf script as root with the set command for memory.memorylimitmb. En el ejemplo siguiente se cambia la memoria disponible para SQL Server a 3,25 GB (3328 MB).The following example changes the memory available to SQL Server to 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:Restart the SQL Server service to apply the changes:

    sudo systemctl restart mssql-server
    

Configuración de memoria adicionalAdditional memory settings

Las opciones siguientes están disponibles para la configuración de memoria.The following options are available to the memory settings.

OpciónOption DescripciónDescription
memory.disablememorypressurememory.disablememorypressure Deshabilitación de la presión de memoria de SQL Server.SQL Server disable memory pressure. Los valores pueden ser true o false.Values can be true or false.
memory.memory_optimizedmemory.memory_optimized Habilitación o deshabilitación de características optimizadas para memoria de SQL Server: optimización de archivos de memoria persistente, protección de la memoria.Enable or disable SQL Server memory optimized features - persistent memory file enlightenment, memory protection. Los valores pueden ser true o false.Values can be true or false.

Configuración de MSDTCConfigure MSDTC

Las configuraciones network.rpcport y distributedtransaction.servertcpport se usan para configurar Microsoft DTC (Coordinador de transacciones distribuidas).The network.rpcport and distributedtransaction.servertcpport settings are used to configure the Microsoft Distributed Transaction Coordinator (MSDTC). Para cambiar estas configuraciones, ejecute los siguientes comandos:To change these settings, run the following commands:

  1. Ejecute el script mssql-conf como raíz con el comando set para "network.rpcport":Run the mssql-conf script as root with the set command for "network.rpcport":

    sudo /opt/mssql/bin/mssql-conf set network.rpcport <rcp_port>
    
  2. Después, establezca la configuración "distributedtransaction.servertcpport":Then set the "distributedtransaction.servertcpport" setting:

    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.In addition to setting these values, you must also configure routing and update the firewall for port 135. Para obtener más información sobre cómo hacerlo, consulte Procedimiento para configurar MSDTC en Linux.For more information on how to do this, see How to configure MSDTC on Linux.

Hay algunas otras configuraciones de mssql-conf que puede usar para supervisar y solucionar problemas de MSDTC.There are several other settings for mssql-conf that you can use to monitor and troubleshoot MSDTC. En la siguiente tabla se describen brevemente estas configuraciones.The following table briefly describes these settings. Para obtener más información sobre su uso, consulte los detalles en el artículo de soporte técnico de Windows Cómo habilitar el seguimiento de diagnóstico para MS DTC.For more information on their use, see the details in the Windows support article, How to enable diagnostic tracing for MS DTC.

Parámetro de mssql-confmssql-conf setting DescripciónDescription
distributedtransaction.allowonlysecurerpccallsdistributedtransaction.allowonlysecurerpccalls Configure solo llamadas RPC seguras para transacciones distribuidas.Configure secure only RPC calls for distributed transactions
distributedtransaction.fallbacktounsecurerpcifnecessarydistributedtransaction.fallbacktounsecurerpcifnecessary Configure solo llamadas RPC de seguridad para transacciones distribuidas.Configure security only RPC calls for distributed transactions
distributedtransaction.maxlogsizedistributedtransaction.maxlogsize Tamaño del archivo de registro de transacciones de DTC en MB.DTC transaction log file size in MB. El valor predeterminado es 64 MB.Default is 64MB
distributedtransaction.memorybuffersizedistributedtransaction.memorybuffersize Tamaño de búfer circular en el que se almacenan los seguimientos.Circular buffer size in which traces are stored. Este tamaño está en MB y el valor predeterminado es 10 MB.This size is in MB and default is 10MB
distributedtransaction.servertcpportdistributedtransaction.servertcpport Puerto de servidor RPC de MSDTC.MSDTC rpc server port
distributedtransaction.trace_cmdistributedtransaction.trace_cm Seguimientos en el administrador de conexiones.Traces in the connection manager
distributedtransaction.trace_contactdistributedtransaction.trace_contact Se hace un seguimiento del grupo de contactos y los contactos.Traces the contact pool and contacts
distributedtransaction.trace_gatewaydistributedtransaction.trace_gateway Se hace un seguimiento del origen de la puerta de enlace.Traces Gateway source
distributedtransaction.trace_logdistributedtransaction.trace_log Seguimiento del registro.Log tracing
distributedtransaction.trace_miscdistributedtransaction.trace_misc Seguimientos que no se pueden clasificar en las otras categorías.Traces that cannot be categorized into the other categories
distributedtransaction.trace_proxydistributedtransaction.trace_proxy Seguimientos que se generan en el proxy de MSDTC.Traces that are generated in the MSDTC proxy
distributedtransaction.trace_svcdistributedtransaction.trace_svc Se hace un seguimiento del inicio del archivo .exe y el servicio.Traces service and .exe file startup
distributedtransaction.trace_tracedistributedtransaction.trace_trace Infraestructura de seguimiento.The trace infrastructure itself
distributedtransaction.trace_utildistributedtransaction.trace_util Rutinas de la utilidad de seguimiento a las que se llama desde varias ubicaciones.Traces utility routines that are called from multiple locations
distributedtransaction.trace_xadistributedtransaction.trace_xa Origen de seguimiento del administrador de transacciones XA (XATM).XA Transaction Manager (XATM) tracing source
distributedtransaction.tracefilepathdistributedtransaction.tracefilepath Carpeta en la que deben almacenarse los archivos de seguimiento.Folder in which trace files should be stored
distributedtransaction.turnoffrpcsecuritydistributedtransaction.turnoffrpcsecurity Habilite o deshabilite la seguridad RPC de las transacciones distribuidas.Enable or disable RPC security for distributed transactions

Aceptación de los CLUF de MLServicesAccept MLServices EULAs

Al agregar paquetes de R o Python de aprendizaje automático al motor de base de datos, tiene que aceptar los términos de licencia de las distribuciones de código abierto de R y Python.Adding machine learning R or Python packages to the database engine requires that you accept the licensing terms for open-source distributions of R and Python. En la tabla siguiente se enumeran todos los comandos disponibles o las opciones relacionadas con los CLUF de mlservices.The following table enumerates all available commands or options related to mlservices EULAs. Se usa el mismo parámetro de CLUF para R y Python, en función de lo que haya instalado.The same EULA parameter is used for R and Python, depending on what you installed.

# 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

También puede agregar la aceptación del CLUF directamente al archivo mssql.conf:You can also add EULA acceptance directly to the mssql.conf file:

[EULA]
accepteula = Y
accepteulaml = Y

Habilitación del acceso de red salienteEnable outbound network access

El acceso de red saliente para las extensiones de R, Python y Java en la característica SQL Server Machine Learning Services está deshabilitado de forma predeterminada.Outbound network access for R, Python, and Java extensions in the SQL Server Machine Learning Services feature is disabled by default. Para habilitar las solicitudes salientes, establezca la propiedad booleana "outboundnetworkaccess" con mssql-conf.To enable outbound requests, set the "outboundnetworkaccess" Boolean property using mssql-conf.

Después de establecer la propiedad, reinicie el servicio SQL Server Launchpad para leer los valores actualizados del archivo INI.After setting the property, restart SQL Server Launchpad service to read the updated values from the INI file. En un mensaje de reinicio se le recuerda si se ha modificado un valor relacionado con la extensibilidad.A restart message reminds you whenever an extensibility-related setting is modified.

# 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

También puede agregar “outboundnetworkaccess” directamente al archivo mssql.conf:You can also add "outboundnetworkaccess" directly to the mssql.conf file:

[extensibility]
outboundnetworkaccess = 1

Cambio del puerto TCPChange the TCP port

La configuración network.tcpport cambia el puerto TCP en el que SQL Server escucha las conexiones.The network.tcpport setting changes the TCP port where SQL Server listens for connections. De forma predeterminada, este puerto se establece en el 1433.By default, this port is set to 1433. Para cambiar el puerto, ejecute los siguientes comandos:To change the port, run the following commands:

  1. Ejecute el script mssql-conf como raíz con el comando "set" para "network.tcpport":Run the mssql-conf script as root with the "set" command for "network.tcpport":

    sudo /opt/mssql/bin/mssql-conf set network.tcpport <new_tcp_port>
    
  2. Reinicie el servicio SQL Server:Restart the SQL Server service:

    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.When connecting to SQL Server now, you must specify the custom port with a comma (,) after the hostname or IP address. Por ejemplo, para conectarse con SQLCMD, usaría el siguiente comando:For example, to connect with SQLCMD, you would use the following command:

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

Especificación de la configuración de TLSSpecify TLS settings

Las opciones siguientes configuran TLS para una instancia de SQL Server que se ejecuta en Linux.The following options configure TLS for an instance of SQL Server running on Linux.

OpciónOption DescripciónDescription
network.forceencryptionnetwork.forceencryption Si es 1, SQL ServerSQL Server obliga a que se cifren todas las conexiones.If 1, then SQL ServerSQL Server forces all connections to be encrypted. De forma predeterminada, esta opción es 0.By default, this option is 0.
network.tlscertnetwork.tlscert La ruta de acceso absoluta al archivo de certificado que usa SQL ServerSQL Server para TLS.The absolute path to the certificate file that SQL ServerSQL Server uses for TLS. Ejemplo: /etc/ssl/certs/mssql.pem. La cuenta de mssql debe poder acceder al archivo de certificado.Example: /etc/ssl/certs/mssql.pem The certificate file must be accessible by the mssql account. Microsoft recomienda restringir el acceso al archivo mediante chown mssql:mssql <file>; chmod 400 <file>.Microsoft recommends restricting access to the file using chown mssql:mssql <file>; chmod 400 <file>.
network.tlskeynetwork.tlskey Ruta de acceso absoluta al archivo de clave privada que usa SQL ServerSQL Server para TLS.The absolute path to the private key file that SQL ServerSQL Server uses for TLS. Ejemplo: /etc/ssl/private/mssql.key. La cuenta de mssql debe poder acceder al archivo de certificado.Example: /etc/ssl/private/mssql.key The certificate file must be accessible by the mssql account. Microsoft recomienda restringir el acceso al archivo mediante chown mssql:mssql <file>; chmod 400 <file>.Microsoft recommends restricting access to the file using chown mssql:mssql <file>; chmod 400 <file>.
network.tlsprotocolsnetwork.tlsprotocols Lista separada por comas de los protocolos TLS que admite SQL Server.A comma-separated list of which TLS protocols are allowed by SQL Server. SQL ServerSQL Server siempre intenta negociar el protocolo más seguro permitido.always attempts to negotiate the strongest allowed protocol. Si un cliente no admite ningún protocolo permitido, SQL ServerSQL Server rechaza el intento de conexión.If a client does not support any allowed protocol, SQL ServerSQL Server rejects the connection attempt. Por motivos de compatibilidad, todos los protocolos admitidos se permiten de forma predeterminada (1.2, 1.1 y 1.0).For compatibility, all supported protocols are allowed by default (1.2, 1.1, 1.0). Si sus clientes admiten TLS 1.2, Microsoft recomienda permitir solo TLS 1.2.If your clients support TLS 1.2, Microsoft recommends allowing only TLS 1.2.
network.tlsciphersnetwork.tlsciphers Especifica qué cifrados permite SQL ServerSQL Server para TLS.Specifies which ciphers are allowed by SQL ServerSQL Server for TLS. Esta cadena debe tener el formato que se indica en la lista de cifrado de OpenSSL.This string must be formatted per OpenSSL's cipher list format. En general, no debería tener que cambiar esta opción.In general, you should not need to change this option.
De forma predeterminada, se permiten los siguientes cifrados:By default, the following ciphers are allowed:
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
network.kerberoskeytabfilenetwork.kerberoskeytabfile Ruta de acceso al archivo keytab de Kerberos.Path to the Kerberos keytab file

Para obtener un ejemplo del uso de la configuración de TLS, consulte Cifrar conexiones a SQL Server en Linux.For an example of using the TLS settings, see Encrypting Connections to SQL Server on Linux.

Configuración de redNetwork settings

Consulte 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 AD con SQL Server en Linux.See Tutorial: Use Active Directory authentication with SQL Server on Linux for comprehensive information on using AD authentication with SQL Server on Linux.

Las siguientes opciones son configuraciones de red adicionales que se pueden configurar mediante mssql-conf.The following options are additional network settings configurable using mssql-conf.

OpciónOption DescripciónDescription
network.disablesssdnetwork.disablesssd Deshabilitación de la consulta SSSD para obtener información de cuenta de AD y establecer las llamadas LDAP como método predeterminado.Disable querying SSSD for AD account information and default to LDAP calls. Los valores pueden ser true o false.Values can be true or false.
network.enablekdcfromkrb5confnetwork.enablekdcfromkrb5conf Habilitación de la búsqueda de información de KDC desde krb5.conf.Enable looking up KDC information from krb5.conf. Los valores pueden ser true o false.Values can be true or false.
network.forcesecureldapnetwork.forcesecureldap Forzamiento del uso de LDAPS para contactar con el controlador de dominio.Force using LDAPS to contact domain controller. Los valores pueden ser true o false.Values can be true or false.
network.ipaddressnetwork.ipaddress Dirección IP para las conexiones entrantes.IP address for incoming connections.
network.kerberoscredupdatefrequencynetwork.kerberoscredupdatefrequency Tiempo en segundos entre las comprobaciones de las credenciales de Kerberos que deben actualizarse.Time in seconds between checks for kerberos credentials that need to be updated. El valor es un entero.Value is an integer.
network.privilegedadaccountnetwork.privilegedadaccount Usuario con privilegios de AD que se usará para la autenticación de AD.Privileged AD user to use for AD authentication. El valor es <username>.Value is <username>. Para más información, consulte el Tutorial: Usar la autenticación de Active Directory con SQL Server en LinuxFor more information, see Tutorial: Use Active Directory authentication with SQL Server on Linux
uncmappinguncmapping Asigna la ruta de acceso UNC a una ruta de acceso local.Maps UNC path to a local path. Por ejemplo, sudo /opt/mssql/bin/mssql-conf set uncmapping //servername/sharename /tmp/folder.For example, sudo /opt/mssql/bin/mssql-conf set uncmapping //servername/sharename /tmp/folder.

Habilitación o deshabilitación de las marcas de seguimientoEnable/Disable traceflags

La opción traceflag habilita o deshabilita las marcas de seguimiento del inicio del servicio SQL Server.This traceflag option enables or disables traceflags for the startup of the SQL Server service. Para habilitar o deshabilitar una marca de seguimiento, use los siguientes comandos:To enable/disable a traceflag, use the following commands:

  1. Habilite una marca de seguimiento con el siguiente comando.Enable a traceflag using the following command. Por ejemplo, para la marca de seguimiento 1234:For example, for Traceflag 1234:

    sudo /opt/mssql/bin/mssql-conf traceflag 1234 on
    
  2. Puede habilitar varias marcas de seguimiento si las especifica por separado:You can enable multiple traceflags by specifying them separately:

    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:In a similar way, you can disable one or more enabled traceflags by specifying them and adding the off parameter:

    sudo /opt/mssql/bin/mssql-conf traceflag 1234 2345 3456 off
    
  4. Reinicie el servicio SQL Server para aplicar los cambios:Restart the SQL Server service to apply the changes:

    sudo systemctl restart mssql-server
    

Eliminación de una configuraciónRemove a setting

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.To unset any setting made with mssql-conf set, call mssql-conf with the unset option and the name of the setting. De esta forma, se borra la configuración y se devuelve a su valor predeterminado.This clears the setting, effectively returning it to its default value.

  1. En el siguiente ejemplo se borra la opción network.tcpport.The following example clears the network.tcpport option.

    sudo /opt/mssql/bin/mssql-conf unset network.tcpport
    
  2. Reinicie el servicio SQL Server.Restart the SQL Server service.

    sudo systemctl restart mssql-server
    

Visualización de la configuración actualView current settings

Para ver todas las opciones configuradas, ejecute el siguiente comando para generar el contenido del archivo mssql.conf:To view any configured settings, run the following command to output the contents of the mssql.conf file:

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

Cualquier configuración que no se muestre en este archivo usa sus valores predeterminados.Any settings not shown in this file are using their default values. En la sección siguiente se proporciona un archivo mssql.conf de ejemplo.The next section provides a sample mssql.conf file.

Formato de mssql.confmssql.conf format

En el siguiente archivo /var/opt/mssql/mssql.conf se proporciona un ejemplo de cada configuración.The following /var/opt/mssql/mssql.conf file provides an example for each setting. Puede usar este formato para realizar cambios manualmente en el archivo mssql.conf según sea necesario.You can use this format to manually make changes to the mssql.conf file as needed. Si cambia el archivo manualmente, debe reiniciar SQL Server antes de que se apliquen los cambios.If you do manually change the file, you must restart SQL Server before the changes are applied. Para usar el archivo mssql.conf con Docker, debe hacer que Docker conserve sus datos.To use the mssql.conf file with Docker, you must have Docker persist your data. En primer lugar, agregue un archivo mssql.conf completo al directorio de host y después ejecute el contenedor.First add a complete mssql.conf file to your host directory and then run the container. Hay un ejemplo de este procedimiento en Comentarios del cliente.There is an example of this in Customer Feedback.

[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

Pasos siguientesNext steps

Para usar variables de entorno en su lugar a fin de realizar algunos de estos cambios de configuración, consulte Configuración de SQL Server con variables de entorno.To instead use environment variables to make some of these configuration changes, see Configure SQL Server settings with environment variables.

Para ver otras herramientas y escenarios de administración, consulte Administrar SQL Server en Linux.For other management tools and scenarios, see Manage SQL Server on Linux.