DocumentatieAEM 6.5Handboek

RDBMS-ondersteuning in AEM 6.4 rdbms-support-in-aem

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder

Overzicht overview

Ondersteuning voor relationele databasedruk in AEM wordt geïmplementeerd via Document Microkernel. De Document Microkernel is de basis die ook wordt gebruikt voor de implementatie van MongoDB-persistentie.

Deze API bestaat uit een Java API die is gebaseerd op de API van Mongo Java. Er wordt ook een implementatie van een BlobStore-API geleverd. Standaard worden klodders opgeslagen in de database.

Voor meer informatie over de implementatiedetails, zie RDBDocumentStoreen RDBBlobStoredocumentatie.

NOTE
De steun voor PostgreSQL 9.4 wordt ook verstrekt, maar slechts voor demodoeleinden. Het zal niet beschikbaar voor productiemilieu's zijn.

Ondersteunde databases supported-databases

Voor meer informatie over het niveau van de Relationele steun van het Gegevensbestand in AEM, zie de pagina van Technische Vereisten.

Configuratiestappen configuration-steps

De gegevensopslagruimte wordt gemaakt door de DocumentNodeStoreService OSGi-service te configureren. Naast MongoDB is de toepassing uitgebreid met ondersteuning voor relationele databasepersistentie.

Om het te werken, moet een gegevensbron met AEM worden gevormd. Dit gebeurt via het org.apache.sling.datasource.DataSourceFactory.config -bestand. De bestuurders JDBC voor het respectieve gegevensbestand moeten afzonderlijk als bundels OSGi binnen de lokale configuratie worden verstrekt.

Voor stappen bij het creëren van bundels OSGi voor bestuurders JDBC, zie deze documentatieop de website van Apache Sling.

Nadat de bundels zijn geïnstalleerd, volgt u de onderstaande stappen om AEM te configureren met RDB-persistentie:

  1. Zorg ervoor dat de databasdaemon is gestart en dat u een actieve database hebt voor gebruik met AEM.

  2. Kopieer de AEM 6.3 jar in de installatiemap.

  3. Maak een map met de naam crx-quickstart\install in de installatiemap.

  4. Configureer de opslag van de documentnode door een configuratiebestand met de volgende naam in de map crx-quickstart\install te maken:

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

  5. Configureer de gegevensbron en de JDBC-parameters door een ander configuratiebestand met de volgende naam in de map crx-quickstart\install te maken:

    • org.apache.sling.datasource.DataSourceFactory-oak.config
    note note
    NOTE
    Voor gedetailleerde informatie over de gegevensbronconfiguratie voor elk gesteund gegevensbestand, zie de Opties van de Configuratie van Source van Gegevens.

  6. Bereid daarna de bundels JDBC OSGi voor die met AEM moeten worden gebruikt:

    1. Maak in de map crx-quickstart/install een map met de naam 9 .

    2. Plaats de jar JDBC in de nieuwe omslag.

  7. Start ten slotte AEM met de runmodi crx3 en crx3rdb :

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

Source-configuratieopties voor gegevens data-source-configuration-options

De org.apache.sling.datasource.DataSourceFactory-oak.config configuratie OSGi wordt gebruikt om de parameters te vormen nodig voor communicatie tussen AEM en de laag van de gegevensbestandpersistentie.

De volgende configuratieopties zijn beschikbaar:

  • datasource.name: De naam van de gegevensbron. De standaardwaarde is oak .

  • url: De URL-tekenreeks van de database die moet worden gebruikt met JDBC. Elk databasetype heeft een eigen URL-tekenreeksindeling. Voor meer info, zie {de Formaten van het Koord van 0} URL 🔗 hieronder.

  • driverClassName: De naam van de JDBC-stuurprogrammaklasse. Dit verschilt afhankelijk van de database die u wilt gebruiken en vervolgens van het stuurprogramma dat nodig is om verbinding met de database te maken. Hieronder ziet u de klassenamen voor alle databases die worden ondersteund door AEM:

    • org.postgresql.Driver voor PostSQL;
    • com.ibm.db2.jcc.DB2Driver voor DB2;
    • oracle.jdbc.OracleDriver voor Oracle;
    • com.mysql.jdbc.Driver voor MySQL en MariaDB (experimenteel);
    • c om.microsoft.sqlserver.jdbc.SQLServerDriver voor Microsoft SQL Server (experimenteel).

  • username: De gebruikersnaam waaronder de database wordt uitgevoerd.

  • password: Het databasewachtwoord.

Opmaak URL-tekenreeks url-string-formats

Afhankelijk van het databasetype dat moet worden gebruikt, wordt in de configuratie van de gegevensbron een andere indeling voor de URL-tekenreeks gebruikt. Hieronder volgt een lijst met indelingen voor de databases die momenteel AEM ondersteunen:

  • jdbc:postgresql:databasename voor PostSQL;
  • jdbc:db2://localhost:port/databasename voor DB2;
  • jdbc:oracle:thin:localhost:port:SID voor Oracle;
  • jdbc:mysql://localhost:3306/databasename voor MySQL en MariaDB (experimenteel);
  • jdbc:sqlserver://localhost:1453;databaseName=name voor Microsoft SQL Server (experimenteel).

Bekende beperkingen known-limitations

Hoewel gelijktijdig gebruik van meerdere AEM instanties met één database wordt ondersteund door RDBMS-persistentie, zijn gelijktijdige installaties niet mogelijk.

Als u dit wilt omzeilen, moet u eerst de installatie uitvoeren met één lid en de andere leden toevoegen nadat de eerste installatie is voltooid.

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