Uso de Caché de Tablas Externas para Mejorar el Rendimiento de Tablas Externas

Cuando se crea la caché, inicialmente está vacía y activada para relleno. El tamaño de la caché aumenta cada vez que se agrega un archivo, según los límites de cuota de espacio definidos para el esquema, hasta que alcanza los límites asignados. Consulte Set Optional Sizing Preferences for Policy-Based Caches para obtener más información.

Después de crear una caché, puede rellenar los archivos en la caché. Al rellenar los archivos, se carga el contenido de los archivos de tabla externa especificados en la caché. Puede elegir rellenar todos los archivos de una tabla, un porcentaje específico de la tabla o especificar una condición de filtro para limitar los archivos que desea rellenar. Por ejemplo, puede filtrar los archivos según sus nombres o un rango de fechas.

Agregar tabla a caché de tabla externa

Utilice DBMS_EXT_TABLE_CACHE.ADD_TABLE para rellenar una tabla completa o un determinado porcentaje de la tabla externa en la caché.

Ejemplos

BEGIN
  DBMS_EXT_TABLE_CACHE.ADD_TABLE (
    owner         => 'SALES', 
    table_name    => 'STORE_SALES');
END;
/

En este ejemplo, se intenta rellenar la tabla STORE_SALES en la caché, omitiendo cualquier archivo existente que ya se haya rellenado.

BEGIN
  DBMS_EXT_TABLE_CACHE.ADD_TABLE (
    owner         => 'SALES', 
    table_name    => 'STORE_SALES',
    percent_files => 80);
END;
/

Este ejemplo intenta rellenar el 80% de la tabla STORE_SALES en la caché, omitiendo cualquier archivo existente que ya se haya rellenado.

El parámetro percent_files es opcional; si no especifica este parámetro, toda la tabla se rellena en la caché.

Consulte ADD_TABLE Procedure para obtener más información.

Agregar archivos a caché de tabla externa

Ejemplos

BEGIN
  DBMS_EXT_TABLE_CACHE.ADD_FILE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    file_url     => 'https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/salesdata.parquet'
);
END;
/

En este ejemplo, se rellenan los datos del archivo salesdata.parquet en la caché.

En este ejemplo, se omite rellenar el archivo en la caché si el archivo especificado existe en la caché y no se ha modificado desde la última vez que el archivo se almacenó en caché.

Consulte ADD_FILE Procedure para obtener más información.

BEGIN
  DBMS_EXT_TABLE_CACHE.ADD_BY_LIKE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    path_filters => '["https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/sales%.parquet",
                      "https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/customer%.parquet"]'
);
END;
/

En este ejemplo, se rellenan todos los archivos con nombres que comienzan por sales o customer, al tiempo que se excluyen los archivos que ya se han rellenado.

BEGIN
  DBMS_EXT_TABLE_CACHE.ADD_BY_LIKE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    path_filters => '["https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/sales#_data1.parquet",
                      "https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/sales#_data2.parquet"]',
    esc_char     => '#',
    force        => TRUE);
END;
/

En este ejemplo, se rellenan los archivos sales_data1.parquet y sales_data2.parquet en la caché.

En este ejemplo, el carácter '#' se define como el carácter de escape. El carácter '_' que sigue a '#' se trata como un guion bajo literal, no como un comodín que coincide con un solo carácter.

Consulte ADD_BY_LIKE Procedure para obtener más información.

BEGIN
  DBMS_EXT_TABLE_CACHE.ADD_LATEST_FILES (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    since        => INTERVAL '7' DAY,
    max_files    => 5,
    force        => TRUE);
END;
/

El parámetro since especifica el intervalo de tiempo; solo los archivos modificados en los últimos siete (7) días son elegibles para rellenarse en la caché.

El parámetro max_files limita el número de archivos que se pueden rellenar en la caché. Este ejemplo rellena sólo cinco (5) archivos.

El parámetro force fuerza la sobrescritura de los archivos especificados en la caché aunque los archivos no se hayan modificado.

Consulte ADD_LATEST_FILES Procedure para obtener más información.

Borrar caché de tabla externa

Utilice DBMS_EXT_TABLE_CACHE.CLEAR para borrar todos los archivos de la caché de tabla externa. Por ejemplo:

BEGIN
  DBMS_EXT_TABLE_CACHE.CLEAR (
    owner         => 'SALES', 
    table_name    => 'STORE_SALES');
END;
/

En este ejemplo, se borran todos los archivos de la caché STORE_SALES y se anula la asignación de todo el espacio utilizado por los archivos eliminados.

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

Borrar archivos de la caché de tabla externa

Ejemplos

Utilice DBMS_EXT_TABLE_CACHE.DROP_FILE para borrar un archivo de la caché de tabla externa. Por ejemplo:

BEGIN
  DBMS_EXT_TABLE_CACHE.DROP_FILE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    file_url     => 'https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/salesdata.parquet'
);
END;
/

En este ejemplo, se borra el archivo salesdata.parquet de la caché y se anula la asignación de todo el espacio utilizado por el archivo eliminado.

Consulte DROP_FILE Procedure para obtener más información.

Utilice DBMS_EXT_TABLE_CACHE.DROP_BY_LIKE para borrar uno o más archivos basados en el parámetro path_filters. Por ejemplo:

BEGIN
  DBMS_EXT_TABLE_CACHE.DROP_BY_LIKE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    path_filters => '["https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/salesdata.parquet",
                      "https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/salesdata1.parquet"]'
);
END;
/

En este ejemplo, se borran los archivos salesdata.parquet y salesdata1.parquet de la caché y se anula la asignación de todo el espacio utilizado por los archivos eliminados.

BEGIN
  DBMS_EXT_TABLE_CACHE.DROP_BY_LIKE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    path_filters => '["https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/sales#_data1.parquet",
                      "https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/sales#_data2.parquet"]'
);
END;
/

En este ejemplo, se borran los archivos sales#_data1 y sales#_data2 de la caché y se anula la asignación de todo el espacio utilizado por los archivos eliminados.

En este ejemplo, el carácter '#' se define como el carácter de escape. El carácter '_' que sigue a '#' se trata como un guion bajo literal, no como un comodín que coincide con un solo carácter.

Consulte DROP_BY_LIKE Procedure para obtener más información.

Utilice DBMS_EXT_TABLE_CACHE.RETIRE_FILES para borrar uno o más archivos según el intervalo especificado. Por ejemplo:

BEGIN
 DBMS_EXT_TABLE_CACHE.RETIRE_FILES (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES',
    before       => INTERVAL '30' DAY);
END;
/

En este ejemplo, se borran los archivos que tienen más de treinta (30) días de la caché y se anula la asignación de todo el espacio utilizado por los archivos eliminados.

Consulte RETIRE_FILES Procedure para obtener más información.

Los ejemplos anteriores eliminan uno o más archivos de la caché mientras conservan la caché. Puede volver a cargar los archivos en la caché cuando sea necesario. Consulte Relleno de Archivos en Caché de Tabla Externa para obtener más información.

Ejecute DBMS_EXT_TABLE_CACHE.DISABLE para desactivar la caché de tabla externa de la base de datos. La desactivación de una caché no suprime los datos de la caché; en su lugar, la caché se marca como DISABLED y el optimizador no puede utilizar la caché para reescrituras de consulta.

Ejemplo

BEGIN
    DBMS_EXT_TABLE_CACHE.DISABLE (      
      owner          => 'SALES',
      table_name     => 'STORE_SALES');                                                                 
END;                                                                 
/

En este ejemplo, se desactiva la caché STORE_SALES.

Consulte DISABLE Procedure para obtener más información.

Después de desactivar una caché de tabla externa, utilice DBMS_EXT_TABLE_CACHE.ENABLE para activar la caché.

BEGIN
  DBMS_EXT_TABLE_CACHE.ENABLE (
    owner        => 'SALES', 
    table_name   => 'STORE_SALES'
 );
END;
/

Este ejemplo activa la caché STORE_SALES.

Consulte ENABLE Procedure para obtener más información.

Ejecute DBMS_EXT_TABLE_CACHE.DROP_CACHE para borrar una caché de tabla externa. El procedimiento DBMS_EXT_TABLE_CACHE.DROP_CACHE elimina la caché de tabla externa especificada de la base de datos y libera el espacio de almacenamiento asociado a la caché.

Ejemplo:

BEGIN
    DBMS_EXT_TABLE_CACHE.DROP_CACHE (      
      owner          => 'SALES',
      table_name     => 'STORE_SALES');                                                             
END;                                                                 
/

En este ejemplo se borra la caché STORE_SALES del esquema SALES.

Al borrar una caché, se eliminan los metadatos del diccionario de datos y se suprimen todos los datos almacenados en caché.

Consulte DROP_CACHE Procedure para obtener más información.

SELECT external_table_name, cached
  FROM user_external_tab_caches;

Consulte Vistas DBA_EXTERNAL_TAB_CACHES y USER_EXTERNAL_TAB_CACHES para obtener más información.

Por defecto, la caché de tabla externa está desactivada para un usuario. Para activar y crear la caché de tabla externa, utilice el procedimiento DBMS_EXT_TABLE_CACHE.CREATE_CACHE. La caché se crea en el esquema por defecto y hereda los límites de cuota de espacio definidos para el esquema. Sin embargo, también puede utilizar el procedimiento DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY para definir cuotas de espacio para la caché de tabla externa. Utilice los parámetros PROPERTY_NAME y PROPERTY_VALUE del procedimiento DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY para definir los límites de cuota de espacio.

El parámetro PROPERTY_NAME acepta los valores MAX_CACHE_SIZE y MAX_CACHE_PERCENT. La propiedad MAX_CACHE_SIZE especifica el tamaño total de la caché externa en bytes. La propiedad MAX_CACHE_PERCENT especifica el tamaño total de la caché externa como porcentaje de la cuota del usuario especificado.

Ejemplos

BEGIN
    DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY (
    property_name  => 'MAX_CACHE_PERCENT',          
    property_value => 50,                   
    owner          => 'SALES');                                                                
END;                                                                 
/

En este ejemplo se define la preferencia de almacenamiento en caché en MAX_CACHE_PERCENT para el esquema SALES.

property_value es el 50%, que especifica que la cuota de espacio de caché para el esquema SALES es un máximo del 50% de la cuota de espacio total definida para SALES.

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

En este ejemplo se define la preferencia de almacenamiento en caché en MAX_CACHE_SIZE para el esquema SALES.

property_value es 5368709120, que especifica que el tamaño máximo de caché para el esquema SALES es de hasta 5 GB.

Consulte Procedimiento SET_USER_PROPERTY y Procedimiento CREATE_CACHE para obtener más información.

Utilice DBMS_EXT_TABLE_CACHE.GET_USER_PROPERTY para recuperar las propiedades de tamaño de caché.

Ejemplo:

SET SERVEROUTPUT ON
    DECLARE
    max_cache_sz NUMBER,
    BEGIN
    max_cache_sz := DBMS_EXT_TABLE_CACHE.GET_USER_PROPERTY (
        property_name       => 'MAX_CACHE_SIZE',         
        owner               => 'SALES');                                                                
END;                                                                 
/

Consulte GET_USER_PROPERTY Function para obtener más información.

Tenga en cuenta el siguiente orden de prioridad para definir las propiedades de tamaño de caché:

Por defecto, el almacenamiento en caché automático está desactivado, puede activar el almacenamiento en caché automático para las tablas externas, ya sea globalmente para todos los usuarios de la base de datos o para un usuario específico. Después de activar el almacenamiento en caché automático, la base de datos crea automáticamente cachés de tablas externas basadas en las estadísticas de uso de consultas de tablas externas disponibles en los juegos de ajustes SQL (STS). Todas las cachés recién creadas se marcan como AUTO. Las cachés existentes siguen la configuración de gestión de caché basada en políticas.

Al activar el almacenamiento en caché automático, puede especificar opcionalmente el ámbito del refrescamiento de la caché, lo que significa que las cachés se pueden refrescar durante cada ciclo de refrescamiento y definir la ventana de tiempo permitida para completar el proceso de refrescamiento.

Utilice DBMS_CACHE.SET_GLOBAL_PROPERTY o DBMS_CACHE.SET_USER_PROPERTY para definir las propiedades de almacenamiento en caché de AUTO, incluidas las propiedades para activar el almacenamiento en caché automático global o para un usuario especificado, respectivamente. Las preferencias de almacenamiento en caché a nivel de usuario tienen prioridad sobre las preferencias de almacenamiento en caché global. Utilice los parámetros PROPERTY_NAME y PROPERTY_VALUE de estos procedimientos para definir los límites de cuota de espacio para las cachés de tablas externas.

En función de la cuota de espacio especificada, Oracle crea las cachés e intenta rellenar todos los datos de la tabla externa en la caché. El proceso de relleno falla si el tamaño de la caché no es suficiente para alojar todos los datos de la tabla externa.

También puede utilizar el procedimiento DBMS_CACHE.REFRESH para realizar un refrescamiento bajo demanda para todas las cachés de un usuario especificado.

Durante cada ciclo de refrescamiento, las cachés no válidas y las cachés a las que se ha accedido menos recientemente se borran de la base de datos. También puede utilizar el procedimiento DBMS_CACHE.CLEAR para borrar todas las cachés de un usuario especificado.