sqlite_create_aggregate() похожа на sqlite_create_function(), за исключением того, что регистрирует функцию, которая может быть использована для вычисления результата на основе всех записей результата запроса.
Главное отличие этой функции от sqlite_create_function()
состоит в том, что для работы агрегатной функции неоходимы 2 функции;
step_func
вызывается для каждой записи из результат
запроса. Эта функция должна аккумулировать результат и сохранять его в
контекстной переменной. После обработки всех записей, вызывается
finalize_func
, которая должна обработать данные из
контекстной переменной и вернуть результат.
В этом примере, мы создаем агрегатную функцию, коорая возвращает длину
самой длинной строки в одном из полей результата запроса. Для каждой
записи, вызывается функция max_len_step, которой помимо
строки передается контекстная переменная context
.
Эту переменню вы можете использовать по своему усмотрению для накопления
результатов вычислений. В нашем примере, в этой переменной хранится
максимальная длина строки; если длина строки string
больше, чем значение, сохраненное в контекстной переменной, контекстной
переменной присваивается новое значение.
После обработки всех записей, SQLite вызовет функцию
max_len_finalize для определения результата агрегатной
функции. Здесь можно было бы провести вычисления, основанные на значении
контекстной переменной context
, но в этом простейшем
примере, все вычисления были произведены в процессе обработки запроса, и
остается только вернуть полученное значение.
Замечание: Приведенный выше пример будет работать некорректно, если прменить созданную функцию к бинарным данным. Описание функции sqlite_udf_decode_binary() объясняет, почему это происходит и как этого избежать.
Подсказка: НЕ РЕКОМЕНДУЕТСЯ сохранять все полученные значения в контекстной переменной и затем производить все вычисления на последнем шаге, так как при этом SQLite может израсходовать большое количество памяти в процессе обработки запроса - представьте, сколько памяти потребуется, чтобы сохранить в памяти миллион записей, по 32 байта каждая.
Подсказка: sqlite_create_function() и sqlite_create_aggregate() могут быть использованы для переопределения встроенных функций SQLite.
Пред. | Начало | След. |
sqlite_column | Уровень выше | sqlite_create_function |