Php/docs/function.ingres-unbuffered-query
ingres_unbuffered_query
(No version information available, might only be in Git)
ingres_unbuffered_query — Send an unbuffered SQL query to Ingres
说明
ingres_unbuffered_query
( resource $link
, string $query
[, array $params
[, string $types
]] ) : mixed
ingres_unbuffered_query() sends the given
query
to the Ingres server.
The query becomes part of the currently open transaction. If there is no open transaction, ingres_unbuffered_query() opens a new transaction. To close the transaction, you can call either ingres_commit() to commit the changes made to the database or ingres_rollback() to cancel these changes. When the script ends, any open transaction is rolled back (by calling ingres_rollback()). You can also use ingres_autocommit() before opening a new transaction to have every SQL query immediately committed. Ingres allows only a single unbuffered statement to be active at any one time. The extension will close any active unbuffered statements before executing any SQL. In addition you cannot use ingres_result_seek() to position the row before fetching.
Note:
Related Configurations
See also the ingres.describe and ingres.utf8 directives in Runtime Configuration.
参数
link
The connection link identifier
query
A valid SQL query (see the Ingres SQL reference guide) in the Ingres documentation. See the query parameter in ingres_query() for a list of SQL statements that cannot be executed via ingres_unbuffered_query().
Data inside the query should be properly escaped.
params
An array of parameter values to be used with the query
types
A string containing a sequence of types for the parameter values passed. See the types parameter in ingres_query() for the list of type codes.
返回值
ingres_unbuffered_query() returns a query result identifier when
there are rows to fetch; else it returns false
when there are no rows, as
is the case of an INSERT, UPDATE, or DELETE statement. To see if an error
occurred, use ingres_errno(),
ingres_error(), or
ingres_errsqlstate().
范例
Example #1 Issue a simple un-buffered select
<?php$link = ingres_connect("demodb");$result = ingres_unbuffered_query($link, "select * from user_profile");while ($row = ingres_fetch_row($result)) { echo $row[1]; echo $row[2];}?>
Example #2 Passing query parameters to ingres_unbuffered_query()
<?php$link = ingres_connect("demodb");$params[] = "Emma";$query = "select * from user_profile where up_first = ?";$result = ingres_unbuffered_query($link, $query, $params);while ($row = ingres_fetch_row($result)) { echo $row[1]; echo $row[2];}?>
Example #3 Inserting a BLOB with parameter types
<?php$link = ingres_connect("demodb");//Open a photo$fh = fopen("photo.jpg","r");$blob_data = stream_get_contents($fh);fclose($fh);//Prepare parameters$params[] = $blob_data;$params[] = 1201;//Define parameter types$param_types = "Bi";$query = "update user_profile set up_image = ? where up_id = ?";$result = ingres_unbuffered_query($link, $query , $params, $param_types);if (ingres_errno()){ echo ingres_errno() . "-" . ingres_error() . "\n";}?>
参见
- ingres_query() - Send an SQL query to Ingres
- ingres_fetch_array() - Fetch a row of result into an array
- ingres_fetch_assoc() - Fetch a row of result into an associative array
- ingres_fetch_object() - Fetch a row of result into an object
- ingres_fetch_row() - Fetch a row of result into an enumerated array
- ingres_commit() - Commit a transaction
- ingres_rollback() - Roll back a transaction
- ingres_autocommit() - Switch autocommit on or off
- ingres_set_environment() - Set environment features controlling output options
- ingres_errno() - Get the last Ingres error number generated
- ingres_error() - Get a meaningful error message for the last error generated