外部データベースのセットアップ

MySQL サーバー側

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

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

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

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

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

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

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

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

TeamCity サーバー側 (MySQL 使用)

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

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

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

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

PostgreSQL サーバー側

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

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

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

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

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

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

TeamCity サーバー側 (PostgreSQL 使用)

必要な PostgreSQL JDBC42 ドライバ(英語)をダウンロードし、 <TeamCity データディレクトリ>/ライブラリ/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 データディレクトリ>/ライブラリ/JDBC ディレクトリに配置します (そこに既存のファイルがある場合は除去してください)。
     ドライバーは Oracle サーバーのインストール環境で探すことを強くお勧めします。 必要に応じて、ファイルについて DBA に問い合わせてください。 または、Oracle JDBC ドライバーを Oracle の Web サイトからダウンロードしてください。

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

MS SQL サーバー側

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

2. TeamCity ユーザーを作成し、そのユーザーがデータベースの所有者であることを確認します (ユーザーに dbo 権限を付与します)。これにより、そのユーザーはデータベーススキーマを変更できるようになります。 SSL 接続の場合は、MS SQL サーバーのバージョンと TeamCity の Java バージョンに互換性があることを確認してください。 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>.jre11.jar を <TeamCity データディレクトリ>/ライブラリ/JDBC ディレクトリにコピーします (存在する場合は削除します)。 MS SQL 統合セキュリティ (Windows 認証) では、 手順に従ってドライバーパッケージから sqljdbc_auth.dll をインストールする必要があります。

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

jTDS ドライバー

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

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

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

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

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

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