AEM 6.4 の RDBMS サポート rdbms-support-in-aem
概要 overview
AEMでのリレーショナルデータベース永続性のサポートは、Document Microkernel を使用して実装されます。 Document Microkernel は、MongoDB 永続性の実装にも使用される基盤です。
これは、Mongo Java API をベースとする Java API で構成されます。 BlobStore API の実装も提供されます。 デフォルトでは、BLOB はデータベースに保存されます。
実装の詳細について詳しくは、 RDBDocumentStore および RDBBlobStore ドキュメント。
サポートされるデータベース supported-databases
AEMでのリレーショナル・データベースのサポート・レベルの詳細は、 技術要件ページ.
設定手順 configuration-steps
リポジトリは、DocumentNodeStoreService
OSGi サービスを設定することで作成されます。このサービスは、MongoDB に加えてリレーショナルデータベース永続性もサポートするように拡張されています。
このサービスが動作するためには、AEM でデータソースを設定する必要があります。この設定は、org.apache.sling.datasource.DataSourceFactory.config
ファイルを通して行われます。ローカル設定内の OSGi バンドルとは別に、対応するデータベースの JDBC ドライバを指定する必要があります。
JDBC ドライバー用の OSGi バンドルの作成手順については、次を参照してください。 ドキュメント を Apache Sling Web サイトにコピーします。
バンドルを配置したら、次の手順に従って RDB 永続性を使用してAEMを設定します。
-
データベースのデーモンが起動しており、AEM で使用するためのアクティブなデータベースがあることを確認します。
-
AEM 6.3 jar をインストールディレクトリにコピーします。
-
インストールディレクトリ内に
crx-quickstart\install
というフォルダーを作成します。 -
ドキュメントノードストアを設定するために、この
crx-quickstart\install
ディレクトリ内に、次の名前の設定ファイルを作成します。org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
-
データソースと JDBC パラメーターを設定するために、この
crx-quickstart\install
フォルダー内に、また別の次の名前の設定ファイルを作成します。org.apache.sling.datasource.DataSourceFactory-oak.config
note note NOTE サポートされているそれぞれのデータベースに関するデータソース設定について詳しくは、データソース設定オプションを参照してください。 -
次に、AEM で使用する JDBC OSGi バンドルを準備します。
-
crx-quickstart/install
フォルダーで、9
という名前のフォルダーを作成します。 -
この新しいフォルダー内に JDBC jar を配置します。
-
-
最後に、
crx3
およびcrx3rdb
実行モードで AEM を起動します。code language-java java -jar quickstart.jar -r crx3,crx3rdb
データソース設定オプション data-source-configuration-options
AEM とデータベース永続性レイヤー間の通信のために必要になるパラメーターの設定には、org.apache.sling.datasource.DataSourceFactory-oak.config
OSGi 設定を使用します。
以下の設定オプションを使用できます。
-
datasource.name:
データソース名。デフォルトは、oak
です。 -
url:
JDBC で使用する必要のあるデータベースの URL 文字列。データベースタイプごとに独自の URL 文字列の形式が設定されています。詳しくは、後述の URL 文字列の形式を参照してください。 -
driverClassName:
JDBC ドライバーのクラス名。これは、使用するデータベースと、その後接続に必要なドライバーによって異なります。AEM でサポートされるすべてのデータベースのクラス名を次に示します。org.postgresql.Driver
(PostgreSQL の場合)com.ibm.db2.jcc.DB2Driver
(DB2 用の場合)oracle.jdbc.OracleDriver
(Oracle の場合)com.mysql.jdbc.Driver
(MySQL および MariaDB、試行用)- c
om.microsoft.sqlserver.jdbc.SQLServerDriver
(Microsoft SQL Server の場合)(試行用)
-
username:
データベースを実行するユーザー名。 -
password:
データベースのパスワード。
URL 文字列形式 url-string-formats
データソースの設定では、使用する必要のあるデータベースタイプに応じて、異なる URL 文字列形式が使用されます。 AEMが現在サポートしているデータベースの形式の一覧を次に示します。
jdbc:postgresql:databasename
(PostgreSQL の場合)jdbc:db2://localhost:port/databasename
(DB2 用の場合)jdbc:oracle:thin:localhost:port:SID
(Oracle の場合)jdbc:mysql://localhost:3306/databasename
(MySQL および MariaDB、試行用)jdbc:sqlserver://localhost:1453;databaseName=name
(Microsoft SQL Server の場合)(試行用)
既知の制限事項 known-limitations
単一のデータベースを持つ複数のAEMインスタンスの同時使用は RDBMS の永続性でサポートされますが、同時インストールはサポートされません。
この制限を回避するには、まず 1 つのメンバーでインストールを実行し、最初のインストールが完了した後で、他のメンバーを追加します。