SQL Server データベースセットアップ

このページでは、Microsoft SQL Server データベースを利用する場合の Confluence の設定に関して説明します。

始める前に

始める前に、以下の内容を確認します:

  • ご使用の SQL Server のバージョンがサポート対象であるかどうかについては、「サポート対象プラットフォーム」を参照してください。Confluence をインストールする前にデータベースのアップグレードが必要になる場合があります。
  • 別のデータベース (組み込みの評価データベースを含む) から切り替える場合、「別のデータベースへの移行」をお読みください。

1. SQL Server をインストールする

Microsoft SQL Server がインストールされていない場合、ダウンロードしてインストールします。手順については、MSDN の「SQL Server のインストール」を参照してください。

認証モードについて...

SQL Server では、SQL Server 認証と Windows 認証の 2 種類の認証を使用できます。Confluence がお使いのデータベースに接続できるようにするには、SQL Server で 混合認証 (SQL Server と Windows モードの両方) を許可するように設定する必要があります。この設定は一般的、[プロパティ] > [セキュリティ] > [サーバー認証] にあります。


2. データベースとデータベース ユーザーを作成する

SQL Server をインストールしたら、次のように、Confluence 用のデータベース ユーザーとデータベースを作成します。

  1. SQL の管理者権限を使用し、新しいデータベース (例: confluence) を作成します。
  2. データベースの既定の照合順序を SQL_Latin1_General_CP1_CS_AS (大文字と小文字を区別) に設定します。  

    ALTER DATABASE <database-name> COLLATE SQL_Latin1_General_CP1_CS_AS

    "database could not be exclusively locked to perform the operation" エラーが表示された場合は、データベースをシングル ユーザー モードに変更して他のユーザーからの接続を拒否する必要がある場合があります。

    ALTER DATABASE <database-name> SET SINGLE_USER WITH ROLLBACK IMMEDIATE;
    <your ALTER DATABASE query>
    ALTER DATABASE <database-name> SET MULTI_USER;
  3. READ_COMMITTED_SNAPSHOT のデータベース分離レベルが ON になっていることを確認します。  

    SELECT is_read_committed_snapshot_on FROM
    sys.databases WHERE name= 'database-name' 

    このクエリが 1 を返した場合、 READ_COMMITTED_SNAPSHOT は ON になっており、先へ進むことができます。

    このクエリが 0 を返した場合、READ_COMMITTED_SNAPSHOT オプションは OFF になっており、次のようにオンにする必要があります。

    ALTER DATABASE <database-name>
       SET READ_COMMITTED_SNAPSHOT ON
       WITH ROLLBACK IMMEDIATE;
  4. SQL の管理者権限を使用し、Confluence 用の新しい SQL ユーザー アカウント (例: confluenceuser) を作成します。 

  5. このユーザーに既定のスキーマを指定するには、次の手順に従います。

    ALTER USER <confluenceuser> WITH DEFAULT_SCHEMA = dbo
  6. このユーザーが、データベース テーブルの作成、読み取り、書き込みに関する完全な権限を持っていることをご確認ください。Confluence が独自のスキーマを作成できて、トリガーと関数の作成/ドロップを行える必要があります。詳細については、SQL Server のドキュメントをご参照ください。

3. Confluence のインストール 

お使いのオペレーティング システムに Confluence をインストールするための詳細な手順については、Confluence インストール ガイドを確認してください。 

4. データベースの詳細を入力する

Confluence セットアップ ウィザードを利用して、お使いのデータベースに Confluence を接続できます。 

JDBC 接続を使用する (既定)

データベースへの接続には JDBC の使用を推奨します。

Confluence セットアップ ウィザードは 2 つのセットアップ オプションを提供します。

  • シンプル - 最も簡単にデータベースに接続する方法です。
  • 接続文字列を使用 - 追加パラメーターを指定する必要があり、データベース URL の作成に慣れている場合は、このオプションを使用します。 

セットアップ タイプに応じて、次の情報を求めるプロンプトが表示されます。

セットアップ タイプフィールド説明
simple ホスト名データベース サーバーのホスト名または IP アドレス。  
simple ポートSQL Server のポートです。SQL Server をインストールした際にポートを変更していなければ、既定の 1433 になります。
simpleデータベース名 Confluence データベースの名前 (上記の例では confluence)。
simpleインスタンス名

インスタンス名を見つけるには、データベースへ接続して次のいずれかを実行します。

select @@SERVICENAME;
SELECT SERVERPROPERTY('InstanceName');

SQL Server 内にデフォルト名のインスタンス セットアップがある場合、このパラメーターを指定する必要はありません。

接続文字列を使用データベース URLデータベース URL は次の形式で入力されます。
jdbc:sqlserver://<hostname>:<port>;databaseName=<database>

例:  
jdbc:sqlserver://yourserver:1433;databaseName=confluence

両方ユーザ名専用データベース ユーザーのユーザー名 (上記の例では confluenceuser)。
両方パスワード専用データベース ユーザーのパスワードです。

5. データベース接続のテスト

データベースのセットアップ画面で [テスト接続] ボタンをクリックすると、次の点をチェックできます。

  • Confluence データベースがご利用のデータベース サーバーに接続できること
  • データベースの照合順序と分離レベルが正しいこと
  • データベース ユーザーがデータベースに対する適切な権限を持っていること

テストが成功したら、[次へ] をクリックして Confluence のセットアップ プロセスを続行します。 

データベース ドライバの変更

Confluence 6.6 で、Microsoft SQL Server 用のオープンソースの jTDS ドライバーを、公式の Microsoft JDBC Driver for SQL Server に変更しました。6.6 以降にアップグレードすると、新しいドライバに自動的に移行されます。  

何らかの理由で自動移行に失敗する場合、この変更を手動で行う必要があります。「Confluence 6.4 以降で jTDS ドライバからサポートされている Microsoft SQL Server ドライバへ移行する」を参照してください。  

トラブルシューティング

  • 次のエラー メッセージが表示された場合は、localhost から接続する際に必要となる全てのデータベース権限を confluenceuser ユーザーに付与したかどうかを確認します。

    Could not successfully test your database: : Server connection failure during transaction. Due to underlying exception: 'java.sql.SQLException: Access denied for user 'confluenceuser'@'localhost' (using password: YES)'
最終更新日 2023 年 5 月 22 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.