ツイートはてブ LINE Pocket

MS SQL Server による TeamCity の設定

この記事では、TeamCity を MS SQL Server と統合する手順を説明します。クイックリファレンスについては、このセクションを参照してください。

前提条件

MS SQL サーバー
MS SQL Server Management Studio
TeamCity サーバーをインストール

SQL サーバーの TCP/IP プロトコルを有効にする

SQL Server 構成マネージャーを開き、以下を実行します。

SQL Server ネットワーク構成を展開し、MS SQL のプロトコルをクリックします。
右側のペインで、TCP/IP を右クリックし、有効をクリックして、はいを選択します (MS SQL では、TCP/IP はデフォルトで無効になっています)。OK をクリックします。
変更を有効にするには、MSSQL サーバーを再起動する必要があります。左側のペインで SQL Server サービスをクリックし、右側のペインで SQL Server を右クリックして再開をクリックします。
SQL Server ブラウザーが実行されていることを確認してください。

新しいデータベースを作成する

MS SQL Server Management Studio の場合:

データベースサーバーに接続し、オブジェクトエクスプローラーでデータベースノードを右クリックして、新規データベースを選択します。
一般ページで、データベース名 (下のスクリーンショットでは「TeamCity」) を指定し、十分なトランザクションログ(英語)領域を割り当てます。推奨される最小値は 1 GB (1024 MB) です。要件は、サーバーの使用頻度によって異なります。
プライマリ照合を指定します。左側のペインのオプションノードに移動し、右側で照合を選択します。ロケールに対応する大文字と小文字を区別する照合 (照合名が _CS_AS で終わる) をお勧めします。設定を保存するには、OK をクリックします。
次のようにして、no count 設定が無効になっていることを確認します。オブジェクトエクスプローラーでサーバーインスタンスを右クリックし、Properties | 接続に移動します。デフォルトの接続オプションフレームで、no count をオフにする必要があります。変更がある場合は保存します。

TeamCity データベースユーザーの設定

SQL Server は、SQL Server 認証と Windows 認証モードの 2 つの認証方法をサポートしています。

SQL 認証では、データベース設定でユーザー名とパスワードを指定する必要があります。Windows 認証を使用する前に、この認証を開始することをお勧めします。
Windows 認証（MS SQL 統合セキュリティ）を使用すると、特定の Windows ユーザーで実行されている TeamCity サーバーは、ユーザー名とパスワードを入力せずに、そのユーザーとして SQL サーバーに接続できます。ただし、追加の設定が必要です。

SQL Server 認証を使用して TeamCity 専用ユーザーを作成する

セキュリティノードに移動し、ログインを右クリックして新規ログインを選択し、開いた一般ウィンドウでログイン名（下図の「TeamCity」）を入力し、SQL サーバー認証を選択してユーザーのパスワードを入力します。デフォルトのデータベースを TeamCity に設定します。
左ペインでユーザーマッピングを選択し、右上ペインのリストで TeamCity データベースをチェックし、下ペインでユーザーに TeamCity データベース所有者権限を付与します。db_owner ボックスをチェックします。OK をクリックします。

Windows 認証を使用して SQL データベースユーザーを作成する

セキュリティノードに移動し、ログインを右クリックして新規ログインを選択し、開いた一般ウィンドウでログイン名を入力し、Windows 認証を選択して、検索ボタンをクリックします。
ユーザーまたはグループを選択ダイアログで、TeamCity の実行に使用されるユーザーアカウントを指定します。名前を確認するをクリックします。ユーザーが見つかったら、OK をクリックします。
このユーザーに DB 所有者権限を付与します。左側のペインでユーザーマッピングを選択し、右上のペインのリストで TeamCity データベースをチェックし、下部のペインでユーザーに TeamCity データベース所有者権限を付与します。db_owner ボックスをチェックします。OK をクリックします。

SQL Server データベース用の JDBC ドライバーのセットアップ

Microsoft ダウンロードセンターから Microsoft JDBC ドライバーバージョン 6.0 以降 (TeamCity サーバープラットフォームに応じて .exe または .tar.gz を選択) をダウンロードします。
ダウンロードしたパッケージを一時ディレクトリに解凍します。
ダウンロードしたパッケージから sqljdbc42.jar (またはバージョン 6.0 以降では mssql-jdbc-<version>.jre8.jar) パッケージを <TeamCity Data Directory> /lib/jdbc ディレクトリにコピーします。

Windows 認証の追加設定 (MSSQL 統合セキュリティ)

Windows 認証（MS SQL 統合セキュリティ）の場合、JDBC ドライバーに加えて、JDBC ドライバーパッケージからネイティブドライバーライブラリ sqljdbc_auth.dll をインストールする必要があります。ライブラリの必要なバージョンは、サーバーが使用する Java バージョンのビット数によって異なります。

TeamCity サーバーにバンドルされているデフォルトの 32 ビット JVM の場合は、<sql_jdbc_home>/enu/auth/x86/sqljdbc_auth.dll ファイルを <TeamCity Data Directory> /lib/jdbc/native/windows-i386 にコピーします。
TeamCity サーバーを実行するために使用される 64 ビット JVM の場合は、<sql_jdbc_home>/enu/auth/x64/sqljdbc_auth.dll を使用し、それを <TeamCity Data Directory> /lib/jdbc/native/windows-amd64 ディレクトリに配置します。

TeamCity を開始

TeamCity サーバーを起動します。Windows 認証 (MS SQL 統合セキュリティ) の場合は、この手順で構成されたユーザーでサーバーが実行されていることを確認します。
データベースとして MS SQL を選択します。
要求されたら、JDBC ドライバーのリフレッシュをクリックします。
接続設定を指定します。
- データベースホスト — SQL サーバーホスト。
- ポート — オプション。デフォルトでは、TeamCity はデフォルトポート（1433）でデータベースに接続しようとします。データベースが別のポートを使用している場合（たとえば、MS SQL Express によって自動割り当てされたり、手動で変更されたりする場合）、このフィールドに入力することを忘れないでください。データベースで使用されているポートは、SQL Server 構成マネージャー TCP/IP プロパティ | IP アドレス | TCP 動的ポートで確認できます。
- データベースインスタンス名 — デフォルトの SQL サーバーインスタンスは空白のままにします。名前付きインスタンスを使用する場合は、ここにその名前を入力します。
- データベース名 — 新しく作成されたデータベースの名前
必要な認証タイプを選択します。SQL Server 認証の場合は、この手順で構成された専用 SQL ユーザーの資格情報を提供します。
セットアップを続行します。データベーススキーマとコンポーネントを初期化するには時間がかかります。

2025 年 4 月 07 日

TeamCity オンプレミス 2026.1 ヘルプ