oci_set_edition

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)

oci_set_edition — Define la edición de la base de datos

Descripción

oci_set_edition(string $edition): bool

Define la edición de los objetos de la base de datos a utilizar por las conexiones.

La edición Oracle permite que versiones concurrentes de las aplicaciones se ejecuten utilizando el mismo nombre de esquema y objetos. Esto es práctico para actualizar sistemas en vivo.

Llame a la función oci_set_edition() antes de llamar a una función como oci_connect(), oci_pconnect() o oci_new_connect().

Si se define una edición pero no es válida en la base de datos, cualquier intento de conexión fallará incluso si la función oci_set_edition() devuelve un estado de éxito.

Al utilizar conexiones persistentes, si una conexión con la edición solicitada ya existe, será reutilizada. De lo contrario, se creará una conexión persistente diferente.

Parámetros

edition: Nombre de la edición Oracle, previamente creada con el comando SQL "CREATE EDITION".

Valores devueltos

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

Ejemplos

Ejemplo #1 2 scripts pueden utilizar diferentes versiones de myfunc() al mismo momento

<?php

// Archivo 1

echo "Versión 1 de la aplicación\n";

oci_set_edition('ORA$BASE');
$c = oci_connect('hr', 'welcome', 'localhost/XE');

$s = oci_parse($c, "begin :r := myfunc(); end;");
oci_bind_by_name($s, ":r", $r, 20);
oci_execute($s);
echo "El resultado es $r\n";

?>

<?php

// Archivo 2

echo "Versión 2 de la aplicación\n";

oci_set_edition('E1');
$c = oci_connect('hr', 'welcome', 'localhost/XE');

$s = oci_parse($c, "begin :r := myfunc(); end;");
oci_bind_by_name($s, ":r", $r, 20);
oci_execute($s);
echo "El resultado es $r\n";

?>

Notas

Nota: Requisito de la versión Oracle

Esta función está disponible para Oracle 11gR2 y versiones posteriores.

Precaución

Conexiones persistentes

Para evitar inconsistencias de datos o errores inesperados, no se utilice la consulta ALTER SESSION SET EDITION para cambiar una edición en las conexiones persistentes.

Precaución

Cola de conexiones DRCP

Para evitar inconsistencias de datos o errores inesperados al utilizar ediciones y DRCP con Oracle 11.2.0.1, mantenga una correspondencia uno-a-uno entre oci8.connection_class y el nombre de la edición utilizado por sus aplicaciones. Cada servidor para una clase de conexión dada debe ser utilizado con una sola edición. Esta restricción fue eliminada en Oracle 11.2.0.2.