PHP 8.5.0 Alpha 1 available for testing

db2_prepare

(PECL ibm_db2 >= 1.0.0)

db2_prepare Prepara una consulta SQL para ser ejecutada

Descripción

db2_prepare(resource $connection, string $statement, array $options = []): resource|false

db2_prepare() crea una consulta SQL preparada que puede incluir ningún o varios marcadores (caracteres ?) representando los argumentos de entrada, salida o entrada/salida. Se pueden pasar argumentos a la consulta preparada utilizando la función db2_bind_param(), si solo hay entradas, se puede utilizar db2_execute().

Existen tres ventajas principales de utilizar consultas preparadas en la aplicación :

  • Rendimiento : al preparar una consulta, el servidor de base de datos crea un plan de acceso optimizado para la recuperación de datos con la consulta. Posteriormente, el envío de la consulta preparada con db2_execute() permite a la consulta reutilizar el plan de acceso y así evitar sobrecargas del procesador en cada envío de consulta que crearía dinámicamente un nuevo plan de acceso.

  • Seguridad : al preparar una consulta, se pueden incluir marcadores para los valores de entrada. Al ejecutar una consulta preparada con estos valores de entrada, el servidor de base de datos verifica cada valor de entrada para asegurarse de que los tipos coincidan con la definición de la columna o del parámetro de definición.

  • Funcionalidad avanzada : Los marcadores permiten no solo pasar valores de entrada en las consultas SQL preparadas, sino también recuperar parámetros de SALIDA y de ENTRADA/SALIDA de los procedimientos de registro utilizando la función db2_bind_param().

Parámetros

connection

Una variable recurso de conexión válida devuelta por db2_connect() o db2_pconnect().

statement

Una consulta SQL que puede contener uno o varios marcadores.

options

Un array asociativo que contiene las opciones de la consulta. Se puede utilizar este parámetro para solicitar un cursor flotante en los servidores de base de datos que soportan esta funcionalidad.

Para una descripción de las opciones válidas, consulte la función db2_set_option().

Valores devueltos

Devuelve una variable recurso si la consulta SQL fue enviada correctamente o false si el servidor de base de datos ha devuelto un error. Se puede determinar qué error fue devuelto llamando a la función db2_stmt_error() o db2_stmt_errormsg().

Ejemplos

Ejemplo #1 Preparación y ejecución de una consulta SQL con marcadores

El siguiente ejemplo prepara una consulta INSERT que acepta cuatro marcadores, luego itera sobre el array que contiene los valores de entrada que serán pasados a la función db2_execute().

<?php
$animales
= array(
array(
0, 'gato', 'Pook', 3.2),
array(
1, 'perro', 'Peaches', 12.3),
array(
2, 'caballo', 'Smarty', 350.0),
);

$insert = 'INSERT INTO animales (id, raza, nombre, peso)
VALUES (?, ?, ?, ?)'
;
$stmt = db2_prepare($conn, $insert);
if (
$stmt) {
foreach (
$animales as $animal) {
$result = db2_execute($stmt, $animal);
}
}
?>

Ver también

add a note

User Contributed Notes 3 notes

up
0
agr dot valayam at gmail dot com
8 years ago
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]
up
0
NormInNorman
15 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.
up
-2
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
To Top