diff --git a/reference/cubrid/constants.xml b/reference/cubrid/constants.xml new file mode 100644 index 000000000..1cc9492ff --- /dev/null +++ b/reference/cubrid/constants.xml @@ -0,0 +1,402 @@ + + + + + + &reftitle.constants; + &extension.constants; + + Die folgenden Konstanten können beim Ausführen einer SQL-Anweisung verwendet + werden. Sie können an cubrid_prepare und + cubrid_execute übergeben werden. + + CUBRID-Flags für die SQL-Ausführung + + + + Konstante + Beschreibung + + + + + CUBRID_INCLUDE_OID + Legt fest, ob während der Abfrageausführung die OID ermittelt werden soll. + + + CUBRID_ASYNC + Führt die Abfrage im asynchronen Modus aus. + + + CUBRID_EXEC_QUERY_ALL + Führt die Abfrage im synchronen Modus aus. Dieses Flag muss + gesetzt werden, wenn mehrere SQL-Anweisungen ausgeführt werden. + + + +
+ + + + Die folgenden Konstanten können beim Abrufen der Ergebnisse verwendet werden, + um das Abrufverhalten festzulegen. Sie können an + cubrid_fetch und + cubrid_fetch_array übergeben werden. + + CUBRID-Flags für das Abrufen + + + + Konstante + Beschreibung + + + + + CUBRID_NUM + Ruft das Abfrageergebnis als numerisches Array ab (0-Standard). + + + CUBRID_ASSOC + Ruft das Abfrageergebnis als assoziatives Array ab. + + + CUBRID_BOTH + Ruft das Abfrageergebnis sowohl als numerisches als auch als assoziatives Array ab (Standardwert). + + + CUBRID_OBJECT + Ruft das Abfrageergebnis als Objekt ab. + + + CUBRID_LOB + Die Konstante CUBRID_LOB kann verwendet werden, wenn Sie mit dem + LOB-Objekt arbeiten möchten. Sie kann an + cubrid_fetch, + cubrid_fetch_row, + cubrid_fetch_array, + cubrid_fetch_assoc und + cubrid_fetch_object übergeben werden. + + + +
+ + + + Die folgenden Konstanten können beim Positionieren des Cursors in + Abfrageergebnissen verwendet werden. Sie können an + cubrid_move_cursor übergeben oder von dieser Funktion + zurückgegeben werden. + + CUBRID-Flags für die Cursorposition + + + + Konstante + Beschreibung + + + + + CUBRID_CURSOR_FIRST + Bewegt den aktuellen Cursor an die erste Position im Ergebnis. + + + CUBRID_CURSOR_CURRENT + Bewegt den aktuellen Cursor als Standardwert, wenn der Ursprung nicht angegeben ist. + + + CUBRID_CURSOR_LAST + Bewegt den aktuellen Cursor an die letzte Position im Ergebnis. + + + CUBRID_CURSOR_SUCCESS + Rückgabewert der Funktion cubrid_move_cursor + im Erfolgsfall. Dieses Flag wurde ab 8.4.1 entfernt. + + + CUBRID_NO_MORE_DATA + Rückgabewert der Funktion cubrid_move_cursor + im Fehlerfall. Dieses Flag wurde ab 8.4.1 entfernt. + + + CUBRID_CURSOR_ERROR + Rückgabewert der Funktion cubrid_move_cursor + im Fehlerfall. Dieses Flag wurde ab 8.4.1 entfernt. + + + +
+ + + + Die folgenden Konstanten können beim Festlegen des Auto-Commit-Modus für die + Datenbankverbindung verwendet werden. Sie können an + cubrid_set_autocommit übergeben oder von + cubrid_get_autocommit zurückgegeben werden. + + CUBRID-Flags für den Auto-Commit-Modus + + + + Konstante + Beschreibung + + + + + CUBRID_AUTOCOMMIT_TRUE + Aktiviert den Auto-Commit-Modus. + + + CUBRID_AUTOCOMMIT_FALSE + Deaktiviert den Auto-Commit-Modus. + + + +
+ + + + Die folgenden Konstanten können beim Festlegen des Datenbankparameters + verwendet werden. Sie können an + cubrid_set_db_parameter übergeben werden. + + CUBRID-Parameter-Flags + + + + Konstante + Beschreibung + + + + + CUBRID_PARAM_ISOLATION_LEVEL + Transaktionsisolationsgrad für die Datenbankverbindung. + + + CUBRID_PARAM_LOCK_TIMEOUT + Transaktions-Timeout in Sekunden. + + + +
+ + + + Die folgenden Konstanten können beim Festlegen des + Transaktionsisolationsgrads verwendet werden. Sie können an + cubrid_set_db_parameter übergeben oder von + cubrid_get_db_parameter zurückgegeben werden. + + CUBRID-Flags für den Isolationsgrad + + + + Konstante + Beschreibung + + + + + TRAN_COMMIT_CLASS_UNCOMMIT_INSTANCE + Der niedrigste Isolationsgrad (1). Für das Tupel kann ein Dirty + Read, Non-Repeatable Read oder Phantom Read auftreten, und für die + Tabelle kann ebenfalls ein Non-Repeatable Read auftreten. + + + TRAN_COMMIT_CLASS_COMMIT_INSTANCE + Ein relativ niedriger Isolationsgrad (2). Ein Dirty Read tritt + nicht auf, aber ein Non-Repeatable Read oder Phantom Read kann + auftreten. + + + TRAN_REP_CLASS_UNCOMMIT_INSTANCE + Die Standardisolation von CUBRID (3). Für das Tupel kann ein + Dirty Read, Non-Repeatable Read oder Phantom Read auftreten, aber für + die Tabelle ist ein Repeatable Read gewährleistet. + + + TRAN_REP_CLASS_COMMIT_INSTANCE + Ein relativ niedriger Isolationsgrad (4). Ein Dirty Read tritt + nicht auf, aber ein Non-Repeatable Read oder Phantom Read kann. + + + TRAN_REP_CLASS_REP_INSTANCE + Ein relativ hoher Isolationsgrad (5). Ein Dirty Read oder + Non-Repeatable Read tritt nicht auf, aber ein Phantom Read kann. + + + TRAN_SERIALIZABLE + Der höchste Isolationsgrad (6). Probleme im Zusammenhang mit der + Nebenläufigkeit (z. B. Dirty Read, Non-Repeatable Read, Phantom Read + usw.) treten nicht auf. + + + +
+ + + + Die folgenden Konstanten können beim Abrufen von Schemainformationen + verwendet werden. Sie können an cubrid_schema übergeben + werden. + + CUBRID-Schema-Flags + + + + Konstante + Beschreibung + + + + + CUBRID_SCH_CLASS + Ruft den Namen und Typ einer Tabelle in CUBRID ab. + + + CUBRID_SCH_VCLASS + Ruft den Namen und Typ einer Sicht in CUBRID ab. + + + CUBRID_SCH_QUERY_SPEC + Ruft die Abfragedefinition einer Sicht ab. + + + CUBRID_SCH_ATTRIBUTE + Ruft die Attribute einer Tabellenspalte ab. + + + CUBRID_SCH_CLASS_ATTRIBUTE + Ruft die Attribute einer Tabelle ab. + + + CUBRID_SCH_METHOD + Ruft die Instanzmethode ab. Die Instanzmethode ist eine Methode, + die von einer Klasseninstanz aufgerufen wird. Sie wird häufiger + verwendet als die Klassenmethode, da die meisten Operationen in der + Instanz ausgeführt werden. + + + CUBRID_SCH_CLASS_METHOD + Ruft die Klassenmethode ab. Die Klassenmethode ist eine Methode, + die von einem Klassenobjekt aufgerufen wird. Sie wird üblicherweise + verwendet, um eine neue Klasseninstanz zu erstellen oder zu + initialisieren. Sie wird auch verwendet, um auf Klassenattribute + zuzugreifen oder diese zu aktualisieren. + + + CUBRID_SCH_METHOD_FILE + Ruft die Informationen der Datei ab, in der die Methode der + Tabelle definiert ist. + + + CUBRID_SCH_SUPERCLASS + Ruft den Namen und Typ der Tabelle ab, von der eine Tabelle + Attribute erbt. + + + CUBRID_SCH_SUBCLASS + Ruft den Namen und Typ der Tabelle ab, die Attribute von dieser + Tabelle erbt. + + + CUBRID_SCH_CONSTRAINT + Ruft die Tabellenbeschränkungen ab. + + + CUBRID_SCH_TRIGGER + Ruft die Tabellentrigger ab. + + + CUBRID_SCH_CLASS_PRIVILEGE + Ruft die Berechtigungsinformationen einer Tabelle ab. + + + CUBRID_SCH_ATTR_PRIVILEGE + Ruft die Berechtigungsinformationen einer Spalte ab. + + + CUBRID_SCH_DIRECT_SUPER_CLASS + Ruft die direkte übergeordnete Tabelle einer Tabelle ab. + + + CUBRID_SCH_PRIMARY_KEY + Ruft den Primärschlüssel einer Tabelle ab. + + + CUBRID_SCH_IMPORTED_KEYS + Ruft die importierten Schlüssel einer Tabelle ab. + + + CUBRID_SCH_EXPORTED_KEYS + Ruft die exportierten Schlüssel einer Tabelle ab. + + + CUBRID_SCH_CROSS_REFERENCE + Ruft die Referenzbeziehung zweier Tabellen ab. + + + +
+ + + + Die folgenden Konstanten können beim Melden von Fehlern verwendet werden. Sie + können von cubrid_error_code_facility zurückgegeben + werden. + + CUBRID-Fehlerquellencode + + + + Konstante + Beschreibung + + + + + CUBRID_FACILITY_DBMS + Der Fehler ist im CUBRID-DBMS aufgetreten. + + + CUBRID_FACILITY_CAS + Der Fehler ist im CUBRID-Broker-CAS aufgetreten. + + + CUBRID_FACILITY_CCI + Der Fehler ist im CUBRID-CCI aufgetreten. + + + CUBRID_FACILITY_CLIENT + Der Fehler ist im CUBRID-PHP-Client aufgetreten. + + + +
+ + + + diff --git a/reference/cubrid/functions/cubrid-connect-with-url.xml b/reference/cubrid/functions/cubrid-connect-with-url.xml new file mode 100644 index 000000000..05d70acaa --- /dev/null +++ b/reference/cubrid/functions/cubrid-connect-with-url.xml @@ -0,0 +1,250 @@ + + + + + + cubrid_connect_with_url + Bereitet die Umgebung für die Verbindung zu einem CUBRID-Server vor + + + + &reftitle.description; + + resourcecubrid_connect_with_url + stringconn_url + stringuserid + stringpasswd + boolnew_link&false; + + + Die Funktion cubrid_connect_with_url wird verwendet, um + die Umgebung für die Verbindung zu Ihrem Server vorzubereiten, wobei die + Verbindungsinformationen über ein URL-Zeichenkettenargument übergeben + werden. Wenn in CUBRID die HA-Funktion aktiviert ist, müssen Sie die + Verbindungsinformationen des Standby-Servers, der bei einem Ausfall für das + Failover verwendet wird, im URL-Zeichenkettenargument dieser Funktion + angeben. Wenn kein Benutzername und kein Passwort angegeben werden, wird + standardmäßig die Verbindung "PUBLIC" hergestellt. + + + <url> ::= CUBRID:<host>:<db_name>:<db_user>:<db_password>:[?<properties>] + + + <properties> ::= <property> [&<property>] + + + <properties> ::= alhosts=<alternative_hosts>[ &rctime=<time>] + + + <properties> ::= login_timeout=<milli_sec> + + + <properties> ::= query_timeout=<milli_sec> + + + <properties> ::= disconnect_on_query_timeout=true|false + + + <alternative_hosts> ::= <standby_broker1_host>:<port> [,<standby_broker2_host>:<port>] + + + <host> := HOSTNAME | IP_ADDR + + + <time> := SECOND + + + <milli_sec> := MILLI SECOND + + + host : Ein Hostname oder eine IP-Adresse der Master-Datenbank + db_name : Ein Name der Datenbank + db_user : Ein Name des Datenbankbenutzers + db_password : Ein Passwort des Datenbankbenutzers + + alhosts : Gibt die Broker-Informationen des Standby-Servers an, der für das + Failover verwendet wird, wenn keine Verbindung zum aktiven Server möglich + ist. Sie können mehrere Broker für das Failover angeben, und die Verbindung + zu den Brokern wird in der in alhosts aufgeführten Reihenfolge + versucht + + rctime : Ein Intervall zwischen den Versuchen, eine Verbindung zu dem + aktiven Broker herzustellen, bei dem der Ausfall aufgetreten ist. Nach + einem Ausfall verbindet sich das System mit dem durch althosts angegebenen + Broker (Failover), beendet die Transaktion und versucht dann bei jedem + rctime, sich mit dem aktiven Broker der Master-Datenbank zu verbinden. Der + Standardwert beträgt 600 Sekunden. + + login_timeout : Timeout-Wert (Einheit: Millisekunden) für die + Datenbankanmeldung. Der Standardwert ist 0, was eine unendliche + Verzögerung bedeutet. + + + query_timeout : Timeout-Wert (Einheit: Millisekunden) für eine + Abfrageanforderung. Bei Zeitüberschreitung wird eine Nachricht zum + Abbrechen der angeforderten Abfrage an den Server gesendet. Der + Rückgabewert kann von der Konfiguration disconnect_on_query_timeout + abhängen; auch wenn die Nachricht zum Abbrechen einer Anforderung an den + Server gesendet wird, kann diese Anforderung erfolgreich sein. + + + disconnect_on_query_timeout : Konfiguriert einen Wert, der angibt, ob bei + einer Zeitüberschreitung sofort ein Fehler der ausgeführten Funktion + zurückgegeben werden soll. Der Standardwert ist false. + + + + + ? und :, die in der + PHP-Verbindungs-URL als Bezeichner verwendet werden, dürfen nicht im + Passwort enthalten sein. Das Folgende ist ein Beispiel für ein Passwort, + das nicht als Verbindungs-URL verwendet werden kann, da es + "?:" enthält. + + + $url = "CUBRID:localhost:33000:tdb:dba:12?:?login_timeout=100"; + + + Passwörter, die ? oder : enthalten, + können als separater Parameter übergeben werden. + + + $url = "CUBRID:localhost:33000:tbd:::?login_timeout=100"; + + + $conn = cubrid_connect_with_url($url, "dba", "12?"); + + + Wenn der Benutzer oder das Passwort leer ist, dürfen Sie + ":" nicht entfernen; das Folgende ist ein Beispiel. + + + $url = "CUBRID:localhost:33000:demodb:::"; + + + + + + &reftitle.parameters; + + + conn_url + Eine Zeichenkette, die die Verbindungsinformationen des Servers enthält. + + + userid + Benutzername für die Datenbank. + + + passwd + Benutzerpasswort. + + + new_link + Wenn ein zweiter Aufruf von + cubrid_connect_with_url mit denselben Argumenten + erfolgt, wird keine neue Verbindung hergestellt, sondern stattdessen die + Verbindungskennung der bereits geöffneten Verbindung zurückgegeben. Der + Parameter new_link ändert dieses Verhalten und + bewirkt, dass cubrid_connect_with_url immer eine neue + Verbindung öffnet, selbst wenn + cubrid_connect_with_url zuvor mit denselben + Parametern aufgerufen wurde. + + + + + + &reftitle.returnvalues; + + Die Verbindungskennung, wenn der Vorgang erfolgreich ist,&return.falseforfailure;. + + + + + &reftitle.examples; + + Beispiel für <function>cubrid_connect_with_url</function> mit einer URL ohne Eigenschaften + + +]]> + + + + + Beispiel für <function>cubrid_connect_with_url</function> mit einer URL mit Eigenschaften + + +]]> + + + + + + &reftitle.seealso; + + cubrid_connect + cubrid_pconnect + cubrid_pconnect_with_url + cubrid_disconnect + cubrid_close + + + + + diff --git a/reference/cubrid/setup.xml b/reference/cubrid/setup.xml new file mode 100644 index 000000000..d484ecf4d --- /dev/null +++ b/reference/cubrid/setup.xml @@ -0,0 +1,83 @@ + + + + + &reftitle.setup; + +
+ &reftitle.required; + + Damit diese Funktionen verfügbar sind, müssen Sie CUBRID installieren und die CUBRID-PHP-Bibliothek mit CUBRID-Unterstützung kompilieren. + +
+ + &reference.cubrid.configure; + +
+ &reftitle.runtime; + + Es gibt derzeit keine Laufzeitkonfiguration. + +
+ +
+ &reftitle.resources; + + In CUBRID werden vier Ressourcentypen verwendet. Der erste ist die + Verbindungskennung für eine Datenbankverbindung, der zweite ist die + Ressource, die das Ergebnis einer Abfrage enthält, und die letzten beiden + sind Ressourcen, die die Abfrageergebnisse der Datentypen BLOB/CLOB + enthalten. + +
+ Verbindungskennung + + Eine Verbindungskennung, die von cubrid_connect, + cubrid_connect_with_url, + cubrid_pconnect und + cubrid_pconnect_with_url zurückgegeben wird. + +
+
+ Anfragekennung + + Eine Anfragekennung, die von cubrid_prepare und cubrid_execute zurückgegeben wird. + +
+
+ LOB-Kennung + + Eine LOB-Kennung, die von cubrid_lob_get zurückgegeben wird. + +
+
+ LOB2-Kennung + + Eine LOB-Kennung, die von cubrid_lob2_new zurückgegeben + oder aus der Ergebnismenge ermittelt wird. + +
+ +
+ + +