Oracle für Hoster #

Diese Seite ist für Systemadministratoren bei einem Hosting-Anbieter, deren Kunden Exponential auf Oracle betreiben, meist auf einer Datenbank, die der Kunde bereits besitzt. Sie beantwortet: was die Webserver brauchen (PHP oci8 und einen Oracle-Client), was der DBA des Kunden bereitstellen muss, wie die Verbindung konfiguriert wird, welche Einstellungen die Kosten für Verbindungen senken und wie die Datenbank gewartet und gesichert wird. Oracle ist die fünfte in der offiziellen Reihenfolge. Quellen: Datenbankunterstützung und Kapitel 9.6; die vollständige Referenz sind die eigenen Dateien README.md und INSTALL der Erweiterung in extension/ezoracle/.

Inhalt #

1. Was es ist
2. Anforderungen
3. Was der DBA bereitstellt
4. Einstellungen und Installation
5. Persistente Verbindungen und DRCP
6. Wartung und Backups
7. Das eigene Verhalten von Oracle
8. Checkliste
9. Verwandte Seiten

Was es ist #

Die Unterstützung für Oracle kommt von der Erweiterung ezoracle, die composer.json verlangt (~2.3.7); sie liegt daher in jeder Installation in extension/ezoracle. Sie stellt den Treiber eZOracleDB, den Schema-Handler eZOracleSchema, Konsolenbefehle (ext:ezoracle:<name>) und Cronjobs bereit. Sie wird nur für Websites aktiviert, die Oracle nutzen; die Installer aktivieren sie für die neue Website.

Anforderungen #

oci8 selbst kommt von Ihrem Hersteller, aus EPEL oder von Remi. Wenn der Client außerhalb des Bibliothekspfads des Systems liegt, setzen Sie LD_LIBRARY_PATH (und TNS_ADMIN für TNS-Aliase) überall, wo PHP läuft: im PHP-FPM-Pool (env[...]), in der Umgebung von Velocity und in der Cron-Umgebung.

Warnung Ein PHP, das oci8 auf der Kommandozeile lädt, aber nicht im PHP-FPM-Pool (oder umgekehrt), ist das häufigste Oracle-Problem bei einem Hoster. Prüfen Sie auf jedem Server php -m und die Informationsseite des Web-PHP auf oci8.

Was der DBA bereitstellt #

Einen Oracle-Benutzer, der Sitzungen, Tabellen, Views, Trigger, Sequenzen und Prozeduren anlegen darf. Die Erweiterung gibt das SQL für den DBA aus:

ORACLE_NEW_PASSWORD='<a strong password>' php extension/ezoracle/bin/php/ora-grant.php <customer> - USERS

(- nimmt das Passwort aus ORACLE_NEW_PASSWORD, sodass es nicht in der Prozessliste steht; USERS ist der Tablespace.) Dasselbe gibt es als php bin/php/console ext:ezoracle:ora-grant. Für die Befehle zu Zustand und Berichten vergeben Sie außerdem SELECT_CATALOG_ROLE.

Einstellungen und Installation #

[DatabaseSettings]
DatabaseImplementation=ezoracle
User=<customer>
Password=<the password>
# Easy Connect host:port/service_name, a TNS alias or a full descriptor;
# Server and Port are not used by this driver
Database=db.example.com:1521/<service>
Charset=utf-8

[ExtensionSettings]
ActiveExtensions[]=ezoracle

EXP_INSTALL_DB_PASSWORD='<the password>' php bin/php/console exp:install --apply --db=oracle \
    --db-host=db.example.com --db-port=1521 --db-name=<service> --db-user=<customer> --allow-root-user

--db-name ist der Dienstname (Standard FREEPDB1); eine vollständige Verbindungszeichenfolge oder @<tns alias> wird unverändert verwendet. Für den Kickstarter setzen Sie [database_choice] Type=oci8 (oracle wird akzeptiert).

Persistente Verbindungen und DRCP #

Eine neue dedizierte Oracle-Sitzung kostet pro Anfrage einige zehn Millisekunden. Alles über die einfache Verbindung hinaus steht in ezoracle.ini und wird in settings/override/ezoracle.ini.append.php überschrieben; jede Funktion ist standardmäßig aus:

[ConnectionSettings]
Persistent=enabled
DRCP=enabled
ConnectionClass=EXPONENTIAL
KeepAliveInterval=60

• Persistente Verbindungen leben so lange wie der PHP-Prozess; oci8.persistent_timeout, oci8.max_persistent und oci8.ping_interval in php.ini steuern sie.
• DRCP (Database Resident Connection Pooling) teilt einen Pool von Serverprozessen zwischen allen PHP-Prozessen, sodass Hunderte Worker nicht Hunderte dedizierte Serverprozesse brauchen. Der DBA startet den Pool einmal: EXECUTE DBMS_CONNECTION_POOL.START_POOL;.
• Die Reihenfolge der Erweiterungen zählt. Wenn die Einstellungen aus einer Website-Erweiterung statt aus settings/override/ kommen, führen Sie diese Erweiterung in ActiveExtensions[] vor ezoracle auf (Kapitel 9.6).

Den wirksamen Wert prüfen Sie mit php bin/php/console exp:ini get ezoracle.ini/ConnectionSettings/DRCP --allow-root-user.

Wartung und Backups #

Konsolenbefehle (php bin/php/console ext:ezoracle:<name>): health, gather-stats, recompile, purge-recyclebin, sequence-sync, schema-diff, indexes, report, datapump, ci-indexes. Jeder gibt pro Prüfung eine Zeile PASS, WARN, FAIL oder INFO aus. Die Cronjob-Teile ezoracle (nächtlich) und ezoraclehealth (stündlich) führen sie aus, sobald sie in ezoracle.ini [CronjobSettings] aktiviert sind:

15 3 * * *  cd /path/to/installation && php runcronjobs.php -q -s <admin siteaccess> ezoracle
0 * * * *   cd /path/to/installation && php runcronjobs.php -q -s <admin siteaccess> ezoraclehealth

Backups: php bin/php/console ext:ezoracle:datapump (siehe sein --help) oder Oracles expdp; Wiederherstellung mit Oracles impdp. Langsame Anweisungen gehen nach var/log/oracle-slow.log, wenn [LogSettings] SlowQueryThreshold gesetzt ist.

Das eigene Verhalten von Oracle #

Oracle ist nicht in der CI des Projekts; Tests nur für Oracle in der Kernel-Suite werden auf anderen Engines übersprungen (Testabdeckung).

Checkliste #

• To do: Exponential 6.0.15 oder später.
• To do: Oracle 19c oder später in AL32UTF8.
• To do: oci8 im Web-PHP, im PHP der Kommandozeile und im PHP von Velocity geladen, mit den Client-Bibliotheken jeweils auffindbar.
• To do: Der Benutzer aus der Ausgabe von ora-grant.php angelegt; SELECT_CATALOG_ROLE für die Zustandsprüfungen.
• To do: ezoracle für die Website aktiv; persistente Verbindungen und DRCP erwogen.
• To do: Backups mit dem DBA des Kunden vereinbart.

Verwandte Seiten #

• Datenbanken in der offiziellen Reihenfolge
• Datenbankunterstützung: Oracle
• Kapitel 9.6: Oracle 19c und später
• Treiber für SQLite und Oracle
• Datenbank-Backups je Engine
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.