ingres_prepare
(PECL ingres >= 1.1.0)
ingres_prepare — 後で実行するためのクエリを準備する
説明
ingres_prepare
( resource $link
, string $query
) : mixed
ingres_execute() で実行するためのクエリを準備します。
クエリは、現在開いているトランザクションの一部となります。 開いているトランザクションがない場合は ingres_query() が新しいトランザクションを開きます。 トランザクションを閉じるには、ingres_commit() をコールして変更をデータベースにコミットするか ingres_rollback() で変更をキャンセルします。 スクリプトが終了すると、開いているトランザクションはすべて (ingres_rollback() をコールして) ロールバックされます。 新しいトランザクションを開く前に ingres_autocommit() をコールすると、 SQL を実行するたびにその場で自動的にコミットするようになります。
注意:
関連する設定項目
実行時設定での ingres.describe、 ingres.scrollable および ingres.utf8 の説明も参照ください。
パラメータ
link- 接続リンク ID。
query- Ingres のドキュメント (Ingres
SQL reference guideを参照ください) に書かれた正しい形式の SQL クエリ。 ingres_prepare() を使って実行できない SQL 文の一覧は、 ingres_query() の query パラメータを参照ください。
返り値
ingres_prepare() はクエリの結果 ID を返します。 ingres_execute() でクエリを実行するときに、これを使います。 エラーが発生したかどうかを知るには、ingres_errno()、 ingres_error() あるいは ingres_errsqlstate() を使います。
参考
- ingres_unbuffered_query() - 未バッファ SQL クエリを Ingres に送信する
- ingres_fetch_array() - 1 行分の結果を配列に取得する
- ingres_fetch_assoc() - 1 行分の結果を連想配列に取得する
- ingres_fetch_object() - 1 行分の結果をオブジェクトとして取得する
- ingres_fetch_row() - 1 行分の結果を数値添字配列として取得する
- ingres_commit() - トランザクションをコミットする
- ingres_rollback() - トランザクションをロールバックする
- ingres_autocommit() - autocommit をオンまたはオフに切替える
- ingres_set_environment() - 環境を設定して出力オプションを制御する
- ingres_errno() - 直近に発生した ingres エラー番号を取得する
- ingres_error() - 直近に発生したエラーのエラーメッセージを取得する
