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().
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é.
cursor
La valeur DB2_FORWARD_ONLY demande un curseur
d'avancement seul pour cette requête SQL. Cette valeur est le
type par défaut pour un curseur et est supportée par tous les
serveurs de base de données. C'est aussi beaucoup plus rapide qu'un
curseur flottant.
La valeur DB2_SCROLLABLE demande un curseur
flottant pour cette requête SQL. Ce type de curseur permet de
récupérer les lignes de manière non séquentielle du serveur de base
de données. Cependant, cela est supporté que par les serveurs DB2
et est beaucoup plus lent que les curseurs d'avancement seul.
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().
