PHP PDO连接Firebird 2.5数据库时出现SQL方言错误求助

错误根源 #

你碰到的SQL error code = -817问题，本质是当前数据库使用SQL Dialect 1——这是Firebird为兼容旧版本保留的模式，不支持动态SQL里的现代语法特性（比如你用的FIRST、特定CAST用法），而Firebird 2.5本身完全支持功能更完善的Dialect 3。

解决方案 #

1. 连接时强制指定SQL Dialect 3 #

修改PDO连接字符串，添加;dialect=3参数，让连接使用Dialect 3模式：

$pdo = new PDO('firebird:dbname=localhost:C:\\xampp\\htdocs\\fbtomysql\\banco\\TESTE.FDB;dialect=3', 'SYSDBA', 'masterkey');

2. 优化SQL语句的日期写法（可选） #

为避免日期格式歧义，可将原SQL中的日期字符串改为标准的日期字面量写法：
将WHERE V.VENDA_DATA BETWEEN '2024-01-01' AND '2024-10-22'替换为：

WHERE V.VENDA_DATA BETWEEN DATE '2024-01-01' AND DATE '2024-10-22'

修改后的完整代码 #

$query = "SELECT FIRST 2 PG.PRODUTOGRADE_IDENTIFICADOR AS ID, P.PRODUTO_DESCRICAO AS PRODUTO, CAST(SUM(VP.VENDAPRODUTO_QUANTIDADE) AS DECIMAL(18, 2)) AS QTD, CAST(SUM(VP.VENDAPRODUTO_VALOR) AS DECIMAL(18, 2)) AS V_TOTAL_VENDA FROM VENDA V INNER JOIN VENDAPRODUTO VP ON VP.VENDA_IDENTIFICADOR = V.VENDA_IDENTIFICADOR INNER JOIN PRODUTOGRADE PG ON VP.PRODUTOGRADE_IDENTIFICADOR = PG.PRODUTOGRADE_IDENTIFICADOR INNER JOIN PRODUTO P ON P.PRODUTO_IDENTIFICADOR = PG.PRODUTO_IDENTIFICADOR WHERE V.VENDA_DATA BETWEEN DATE '2024-01-01' AND DATE '2024-10-22' GROUP BY PG.PRODUTOGRADE_IDENTIFICADOR, P.PRODUTO_DESCRICAO ORDER BY QTD DESC";

$pdo = new PDO('firebird:dbname=localhost:C:\\xampp\\htdocs\\fbtomysql\\banco\\TESTE.FDB;dialect=3', 'SYSDBA', 'masterkey');

$select = $pdo->prepare($query);
$select->setFetchMode(PDO::FETCH_ASSOC);
$select->execute();
$result = $select->fetchAll();

foreach($result as $x){
    print_r($x);
}

补充说明 #

如果修改后仍有问题，可能是数据库创建时就指定了Dialect 1，这种情况需要备份数据后，用Dialect 3重新创建数据库再导入数据——不过大部分场景下，连接时指定Dialect 3就能解决动态SQL的兼容性问题。

内容的提问来源于stack exchange，提问作者E. Coelho