Beispiel für die Benutzung der PostgreSQL-Erweiterung
pg_affected_rows
PostgreSQL
PHP Manual

# PostgreSQL-Funktionen

## Anmerkungen

> Hinweis: Nicht alle Funktionen sind in allen Versionen verfügbar. Es hängt davon ab, welche libpq-Version (die PostgreSQL-C-Client-Bibliothek) auf Ihrem Rechner verfügbar ist und wie libpq kompiliert wurde. Falls eine Funktion nicht verfügbar ist, liegt es daran, dass libpq die nötigen Routinen nicht unterstützt, die diese Funktion braucht.

> Hinweis: Die meisten PostgreSQL-Funktionen nehmen den Parameter `connection` als ersten optionalen Parameter entgegen. Falls er nicht angegeben wurde, wird die zuletzt geöffnete Verbindung benutzt. Wenn keine geöffnete Verbindung existiert, geben die Funktionen `FALSE` zurück.

> Hinweis: PostgreSQL wandelt automatisch alle Bezeichner (beispielsweise Tabellen- oder Spaltennamen) in Kleinbuchstaben um, und zwar sowohl bei der Erzeugung der Objekte als auch in Abfragen. Um Namen in Groß- und Kleinschreibung oder in Großbuchstaben zu erzwingen, müssen diese in doppelte Anführungszeichen ("") eingeschlossen werden.

> Hinweis: PostgreSQL stellt keine speziellen Kommandos zur Verfügung, um Informationen über ein Datenbank-Schema (z.B. alle Tabellen in der aktuellen Datenbank) zu erhalten. Stattdessen gibt es ab der Version 7.4 und höher ein Standard-Schema, das information_schema, in dem alle notwendigen Informationen in System-Views enthalten und die einfach abzufragen sind. Ausführliche Informationen darüber gibt es in der » PostgreSQL-Dokumentation.

## Inhaltsverzeichnis

- pg_affected_rows — Gibt die Anzahl betroffener Datensätze (Tupel) zurück
- pg_cancel_query — Löscht eine asynchrone Abfrage
- pg_client_encoding — Gibt die Kodierung des Clients zurück
- pg_close — Schließt eine PostgreSQL-Verbindung
- pg_connect — Öffnet eine PostgreSQL-Verbindung
- pg_connection_busy — Gibt den Status der Verbindung zurück (busy/not busy)
- pg_connection_reset — Setzt die Verbindung zurück und verbindet neu
- pg_connection_status — Gibt den Verbindungsstatus zurück
- pg_convert — Konvertiert die Werte eines assoziativen Arrays in passende Werte für SQL-Kommandos.
- pg_copy_from — Fügt Datensätze aus einem Array in eine Tabelle ein
- pg_copy_to — Kopiert eine Tabelle in ein Array
- pg_dbname — Gibt den Namen der Datenbank zurück
- pg_delete — Lscht Datenstze
- pg_end_copy — Synchronisation mit dem PostgreSQL-Server
- pg_escape_bytea — Maskiert Zeichenketten zum Einfügen in ein Feld vom Typ bytea
- pg_escape_string — Maskiert einen String zum Einfgen in Felder mit text/char Datentypen
- pg_execute — Fordert den Datenankserver auf, eine vorbereitete Anfrage mit den angegebenen Parametern auszuführen und wartet auf das Ergebnis
- pg_fetch_all_columns — Gibt alle Werte einer bestimmten Spalte eines Abfrageergebnisses in einem Array zurück
- pg_fetch_all — Gibt alle Zeilen eines Abfrageergebnisses als Array zurück
- pg_fetch_array — Holt eine Zeile als Array
- pg_fetch_assoc — Holt eine Zeile als assoziatives Array
- pg_fetch_object — Holt einen Datensatz als Objekt
- pg_fetch_result — Liefert Werte aus einer Ergebnismenge
- pg_fetch_row — Holt einen Datensatz als numerisches Array
- pg_field_is_null — Prüft, ob ein Feld einen SQL NULL-Wert enthält
- pg_field_name — Gibt den Namen eines Feldes zurück
- pg_field_num — Gibt die Feldnummer des angegebenen Feldes zurück
- pg_field_prtlen — Gibt die Länge des Feldes zurück
- pg_field_size — Gibt den belegten Speicher für ein Feld zurück
- pg_field_table — Gibt zu einem Feldnamen den Namen der Tabelle oder deren oid zurück, in der das Feld definiert ist
- pg_field_type_oid — Gibt die ID des PostgreSQL-Datentyps (OID) eines Feldes zurück
- pg_field_type — Gibt den Datentyp eines Feldes zurück
- pg_free_result — Gibt den durch Ergebnisse belegten Speicher frei
- pg_get_notify — Gibt eine SQL NOTIFY-Nachricht zurück
- pg_get_pid — Prüft die Datenbankverbindung
- pg_get_result — Gibt asynchrone Abfrageergebnisse zurück
- pg_host — Gibt den Namen des Host zurück, zu dem verbunden wurde
- pg_insert — Überträgt Werte aus einem Array in eine Tabelle
- pg_last_error — Gibt die letzte Fehlermeldung einer Verbindung zurück
- pg_last_notice — Gibt die letzte NOTICE-Meldung des PostgreSQL-Servers zurück
- pg_last_oid — Gibt den Objektbezeichner (OID) des zuletzt eingefügten Datensatzes zurück
- pg_lo_close — Schließt ein Large Object
- pg_lo_create — Erzeugt ein Large Object
- pg_lo_export — Exportiert ein Large Object in eine Datei
- pg_lo_import — Importiert ein Large Object aus einer Datei
- pg_lo_open — Öffnet ein Large Object
- pg_lo_read_all — Liest ein Large Object vollständig und reicht es direkt an den Browser weiter
- pg_lo_read — Liest ein Large Object
- pg_lo_seek — Setzt die Lese- oder Schreibposition in einem Large Object
- pg_lo_tell — Gibt die aktuelle Lese- oder Schreibposition in einem Large Object zurück
- pg_lo_unlink — Löscht ein Large Object
- pg_lo_write — Schreibt in ein Large Object
- pg_meta_data — Gibt Metadaten einer Tabelle als Array zurück
- pg_num_fields — Gibt die Anzahl der Felder in einem Abfrageergebnis zurück
- pg_num_rows — Gibt die Anzahl der Zeilen in einem Abfrageergebnis zurück
- pg_options — Gibt die Verbindungsoptionen der aktuellen Verbindung zurück
- pg_parameter_status — Gibt den Wert einer aktuellen Server-Einstellung zurück
- pg_pconnect — Öffnet eine persistente PostgreSQL-Verbindung
- pg_ping — Prüft die Datenbankverbindung
- pg_port — Gibt die Portnummer zurück, über die die Verbindung aufgebaut wurde
- pg_prepare — Sendet eine Aufforderung an den Server, eine vorbereitete Anfrage mit den übergebenen Parametern zu erzeugen und wartet auf ihre Beendigung.
- pg_put_line — Sendet eine NULL-terminierte Zeichenkette zum PostgreSQL-Server
- pg_query_params — Sendet ein Kommando zum Server und wartet seine Ausführung ab. Getrennt vom SQL-Kommando können dabei Parameter übergeben werden.
- pg_query — Führt eine Abfrage aus
- pg_result_error_field — Gibt den Inhalt eines bestimmtes Feldes zu einer Fehlermeldung zurück
- pg_result_error — Gibt die mit der Ergebniskennung verknüpfte Fehlermeldung zurück
- pg_result_seek — Setzt den internen Datensatzzeiger auf die angegebene Position in einem Abfrageergebnis
- pg_result_status — Gibt den Status eines Abfrageergebnisses zurück
- pg_select — Wählt Datensätze aus
- pg_send_execute — Sendet eine Aufforderung an den Server, eine vorbereitete Abfrage mit den übergebenen Parametern auszuführen, ohne auf die Ergebnisse zu warten.
- pg_send_prepare — Sendet eine Aufforderung an den Server, eine vorbereitete Abfrage mit den übergebenen Parametern zu erzeugen, ohne auf ihre Beendigung zu warten.
- pg_send_query_params — Sendet ein Kommando und separate Parameter zum Server, ohne auf die Rückgabe der Ergebnisse zu warten
- pg_send_query — Sendet eine asynchrone Abfrage
- pg_set_client_encoding — Setzt die Kodierung des Clients
- pg_set_error_verbosity — Bestimmt den Detaillierungsgrad von Fehlermeldungen, die von pg_last_error und pg_result_error zurückgegeben werden.
- pg_trace — Ermöglicht die Ablaufverfolgung einer Verbindung
- pg_transaction_status — Gibt den aktuellen Transaktionsstatus des Servers zurück
- pg_tty — Gibt den TTY Namen für die Verbindung zurück
- pg_unescape_bytea — Entfernt Maskierungen für den Typ bytea
- pg_untrace — Beendet die Ablaufverfolgung einer PostgreSQL-Verbindung
- pg_update — Aktualisiert eine Tabelle
- pg_version — Gibt ein Array zurück, das die Versionen von Client, Protokoll und Server enthält (falls verfügbar).

Beispiel für die Benutzung der PostgreSQL-Erweiterung
pg_affected_rows
PostgreSQL
PHP Manual