(PHP 4 >= 4.0.6, PHP 5)
mysql_unbuffered_query — Sendet eine SQL Anfrage an MySQL, ohne Ergebniszeilen abzuholen und zu puffern.
$query
[, resource $Verbindungs-Kennung
] )
mysql_unbuffered_query() sendet die SQL Anfrage
query
an MySQL, ohne dass die Datensätze des
Ergebnisses automatisch geholt und gepuffert werden, wie es bei der
Verwendung von mysql_query() der Fall ist. Dies spart
eine erhebliche Menge an Speicher bei SQL Anfragen ein, die große
Ergebnismengen liefern und sie können unmittelbar mit dem Anfrageergebnis
arbeiten, sobald der erste Datensatz gefunden wurde: Sie müssen nicht
darauf warten, bis die gesamte SQL Anfrage abgeschlossen ist. Zur Nutzung
von mysql_unbuffered_query() mit verschiedenen
Datenbanken gleichzeitig zugegriffen, muss der optionale
Parameter Verbindungs-Kennung
angegeben werden.
query
Die auszuführende SQL Abfrage.
Werte innerhalb der Abfrage sollten mit korrekt maskiert sein.
Verbindungs-Kennung
Die MySQL-Verbindung.
Wird die Verbindungskennung nicht angegeben, wird die letzte durch
mysql_connect() geöffnete Verbindung angenommen. Falls
keine solche Verbindung gefunden wird, wird versucht, eine Verbindung
aufzubauen, wie es beim Aufruf von mysql_connect() ohne
Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden
oder aufgebaut werden kann, wird eine Warnung der Stufe
E_WARNING
erzeugt.
Für SELECT, SHOW, DESCRIBE oder EXPLAIN Anweisungen
gibt mysql_unbuffered_query() eine
Kennung resource bei Erfolg zurück oder FALSE
bei Fehlern.
Für alle anderen von SQL Anweisungen wie INSERT, UPDATE, DELETE, DROP, etc,
gibt mysql_unbuffered_query() TRUE
bei Erfolg zurück
oder FALSE
bei Fehlern.
Hinweis:
Die Vorteile von mysql_unbuffered_query() haben ihren Preis: Auf ein Ergebnis von mysql_unbuffered_query() können die Funktionen mysql_num_rows() und mysql_data_seek() nicht angewendet werden. Ausserdem müssen Sie sicherstellen, dass Sie alle Zeilen des Ergebnisses einer ungepufferteten SQL Anfrage abgeholt haben. Erst dann können Sie eine neue SQL Anfrage bei Nutzung derselben Verbindung
Verbindungs-Kennung
an MySQL absetzen.