next up previous contents index
Next: db_errormessage($connection_name="default"): Up: Funktionen für das Ausführen Previous: Funktionen für das Ausführen

db_query($querystring, $connection_name="default"):

Um SQL-Anfragen auszuführen wird die Funktion 'db_query' verwendet. Als Parameter hat sie den SQL-Query-String und den Namen der Datenbank-Verbindung. Für die Standardverbindung ``default'' kann der Name entfallen. Die Anfrage sollte so allgemein sein, dass jedes verwendbare Datenbanksystem (``mysql'', ``Postgres'' und ``Interbase'') sie verstehen und auswerten kann.

``UNION'' im Sinne von ``UNION ALL'' wird mit Hilfe der Funktion 'db_union_query' von 'lib-sqlunion.inc.php' unabhängig vom zugrunde liegenden Datenbank-System unterstützt. Dazu wird von 'db_query' 'db_union_query' aufgerufen, die den Anfragestring zerlegt und die Einzelanfragen an das darunter liegende Datenbank-System weitergibt.

Bei Fehler wird von 'db_query' 'false' als Rückgabe geliefert, sonst der Result-Handler (der ungleich 'false' ist). Über diesen kann dann mit den weiter unten beschrieben Funktionen auf das Anfrage-Ergebnis zugegriffen werden.

Die zur Zeit implementierten Datenbank-spezifischen Funktionen sind 'my_mysql_query' (für ``mysql''), 'my_pg_query' (für ``Postgres'') und 'my_ibase_query' (für ``Interbase''). Sie werden von 'db_union_query' aus aufgerufen.



Copyright Munich Network Management Team