[comment]: # (tags: mssql)

[comment]: # ({12942068-2b91b381})
# 8 MSSQL plugin

[comment]: # ({/12942068-2b91b381})

[comment]: # ({824434d2-982c8358})
#### Vista general

Aquesta secció llista els paràmetres admesos a l'arxiu de configuració del plugin de MSSQL (mssql.conf) per a l'agent 2 de Zabbix.
 
El plugin d'MSSQL es pot carregar i és disponible i detallat al [repositori del plugin de MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)

El plugin s'admet des de la versió de Zabbi 6.0.27.
Els binaris de plugins precompilats per a Windows són disponibles des de [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.28/) i són compatibles amb la versió 6.0.27.

Veieu que:

-   Els valors per defecte reflecteixen els processos per defecte, no pas els valors dels arxius de configuració descarregats;
-   Zabbix admet arxius de configuració codificats només en UTF-8, sense [BOM](https://en.wikipedia.org/wiki/Byte_order_mark);
-   Els comentaris que comencen amb "\#" només s'admeten al principi de les línies.

[comment]: # ({/824434d2-982c8358})

[comment]: # ({03a0ccba-efe3e04c})
#### Paràmetres

|Paràmetre|Obligatori|Rang|Predeterminat|Descripció|
|--|--|--|--|-----------|
|Plugins.MSSQL.CustomQueriesDir|no| |buit|Especifica la ruta del fitxer a un directori que conté fitxers .sql definits per l'usuari amb crides personalitzades que el plugin pot executar. El plugin carrega tots els fitxers .sql disponibles al directori configurat a l'inici. Això vol dir que els canvis als fitxers de crides personalitzades no es reflectiran fins que es reiniciï el plugin. El plugin s'inicia i s'atura juntament amb l'agent Zabbix 2.|
|Plugins.MSSQL.Default.CACertPath|no| | |Ruta del fitxer predeterminada al certificat de clau pública de l'autoritat de certificació (CA) que va emetre el certificat del servidor MSSQL. El certificat ha de ser en format PEM.|
|Plugins.MSSQL.Default.Database|no| | |Nom de la base de dades per defecte a la que connectar-se.|
|Plugins.MSSQL.Default.Encrypt|no| | |Especifica el tipus de xifrat de connexió predeterminat. Els valors possibles són:<br>*true* - l'enviament de dades entre el connector i el servidor és xifrat;<br>*false* - l'enviament de dades entre el connector i el servidor no és xifrat més enllà del paquet d'inici de sessió;<br>*strict* - l'enviament de dades entre el connector i el servidor es xifra E2E mitjançant [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);< br>*disable* - l'enviament de dades entre el connector i el servidor no és pas xifrat.|
|Plugins.MSSQL.Default.HostNameInCertificate|no| | |Nom comú (CN) del certificat del servidor MSSQL per defecte.|
|Plugins.MSSQL.Default.Password|no| | |Mot de pas per defecte que s'ha d'enviar a un servidor MSSQL protegit.|
|Plugins.MSSQL.Default.TLSMinVersion|no| | |La versió mínima de TLS que cal emprar per defecte. Els valors possibles són: `1.0`, `1.1`, `1.2`, `1.3`.|
|Plugins.MSSQL.Default.TrustServerCertificate|no| | |Si el connector hauria de confiar en el certificat del servidor sense validar-lo per defecte. Valors possibles: `true`, `false`.|
|Plugins.MSSQL.Default.Uri|no| |sqlserver://localhost:1433|L'URI predeterminat per connectar-se. L'únic esquema compatible és `sqlserver://`. Es pot ometre un esquema. Les credencials incrustades seran ignorades.|
|Plugins.MSSQL.Usuari predeterminat|no| | |El nom d'usuari predeterminat que s'enviarà a un servidor MSSQL protegit.|
|Plugins.MSSQL.KeepAlive|no|60-900|300|El temps màxim d'espera (en segons) abans que es tanquin les connexions de connectors no utilitzats.|
|Plugins.MSSQL.Sessions.<SessionName>.CACertPath|no| | |La ruta del fitxer al certificat de clau pública de l'autoritat de certificació (CA) que va emetre el certificat del servidor MSSQL per a la sessió anomenada. El certificat ha d'estar en format PEM.<br>**<SessionName>**: defineix el nom d'una sessió per utilitzar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.Database|no| | |El nom de la base de dades a la qual connectar-se per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per utilitzar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.Encrypt|no| | |Especifica el tipus de xifratge de connexió per a la sessió anomenada. Els valors possibles són:<br>*true* - l'enviament de dades entre el connector i el servidor és xifrat;<br>*false* - l'enviament de dades entre el connector i el servidor no és xifrat més enllà del paquet d'inici de sessió;<br>*strict*: l'enviament de dades entre el connector i el servidor es xifra E2E mitjançant [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);< br>*disable* - l'enviament de dades entre el connector i el servidor no és pas xifrat.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate|no| | |Nom comú (CN) del certificat del servidor MSSQL per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la en claus d'element.|
|Plugins.MSSQL.Sessions.<SessionName>.Password|no| | |Mot de pas que s'ha d'enviar a un servidor MSSQL protegit per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion|no| | |La versió mínima de TLS que cal emprar per a la sessió anomenada. Els valors possibles són: `1.0`, `1.1`, `1.2`, `1.3`.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate|no| | |Si el connector hauria de confiar en el certificat del servidor sense validar-lo per a la sessió anomenada. Valors possibles: `true`, `false`.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.Uri|no| |sqlserver://localhost:1433|URI per connectar, per a la sessió anomenada. L'únic esquema compatible és `sqlserver://`. Es pot ometre un esquema. Les credencials incrustades s'ignoraran.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.MSSQL.Sessions.<SessionName>.User|no| | |El nom d'usuari que s'ha d'enviar a un servidor MSSQL protegit per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.MSSQL.System.Path|no| | |Camí de l'executable del connector MSSQL.<br>Configuració global del connector MSSQL. S'aplica a totes les connexions.<br>Exemple d'ús: `Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql`|
|Plugins.MSSQL.Timeout|no|1-30|global timeout|La durada, en segons, d'esperar que un servidor respongui quan es connecta per primera vegada i en les operacions de seguiment de la sessió.|

Veieu també:

- Descripció dels paràmetres de configuració generals de l'agent 2 de Zabbix:
    [Agent Zabbix 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /
    [Agent Zabbix 2
    (Windows)](/manual/appendix/config/zabbix_agent2_win)
- Instruccions per configurar [connectors](/manual/extensions/plugins)

[comment]: # ({/03a0ccba-efe3e04c})
