パラメータ設定: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を指定。|
## システム環境変数への登録方法
SaConnectionString、OwnerConnectionString、UserConnectionStringは[システム環境変数に登録](/ja/manual/credentials-in-environment-variables)できます。システム環境変数への登録については以下ページも参照ください。
[パラメータ設定:資格情報をシステム環境変数に登録する](credentials-in-environment-variables)
### 1. 命名規則
システム環境変数の命名規則は以下の通りです。
```
(サービス名)_Rds_(データベースの種類)_(ユーザの種類)ConnectionString
```
|項目|必須|説明|
|---|---|---|
|サービス名|○|[Service.json](/ja/manual/service-json)の「EnvironmentName」または「Name」を指定|
|データベースの種類||次のいずれかの値を指定。"SQLServer"、"PostgreSQL"、"MySQL"|
|ユーザの種類||次のいずれかの値を指定。"Sa"、"Owner"、"User"|
#### 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=<設定したパスワード>|
### 2. 優先順
本パラメータファイルとシステム環境の両方に設定した場合や省略形で設定した場合の優先順位は以下のとおりです。
#### SaConnectionStringの優先順
|優先順|設定値|
|:--|:--|
|1|本パラメータファイルの「SaConnectionString」|
|2|環境変数の「(サービス名:EnvironmentName)_Rds_SaConnectionString」|
|3|環境変数の「(サービス名:EnvironmentName)_Rds_ConnectionString」|
|4|環境変数の「(サービス名:Name)_Rds_(データベースの種類)_SaConnectionString」|
|5|環境変数の「(サービス名:Name)_Rds_(データベースの種類)_ConnectionString」|
|6|環境変数の「(サービス名:Name)_Rds_SaConnectionString」|
|7|環境変数の「(サービス名:Name)_Rds_ConnectionString」|
#### OwnerConnectionStringの優先順
|優先順|設定値|
|:--|:--|
|1|本パラメータファイルの「OwnerConnectionString」|
|2|環境変数の「(サービス名:EnvironmentName)_Rds_OwnerConnectionString」|
|3|環境変数の「(サービス名:EnvironmentName)_Rds_ConnectionString」|
|4|環境変数の「(サービス名:Name)_Rds_(データベースの種類)_OwnerConnectionString」|
|5|環境変数の「(サービス名:Name)_Rds_(データベースの種類)_ConnectionString」|
|6|環境変数の「(サービス名:Name)_Rds_OwnerConnectionString」|
|7|環境変数の「(サービス名:Name)_Rds_ConnectionString」|
#### UserConnectionStringの優先順
|優先順|設定値|
|:--|:--|
|1|本パラメータファイルの「UserConnectionString」|
|2|環境変数の「(サービス名:EnvironmentName)_Rds_UserConnectionString」|
|3|環境変数の「(サービス名:EnvironmentName)_Rds_ConnectionString」|
|4|環境変数の「(サービス名:Name)_Rds_(データベースの種類)_UserConnectionString」|
|5|環境変数の「(サービス名:Name)_Rds_(データベースの種類)_ConnectionString」|
|6|環境変数の「(サービス名:Name)_Rds_UserConnectionString」|
|7|環境変数の「(サービス名:Name)_Rds_ConnectionString」|
### 3. システム環境変数に登録する際の注意点
「2. 優先順」に記載の通りパラメータファイルに設定した値が最優先となるため、システム環境変数に登録する場合はパラメータファイルでは「null」を指定してください。
## 対応バージョン
|対応バージョン|内容|
|:--|:--|
|1.4.9.0 以降|MySQLに対応|
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/parameter-edit">パラメータ設定:パラメータ変更時の確認事項</a><span>2023/04/05 up</span></li>
<li><a href="/ja/manual/service-json">パラメータ設定:Service.json</a><span>2025/05/13 up</span></li>
<li><a href="/ja/manual/credentials-in-environment-variables">パラメータ設定:資格情報をシステム環境変数に登録する</a><span>2025/05/13 up</span></li></ul></article>
<ul><li><a href="/ja/manual/syslog-extension">システムログの拡張機能</a><span>2024/09/13 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />