Web aym.pekori.to

PDO::sqliteCreateAggregate

(no version information, might be only in CVS)

PDO::sqliteCreateAggregate --  SQL 文で使用する集約ユーザ定義関数 (UDF) を登録する

説明

bool PDO::sqliteCreateAggregate ( string function_name, callback step_func, callback finalize_func [, int num_args] )

警告

この関数は、 実験的 なものです。この関数の動作・ 名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 この関数は自己責任で使用してください。

PDO::sqliteCreateAggregate()PDO::sqliteCreateFunction() と似ていますが、 この関数で登録した関数は、クエリのすべての行の内容を集約する関数を登録します。

この関数と PDO::sqliteCreateFunction() の最大の違いは、 集約関数を作成するためには 2 つの関数が必要であるということです。 step_func は、結果セットの各行についてコールされるものです。 この PHP 関数は、結果を蓄積して集約コンテキストに保存しなければなりません。 すべての行が処理された後で、finalize_func がコールされます。ここでは、集約コンテキストからデータを取得して結果を返します。 コールバック関数の返す値は、SQLite が理解できる形式 (すなわち スカラー型) でなければなりません。

パラメータ

function_name

SQL 文で使用する関数の名前。

step_func

結果セットの各行に対して実行されるコールバック関数。

finalize_func

各行から取得したデータを集約するためのコールバック関数。

num_args

コールバック関数があらかじめ定義済みの引数を受け取る場合に、 SQLite のパーサに渡すヒント。

例 1. 集約関数 max_length の例

<?php
$data
= array(
   
'one',
   
'two',
   
'three',
   
'four',
   
'five',
   
'six',
   
'seven',
   
'eight',
   
'nine',
   
'ten',
   );
$db = new PDO('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, $string)
{
    if (
strlen($string) > $context) {
        
$context = strlen($string);
    }
}

function
max_len_finalize(&$context)
{
    return
$context;
}

$db->sqliteCreateAggregate('max_len', 'max_len_step', 'max_len_finalize');

var_dump($db->query('SELECT max_len(a) from strings')->fetchAll());

?>

この例では、 テーブルのカラムの中で一番長い文字列の長さを計算する集約関数を作成します。 各行について max_len_step 関数がコールされ、 context パラメータが渡されます。 このパラメータには、他の PHP 変数と同様に、配列やオブジェクトが設定されます。 この例では、これまでに登場した値のうち長さが最大のものの長さを保持しています。 string が現在の最大値より長い場合に、 その値で現在の最大値を更新します。

すべての行に対する処理が終わると、SQLite は max_len_finalize 関数をコールして集約結果を決定します。 ここでは、context の内容に基づいた、 なんらかの計算を行うことができます。 しかし、この例ではクエリを処理している過程で既に結果が決定しているので、 ここでは単に context の値を返しているだけです。

ティップ: 結果の値を context に溜め込んでおき、最後に一括して処理するという方法は推奨 「しません」。これは、SQLite のメモリ消費量が大きくなるからです。 仮に 32 バイトの長さのデータが百万件あったとして、 それを溜め込むためにどれだけのメモリが必要になるか考えてみましょう。

ティップ: PDO::sqliteCreateFunction() および PDO::sqliteCreateAggregate() を使用して、 SQLite のネイティブ SQL 関数を上書きすることができます。

注意: このメソッドは、SQLite2 ドライバでは使用できません。 代わりに、古い形式の sqlite API を使用してください。

参考

PDO::sqliteCreateFunction()
sqlite_create_function()
sqlite_create_aggregate()