db2_execute
Executes a prepared SQL statement
&reftitle.description;
booldb2_execute
resourcestmt
arrayparameters
db2_execute executes an SQL statement that was
prepared by db2_prepare.
If the SQL statement returns a result set, for example, a SELECT statement
or a CALL to a stored procedure that returns one or more result sets, you
can retrieve a row as an array from the stmt resource
using db2_fetch_assoc,
db2_fetch_both, or
db2_fetch_array. Alternatively, you can use
db2_fetch_row to move the result set pointer to the
next row and fetch a column at a time from that row with
db2_result.
Refer to db2_prepare for a brief discussion of the
advantages of using db2_prepare and
db2_execute rather than db2_exec.
&reftitle.parameters;
stmt
A prepared statement returned from db2_prepare.
parameters
An array of input parameters matching any parameter markers contained
in the prepared statement.
&reftitle.returnvalues;
&return.success;
&reftitle.examples;
Preparing and executing an SQL statement with parameter markers
The following example prepares an INSERT statement that accepts four
parameter markers, then iterates over an array of arrays containing the
input values to be passed to db2_execute.
]]>
&example.outputs;
Calling a stored procedure with an OUT parameter
The following example prepares a CALL statement that accepts one
parameter marker representing an OUT parameter, binds the PHP variable
$my_pets to the parameter using
db2_bind_param, then issues
db2_execute to execute the CALL statement. After the
CALL to the stored procedure has been made, the value of
$num_pets changes to reflect the value returned by the
stored procedure for that OUT parameter.
]]>
&example.outputs;
Returning XML data as a SQL ResultSet
The following example demonstrates how to work with documents stored
in a XML column using the SAMPLE database. Using some pretty simple
SQL/XML, this example returns some of the nodes in a XML document in
a SQL ResultSet format that most users are familiar with.
CID $row->NAME $row->PHONE\n");
}
}
db2_close($conn);
?>
]]>
&example.outputs;
Performing a "JOIN" with XML data
The following example works with documents stored in 2 different
XML columns in the SAMPLE database. It creates 2 temporary
tables from the XML documents from 2 different columns and
returns a SQL ResultSet with information regarding shipping
status for the customer.
CID $row->NAME $row->PHONE $row->PONUM $row->STATUS\n");
}
}
db2_close($conn);
?>
]]>
&example.outputs;
Returning SQL data as part of a larger XML document
The following example works with a portion of the PRODUCT.DESCRIPTION
documents in the SAMPLE database. It creates a XML document containing
product description (XML data) and pricing info (SQL data).
{
for $prod in $doc/product
where $prod/description/price < 10.00
order by $prod/description/price ascending
return(
{
$prod,
{$start} ,
{$end} ,
{$promo}
}
)
}
\' passing by ref DESCRIPTION AS "doc",
PROMOSTART as "start",
PROMOEND as "end",
PROMOPRICE as "promo"
RETURNING SEQUENCE)
AS CLOB (32000))
AS NEW_PRODUCT_INFO
FROM PRODUCT
WHERE PID = ?
';
$stmt = db2_prepare($conn, $query);
$pid = "100-100-01";
if ($stmt) {
db2_bind_param($stmt, 1, "pid", DB2_PARAM_IN);
db2_execute($stmt);
while($row = db2_fetch_array($stmt)){
printf("$row[0]\n");
}
}
db2_close($conn);
?>
]]>
&example.outputs;
Snow Shovel, Basic 22 inch
Basic Snow Shovel, 22 inches wide, straight handle with D-Grip
9.99
1 kg
2004-11-19
2004-12-19
7.25
]]>
&reftitle.seealso;
db2_exec
db2_fetch_array
db2_fetch_assoc
db2_fetch_both
db2_fetch_row
db2_prepare
db2_result