[comment]: # translation:outdated

[comment]: # (tags: mssql)

[comment]: # ({12942068-2b91b381})
# 7 Plugin MSSQL

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

[comment]: # ({046b0b00-982c8358})
#### Visão Geral

Esta seção lista os parâmetros suportados no arquivo de configuração do plugin MSSQL Zabbix agent 2 (mssql.conf).

Este plugin é suportado desde o Zabbix 6.0.27. Para mais informações, consulte o readme [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md).

Observe que:

- Os valores padrão refletem os padrões do processo, não os valores nos arquivos de configuração enviados;
-  O Zabbix suporta apenas arquivos de configuração codificados em UTF-8 sem [BOM](https://en.wikipedia.org/wiki/Byte_order_mark);
- Comentários que começam com "#" são suportados apenas no início da linha.

[comment]: # ({/046b0b00-982c8358})

[comment]: # ({76570e1c-efe3e04c})
#### Parâmetros

|Parâmetro|Obrigatório|Intervalo|Padrão|Descrição|
|--|--|--|--|----------|
|Plugins.MSSQL.CustomQueriesDir|não| |vazio|Especifica o caminho do arquivo para um diretório contendo arquivos .sql definidos pelo usuário com consultas personalizadas que o plugin pode executar. O plugin carrega todos os arquivos .sql disponíveis no diretório configurado ao iniciar. Isso significa que quaisquer alterações nos arquivos de consulta personalizados não serão refletidas até que o plugin seja reiniciado. O plugin é iniciado e parado junto com o Zabbix agent 2.|
|Plugins.MSSQL.Default.CACertPath|não| | |O caminho do arquivo para a chave pública da autoridade certificadora (CA) que emitiu o certificado do servidor MSSQL. O certificado deve estar no formato PEM.|
|Plugins.MSSQL.Default.Database|não| | |O nome do banco de dados padrão para conectar-se.|
|Plugins.MSSQL.Default.Encrypt|não| | |Especifica o tipo de criptografia de conexão padrão. Os valores possíveis são:<br>*true* - dados enviados entre o plugin e o servidor são criptografados;<br>*false* - dados enviados entre o plugin e o servidor não são criptografados além do pacote de login;<br>*strict* - dados enviados entre o plugin e o servidor são criptografados de ponta a ponta usando [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);<br>*disable* - dados enviados entre o plugin e o servidor não são criptografados.|
|Plugins.MSSQL.Default.HostNameInCertificate|não| | |O nome comum (CN) do certificado do servidor MSSQL por padrão.|
|Plugins.MSSQL.Default.Password|não| | |A senha a ser enviada para um servidor MSSQL protegido por padrão.|
|Plugins.MSSQL.Default.TLSMinVersion|não| | |A versão mínima do TLS a ser usada por padrão. Os valores possíveis são: `1.0`, `1.1`, `1.2`, `1.3`.|
|Plugins.MSSQL.Default.TrustServerCertificate|não| | |Define se o plugin deve confiar no certificado do servidor sem validá-lo por padrão. Os valores possíveis são: `true`, `false`.|
|Plugins.MSSQL.Default.Uri|não| |sqlserver://localhost:1433|O URI padrão para conexão. O único esquema suportado é `sqlserver://`. Um esquema pode ser omitido. Credenciais embutidas serão ignoradas.|
|Plugins.MSSQL.Default.User|não| | |O nome de usuário padrão a ser enviado para um servidor MSSQL protegido.|
|Plugins.MSSQL.KeepAlive|não|60-900|300|O tempo máximo de espera (em segundos) antes que conexões de plugins não utilizadas sejam encerradas.|
|Plugins.MSSQL.Sessions.<SessionName>.CACertPath|não| | |O caminho do arquivo para a chave pública da autoridade certificadora (CA) que emitiu o certificado do servidor MSSQL para a sessão nomeada. O certificado deve estar no formato PEM.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.Database|não| | |O nome do banco de dados para conexão na sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.Encrypt|não| | |Especifica o tipo de criptografia de conexão para a sessão nomeada. Os valores possíveis são:<br>*true* - dados enviados entre o plugin e o servidor são criptografados;<br>*false* - dados enviados entre o plugin e o servidor não são criptografados além do pacote de login;<br>*strict* - dados enviados entre o plugin e o servidor são criptografados de ponta a ponta usando [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);<br>*disable* - dados enviados entre o plugin e o servidor não são criptografados.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate|não| | |O nome comum (CN) do certificado do servidor MSSQL para a sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.Password|não| | |A senha a ser enviada para um servidor MSSQL protegido para a sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion|não| | |A versão mínima do TLS a ser usada para a sessão nomeada. Os valores possíveis são: `1.0`, `1.1`, `1.2`, `1.3`.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate|não| | |Define se o plugin deve confiar no certificado do servidor sem validá-lo para a sessão nomeada. Os valores possíveis são: `true`, `false`.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.Uri|não| |sqlserver://localhost:1433|O URI para conexão, para a sessão nomeada. O único esquema suportado é `sqlserver://`. Um esquema pode ser omitido. Credenciais embutidas serão ignoradas.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.Sessions.<SessionName>.User|não| | |O nome de usuário a ser enviado para um servidor MSSQL protegido para a sessão nomeada.<br>**<SessionName>** - define o nome de uma sessão para uso em chaves de item.|
|Plugins.MSSQL.System.Path|não| | |Caminho para o executável do plugin MSSQL.<br>Configuração global para o plugin MSSQL. Aplicado a todas as conexões.<br>Exemplo de uso: `Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql`|
|Plugins.MSSQL.Timeout|não|1-30|tempo limite global|O tempo de espera para uma resposta do servidor ao conectar-se pela primeira vez e em operações subsequentes na sessão.|

Veja também:

-   Descrição dos parâmetros de configuração geral do Zabbix agent 2:
    [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /
    [Zabbix agent 2
    (Windows)](/manual/appendix/config/zabbix_agent2_win)
-   Instruções para configurar [plugins](/manual/extensions/plugins)

[comment]: # ({/76570e1c-efe3e04c})