ingres_prepare
(PECL ingres >= 1.1.0)
ingres_prepare — Bereitet eine Abfrage zur späteren Ausführung vor
Beschreibung
Bereitet eine Abfrage zur Ausführung mit ingres_execute() vor.
Die Abfrage wird Teil der aktuell geöffneten Transaktion. Falls es aktuell keine offene Transaktion gibt, wird mit ingres_query() eine geöffnet. Geschlossen wird sie entweder mit ingres_commit(), wobei die gemachten Änderungen in die Datenbank geschrieben werden, oder mit ingres_rollback(), wobei die Änderungen verworfen werden. Wenn das Skript zuende ist, wird jede geöffnete Transaktion zurückgesetzt (indem die ingres_rollback() aufgerufen wird). Sie können vor dem Öffnen einer neuen Transaktion ingres_autocommit() ausführen, danach werden alle Änderungen sofort nach der Ausführung einer SQL-Abfrage committet.
Hinweis: Verwandte Konfigurationen
Siehe auch die Direktiven ingres.describe, ingres.scrollable und ingres.utf8 der Laufzeit-Konfiguration.
Parameter-Liste
-
link -
Die Verbindungskennung
-
query -
Eine gültige SQL-Abfrage (siehe im SQL reference guide der Ingres-Dokumentation). Bei der Funktion ingres_query() finden Sie bei dem Parameter query eine Liste der SQL-Kommandos, die nicht mit ingres_prepare() ausgeführt werden können.
Rückgabewerte
ingres_prepare() gibt eine Ergebniskennung zurück, die in der Funktion ingres_execute() verwendet wird, um die Abfrage auszuführen. Ob dabei ein Fehler auftrat, kann mit ingres_errno(), ingres_error() oder ingres_errsqlstate() ermittelt werden.
Siehe auch
- ingres_unbuffered_query() - Sendet eine SQL-Abfrage an Ingres, ohne die Ergebniszeilen zu puffern
- ingres_fetch_array() - Liest eine Zeile der Ergebnismenge in ein Array ein
- ingres_fetch_object() - Gibt eine Zeile der Ergebnismenge als Objekt zurück
- ingres_fetch_row() - Holt eine Zeile aus einer Ergebnismenge in ein numerisches Array
- ingres_commit() - Beendet eine Transaktion
- ingres_rollback() - Setzt eine Transaktion zurück
- ingres_autocommit() - Schaltet den autocommit-Modus an oder aus
- ingres_set_environment() - Setzt Eigenschaften der Umgebung zur Ausgabesteuerung
- ingres_errno() - Gibt den letzten Ingres-Fehlercode zurück
- ingres_error() - Gibt eine textuelle Beschreibung des letzten Fehlercodes zurück