外部データベースの設定

MySQL サーバー側

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

• InnoDB ストレージエンジンを使用する

• utf8mb4 文字セットを使用 (MySQL のバージョンが 5.5.2 以前の場合は utf8)

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

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

• MySQL サーバーの設定に関する推奨事項も参照してください

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

TeamCity サーバー側 (MySQL)

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

1. http://dev.mysql.com/downloads/connector/j/(英語) から MySQLJDBC ドライバーをダウンロードします。サーバーと互換性のあるバージョンを使用していることを確認してください。MySQL サーバーのバージョンが 5.5 以降の場合、JDBC ドライバーのバージョンは少なくとも 5.1.23 である必要があります。8 を超えるバージョンの場合は、ドライバーバージョン 8 を使用する必要があります。

2. ダウンロードしたアーカイブから mysql-connector-java-*-bin.jar を <TeamCity Data Directory>/lib/jdbc ディレクトリに配置します（既存のファイルがある場合は、そこから削除します）。TeamCity のセットアップを続行します。

PostgreSQL サーバー側

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

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

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

2. PostgreSQL サーバーの設定に関する推奨事項も参照してください

TeamCity は、テーブルに使用されるスキーマを指定しません。デフォルトでは、PostgreSQL は「public」スキーマ(英語)にテーブルを作成します（「public」はスキーマの名前です）。TeamCity は、他の PostgreSQL スキーマでも機能します。別のスキーマに切り替えるには、次の手順を実行します。

ユーザー名とまったく同じ名前のスキーマを作成します。これは、pgAdmin ツールを使用するか、次の SQL を使用して実行できます。

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

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

必要な PostgreSQL JDBC42 ドライバ(英語)をダウンロードして、<TeamCity データディレクトリ > /lib/jdbc ディレクトリに置きます（存在する場合は、そこに既存のファイルを削除します）。TeamCity セットアップに進みます。

Oracle サーバー側

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

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

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

TeamCity は最初の接続で、ユーザーのスキーマに必要なすべてのテーブルとインデックスを作成します。(メモ: TeamCity は他のスキーマがアクセス可能であってもそれらにアクセスしようとしません)

TeamCity サーバー側 (Oracle との)

1. Oracle JDBC ドライバーを入手してください。サポートされているドライバーのバージョンは 11.1 以上です。次のファイルを配置します。

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

• orai18n.jar （ドライババージョンにない場合は省略可能）を <TeamCity データディレクトリ > /lib/jdbc ディレクトリに追加します（存在する場合は既存のファイルを削除します）。

Oracle サーバーのインストール場所にドライバを配置することを強くお勧めします。必要に応じて、ファイルについて DBA に連絡してください。または、Oracle Web サイト(英語)から Oracle JDBC ドライバをダウンロードしてください。ドライバのバージョンが Oracle サーバーと互換性があることを確認してください。

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

MS SQL サーバー側

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

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

3. サーバーの使用頻度に応じて、十分なトランザクションログ領域を割り当てます。推奨設定は 1Gb 以上です。

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

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

TeamCity サーバー側 (MS SQL)

1. Microsoft Download Center (英語) から Microsoft JDBC driver v6.4+ (英語)（sqljdbc_6.*.x パッケージ）をダウンロードします。

2. ダウンロードしたパッケージを一時ディレクトリに解凍します。

3. ダウンロードしたばかりのパッケージから mssql-jdbc-*.jre8.jar を <TeamCity データディレクトリ > /lib/jdbc ディレクトリにコピーします（存在する場合は、そこに既存のファイルを削除します）。MS SQL 統合セキュリティ（Windows 認証）を使用するには、指示に従ってドライバパッケージから sqljdbc_auth.dll をインストールする必要があります。

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

jTDS ドライバー

jTDS JDBC ドライバを使用することはお勧めできません。ドライバの使用中に Unicode 文字を使用することに関する少なくとも既知の問題があります。

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

スイッチの適切な手順は次のとおりです。

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

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

• データベースをバックアップから新しい MS SQL データベースに復元します

• サーバーを実行する