(PHP 8 >= 8.4.0)
Pdo\Sqlite::createAggregate — Registriert eine benutzerdefinierte Aggregationsfunktion zur Verwendung in SQL-Anweisungen
$name,$step,$finalize,$numArgs = -1Diese Methode entspricht Pdo\Sqlite::createFunction(), mit dem Unterschied, dass sie Funktionen registriert, die verwendet werden können, um ein über alle Zeilen einer Abfrage aggregiertes Ergebnis zu berechnen.
Der Hauptunterschied zwischen dieser Methode und Pdo\Sqlite::createFunction() ist, dass zwei Funktionen notwendig sind, um das Aggregat zu verwalten.
Mit dieser Methode ist es möglich, native SQL-Funktionen zu überschreiben.
namestepEs ist notwendig, diese Funktion wie folgt zu definieren:
contextnull für die erste Zeile; in den folgenden Zeilen hat er den Wert,
der zuvor von der Schritt-Funktion zurückgegeben wurde. Sie sollten
diesen nutzen, um den Aggregationszustand zu bewahren.
rownumbervaluevaluescontext
verwendet.
finalizeDiese Funktion ist wie folgt zu definieren:
contextEnthält den Rückgabewert des letzten Aufrufs der Schritt-Funktion.
rowcountEnthält die Anzahl an Zeilen, die bereits aggregiert wurden.
numArgsBeispiel #1 Pdo\Sqlite::createAggregate()-Beispiel
In diesem Beispiel wird eine benutzerdefinierte Aggregationsfunktion mit
dem Namen max_length erstellt, die in SQL-Abfragen
verwendet werden kann.
In diesem Beispiel erzeugen wir eine Aggregationsfunktion mit dem Namen
max_length, die die Länge der längsten Zeichenkette
innerhalb einer der Tabellenspalten ermittelt.
Für jede durchlaufene Zeile wird die Funktion max_len_step
mit dem Parameter $context aufgerufen.
Der Parameter "context" ist eine normale PHP-Variable, welche ein
array oder sogar ein object beinhalten kann.
In diesem Beispiel benötigen wir ihn als Speicher für die größte bisher
gefundene Länge.
Wenn die Zeichenkette in $string länger ist, als die
aktuell längste, wird der Inhalt von "context" mit der neuen Länge
überschrieben.
Nachdem alle Zeilen abgearbeitet wurden, ruft SQLite die
max_len_finalize-Funktion auf, um das Endergebnis zu
ermitteln.
Auf Basis der in $context gesammelten Daten können
beliebige Berechnungen durchgeführt werden.
In diesem einfachen Beispiel wurde das Ergebnis bereits während der Abfrage
berechnet, so dass der Wert von "context" direkt zurückgegeben werden kann.
<?php
$data = [
'one',
'two',
'three',
'four',
'five',
'six',
'seven',
'eight',
'nine',
'ten',
];
$db = new Pdo\Sqlite('sqlite::memory:');
$db->exec("CREATE TABLE strings(a)");
$insert = $db->prepare('INSERT INTO strings VALUES (?)');
foreach ($data as $str) {
$insert->execute(array($str));
}
$insert = null;
function max_len_step($context, $row_number, $string)
{
if (strlen($string) > $context) {
$context = strlen($string);
}
return $context;
}
function max_len_finalize($context, $row_count)
{
return $context === null ? 0 : $context;
}
$db->createAggregate('max_len', 'max_len_step', 'max_len_finalize');
var_dump($db->query('SELECT max_len(a) from strings')->fetchAll());
?>Es ist NICHT ratsam, eine Kopie der Werte in 'context' zu speichern, um diese dann am Ende auszuwerten. Das würde dazu führen, dass SQLite eine große Menge an Speicher benötigt, um die Abfrage abzuarbeiten - stellen Sie sich vor, wie viel Speicherplatz Sie benötigen würden, wenn eine Million Zeilen im Speicher abgelegt würden, von denen jede eine Zeichenkette von 32 Byte Länge enthält.