外部データベースを設定する

MySQL サーバー側

推奨データベースサーバー設定:

• InnoDB ストレージエンジンを使用します。

• utf8mb4 文字セット（または MySQL バージョンが 5.5.2 以前の場合は utf8）を使用します。

• 大文字と小文字を区別する照合を使用します。

• TeamCity を実行している JVM のタイムゾーンと MySQL インスタンスのタイムゾーンが同じであることを確認するには、my.cnf ファイルを使用するか、OS レベルでタイムゾーンを構成します。

• TeamCity は主キーのないテーブルを管理するため、サーバーの sql_require_primary_key(英語) システム変数を OFF に設定する必要があります。

• MySQL サーバー設定の推奨事項も参照します。

TeamCity によって使用される MySQL ユーザーアカウントには、TeamCity データベースに対するすべての権限が付与されている必要があります。これは MySQL コンソールから以下の SQL コマンドを実行できます。

TeamCity サーバー側 (MySQL)

JDBC ドライバのインストール

1. MySQL JDBC ドライバー(英語)をダウンロードします。必ずサーバーと互換性のあるバージョンを使用してください。

2. Windows の場合、インストーラーを「カスタム」モードで実行し、「MySQL コネクター | Connector/J」を選択してスタンドアロンコネクターをインストールします。

3. ダウンロードしたアーカイブ (Linux) またはインストールフォルダー (Windows) から mysql-connector-j-<version>.jar を <TeamCity Data Directory> /lib/jdbc ディレクトリにコピーします (既存のファイルがある場合は削除します)。TeamCity のセットアップを続行します。

PostgreSQL サーバー側

1. PostgreSQL で TeamCity 用の空のデータベースを作成します。

   • データベースが UTF8 を使用するように設定してください。

   • データベースを操作するために TeamCity によって使用されるユーザーアカウントにこのデータベースを変更するための権限を付与します。

2. PostgreSQL サーバーの設定に関する推奨事項も参照します。

TeamCity は、テーブルに使用されるスキーマを指定しません。デフォルトでは、PostgreSQL は public スキーマ(英語)にテーブルを作成します。TeamCity は、他の PostgreSQL スキーマでも機能します。別のスキーマに切り替えるには、ユーザー名とまったく同じ名前のスキーマを作成します。これは、pgAdmin ツールまたは次の SQL を使用して実行できます。

スキーマは空にする必要があります（テーブルを含めることはできません）。

TeamCity サーバー側 (PostgreSQL との連携)

必要な PostgreSQL JDBC42 ドライバ(英語)をダウンロードし、 <TeamCity Data Directory> /lib/jdbc ディレクトリに配置します (既存のファイルがある場合は削除します)。TeamCity のセットアップを続行します。

Oracle サーバー側

TeamCity 用の Oracle ユーザーアカウント / スキーマを作成します。

• データベースインスタンスの各国語キャラクタセットが UTF または Unicode であることを確認してください。

• このデータベースを操作するために TeamCity がアカウントを使用するユーザーに CREATE SESSION および CREATE TABLE 権限を付与します。

最初の接続で、TeamCity はユーザーのスキーマに必要なすべてのテーブルとインデックスを作成します。(注: TeamCity は、他のスキーマにアクセスできる場合でも、他のスキーマにアクセスしようとはしません。)

TeamCity ユーザーに表スペースにアクセスするためのクォータがあることを確認してください。

TeamCity サーバー側 (Oracle との)

1. Oracle JDBC ドライバーを入手します。サポートされているドライバーのバージョンは 11.1 以降です。Oracle JDBC ドライバーは、Oracle サーバーと互換性がある必要があります。
   次のファイルを配置します。

   • ojdbc8.jar (またはデータベースのバージョンに応じて ojdbc6.jar、ojdbc7.jar)

   • orai18n.jar (ドライバーバージョンにない場合は省略可能)
     <TeamCity Data Directory> /lib/jdbc ディレクトリに (存在する場合は既存のファイルを削除します)。
     ドライバは Oracle サーバーインストール内に置くことを強くお勧めします。必要な場合は、DBA にファイルについて問い合わせてください。または、OracleWeb サイト(英語)から Oracle JDBC ドライバをダウンロードします。

2. TeamCity セットアップに進みます。

MS SQL Server 側

1. 新しいデータベースを作成します。プライマリ照合として、ロケールに対応する大文字と小文字を区別する照合（_CS_AS で終わる照合名）を使用してください。

2. TeamCity ユーザーを作成し、このユーザーがデータベースの所有者であることを確認します（ユーザーに dbo 権限を付与します）。これにより、ユーザーはデータベーススキーマを変更できるようになります。SSL 接続の場合は、MSSQL サーバーのバージョンと Java の TeamCity バージョンに互換性があることを確認してください。最新バージョンの SQL サーバーを使用することをお勧めします。

3. サーバーの使用頻度に応じて、十分なトランザクションログスペースを割り当てます。推奨されるセットアップは 1GB 以上です。

4. SQL Server ブラウザーが実行されていることを確認してください。

5. SQL Server インスタンスに対して TCP/IP プロトコルが有効になっていることを確認してください。

TeamCity サーバー側 (MS SQL)

1. マイクロソフトダウンロードセンターから Microsoft JDBC ドライバー v12.6+（sqljdbc_12.6.x パッケージ）をダウンロードします。

2. ダウンロードしたパッケージを一時ディレクトリに解凍します。ダウンロードしたパッケージの mssql-jdbc-<version>.jre8.jar を <TeamCity Data Directory> /lib/jdbc ディレクトリにコピーします (存在する場合は削除します)。MS SQL 統合セキュリティ (Windows 認証) では、手順に従ってドライバーパッケージから sqljdbc_auth.dll をインストールする必要があります。

3. TeamCity セットアップに進みます。

jTDS ドライバー

Unicode 文字の使用に関する既知の問題があるため、jTDSJDBC ドライバーの使用はお勧めしません。

ドライバーを使用する場合（jtds テキストは database.properties の connectionUrl に表示されます）、ネイティブドライバーを切り替えることを強くお勧めします。

1. データベースを含むサーバーバックアップを作成します。

2. 上記のセクションで説明したように、サーバーを停止し、ネイティブ MicrosoftJDBC ドライバーを使用するようにサーバーを構成します。

3. データベースをバックアップから新しい MSSQL データベースに復元します。

4. サーバーを実行します。