pg_execute
Fordert den Datenankserver auf, eine vorbereitete Anfrage mit den
angegebenen Parametern auszuführen und wartet auf das Ergebnis
&reftitle.description;
PgSql\Resultfalsepg_execute
PgSql\Connectionconnection
stringstmtname
arrayparams
Fordert den Datenankserver auf, eine vorbereitete Anfrage mit den
angegebenen Parametern auszuführen und wartet auf das Ergebnis.
pg_execute ist ähnlich wie
pg_query_params, mit dem Unterschied, dass das
auszuführende Kommando zuvor als vorbereitete Abfrage definiert wurde und
kein SQL-String ist. Damit werden Abfragen, die wiederholt verwendet
werden, nur ein einziges Mal geparst und geplant und nicht jedesmal, wenn
sie ausgeführt werden. Das Kommando muss zuvor in der aktuellen
Datenbanksitzung vorbereitet worden sein. pg_execute
wird von PostgreSQL ab der Version 7.4 unterstützt und wird in allen
früheren Versionen fehlschlagen.
Die Parameter sind identisch zu denen in
pg_query_params, außer dass der Name eines
vorbereiteten Kommandos anstatt einer SQL-Abfrage übergeben wird.
&reftitle.parameters;
connection
&pgsql.parameter.connection-with-unspecified-default;
stmtname
Der Name der vorbereiteten Abfrage, die ausgeführt werden soll. Falls
"" angegeben wurde, wird die unbenannte Abfrage ausgeführt. Dieser Name
muss zuvor mit pg_prepare,
pg_send_prepare oder dem SQL-Kommando
PREPARE vorbereitet worden sein.
params
Ein Array, das die Parameter enthält, mit denen die Platzhalter $1, $2
usw. im originalen Abfragestring ersetzt werden. Die Anzahl der
Arrayelemente muss mit der Anzahl der Platzhalter übereinstimmen.
Beim Aufruf dieser Funktion werden die Elemente in Strings konvertiert.
&reftitle.returnvalues;
Bei Erfolg wird eine PgSql\Result-Instanz zurückgegeben. &return.falseforfailure;
&reftitle.changelog;
&Version;
&Description;
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_execute benutzen:
]]>
&reftitle.seealso;
pg_prepare
pg_send_prepare
pg_query_params