Oracle mit ezoracle einrichten #

Diese Seite richtet sich an Oracle-Datenbankadministratoren, die ein Schema für eine Exponential-Website vorbereiten. Die Unterstützung für Oracle kommt aus der Erweiterung ezoracle (Version 2.3.7, von composer.json als ~2.3.7 verlangt, daher in extension/ezoracle jeder Installation vorhanden und nur für Websites aktiviert, die Oracle verwenden). Sie liefert den Treiber eZOracleDB, den Schema-Handler eZOracleSchema, Konsolenbefehle und Cronjobs. Diese Seite beantwortet: was erforderlich ist, welche Rechte das Konto braucht, wie Sie sich verbinden und installieren und welche Verhaltensweisen von Oracle wichtig sind. Quellen: 9.6 Oracle 19c und neuer und die eigenen Dateien README.md und INSTALL der Erweiterung in extension/ezoracle/.

Inhalt #

1. Anforderungen
2. Das Konto anlegen
3. Connect-Strings
4. Installieren
5. Die Einstellungen
6. Oracles eigene Verhaltensweisen
7. Checkliste

Anforderungen #

• Exponential 6.0.15 oder neuer; frühere Versionen bieten Oracle in den Installern nicht an.
• Oracle Database 19c oder neuer; der Assistent prüft 19.0. Der Treiber verwendet STANDARD_HASH und OFFSET/FETCH. Getestet mit Oracle AI Database 26ai Free (23.26). Die Unterstützungsaussage des Projekts nennt 19c als Minimum (Datenbankunterstützung); das README.md der Erweiterung beschreibt einen Ausweichweg für 11.2 und 12.1, der nur durch ihre Unit-Tests abgedeckt ist. Planen Sie mit 19c.
• Datenbankzeichensatz AL32UTF8. Der Treiber verbindet sich in AL32UTF8; NLS_LANG wird nicht gebraucht.
• PHP 8.0 bis 8.5 mit oci8 (PECL oci8 3.4 für PHP 8.4 und 8.5, 3.2 für 8.1 bis 8.3), gegen einen Oracle-Client gebaut; der Instant Client genügt (PHP-Erweiterungen je Engine).
• Oracle ist nicht in der CI des Projekts; reine Oracle-Kernel-Tests werden auf anderen Engines übersprungen. Testen Sie Upgrades auf einer Staging-Kopie.

Das Konto anlegen #

Das Konto darf Sessions, Tabellen, Views, Trigger, Sequenzen und Prozeduren anlegen. Die Erweiterung gibt das SQL aus, das ein DBA ausführt:

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

- nimmt das Passwort aus ORACLE_NEW_PASSWORD, sodass es nicht in der Prozessliste erscheint; USERS ist der Tablespace. Dasselbe steht als php bin/php/console ext:ezoracle:ora-grant zur Verfügung. Lesen Sie das ausgegebene SQL und führen Sie es dann als DBA aus. Für die Befehle health und report vergeben Sie zusätzlich SELECT_CATALOG_ROLE: Sie lesen V$-Views, und ohne die Rolle sagen die betroffenen Prüfungen das.

Connect-Strings #

site.ini [DatabaseSettings] Database ist der Connect-String; Server und Port verwendet dieser Treiber nicht. Er kann sein:

• Easy Connect: 127.0.0.1:1521/FREEPDB1;
• Easy Connect Plus: tcp://host:port/service?connect_timeout=5;
• ein TNS-Alias (mit TNS_ADMIN für jeden Prozess gesetzt);
• ein vollständiger (DESCRIPTION=...)-Deskriptor.

ezoracle.ini [ConnectionSettings] kann stattdessen einen Deskriptor über mehrere Listener bauen (Oracle: persistente Verbindungen, DRCP und Tuning).

Installieren #

EXP_INSTALL_DB_PASSWORD='<the password>' php bin/php/console exp:install --apply --db=oracle \
    --db-host=127.0.0.1 --db-port=1521 --db-name=FREEPDB1 --db-user=exponential --allow-root-user

--db-name ist der Service-Name (Standard FREEPDB1); daraus wird host:port/service gebaut. Ein vollständiger Connect-String oder @<tns alias> wird so verwendet, wie er angegeben ist. --db=oci8 und --db=ezoracle werden ebenfalls akzeptiert. Die Installer aktivieren die Erweiterung für die neue Website. Im Einrichtungsassistenten erscheint Oracle, wenn oci8 geladen und extension/ezoracle vorhanden ist. Für den Kickstarter setzen Sie [database_choice] Type=oci8 und den Connect-String als Database.

Die Einstellungen #

[DatabaseSettings]
DatabaseImplementation=ezoracle
User=exponential
Password=<the password>
Database=127.0.0.1:1521/FREEPDB1
Charset=utf-8
# Oracle stores '' as NULL; enabled returns '' for NULL in text columns
OracleEmptyStringForNull=disabled
# enabled: ALTER SESSION SET NLS_COMP=LINGUISTIC NLS_SORT=<sort>
OracleCaseInsensitive=disabled
OracleCaseInsensitiveSort=BINARY_CI

[ExtensionSettings]
ActiveExtensions[]=ezoracle

Oracles eigene Verhaltensweisen #

Der Treiber führt bei jedem Verbinden ein ALTER SESSION SET aus (Zahlenformat, Längensemantik, CURSOR_SHARING und die NLS-Einstellungen, wenn OracleCaseInsensitive eingeschaltet ist); unter Der SQL-Abfrage-Cache steht, wie er diese Anweisung behandelt.

Checkliste #

• To do: Oracle 19c oder neuer, Zeichensatz AL32UTF8.
• To do: oci8 in jedem PHP geladen, das die Website verwendet; Client-Bibliotheken werden von PHP-FPM, Velocity und Cron gefunden.
• To do: Das Konto hat die Rechte aus ora-grant.php und für Gesundheitsberichte SELECT_CATALOG_ROLE.
• To do: ezoracle steht in ActiveExtensions[].
• To do: Entscheidungen zu OracleEmptyStringForNull und OracleCaseInsensitive getroffen.
• To do: Sicherungen mit Data Pump eingeplant (Sicherungen je Engine).

Verwandte Seiten #

• Oracle: persistente Verbindungen, DRCP und Tuning
• Wartungsbefehle und Cronjobs für Oracle
• Oracle für Hoster
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.