PDO::nextRowset() does not appear to be currently supported by the Firebird PDO driver. Unfortunate.
PDOStatement::nextRowset
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)
PDOStatement::nextRowset — Rückt in einem Anweisungshandle mit mehreren Sätzen von Zeilen (Rowsets) zum nächsten vor
Beschreibung
Einige Datenbankserver unterstützen gespeicherte Prozeduren, die mehr als einen Satz von Zeilen (sog. Rowsets, auch Ergebnismenge genannt) zurückgeben. PDOStatement::nextRowset() ermöglicht den Zugriff auf den zweiten und die folgenden Sätze von Zeilen, die zu einem PDOStatement-Objekt gehören. Jeder Zeilensatz kann einen anderen Satz von Spalten haben als der vorhergehende Zeilensatz.
Parameter-Liste
Diese Funktion besitzt keine Parameter.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 Abrufen mehrerer von einer gespeicherten Prozedur zurückgegebener Zeilensätze
Das folgende Beispiel zeigt, wie man eine gespeicherte Prozedur,
MULTIPLE_ROWSETS, aufruft, die drei Zeilensätze
zurückgibt. Mit einer
do-while-Schleife wird
die Methode PDOStatement::nextRowset() so oft
aufgerufen, bis sie false zurückgibt, und die Schleife beendet, wenn es
keine weiteren Zeilensätze mehr gibt.
<?php
$sql = 'CALL multiple_rowsets()';
$stmt = $conn->query($sql);
$i = 1;
do {
$rowset = $stmt->fetchAll(PDO::FETCH_NUM);
if ($rowset) {
printResultSet($rowset, $i);
}
$i++;
} while ($stmt->nextRowset());
function printResultSet(&$rowset, $i) {
print "Ergebnismenge $i:\n";
foreach ($rowset as $row) {
foreach ($row as $col) {
print $col . "\t";
}
print "\n";
}
print "\n";
}
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Ergebnismenge 1: apple red banana yellow Ergebnismenge 2: orange orange 150 banana yellow 175 Ergebnismenge 3: lime green apple red banana yellow
Siehe auch
- PDOStatement::columnCount() - Liefert die Anzahl der Spalten in der Ergebnismenge
- PDOStatement::execute() - Führt ein Prepared Statement aus
- PDOStatement::getColumnMeta() - Liefert die Metadaten zu einer Spalte einer Ergebnismenge
- PDO::query() - Bereitet eine SQL-Anweisung ohne Platzhalter vor und führt sie aus
add a note
User Contributed Notes 3 notes
guilleamathews at gmail dot com ¶
13 years ago
et dot coder at gmail dot com ¶
10 years ago
on MSSQL and 'dsn' => 'dblib:...',:
If you know how many count rowset then don't use contruction of do..while.
<?php
do {
$pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
} while (
$pdoStatement->nextRowset()
);
?>
When I get large fetchAll(over 30) for second nextRowset. I get error - Segmentation fault.
Uses step-by-step insted do..while is fix for this bug:
<?php
$pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
$pdoStatement->nextRowset();
$pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
?>
alex at 1stleg dot com ¶
8 years ago
If you use PDO::fetch instead of PDO::fetchAll and do not reach the end the result set, PDO::nextRowset() will fail with "SQLSTATE[HY000]: General error: PDO_DBLIB: dbresults() returned FAIL."
