Function.pg-query

Aus PHP-Wiki

pg_query — Führt eine Abfrage aus

Beschreibung

resource pg_query ( string $query )
resource pg_query ( resource $connection , string $query )

pg_query() führt die query auf der angegebenen Datenbank-connection aus. Falls ein Fehler auftritt und FALSE zurückgegeben wird, können Sie Details zu diesem Fehler mit pg_last_error() anzeigen, vorausgesetzt, die Verbindungskennung ist gültig. Hinweis: Obwohl der Parameter connection weggelassen werden kann, ist dies nicht empfehlenswert, da es die Fehlersuche in Skripten erschweren kann. Hinweis: Diese Funktion ersetzt die Funktion pg_exec(). pg_exec() wird aus Gründen der Kompatibilität immer noch unterstützt, es wird jedoch empfohlen, den neuen Funktionsnamen zu verwenden.

Parameter-Liste

connection

• PostgreSQL Verbindungkennung. Falls connection nicht angegeben wurde, wird die zuletzt mit pg_connect() oder pg_pconnect() geöffnete Verbindung benutzt.

query

• Die auszuführende(n) SQL-Anweisung(en). Werden mehrere Anweisungen an pg_query() übergeben, werden sie automatisch in einer einzigen Transaktion ausgeführt, es sei denn, die Anweisungsfolge enthält explizite BEGIN/COMMIT Anweisungen. Von der Ausführung mehrerer Transaktionen innerhalb eines Funktionsaufrufs wird abgeraten.

Rückgabewerte

Bei Erfolg wird eine Ergebniskennung für die Abfrage zurückgegeben, anderenfalls FALSE.

Beispiele

=== #1 pg_query() Beispiel

<?php
 
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
  echo "Ein Fehler ist aufgetreten.\n";
  exit;
}
 
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
  echo "Ein Fehler ist aufgetreten.\n";
  exit;
}
 
while ($row = pg_fetch_row($result)) {
  echo "Autor: $row[0]  E===
 
 
 
<source lang="php">
 
<?php
 
$conn = pg_pconnect("dbname=publisher");
 
// diese Anweisungen werden in einer einzigen Transaktion ausgeführt.
 
$query = "UPDATE authors SET author=UPPER(author) WHERE id=1;";
$query .= "UPDATE authors SET author=LOWER(author) WHERE id=2;";
$query .= "UPDATE authors SET author=NULL WHERE id=3;";
 
pg_query($conn, $query);
 
?>

Siehe auch

• pg_connect()
• pg_pconnect()
• pg_fetch_array()
• pg_fetch_object()
• pg_num_rows()
• pg_affected_rows()