INGRES_QUERY(3) 							 1							   INGRES_QUERY(3)

ingres_query - Send an SQL query to Ingres

SYNOPSIS

       mixed ingres_query (resource  $link, string  $query, [array  $params], [string  $types])

DESCRIPTION

       ingres_query(3) sends the given $query to the Ingres server.

	The  query  becomes  part  of the currently open transaction. If there is no open transaction, ingres_query(3) opens a new transaction. To
       close the transaction, you can call either ingres_commit(3) to commit the changes made to the  database	or  ingres_rollback(3)	to  cancel
       these  changes. When the script ends, any open transaction is rolled back (by calling ingres_rollback(3)). You can also use ingres_autocom-
       mit(3) before opening a new transaction to have every SQL query immediately committed.

       Note

	      Related Configurations

	       See also the ingres.describe, ingres.scrollable and ingres.utf8 directives in Runtime Configuration

PARAMETERS

	      o $link
		- The connection link identifier.

	      o $query
		- A valid SQL query (see the Ingres SQL reference guide) in the Ingres documentation.  Data inside the query  should  be  properly
		escaped.  The following types of SQL queries cannot be sent with this function:

		     o close (see ingres_close(3))

		     o commit (see ingres_commit(3))

		     o connect (see ingres_connect(3))

		     o disconnect (see ingres_close(3))

		     o get dbevent

		     o prepare to commit

		     o rollback (see ingres_rollback(3))

		     o savepoint

		     o set autocommit (see ingres_autocommit(3))

		     oall cursor-related queries are unsupported

	      o $params
		- An array of parameter values to be used with the query

	      o $types
		-  A string containing a sequence of types for the parameter values passed. When ingres.describe is enabled, this parameter can be
		ignored as the driver automatically fetches the expected parameter types from the server.

	      +----------+------------------------------+---+---+
	      |Type code |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	   Ingres type		|   |	|
	      | 	 |				|   |	|
	      +----------+------------------------------+---+---+
	      |    a	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	     BOOLEAN		|   |	|
	      | 	 |				|   |	|
	      |    b	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	       BYTE		|   |	|
	      | 	 |				|   |	|
	      |    B	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	  LONG BYTE/BLOB	|   |	|
	      | 	 |				|   |	|
	      |    c	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	       CHAR		|   |	|
	      | 	 |				|   |	|
	      |    d	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 | DATE/ANSIDATE/TIMESTAMP/TIME |   |	|
	      | 	 |				|   |	|
	      |    f	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	      FLOAT		|   |	|
	      | 	 |				|   |	|
	      |    i	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	     INTEGER		|   |	|
	      | 	 |				|   |	|
	      |    L	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	    LONG TEXT		|   |	|
	      | 	 |				|   |	|
	      |    m	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	      MONEY		|   |	|
	      | 	 |				|   |	|
	      |    M	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	  LONG NVARCHAR 	|   |	|
	      | 	 |				|   |	|
	      |    n	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	      NCHAR		|   |	|
	      | 	 |				|   |	|
	      |    N	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	     NVARCHAR		|   |	|
	      | 	 |				|   |	|
	      |    t	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	       TEXT		|   |	|
	      | 	 |				|   |	|
	      |    v	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	     VARCHAR		|   |	|
	      | 	 |				|   |	|
	      |    V	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |				|   |	|
	      | 	 |	   LONG VARCHAR 	|   |	|
	      | 	 |				|   |	|
	      +----------+------------------------------+---+---+
RETURN VALUES

       ingres_query(3) returns a query result identifier on success else it returns FALSE. To  see  if	an  error  occurred  use  ingres_errno(3),
       ingres_error(3) or ingres_errsqlstate(3).

EXAMPLES

       Example #1

	      Send a simple select

	      <?php
	      $link = ingres_connect("demodb");

	      $result = ingres_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_query(3)

	      <?php
	      $link = ingres_connect("demodb");

	      $params[] = "Emma";
	      $query = "select * from user_profile where up_first = ?";
	      $result = ingres_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_query($link, $query , $params, $param_types);

	      if (ingres_errno())
	      {
		  echo ingres_errno() . "-" . ingres_error() . "
";
	      }

	      ingres_commit($link);

	      ingres_close($link);
	      ?>

SEE ALSO

       ingres_unbuffered_query(3),  ingres_fetch_array(3),  ingres_fetch_assoc(3),  ingres_fetch_object(3), ingres_fetch_row(3), ingres_commit(3),
       ingres_rollback(3), ingres_autocommit(3), ingres_set_environment(3), ingres_errno(3), ingres_error(3).

PHP Documentation Group 													   INGRES_QUERY(3)