db2_execute

db2_execute(resource $stmt, [array $parameters]): bool
```php

`db2_execute` ejecuta una consulta SQL que ha sido preparada por `db2_prepare`.

Si la consulta SQL devuelve un conjunto de resultados, por ejemplo, una consulta SELECT o CALL a un procedimiento de registro devuelve uno o varios conjuntos de resultados, puede recuperar una fila como un array a partir de la recurso `stmt` utilizando `db2_fetch_assoc`, `db2_fetch_both` o `db2_fetch_array`. Alternativamente, puede utilizar `db2_fetch_row` para mover el puntero a la fila siguiente y recuperar una columna a la vez de esta fila con la función `db2_result`.

Consúltese `db2_prepare` para una breve discusión sobre las ventajas de utilizar `db2_prepare` y `db2_execute` en lugar de `db2_exec`.

## Parámetros

`stmt`  
Una consulta preparada devuelta por `db2_prepare`.

`parameters`  
Un array de parámetros de entrada que contiene los marcadores de variables contenidos en la consulta preparada.

## Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

## Ejemplos

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á pasado a la función `db2_execute`.

El ejemplo anterior mostrará:

    Añadido un nuevo animal con éxito.

Llamada a un procedimiento de registro con un parámetro de SALIDA

El siguiente ejemplo prepara una consulta CALL que acepta un marcador que representa un parámetro de SALIDA, vincula la variable PHP `$my_pets` al parámetro utilizando la función `db2_bind_param` y llama a la función `db2_execute` para ejecutar la consulta CALL. Una vez que la consulta CALL ha sido ejecutada, el valor de `$num_pets` cambia para reflejar el valor devuelto por el procedimiento de registro para este parámetro de SALIDA.

El ejemplo anterior mostrará:

    Tengo 7 animales !

Devuelve datos XML como ResultSet SQL

El siguiente ejemplo demuestra cómo utilizar documentos almacenados en una columna XML utilizando la base de datos SAMPLE. Utilizando un simple SQL/XML, este ejemplo devuelve algunos nodos en un documento XML en un formato ResultSet SQL con el que la mayoría de los usuarios están familiarizados.

El ejemplo anterior mostrará:

    1000     Kathy Smith     416-555-1358
    1001     Kathy Smith     905-555-7258

Ejecutar un "JOIN" con datos XML

El siguiente ejemplo trabaja con documentos almacenados en dos columnas diferentes en la base de datos SAMPLE. Esto crea dos tablas temporales a partir de los documentos XML de dos diferentes columnas XML y devuelve un ResultSet SQL con la información que contiene el estado de envío para un cliente.

El ejemplo anterior mostrará:

    1001     Kathy Smith     905-555-7258     5002     Shipped

Devuelve datos SQL que forman parte de un documento XML grande

El siguiente ejemplo utiliza una porción de los documentos de PRODUCT.DESCRIPTION en la base de datos SAMPLE. Esto crea un documento XML que contiene la descripción del producto (datos XML) y las informaciones concernientes al precio (datos SQL).

<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>