A simple select example.
$pr_stmt = db2_prepare ($this->conn,"select count(*) from note where city=? and year= ?");
db2_execute($pr_stmt,array('test',2016));
$count_res = db2_fetch_array($pr_stmt);
echo "Count =".$count_res[0]
db2_prepare
(PECL ibm_db2 >= 1.0.0)
db2_prepare — Prépare une requête SQL à être exécutée
Description
db2_prepare() crée une requête SQL préparée qui peut
inclure aucun ou plusieurs marqueurs (caractères ?)
représentant les paramètres d'entrée, sortie ou d'entrée/sortie. Vous
pouvez passer des paramètres à la requête préparée en utilisant la
fonction db2_bind_param(), si vous avez que des entrées,
vous pouvez utiliser db2_execute().
Il y a trois principaux avantages d'utiliser les requêtes préparées dans votre application :
-
Performance : lorsque vous préparez une requête, le serveur de base de données crée un plan d'accès optimisé pour la récupération des données avec la requête. Par la suite, l'envoi de la requête préparée avec db2_execute() permet à la requête de réutiliser le plan d'accès et ainsi d'éviter les surcharges du processeurs à chaque envoi de requête qui créerait dynamiquement un nouveau plan d'accès.
-
Sécurité : lorsque vous préparez une requête, vous pouvez inclure des marqueurs pour les valeurs d'entrées. Lorsque vous exécutez une requête préparée avec ces valeurs d'entrées, le serveur de base de données vérifie chaque valeur d'entrée pour s'assurer que les types concordent avec la définition de la colonne ou du paramètre de définition.
-
Fonctionnalité avancée : Les marqueurs vous permettent non seulement de passer des valeurs d'entrées dans les requêtes SQL préparées, mais permettent aussi de récupérer des paramètres de SORTIE et d'ENTRÉE/SORTIE des procédures d'enregistrement en utilisant la fonction db2_bind_param().
Liste de paramètres
-
connection -
Une variable ressource de connexion valide retournée par db2_connect() ou db2_pconnect().
-
statement -
Une requête SQL qui peut contenir un ou plusieurs marqueurs.
-
options -
Un tableau associatif contenant les options de la requête. Vous pouvez utiliser ce paramètre pour demander un curseur flottant sur les serveurs de base de données qui supportent cette fonctionnalité.
Pour une description des options valides, reportez-vous à la fonction db2_set_option().
Valeurs de retour
Retourne une variable ressource si la requête SQL était envoyée
correctement ou false si le serveur de base de données a
retourné une erreur. Vous pouvez déterminer quelle erreur a été retournée
en appelant la fonction
db2_stmt_error() ou db2_stmt_errormsg().
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
$animaux = array(
array(0, 'chat', 'Pook', 3.2),
array(1, 'chien', 'Peaches', 12.3),
array(2, 'cheval', 'Smarty', 350.0),
);
$insert = 'INSERT INTO animaux (id, race, nom, poids)
VALUES (?, ?, ?, ?)';
$stmt = db2_prepare($conn, $insert);
if ($stmt) {
foreach ($animaux as $animal) {
$result = db2_execute($stmt, $animal);
}
}
?>Voir aussi
- db2_bind_param() - Associe une variable PHP à un paramètre d'une requête SQL
- db2_execute() - Exécute une requête SQL préparée
- db2_stmt_error() - Retourne une chaîne contenant la valeur de SQLSTATE retournée par une requête SQL
- db2_stmt_errormsg() - Retourne le dernier message d'erreur d'une requête SQL
add a note
User Contributed Notes 3 notes
agr dot valayam at gmail dot com ¶
8 years ago
NormInNorman ¶
14 years ago
If you are having problems with scrollable cursors and the prepare statement, I've found that you cant set the scrollable option on the connection. The following code (which tries to get the 2nd record):
<?php
$sql = "SELECT * FROM SCHEMA.TABLENAME";
$options = array('cursor' => DB2_SCROLLABLE);
$conn = db2_connect($database, $user, $password,$options);
$stmt = db2_prepare($conn, $sql);
$result = db2_execute($stmt);
$row = db2_fetch_both($stmt, 2);
$conn = db2_connect($database, $user, $password);
$stmt = db2_prepare($conn, $sql, $options);
$result = db2_execute($stmt);
$row = db2_fetch_both($stmt, 2);
?>
Will result in the following error:
Warning: db2_fetch_both() [function.db2-fetch-both]: Fetch Failure in dbtest.php on line 7
In fact, even if you set the options on both the connection and the prepare your fetch will not work. You must only set that option on the prepare.
ndt.db2 at google mail ¶
18 years ago
if you have the error message : PHP Warning: db2_prepare() [<a href='function.db2-prepare'>function.db2-prepare</a>]: Statement Prepare Failed in (....)
and cannot display the error message using db2_stmt_errormsg() , then check if your database connection handle is (still) valid
