pg_send_query
非同期クエリを送信する
&reftitle.description;
intboolpg_send_query
PgSql\Connectionconnection
stringquery
pg_send_query は、connection
に非同期クエリを送信します。pg_query とは異なり、
PostgreSQL へ一度に複数のクエリを送信することができ、
pg_get_result を用いて結果を一つずつ取得することが可能です。
スクリプトの実行は、クエリを実行中もブロックされません。
接続がビジーである(すなわち、クエリが実行中である)ことを調べるには、
pg_connection_busy を使用してください。
クエリは、pg_cancel_query
をコールすることによりキャンセルすることが可能です。
ユーザーは複数のクエリを一度に送信することができますが、
複数のクエリをビジー状態の接続に送信することはできません。
クエリがビジー状態の接続に送信された場合、
最後のクエリが終了するまで待ち、全ての結果は破棄されます。
&reftitle.parameters;
connection
&pgsql.parameter.connection;
query
実行するひとつまたは複数の SQL 文。
クエリ内のデータは 適切にエスケープ
する必要があります。
&reftitle.returnvalues;
成功した場合に &true; 、失敗した場合に 0 を返します。
クエリの結果を確かめるには pg_get_result を使用します。
&reftitle.changelog;
&Version;
&Description;
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_send_query の例
]]>
&example.outputs;
&reftitle.seealso;
pg_query
pg_cancel_query
pg_get_result
pg_connection_busy