oci_set_prefetch

oci_set_prefetch(resource $statement, int $rows): bool
```php

Define el número de filas a pre-cargar por las bibliotecas clientes de Oracle después de una llamada exitosa a la función `oci_execute` pero también para cada llamada a las funciones internas de recuperación de filas en la base de datos. Para las consultas que devuelven un gran número de filas, el rendimiento puede mejorar significativamente aumentando el número de filas a pre-cargar respecto al valor por omisión definido por la opción de configuración [oci8.default_prefetch](#ini.oci8.default-prefetch).

La pre-carga es una forma eficiente de devolver más de una fila de datos desde la base de datos por cada envío de red. Esto permite una mejor utilización de la red y del CPU. La pre-carga de filas es interna a OCI8 y el comportamiento de las funciones de recuperación de datos permanece inalterado según el valor del contador de pre-carga. Por ejemplo, la función `oci_fetch_row` siempre devolverá una fila. El buffer de pre-carga es específico de cada consulta y no será utilizado para re-ejecutar consultas o por otras conexiones.

Es conveniente llamar a la función `oci_set_prefetch` antes de la función `oci_execute`.

Una forma de mejorar la eficiencia es definir el valor de pre-carga a un valor razonable según la red y la base de datos a gestionar. Para las consultas que devuelven un número muy grande de filas, es conveniente recuperar el conjunto de filas por partes (es decir, definir el valor de pre-carga a un valor inferior al número total de filas). Esto permite a la base de datos gestionar las consultas de otros usuarios mientras el script PHP gestiona el conjunto de filas actual.

La pre-carga fue introducida en Oracle 8*i*. La pre-carga `REF CURSOR` fue introducida en Oracle 11*g*R2 y está disponible cuando PHP está vinculado con las bibliotecas clientes de Oracle 11*g*R2 (o superior). Los cursores anidados de pre-carga fueron introducidos en Oracle 11*g*R2 y requieren tanto las bibliotecas clientes de Oracle, como una base de datos en versión 11*g*R2 (o superior).

La pre-carga no es soportada cuando las consultas contienen columnas de tipo LONG o LOB. El valor de pre-carga será utilizado en todas las situaciones donde la pre-carga es soportada.

Al utilizar la base de datos Oracle 12*c*, el conjunto de valores pre-cargados por PHP puede ser sobrescrito por el archivo de configuración cliente de Oracle `oraaccess.xml`. Consulte la documentación de Oracle para más detalles.

## Parámetros

`statement`  
Un identificador de consulta OCI8 creado por la función `oci_parse` y ejecutado por la función `oci_execute`, o un identificador de consulta `REF CURSOR`.

`rows`  
El número de filas a pre-cargar, \>=0

## Valores devueltos

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

## Ejemplos

Modificación del valor de pre-carga para una consulta

Modificación del valor de pre-carga para una recuperación REF CURSOR

Si PHP OCI8 recupera datos desde un cursor `REF CURSOR` y luego devuelve el cursor `REF CURSOR` a un segundo procedimiento almacenado para su procesamiento, entonces es conveniente definir la pre-carga de `REF CURSOR` a `0` para evitar perder filas del conjunto de resultados. El valor de pre-carga es el número de filas adicionales a recuperar para cada llamada interna OCI8 a la base de datos, por lo tanto, definirlo a `0` significa simplemente que se desea recuperar una sola fila a la vez.

Definición del valor de pre-carga al devolver un cursor `REF CURSOR` a Oracle