db2_execute
(PECL)
db2_execute --
Exécute une requête SQL préparée
Description
bool
db2_execute ( resource stmt [, array parameters] )
db2_execute() exécute une requête SQL qui a été
préparée par db2_prepare().
Si la requête SQL retourne un jeu de résultats, par exemple, une requête
SELECT ou CALL à une procédure d'enregistrement retourne un ou
plusieurs jeux de résultats, vous pouvez récupérer une ligne en tant que
tableau à partir de la ressource stmt en utilisant
db2_fetch_assoc(),
db2_fetch_both() ou
db2_fetch_array(). Alternativement, vous pouvez utiliser
db2_fetch_row() pour déplacer le pointeur à
la ligne suivante et récupérer une colonne à la fois de cette ligne avec la
fonction db2_result().
Référez-vous à db2_prepare() pour une brève discussion
sur les avantages de l'utilisation de db2_prepare() et
db2_execute() plutôt que db2_exec().
Liste de paramètres
stmt
Une requête préparée retournée par db2_prepare().
parameters
Un tableau des paramètres d'entrée qui contient les marqueurs de
variables contenus dans la requête préparée.
Valeurs de retour
Cette fonction retourne TRUE en cas de
succès, FALSE en cas d'échec.
Exemples
Exemple 1. Préparation et exécution d'une requête SQL avec des marqueurs
L'exemple suivant prépare une requête INSERT qui accepte quatre
marqueurs, ensuite itère sur le tableau contenant les valeurs d'entrées
qui sera passé à la fonction db2_execute().
<?php $pet = array(0, 'chat', 'Pook', 3.2);
$insert = 'INSERT INTO animaux (id, race, nom, poids) VALUES (?, ?, ?, ?)';
$stmt = db2_prepare($conn, $insert); if ($stmt) { $result = db2_execute($stmt, $pet); if ($result) { print "Ajout d'un nouvel animal réussi."; } } ?>
|
L'exemple ci-dessus va afficher : Ajout d'un nouvel animal réussi. |
|
Exemple 2. Appel d'une procédure d'enregistrement avec un paramètre de SORTIE
L'exemple suivant prépare une requête CALL qui accepte un marqueur qui
représente un paramètre de SORTIE, lie la variable PHP $my_pets
au paramètre en utilisant la fonction
db2_bind_param() et appelle la fonction
db2_execute() pour exécuter la requête
CALL. Une fois que la requête CALL a été exécutée, la valeur de
$num_pets change pour réfléchir la valeur retournée
par la procédure d'enregistrement pour ce paramètre de SORTIE.
<?php $num_pets = 0; $res = db2_prepare($conn, "CALL count_my_pets(?)"); $rc = db2_bind_param($res, 1, "num_pets", DB2_PARAM_OUT); $rc = db2_execute($res); print "Je possède $num_pets animaux !"; ?>
|
L'exemple ci-dessus va afficher : |
Exemple 3. Retourne des données XML en tant que ResultSet SQL
L'exemple suivant démontre comment utiliser des documents enregistrés
dans une colonne XML en utilisant la base de données SAMPLE. En
utilisant un simple SQL/XML, cet exemple retourne quelques noeuds dans un
document XML dans un format ResultSet SQL dont la plupart des
utilisateurs sont familiers.
<?php $conn = db2_connect("SAMPLE", "db2inst1", "ibmdb2"); $query = 'SELECT * FROM XMLTABLE( XMLNAMESPACES (DEFAULT \'http://posample.org\'), \'db2-fn:xmlcolumn("CUSTOMER.INFO")/customerinfo\' COLUMNS "CID" VARCHAR (50) PATH \'@Cid\', "NAME" VARCHAR (50) PATH \'name\', "PHONE" VARCHAR (50) PATH \'phone [ @type = "work"]\' ) AS T WHERE NAME = ? ';
$stmt = db2_prepare($conn, $query); $name = 'Kathy Smith';
if ($stmt) { db2_bind_param($stmt, 1, "name", DB2_PARAM_IN); db2_execute($stmt); while($row = db2_fetch_object($stmt)){ printf("$row->CID $row->NAME $row->PHONE\n"); } } db2_close($conn);
?>
|
L'exemple ci-dessus va afficher : 1000 Kathy Smith 416-555-1358
1001 Kathy Smith 905-555-7258 |
|
Exemple 4. Exécuter un "JOIN" avec des données XML
L'exemple suivant fonctionne avec des documents enregistrés dans deux
colonnes différentes dans la base de données SAMPLE. Cela crée deux
tables temporaires provenant des documents XML de deux différentes
colonnes XML et retourne un ResultSet SQL avec les informations contenant
le statut de livraison pour un client.
<?php
$conn = db2_connect("SAMPLE", "db2inst1", "ibmdb2");
$query = ' SELECT A.CID, A.NAME, A.PHONE, C.PONUM, C.STATUS FROM XMLTABLE( XMLNAMESPACES (DEFAULT \'http://posample.org\'), \'db2-fn:xmlcolumn("CUSTOMER.INFO")/customerinfo\' COLUMNS "CID" BIGINT PATH \'@Cid\', "NAME" VARCHAR (50) PATH \'name\', "PHONE" VARCHAR (50) PATH \'phone [ @type = "work"]\' ) as A, PURCHASEORDER AS B, XMLTABLE ( XMLNAMESPACES (DEFAULT \'http://posample.org\'), \'db2-fn:xmlcolumn("PURCHASEORDER.PORDER")/PurchaseOrder\' COLUMNS "PONUM" BIGINT PATH \'@PoNum\', "STATUS" VARCHAR (50) PATH \'@Status\' ) as C WHERE A.CID = B.CUSTID AND B.POID = C.PONUM AND A.NAME = ? ';
$stmt = db2_prepare($conn, $query);
$name = 'Kathy Smith';
if ($stmt) { db2_bind_param($stmt, 1, "name", DB2_PARAM_IN); db2_execute($stmt); while($row = db2_fetch_object($stmt)){ printf("$row->CID $row->NAME $row->PHONE $row->PONUM $row->STATUS\n"); } }
db2_close($conn);
?>
|
L'exemple ci-dessus va afficher : 1001 Kathy Smith 905-555-7258 5002 Shipped |
|
Exemple 5. Retourne des données SQL faisant partie d'un document XML large
L'exemple suivant utilise une portion des documents de
PRODUCT.DESCRIPTION dans la base de données SAMPLE. Cela crée un document
XML contenant la description du produit (données XML) et les informations
concernant le prix (données SQL).
<?php
$conn = db2_connect("SAMPLE", "db2inst1", "ibmdb2");
$query = ' SELECT XMLSERIALIZE( XMLQUERY(\' declare boundary-space strip; declare default element namespace "http://posample.org"; <promoList> { for $prod in $doc/product where $prod/description/price < 10.00 order by $prod/description/price ascending return( <promoitem> { $prod, <startdate> {$start} </startdate>, <enddate> {$end} </enddate>, <promoprice> {$promo} </promoprice> } </promoitem> ) } </promoList> \' 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);
?>
|
L'exemple ci-dessus va afficher : <promoList xmlns="http://posample.org">
<promoitem>
<product pid="100-100-01">
<description>
<name>Snow Shovel, Basic 22 inch</name>
<details>Basic Snow Shovel, 22 inches wide, straight handle with D-Grip</details>
<price>9.99</price>
<weight>1 kg</weight>
</description>
</product>
<startdate>2004-11-19</startdate>
<enddate>2004-12-19</enddate>
<promoprice>7.25</promoprice>
</promoitem>
</promoList> |
|