Paquete DBMS_CACHE

El paquete DBMS_CACHE facilita el almacenamiento en caché automático para las cachés de lago en una instancia de base de datos de IA autónoma, incluidas las cachés creadas para tablas externas y para tablas expuestas a través de catálogos montados.

Resumen de Subprogramas DBMS_CACHE

En esta tabla se resumen los subprogramas incluidos en el paquete DBMS_CACHE.

Procedimiento CLEAR

Utilice el procedimiento DBMS_CACHE.CLEAR para borrar todas las cachés de lago para un usuario especificado.

El procedimiento DBMS_CACHE.CLEAR borra todas las cachés de lago y libera el espacio de almacenamiento, de forma similar a cómo funciona el comando DROP en una tabla de base de datos.

Sintaxis

DBMS_CACHE.CLEAR (
    owner    IN   VARCHAR2
);

Parámetros

Ejemplo

BEGIN
 DBMS_CACHE.CLEAR (
    owner => 'SALES');
END;
/

Nota de uso

• Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en el paquete DBMS_CACHE para borrar una caché.

Procedimiento ENABLE_AUTO

Utilice el procedimiento DBMS_CACHE.ENABLE_AUTO para activar el almacenamiento en caché automático global o para uno o más esquemas y, opcionalmente, defina la cuota de caché global.

Sintaxis

DBMS_CACHE.ENABLE_AUTO (
    users             IN   CLOB   DEFAULT NULL,
    global_cache_size IN   NUMBER DEFAULT NULL,
    global_cache_pct  IN   NUMBER DEFAULT NULL
);

Parámetros

Notas de uso

• El procedimiento activa el almacenamiento en caché automático definiendo AUTO_CACHE.

• Si se proporciona global_cache_size o global_cache_pct, el procedimiento define la propiedad de cuota global correspondiente.

• Si no se proporciona global_cache_size ni global_cache_pct, el procedimiento define GLOBAL_CACHE_PERCENT en 20.

• Utilice DBMS_CACHE.SET_GLOBAL_PROPERTY o DBMS_CACHE.SET_USER_PROPERTY con AUTO_CACHE = 0 para desactivar el almacenamiento en caché automático.

Ejemplos

Ejemplo para activar el almacenamiento en caché automático de forma global:

BEGIN
  DBMS_CACHE.ENABLE_AUTO(
    users            => NULL,
    global_cache_pct => 20);
END;
/

Ejemplo para activar el almacenamiento en caché automático para los esquemas seleccionados:

DECLARE
  l_users CLOB := '["HR","SALES"]';
BEGIN
  DBMS_CACHE.ENABLE_AUTO(
    users             => l_users,
    global_cache_size => 21474836480);
END;
/

GET_GLOBAL_PROPERTY Procedimiento

El procedimiento DBMS_CACHE.GET_GLOBAL_PROPERTY recupera las preferencias automáticas de la caché de lago para todos los usuarios de la base de datos. Este procedimiento está sobrecargado.

Sintaxis

DBMS_CACHE.GET_GLOBAL_PROPERTY (
    property_name       IN   VARCHAR2,
    property_value_num  OUT  NUMBER);

DBMS_CACHE.GET_GLOBAL_PROPERTY (
    property_name       IN   VARCHAR2,
    property_value_str  OUT  VARCHAR2);

Parámetros

Ejemplo

SET SERVEROUTPUT ON;
DECLARE
  l_auto_cache NUMBER;
BEGIN
  DBMS_CACHE.GET_GLOBAL_PROPERTY(
    property_name      => 'AUTO_CACHE',
    property_value_num => l_auto_cache);
  DBMS_OUTPUT.PUT_LINE('AUTO_CACHE=' || l_auto_cache);
END;
/

Notas de uso

• Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en el paquete DBMS_CACHE para ejecutar este procedimiento.

• GLOBAL_CACHE_SIZE y GLOBAL_CACHE_PERCENT definen solo la cuota. No activan el almacenamiento en caché automático. Utilice AUTO_CACHE o DBMS_CACHE.ENABLE_AUTO para activar el almacenamiento en caché automático.

• Si se definen GLOBAL_CACHE_SIZE y GLOBAL_CACHE_PERCENT, se utiliza el valor más grande. Si ninguna de las propiedades de cuota global está definida explícitamente, GLOBAL_CACHE_PERCENT se define por defecto en 20.

• Si se definen MAX_CACHE_SIZE y MAX_CACHE_PERCENT, se utiliza el valor más grande. Si no se define explícitamente ninguna propiedad de cuota por defecto, MAX_CACHE_PERCENT se define por defecto en 20.

SET_GLOBAL_PROPERTY Procedimiento

Utilice DBMS_CACHE.SET_GLOBAL_PROPERTY para definir propiedades de caché automática global para la base de datos. Este procedimiento está sobrecargado.

AUTO_CACHE activa o desactiva el almacenamiento en caché automático en el ámbito de la base de datos. GLOBAL_CACHE_SIZE y GLOBAL_CACHE_PERCENT definen la cuota de caché global para todas las cachés de tablas externas. MAX_CACHE_SIZE y MAX_CACHE_PERCENT definen las preferencias de cuota de nivel de esquema por defecto para los esquemas que no tienen una sustitución de nivel de usuario. La definición de GLOBAL_CACHE_SIZE, GLOBAL_CACHE_PERCENT, MAX_CACHE_SIZE o MAX_CACHE_PERCENT no activa, por sí sola, el almacenamiento en caché automático.

Sintaxis

DBMS_CACHE.SET_GLOBAL_PROPERTY (
    property_name      IN   VARCHAR2,
    property_value_num IN   NUMBER);

DBMS_CACHE.SET_GLOBAL_PROPERTY (
    property_name      IN   VARCHAR2,
    property_value_str IN   VARCHAR2);

Parámetros

Ejemplos

BEGIN
  DBMS_CACHE.SET_GLOBAL_PROPERTY(
    property_name      => 'AUTO_CACHE',
    property_value_num => 1);
END;
/

BEGIN
  DBMS_CACHE.SET_GLOBAL_PROPERTY(
    property_name      => 'GLOBAL_CACHE_PERCENT',
    property_value_num => 20);
END;
/

BEGIN
  DBMS_CACHE.SET_GLOBAL_PROPERTY(
    property_name      => 'MAX_CACHE_PERCENT',
    property_value_num => 25);
END;
/

BEGIN
  DBMS_CACHE.SET_GLOBAL_PROPERTY(
    property_name      => 'BEHAVIOR',
    property_value_str => 'COOPERATIVE');
END;
/

BEGIN
  DBMS_CACHE.SET_GLOBAL_PROPERTY(
    property_name      => 'AUTO_REFRESH_MODE',
    property_value_str => 'NEW');
END;
/

BEGIN
  DBMS_CACHE.SET_GLOBAL_PROPERTY(
    property_name      => 'MAX_REFRESH_WINDOW',
    property_value_num => 20);
END;
/

Notas de uso

• Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en el paquete DBMS_CACHE para ejecutar este procedimiento.

• Si se definen GLOBAL_CACHE_SIZE y GLOBAL_CACHE_PERCENT, se utiliza el valor más grande.

• Si ninguna de las propiedades de cuota global está definida explícitamente, GLOBAL_CACHE_PERCENT se define por defecto en 20.

• Si se definen MAX_CACHE_SIZE y MAX_CACHE_PERCENT, se utiliza el valor más grande.

• Si no se define explícitamente ninguna propiedad de cuota por defecto, MAX_CACHE_PERCENT se define por defecto en 20.

• Si MAX_CACHE_SIZE está definido en un valor mayor que GLOBAL_CACHE_SIZE, la base de datos genera un error.

• Las cachés manuales y las cachés AUTO consumen el mismo pool de cuotas.

• La propiedad MAX_REFRESH_WINDOW especifica, en segundos, el tiempo máximo permitido para refrescar las cachés de lago. Si el refrescamiento supera el límite especificado, el refrescamiento de caché se cierra normalmente y las cachés elegibles restantes se ponen en cola para el siguiente ciclo de refrescamiento.

• Al refrescar las cachés mediante el procedimiento DBMS_CACHE.REFRESH, el parámetro de procedimiento tiene prioridad sobre la propiedad AUTO_REFRESH_MODE.

  Consulte Procedimiento REFRESH para obtener más información.

Procedimiento REFRESH

Utilice el procedimiento DBMS_CACHE.REFRESH para refrescar todas las cachés de lago AUTO para un usuario especificado.

Sintaxis

DBMS_CACHE.REFRESH (
      owner          IN VARCHAR2,
      refresh_type   IN VARCHAR2 DEFAULT ALL
);

Parámetros

Ejemplo

BEGIN
    DBMS_CACHE.REFRESH (
      owner          => 'SALES',
      refresh_type   => 'CURRENT');
END;
/

Notas de uso

• Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en el paquete DBMS_CACHE para ejecutar este procedimiento.

• Si no especifica un valor para el parámetro refresh_type, Oracle realiza el refrescamiento basado en el valor auto_refresh_mode. El valor por defecto para auto_refresh_mode es ALL.

• Cuando se define la propiedad MAX_REFRESH_WINDOW, Oracle intenta realizar el refrescamiento en la ventana especificada. Si el refrescamiento supera el límite especificado, el refrescamiento de caché se cierra normalmente y las cachés elegibles restantes se ponen en cola para el siguiente ciclo de refrescamiento.

• Todas las cachés AUTO de la base de datos se gestionan mediante un algoritmo de expulsión similar al de menos utilizados recientemente (LRU). Cuando hay presión de espacio, las cachés a las que se ha accedido menos recientemente se borran automáticamente durante el proceso de refrescamiento para liberar el espacio de almacenamiento.

GET_USER_PROPERTY Procedimiento

Utilice el procedimiento DBMS_CACHE.GET_USER_PROPERTY para recuperar propiedades de almacenamiento en caché automático para un usuario.

Sintaxis

DBMS_CACHE.GET_USER_PROPERTY (
    property_name      IN   VARCHAR2,
    owner              IN   VARCHAR2 DEFAULT NULL,
    property_value_str OUT  VARCHAR2);

DBMS_CACHE.GET_USER_PROPERTY (
    property_name      IN   VARCHAR2,
    owner              IN   VARCHAR2 DEFAULT NULL,
    property_value_num OUT  NUMBER);

Parámetros

Ejemplo

SET SERVEROUTPUT ON;
DECLARE
  l_auto_cache NUMBER;
BEGIN
  DBMS_CACHE.GET_USER_PROPERTY(
    property_name      => 'AUTO_CACHE',
    owner              => 'HR',
    property_value_num => l_auto_cache);
  DBMS_OUTPUT.PUT_LINE('AUTO_CACHE=' || l_auto_cache);
END;
/

Notas de uso

• Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en el paquete DBMS_CACHE para ejecutar este procedimiento.

• MAX_CACHE_SIZE y MAX_CACHE_PERCENT son controles de cuota de nivel de esquema. No activan el almacenamiento en caché automático por sí mismos. Utilice AUTO_CACHE para activar o desactivar el almacenamiento en caché automático para el esquema especificado.

• Si se definen MAX_CACHE_SIZE y MAX_CACHE_PERCENT, se utiliza el valor más grande. Si no se define explícitamente ninguna propiedad de cuota de nivel de esquema, MAX_CACHE_PERCENT se define por defecto en 20.

SET_USER_PROPERTY Procedimiento

Utilice DBMS_CACHE.SET_USER_PROPERTY para definir propiedades de caché automática para un esquema especificado. Utilice AUTO_CACHE para activar o desactivar el almacenamiento en caché automático para el esquema. Utilice MAX_CACHE_SIZE y MAX_CACHE_PERCENT para definir las preferencias de cuota de nivel de esquema en el modelo de cuota global.

Sintaxis

DBMS_CACHE.SET_USER_PROPERTY (
    property_name       IN   VARCHAR2,
    property_value_num  IN   NUMBER,
    owner               IN   VARCHAR2 DEFAULT NULL);

DBMS_CACHE.SET_USER_PROPERTY (
    property_name       IN   VARCHAR2,
    property_value_str  IN   VARCHAR2,
    owner               IN   VARCHAR2 DEFAULT NULL
);

Parámetros

Ejemplos

Ejemplo para activar el almacenamiento en caché automático para un esquema:

BEGIN
  DBMS_CACHE.SET_USER_PROPERTY(
    property_name      => 'AUTO_CACHE',
    property_value_num => 1,
    owner              => 'SALES');
END;
/

Ejemplo para definir una cuota de caché de nivel de esquema:

BEGIN
  DBMS_CACHE.SET_USER_PROPERTY(
    property_name      => 'MAX_CACHE_SIZE',
    property_value_num => 5368709120,
    owner              => 'SALES');
END;
/

Notas de uso

• Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en el paquete DBMS_CACHE para ejecutar este procedimiento.

• La configuración de nivel de usuario sustituye la configuración global.

• MAX_CACHE_SIZE y MAX_CACHE_PERCENT no activan el almacenamiento en caché automático por sí mismos.

• Si se definen MAX_CACHE_SIZE y MAX_CACHE_PERCENT, se utiliza el valor más grande.

• Si no se define explícitamente ninguna propiedad de cuota de nivel de esquema, MAX_CACHE_PERCENT se define por defecto en 20.

• Si MAX_CACHE_SIZE está definido en un valor mayor que GLOBAL_CACHE_SIZE, la base de datos genera un error.

• La política manual siempre sustituye el comportamiento automático.