pg_send_query
Sends asynchronous query
&reftitle.description;
intboolpg_send_queryPgSql\Connectionconnectionstringquerypg_send_query sends a query or queries asynchronously to the
connection. Unlike
pg_query, it can send multiple queries at once to
PostgreSQL and get the results one by one using
pg_get_result.
Script execution is not blocked while the queries are executing. Use
pg_connection_busy to check if the connection is
busy (i.e. the query is executing). Queries may be cancelled using
pg_cancel_query.
Although the user can send multiple queries at once, multiple queries
cannot be sent over a busy connection. If a query is sent while
the connection is busy, it waits until the last query is finished and
discards all its results.
&reftitle.parameters;
connection
&pgsql.parameter.connection;
query
The SQL statement or statements to be executed.
Data inside the query should be properly escaped.
&reftitle.returnvalues;
Returns &true; on success, &false; or 0 on failure. Use pg_get_result
to determine the query result.
&reftitle.changelog;
&Version;&Description;
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_send_query example
]]>
&example.outputs;
&reftitle.seealso;
pg_querypg_cancel_querypg_get_resultpg_connection_busy