【PHP8.x】PDO::SQLITE_DETERMINISTIC定数の使い方

SQLITE_DETERMINISTIC定数は、PHPのPDO拡張機能において、SQLiteデータベースに登録するユーザー定義関数（UDF）が「決定的」であることを示すために使用される定数です。この定数は、PDOクラスが提供するsqliteCreateFunction()メソッドなどを利用して、PHPで定義した関数をSQLiteのSQLクエリから呼び出せるようにする際に、関数の特性をデータベースエンジンに伝える役割を持ちます。

「決定的」な関数とは、同じ入力値を与えられた場合、常に同じ結果を返す関数のことを指します。例えば、数値の絶対値を返す関数や、文字列を大文字に変換する関数などがこれに該当します。一方で、現在時刻を返す関数や乱数を生成する関数は、呼び出しごとに異なる結果を返すため、非決定的な関数と見なされます。

SQLiteデータベースエンジンは、関数が決定的であると判断できる場合、クエリの実行計画を最適化するためにその情報を活用します。具体的には、同じ入力値で関数が複数回呼び出される可能性がある場合に、その結果をキャッシュして再利用したり、不要な呼び出しを省略したりすることで、クエリ全体のパフォーマンスを向上させることが可能になります。

しかし、もし非決定的な関数を決定的であると誤ってマークしてしまうと、SQLiteオプティマイザが不適切な最適化を行い、クエリが予期しない結果を返したり、データの一貫性が損なわれたりするリスクがあります。そのため、ユーザー定義関数を登録する際には、その関数の性質を正確に把握し、この定数を適切に設定することが非常に重要です。この定数はPHP 8.0以降で利用可能です。

Copy
1<?php
2$pdo = new PDO('sqlite::memory:');
3
4$pdo->sqliteCreateFunction(
5    'my_function',
6    function ($arg) {
7        return $arg * 2;
8    },
9    1,
10    PDO::SQLITE_DETERMINISTIC
11);

引数なし

引数はありません

int

SQLITE_DETERMINISTIC定数は、INT型の整数値を返します。この定数は、PDO::sqliteCreateFunction()メソッドと共に使用され、作成するユーザー定義関数が常に同じ引数に対して同じ結果を返す（決定論的である）ことを示します。