Prise en charge RDBMS dans AEM 6.4 rdbms-support-in-aem
Présentation overview
La prise en charge de la persistance de la base de données relationnelle dans AEM est mise en oeuvre à l’aide de Document Microkernel. Document Microkernel est la base qui est également utilisée pour mettre en oeuvre la persistance de MongoDB.
Il se compose d’une API Java basée sur l’API Java Mongo. Une implémentation d’une API BlobStore est également fournie. Par défaut, les blobs sont stockés dans la base de données.
Pour plus d’informations sur les détails de mise en oeuvre, voir la section RDBDocumentStore et RDBBlobStore la documentation.
Bases de données prises en charge supported-databases
Pour plus d’informations sur le niveau de prise en charge de la base de données relationnelle dans AEM, voir la section Page Exigences techniques.
Étapes de configuration configuration-steps
Le référentiel est créé lors de la configuration du service OSGi DocumentNodeStoreService
. Il a été étendu pour prendre en charge la persistance de la base de données relationnelle en plus de MongoDB.
Pour qu’elle fonctionne, une source de données doit être configurée avec AEM. Cela s’effectue via le fichier org.apache.sling.datasource.DataSourceFactory.config
. Les pilotes JDBC pour les bases de données respectives doivent être fournis séparément en tant que lots OSGi dans la configuration locale.
Pour obtenir des instructions sur la création de lots OSGi pour les pilotes JDBC, voir ceci documentation sur le site web Apache Sling.
Une fois les lots en place, suivez les étapes ci-dessous pour configurer AEM avec la persistance RDB :
-
Assurez-vous que la base de données daemon est lancée et que votre base de données est active et prête à être utilisée avec AEM.
-
Copiez le jar AEM 6.3 dans le répertoire de l’installation.
-
Créez un dossier nommé
crx-quickstart\install
dans le répertoire de l’installation. -
Configurez l’entrepôt de nœud de document en créant un fichier de configuration avec le nom suivante dans le répertoire
crx-quickstart\install
:org.apache.jackrabbit.oak.plugins.document.DocumentNodeStoreService.config
-
Configurez la source de données et les paramètres JDBC en créant un autre fichier de configuration avec le nom suivant dans le dossier
crx-quickstart\install
:org.apache.sling.datasource.DataSourceFactory-oak.config
note note NOTE Pour plus d’informations sur la configuration de chaque base de données prise en charge, consultez les Options de configuration de la source de données. -
Ensuite, préparez les lots OSGi JDBC à utiliser avec AEM :
-
Dans le fichier
crx-quickstart/install
, créez un dossier nommé9
. -
Placez le jar JDBC dans le nouveau dossier.
-
-
Enfin, lancez AEM avec les modes d’exécution
crx3
etcrx3rdb
:code language-java java -jar quickstart.jar -r crx3,crx3rdb
Options de configuration des sources de données data-source-configuration-options
La configuration OSGi de org.apache.sling.datasource.DataSourceFactory-oak.config
sert à configurer les paramètres nécessaires pour établir la communication entre AEM et la couche de persistance de la base de données.
Les options de configuration suivantes sont disponibles :
-
datasource.name:
Le nom de la source de données. La valeur par défaut estoak
. -
url:
La chaîne URL de la base de données qui doit être utilisée avec JDBC. Chaque type de base de données est doté de son propre format de chaîne d’URL. Pour plus d’informations, reportez-vous à la section Formats de chaîne d’URL ci-dessous. -
driverClassName:
Le nom de classe du pilote JDBC. Cela varie en fonction de la base de données que vous souhaitez utiliser et du pilote nécessaire pour s’y connecter. Vous trouverez ci-dessous les noms de classe pour toutes les bases de données prises en charge par AEM :org.postgresql.Driver
pour PostgreSQLcom.ibm.db2.jcc.DB2Driver
pour DB2oracle.jdbc.OracleDriver
pour Oraclecom.mysql.jdbc.Driver
pour MySQL et MariaDB (stade expérimental)- c
om.microsoft.sqlserver.jdbc.SQLServerDriver
pour Microsoft SQL Server (stade expérimental)
-
username:
Le nom d’utilisateur avec lequel la base de données est exécutée. -
password:
Mot de passe de la base de données.
Formats de chaîne d’URL url-string-formats
Un format de chaîne URL différent est utilisé dans la configuration de la source de données en fonction du type de base de données à utiliser. Vous trouverez ci-dessous une liste de formats pour les bases de données actuellement prises en charge par AEM :
jdbc:postgresql:databasename
pour PostgreSQLjdbc:db2://localhost:port/databasename
pour DB2jdbc:oracle:thin:localhost:port:SID
pour Oraclejdbc:mysql://localhost:3306/databasename
pour MySQL et MariaDB (stade expérimental)jdbc:sqlserver://localhost:1453;databaseName=name
pour Microsoft SQL Server (stade expérimental)
Limites connues known-limitations
Bien que l’utilisation simultanée de plusieurs instances d’AEM avec une seule base de données soit prise en charge par la persistance du SGBDR, les installations simultanées ne le sont pas.
Pour contourner ce problème, assurez-vous d’exécuter d’abord l’installation avec un seul membre et d’ajouter les autres à la fin de l’installation.