文档AEM 6.5用户指南

AEM 6.4中的RDBMS支持 rdbms-support-in-aem

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

概述 overview

使用Document Microkernel实现对AEM中关系数据库持久性的支持。 文档微内核也是用于实现MongoDB持久性的基础。

它包含一个基于Mongo Java API的Java API。 还提供了BlobStore API的实现。 默认情况下，Blob存储在数据库中。

有关实施详细信息的详细信息，请参阅RDBDocumentStore和RDBBlobStore文档。

NOTE
还支持​ PostgreSQL 9.4，但仅用于演示目的。 它将不适用于生产环境。

支持的数据库 supported-databases

有关AEM中关系数据库支持级别的详细信息，请参阅技术要求页。

配置步骤 configuration-steps

通过配置DocumentNodeStoreService OSGi服务创建存储库。 除了MongoDB之外，它还扩展了以支持关系数据库持久性。

数据源需要配置为AEM才能正常工作。 这是通过org.apache.sling.datasource.DataSourceFactory.config文件完成的。 相应数据库的JDBC驱动程序需要作为OSGi捆绑包在本地配置中单独提供。

有关为JDBC驱动程序创建OSGi捆绑包的步骤，请参阅Apache Sling网站上的此文档。

捆绑包准备就绪后，请按照以下步骤使用RDB持久性配置AEM：

  1. 确保数据库守护程序已启动，并且您有一个用于AEM的活动数据库。

  2. 将AEM 6.3 jar复制到安装目录中。

  3. 在安装目录中创建名为crx-quickstart\install的文件夹。

  4. 通过在crx-quickstart\install目录中创建具有以下名称的配置文件来配置文档节点存储：

    • org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config

  5. 通过在crx-quickstart\install文件夹中创建另一个具有以下名称的配置文件来配置数据源和JDBC参数：

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    note note
    NOTE
    有关每个受支持数据库的数据源配置的详细信息，请参阅数据Source配置选项。

  6. 接下来，准备要与AEM一起使用的JDBC OSGi包：

    1. 在crx-quickstart/install文件夹中，创建一个名为9的文件夹。

    2. 将JDBC jar放在新文件夹中。

  7. 最后，使用crx3和crx3rdb运行模式启动AEM：

    code language-java 
    java -jar quickstart.jar -r crx3,crx3rdb

数据Source配置选项 data-source-configuration-options

org.apache.sling.datasource.DataSourceFactory-oak.config OSGi配置用于配置AEM与数据库持久层之间通信所需的参数。

可以使用以下配置选项：

  • datasource.name:数据源名称。 默认为 oak。

  • url:需要与JDBC一起使用的数据库的URL字符串。 每种数据库类型都有自己的URL字符串格式。 有关详细信息，请参阅下面的URL字符串格式。

  • driverClassName: JDBC驱动程序类名。 根据您要使用的数据库以及随后连接到该数据库所需的驱动程序，该选项会有所不同。 以下是AEM支持的所有数据库的类名：

    • PostgreSQL的org.postgresql.Driver；
    • DB2的com.ibm.db2.jcc.DB2Driver；
    • oracle的oracle.jdbc.OracleDriver；
    • MySQL和MariaDB （实验性）的com.mysql.jdbc.Driver；
    • c om.microsoft.sqlserver.jdbc.SQLServerDriver for Microsoft SQL Server（实验性）。

  • username:数据库运行所使用的用户名。

  • password:数据库密码。

URL字符串格式 url-string-formats

数据源配置中会使用不同的URL字符串格式，具体取决于需要使用的数据库类型。 以下是AEM当前支持的数据库格式列表：

  • PostgreSQL的jdbc:postgresql:databasename；
  • DB2的jdbc:db2://localhost:port/databasename；
  • oracle的jdbc:oracle:thin:localhost:port:SID；
  • MySQL和MariaDB （实验性）的jdbc:mysql://localhost:3306/databasename；
  • Microsoft SQL Server的jdbc:sqlserver://localhost:1453;databaseName=name（实验性）。

已知限制 known-limitations

虽然RDBMS持久性支持同时使用具有单个数据库的多个AEM实例，但并不支持并发安装。

要解决此问题，请确保先使用单个成员运行安装，并在第一个成员完成安装后添加其他成员。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2