PostgreSQL『function sequence error（HY010/S1010）』の原因と対処【psqlODBC/ODBC経由】

SQLSTATE=HY010  [Driver Manager] Function sequence error
S1010          [Driver Manager] Function sequence error
HY010          (SQLFetch / SQLGetData / SQLExecute / SQLMoreResults などの直後に発生)

-- 参考：サーバー側の通常カーソル（psqlでの概念確認）
BEGIN;
DECLARE c CURSOR FOR SELECT generate_series(1,3);
FETCH ALL FROM c;  -- 終了させることが重要（ODBCでも「結果を読み切る/閉じる」）
CLOSE c;
COMMIT;

Driver=PostgreSQL Unicode(x64);Server=db.example.com;Port=5432;Database=app;
Uid=app;Pwd=***;UseDeclareFetch=1;Fetch=1000;ServerSidePrepare=1;
# （古い環境で必要な場合）DisallowPremature=1

// 1) SQLAllocHandle(SQL_HANDLE_STMT)
// 2) SQLPrepare または 直接 SQLExecDirect
// 3) （SELECTなら）SQLExecute → SQLFetch/SQLGetData で最後まで読む
// 4) SQLCloseCursor（または SQLFreeStmt(SQL_CLOSE)）で結果を確実に閉じる
// 5) 次の SQL を実行（別の結果を重ねない）
// 6) 終了時に SQLFreeHandle

// 典型的なNG：Fetchが終わっていないのに別のSQLExecuteを同じHSTMTで実行 → HY010

# NG：結果を読み切らずに同じカーソルで別クエリを実行
cur.execute("SELECT * FROM big_table")
row = cur.fetchone()         # まだ残りがある
cur.execute("UPDATE t SET x=1 WHERE id=1")  # HY010 を誘発することがある

# OK：結果を読み切る or 閉じる or 別カーソル/別接続を使う
cur.execute("SELECT * FROM big_table")
for _ in cur:                 # すべて消費
    pass
# もしくは cur.fetchall() で読み切る／cur.close() で明示クローズ
cur.execute("UPDATE t SET x=1 WHERE id=1")

// NG：バッファ非使用で結果を残したまま次のクエリ
$stmt = $pdo->query("SELECT * FROM big_table");  // 結果が未消費
$pdo->exec("DELETE FROM t WHERE id=1");          // HY010 になる場合

// OK：結果を消費/閉じる or 別ステートメントを使う
$stmt = $pdo->query("SELECT * FROM big_table");
$stmt->fetchAll();   // 全件を読み切る（大きい場合は逐次fetch + 破棄）
$stmt->closeCursor(); // カーソルを閉じる
$pdo->exec("DELETE FROM t WHERE id=1");

# Windows: ファイルDSN/システムDSNの例
[ODBC]
DRIVER=PostgreSQL Unicode(x64)
SERVER=127.0.0.1
PORT=5432
DATABASE=app
UID=app
PWD=***
UseDeclareFetch=1
Fetch=1000
ServerSidePrepare=1

# UnixODBC: odbc.ini の例
[pg-app]
Driver=PostgreSQL Unicode
Servername=127.0.0.1
Port=5432
Database=app
Username=app
Password=***
UseDeclareFetch=1
Fetch=1000

// 再現：結果未クローズのまま別SELECT
stmt = SQLAllocHandle(STMT)
SQLExecDirect(stmt, "SELECT * FROM big_table")
SQLFetch(stmt)                   // 1行だけ取得、まだ開いている
SQLExecDirect(stmt, "SELECT 1")  // ← ここで HY010
// 解消
SQLCloseCursor(stmt)             // 先に閉じる
SQLExecDirect(stmt, "SELECT 1")  // 正常実行