パラメータ設定:Rds.json
## 注意事項
パラメータ変更時は[パラメータ変更時の確認事項](/ja/manual/parameter-edit)をご確認ください。
## 設定値
本パラメータファイルの設定値は下記の通りです。
|パラメータ名|設定例|説明|
|:--|:--|:--|
|Dbms|"SQLServer"|利用するデータベースに合わせて"SQLServer"、"PostgreSQL"、"MySQL"のいずれかを指定。.NET Framework版では"SQLServer"から変更不可。"MySQL"はver1.4.9.0以降のみ対応。|
|Provider|"Local"|通常は"Local"を指定。Azure SQL Databaseを利用する場合には"Azure"を指定。|
|SaConnectionString|sa権限の接続文字列|データベースインスタンスにsa権限で接続するための接続文字列を指定。|
|OwnerConnectionString|dbowner権限の接続文字列|Pleasanterのデータベースにdbowner権限で接続するための接続文字列を指定。|
|UserConnectionString|dbreader,dbwriter権限の接続文字列|Pleasanterのデータベースにdbreader,dbwriter権限で接続するための接続文字列を指定。|
|SqlCommandTimeOut|600|SQLコマンドのタイムアウト時間を秒単位で指定。|
|MinimumTime|3|データベースが識別可能な最小時間単位をミリ秒で指定。**本パラメータは変更不可。**|
|DeadlockRetryCount|4|デッドロック発生時の最大再試行回数を指定。|
|DeadlockRetryInterval|1000|デッドロック発生時に再試行を行うまでの間隔をミリ秒単位で指定。|
|DisableIndexChangeDetection|false|バージョンアップ時にデータベースのインデックスの差異を検出しない場合はtrueを指定。手動でインデックスを設定する場合などに設定したインデックスが失われないようtrueを指定する。|
|SysLogsSchemaVersion|1|[システムログの拡張機能](/ja/manual/syslog-extension)を利用する場合は2を指定。|
本パラメータファイル自体を誤って外部に公開しないようにするセキュリティの観点より、
OSのシステム環境変数から資格情報を取得する機能が追加されました。(ver.1.2.21.0)
システム環境変数の命名規則:
```
(サービス名)_Rds_(データベースの種類)_(ユーザの種類)ConnectionString
```
ユーザの種類、データベースの種類は省略可能です。
設定例:
```
(サービス名)_Rds_ConnectionString
```
これまでと同様に本パラメータファイルに設定することも可能です。
Azureの場合は [App Serviceの設定] -> [構成] -> [アプリケーション設定] から追加/編集することが可能です。
### SaConnectionStringの設定例
|データベース|変数|値|
|:--|:--|:--|
|SQL Server|Implem.Pleasanter_Rds_SQLServer_SaConnectionString|Server=(local);Database=master;UID=sa;PWD=<設定したパスワード>;Connection Timeout=30;|
|PostgreSQL|Implem.Pleasanter_Rds_PostgreSQL_SaConnectionString|Server=localhost;Database=postgres;UID=postgres;PWD=<設定したパスワード>|
|MySQL|Implem.Pleasanter_Rds_MySQL_SaConnectionString|Server=localhost;Database=mysql;UID=root;PWD=<設定したパスワード>|
### OwnerConnectionStringの設定例
|データベース|変数|値|
|:--|:--|:--|
|SQL Server|Implem.Pleasanter_Rds_SQLServer_OwnerConnectionString|Server=(local);Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<設定したパスワード>;Connection Timeout=30;|
|PostgreSQL|Implem.Pleasanter_Rds_PostgreSQL_OwnerConnectionString|Server=localhost;Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<設定したパスワード>|
|MySQL|Implem.Pleasanter_Rds_MySQL_OwnerConnectionString|Server=localhost;Database=#ServiceName#;UID=#ServiceName#_Owner;PWD=<設定したパスワード>|
### UserConnectionStringの設定例
|データベース|変数|値|
|:--|:--|:--|
|SQL Server|Implem.Pleasanter_Rds_SQLServer_UserConnectionString|Server=(local);Database=#ServiceName#;UID=#ServiceName#_User;PWD=<設定したパスワード>;Connection Timeout=30;|
|PostgreSQL|Implem.Pleasanter_Rds_PostgreSQL_UserConnectionString|Server=localhost;Database=#ServiceName#;UID=#ServiceName#_User;PWD=<設定したパスワード>|
|MySQL|Implem.Pleasanter_Rds_MySQL_UserConnectionString|Server=localhost;Database=#ServiceName#;UID=#ServiceName#_User;PWD=<設定したパスワード>|
本パラメータファイルとシステム環境の両方に設定した場合や省略形で設定した場合の優先順位は以下のとおりです。
### SaConnectionStringの優先順
|優先順|設定値|
|:--|:--|
|1|本パラメータファイルの「SaConnectionString」|
|2|環境変数の「(サービス名)_Rds_(データベースの種類)_SaConnectionString」|
|3|環境変数の「(サービス名)_Rds_(データベースの種類)_ConnectionString」|
|4|環境変数の「(サービス名)_Rds_SaConnectionString」|
|5|環境変数の「(サービス名)_Rds_ConnectionString」|
### OwnerConnectionStringの優先順
|優先順|設定値|
|:--|:--|
|1|本パラメータファイルの「OwnerConnectionString」|
|2|環境変数の「(サービス名)_Rds_(データベースの種類)_OwnerConnectionString」|
|3|環境変数の「(サービス名)_Rds_(データベースの種類)_ConnectionString」|
|4|環境変数の「(サービス名)_Rds_OwnerConnectionString」|
|5|環境変数の「(サービス名)_Rds_ConnectionString」|
### UserConnectionStringの優先順
|優先順|設定値|
|:--|:--|
|1|本パラメータファイルの「UserConnectionString」|
|2|環境変数の「(サービス名)_Rds_(データベースの種類)_UserConnectionString」|
|3|環境変数の「(サービス名)_Rds_(データベースの種類)_ConnectionString」|
|4|環境変数の「(サービス名)_Rds_UserConnectionString」|
|5|環境変数の「(サービス名)_Rds_ConnectionString」|
## 対応バージョン
|対応バージョン|内容|
|:--|:--|
|1.4.9.0 以降|MySQLに対応|