DocumentaciónAEM 6.5Guía del usuario

AEM Compatibilidad con RDBMS en 6.4 rdbms-support-in-aem

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Admin

Información general overview

AEM La compatibilidad con la persistencia de bases de datos relacionales en la base de datos se implementa mediante el Microkernel de documentos. El Microkernel del documento es la base que también se utiliza para implementar la persistencia de MongoDB.

Consiste en una API de Java basada en la API de Java de Mongo. También se proporciona una implementación de una API de BlobStore. De forma predeterminada, los blobs se almacenan en la base de datos.

Para obtener más información sobre los detalles de la implementación, consulte la RDBDocumentStore y RDBBlobStore documentación.

NOTE
Compatibilidad con PostgreSQL 9.4 también se proporciona, pero solo para fines de demostración. No estará disponible para entornos de producción.

Bases de datos compatibles supported-databases

AEM Para obtener más información sobre el nivel de compatibilidad de la base de datos relacional en el ámbito de la, consulte la Página de requisitos técnicos.

Pasos de configuración configuration-steps

El repositorio se crea configurando la variable DocumentNodeStoreService Servicio OSGi. Se ha ampliado para admitir la persistencia de bases de datos relacionales, además de MongoDB.

AEM Para que funcione, es necesario configurar una fuente de datos con la opción de configuración de la fuente de datos de la aplicación de forma. Esto se realiza mediante la variable org.apache.sling.datasource.DataSourceFactory.config archivo. Los controladores JDBC para la base de datos correspondiente deben proporcionarse por separado como paquetes OSGi dentro de la configuración local.

Para ver los pasos sobre la creación de paquetes OSGi para controladores JDBC, consulte esto documentación en el sitio web de Apache Sling.

AEM Una vez que los paquetes estén en su lugar, siga los siguientes pasos para configurar la con persistencia de RDB:

  1. AEM Asegúrese de que se ha iniciado el daemon de base de datos y de que dispone de una base de datos activa para su uso con el servicio de base de datos de.

  2. AEM Copie el JAR de la versión 6.3 de la en el directorio de instalación.

  3. Cree una carpeta llamada crx-quickstart\install en el directorio de instalación.

  4. Configure el almacén de nodos del documento creando un archivo de configuración con el siguiente nombre en la crx-quickstart\install directorio:

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

  5. Configure la fuente de datos y los parámetros JDBC creando otro archivo de configuración con el siguiente nombre en la crx-quickstart\install carpeta:

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    note note
    NOTE
    Para obtener información detallada sobre la configuración de la fuente de datos de cada base de datos admitida, consulte Opciones de configuración de fuente de datos.

  6. AEM A continuación, prepare los paquetes OSGi de JDBC que se van a utilizar con la:

    1. En el crx-quickstart/install carpeta, cree una carpeta llamada 9.

    2. Coloque el JDBC jar en la nueva carpeta.

  7. AEM Por último, comience por la crx3 y crx3rdb modos de ejecución:

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

Opciones de configuración de fuente de datos data-source-configuration-options

El org.apache.sling.datasource.DataSourceFactory-oak.config AEM La configuración de OSGi se utiliza para configurar los parámetros necesarios para la comunicación entre el nivel de persistencia de la base de datos y el nivel de persistencia de la base de datos.

Estas son las opciones de configuración disponibles:

  • datasource.name: Nombre de la fuente de datos. El valor predeterminado es oak.

  • url: Cadena URL de la base de datos que debe utilizarse con JDBC. Cada tipo de base de datos tiene su propio formato de cadena de URL. Para obtener más información, consulte Formatos de cadena de URL más abajo.

  • driverClassName: El nombre de clase del controlador JDBC. Esto variará según la base de datos que desee utilizar y, posteriormente, el controlador necesario para conectarse a ella. AEM A continuación, se muestran los nombres de clase de todas las bases de datos compatibles con el servicio de bases de datos de:

    • org.postgresql.Driver para PostgreSQL;
    • com.ibm.db2.jcc.DB2Driver para DB2;
    • oracle.jdbc.OracleDriver para el Oracle;
    • com.mysql.jdbc.Driver para MySQL y MariaDB (experimental);
    • c om.microsoft.sqlserver.jdbc.SQLServerDriver para Microsoft SQL Server (experimental).

  • username: El nombre de usuario con el que se ejecuta la base de datos.

  • password: Contraseña de la base de datos.

Formatos de cadena de URL url-string-formats

En la configuración de la fuente de datos se utiliza un formato de cadena de URL diferente en función del tipo de base de datos que se deba utilizar. AEM A continuación se muestra una lista de formatos para las bases de datos que admite actualmente el sistema de bases de datos de que se dispone en la actualidad:

  • jdbc:postgresql:databasename para PostgreSQL;
  • jdbc:db2://localhost:port/databasename para DB2;
  • jdbc:oracle:thin:localhost:port:SID para el Oracle;
  • jdbc:mysql://localhost:3306/databasename para MySQL y MariaDB (experimental);
  • jdbc:sqlserver://localhost:1453;databaseName=name para Microsoft SQL Server (experimental).

Limitaciones conocidas known-limitations

AEM Aunque la persistencia de RDBMS admite el uso simultáneo de varias instancias de con una sola base de datos, las instalaciones simultáneas no lo son.

Para solucionar esto, asegúrese de ejecutar primero la instalación con un solo miembro y agregue los demás después de que el primero haya finalizado la instalación.

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