[comment]: # (tags: mssql)

[comment]: # ({12942068-2b91b381})
# 8 MSSQLプラグイン

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

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

このセクションでは、MSSQL Zabbixエージェント2プラグイン設定ファイル(mssql.conf) でサポートされているパラメータを一覧表示します。

MSSQL プラグインはロード可能なプラグインであり、[MSSQL プラグイン リポジトリ](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0) で利用可能であり、詳細な説明が記載されています。
このプラグインは、Zabbix 6.0.27以降でサポートされています。
Windows用のコンパイル済みプラグインバイナリは、[Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.28/) 以降で利用可能であり、6.0.27バージョンと互換性があります。

注意点:

-   デフォルト値は、出荷時の設定ファイルの値ではなく、プロセスのデフォルト値です。
-   Zabbixの設定ファイルは[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)なしのUTF-8エンコーディングのみサポートします。
-   行の先頭が"\＃"で始まった場合のみコメントとして認識されます。

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

[comment]: # ({03a0ccba-efe3e04c})
#### パラメータ

|パラメータ|必須|範囲|デフォルト|説明|
|--|--|--|--|----------|
|Plugins.MSSQL.CustomQueriesDir|no| |empty|プラグインが実行できるカスタム クエリを含むユーザー定義の .sql ファイルを含むディレクトリへのファイルパスを指定します。プラグインは、起動時に構成されたディレクトリ内のすべての使用可能な .sqlファイルをロードします。つまり、カスタムクエリ ファイルへの変更は、プラグインが再起動されるまで反映されません。プラグインは、Zabbixエージェント2とともに起動および停止されます。|
|Plugins.MSSQL.Default.CACertPath|no| | |MSSQLサーバの証明書を発行した証明機関 (CA) の公開キー証明書へのデフォルトのファイルパス。証明書は PEM 形式である必要があります。|
|Plugins.MSSQL.Default.Database|no| | |接続するデフォルトのデータベース名|
|Plugins.MSSQL.Default.Encrypt|no| | |既定の接続暗号化の種類を指定します。可能な値は次のとおりです:<br>*true* - プラグインとサーバ間のデータ送信は暗号化されます。<br>*false* - プラグインとサーバ間のデータ送信は、ログインパケットを超えて暗号化されません。<br>*strict* - プラグインとサーバ間のデータ送信は、[TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16) を使用してE2Eで暗号化されます。<br>*disable* - プラグインとサーバ間のデータ送信は暗号化されません。|
|Plugins.MSSQL.Default.HostNameInCertificate|no| | |デフォルトでは、MSSQLサーバの証明書の共通名 (CN) です。|
|Plugins.MSSQL.Default.Password|no| | |デフォルトで保護された MSSQLサーバに送信されるパスワード|
|Plugins.MSSQL.Default.TLSMinVersion|no| | |デフォルトで使用する最小 TLS バージョン。使用可能な値:`1.0`、`1.1`、`1.2`、`1.3` |
|Plugins.MSSQL.Default.TrustServerCertificate|no| | |プラグインがデフォルトでサーバ証明書を検証せずに信頼するかどうか。使用可能な値: `true`、`false`|
|Plugins.MSSQL.Default.Uri|no| |sqlserver://localhost:1433|接続するデフォルトの URI。サポートされているスキーマは `sqlserver://` のみです。スキーマは省略できます。埋め込まれた資格情報は無視されます。|
|Plugins.MSSQL.Default.User|no| | |保護された MSSQLサーバに送信されるデフォルトのユーザー名|
|Plugins.MSSQL.KeepAlive|no|60-900|300|未使用のプラグイン接続が閉じられるまでの最大待機時間(秒単位)|
|Plugins.MSSQL.Sessions.<SessionName>.CACertPath|no| | |名前付きセッションの MSSQLサーバの証明書を発行した証明機関 (CA) の公開キー証明書へのファイルパス。証明書は PEM 形式である必要があります。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.Database|no| | |名前付きセッションに接続するデータベース名。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.Encrypt|no| | |名前付きセッションの接続暗号化の種類を指定します。可能な値は次のとおりです:<br>*true* - プラグインとサーバ間のデータ送信は暗号化されます。<br>*false* - プラグインとサーバ間のデータ送信は、ログイン パケットを超えて暗号化されません。<br>*strict* - プラグインとサーバ間のデータ送信は、[TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16) を使用してE2Eで暗号化されます。<br>*disable* - プラグインとサーバ間のデータ送信は暗号化されません。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate|no| | |名前付きセッションの MSSQLサーバの証明書の共通名 (CN)。<br>**<SessionName>** - 項目キーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.Password|no| | |名前付きセッションの保護された MSSQLサーバに送信されるパスワード。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion|no| | |名前付きセッションで使用する最小 TLS バージョン。使用可能な値: `1.0`、`1.1`、`1.2`、`1.3`<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate|no| | |プラグインが、名前付きセッションに対して検証せずにサーバ証明書を信頼するかどうか。使用可能な値: `true`、`false`<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.Uri|no| |sqlserver://localhost:1433|名前付きセッションの接続先 URI。サポートされているスキーマは `sqlserver://` のみです。スキーマは省略できます。埋め込まれた資格情報は無視されます。<br>**<SessionName>** - 項目キーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.Sessions.<SessionName>.User|no| | |名前付きセッションの保護された MSSQLサーバに送信されるユーザー名。<br>**<SessionName>** - アイテムキーで使用するセッションの名前を定義します。|
|Plugins.MSSQL.System.Path|no| | |MSSQL プラグイン実行可能ファイルへのパス。<br>MSSQL プラグインのグローバル設定。すべての接続に適用されます。<br>使用例: `Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql`|
|Plugins.MSSQL.Timeout|no|1-30|global timeout|セッションでの最初の接続時および後続の操作時にサーバが応答するのを待機する期間(秒単位)|

参考情報:

-   一般的なZabbixエージェント2の設定パラメーターの説明: [Zabbixエージェント2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbixエージェント2 (Windows)](/manual/appendix/config/zabbix_agent2_win)
-   [プラグイン](/manual/config/items/plugins)の設定手順

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