Utiliser la mémoire cache de table externe pour améliorer les performances des tables externes

Après avoir créé un cache, vous pouvez alimenter les fichiers dans le cache. L'alimentation des fichiers charge le contenu des fichiers de table externe indiqués dans le cache. Vous pouvez choisir d'alimenter tous les fichiers à partir d'une table, d'un pourcentage spécifique de la table ou de spécifier une condition de filtre pour limiter les fichiers à alimenter. Par exemple, vous pouvez filtrer les fichiers en fonction de leur nom ou d'un intervalle de dates.

Ajouter une table à la mémoire cache de table externe

Utilisez DBMS_EXT_TABLE_CACHE.ADD_TABLE pour alimenter une table entière ou un certain pourcentage de la table externe dans la mémoire cache.

Exemples

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

Cet exemple tente d'alimenter la table STORE_SALES dans la mémoire cache, en ignorant tous les fichiers existants qui ont déjà été alimentés.

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

Cet exemple tente d'alimenter 80 % de la table STORE_SALES dans la mémoire cache, en ignorant tous les fichiers existants qui ont déjà été alimentés.

Le paramètre percent_files est facultatif. Si vous ne spécifiez pas ce paramètre, toute la table est alimentée dans la mémoire cache.

Pour plus d'informations, voir ProcédureADD_TABLE.

Ajouter des fichiers à la mémoire cache de table externe

Exemples

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

Cet exemple charge les données du fichier salesdata.parquet dans la mémoire cache.

Cet exemple ignore l'alimentation du fichier dans le cache si le fichier spécifié existe dans le cache et n'a pas été modifié depuis la dernière mise en cache du fichier.

Pour plus d'informations, voir ProcédureADD_FILE.

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

Cet exemple alimente tous les fichiers avec des noms commençant par sales ou customer, tout en excluant les fichiers déjà alimentés.

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

Cet exemple charge les fichiers sales_data1.parquet et sales_data2.parquet dans la mémoire cache.

Dans cet exemple, le caractère '#' est défini en tant que caractère d'échappement. Le caractère '_' suivant '#' est traité comme un trait de soulignement littéral, et non comme un caractère générique correspondant à un seul caractère.

Pour plus d'informations, voir ProcédureADD_BY_LIKE.

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

Le paramètre since spécifie l'intervalle de temps; seuls les fichiers modifiés au cours des sept (7) derniers jours peuvent être alimentés dans la mémoire cache.

Le paramètre max_files limite le nombre de fichiers pouvant être alimentés dans la mémoire cache. Cet exemple ne charge que cinq (5) fichiers.

Le paramètre force force le remplacement des fichiers spécifiés dans la mémoire cache même si les fichiers n'ont pas été modifiés.

Pour plus d'informations, voir ProcédureADD_LATEST_FILES.

Effacer la mémoire cache de table externe

Utilisez DBMS_EXT_TABLE_CACHE.CLEAR pour supprimer tous les fichiers de la mémoire cache de table externe. Exemple :

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

Cet exemple supprime tous les fichiers de la mémoire cache STORE_SALES et libère tout l'espace utilisé par les fichiers supprimés.

Pour plus d'informations, voir Procédure de nettoyage.

Supprimer des fichiers de la mémoire cache de table externe

Exemples

Utilisez DBMS_EXT_TABLE_CACHE.DROP_FILE pour supprimer un fichier de la mémoire cache de table externe. Exemple :

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

Cet exemple supprime le fichier salesdata.parquet de la mémoire cache et libère tout l'espace utilisé par le fichier supprimé.

Pour plus d'informations, voir ProcédureDROP_FILE.

Utilisez DBMS_EXT_TABLE_CACHE.DROP_BY_LIKE pour supprimer un ou plusieurs fichiers en fonction du paramètre path_filters. Exemple :

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

Cet exemple supprime les fichiers salesdata.parquet et salesdata1.parquet de la mémoire cache et libère tout l'espace utilisé par les fichiers supprimés.

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

Cet exemple supprime les fichiers sales#_data1 et sales#_data2 de la mémoire cache et libère tout l'espace utilisé par les fichiers supprimés.

Dans cet exemple, le caractère '#' est défini en tant que caractère d'échappement. Le caractère '_' suivant '#' est traité comme un trait de soulignement littéral, et non comme un caractère générique correspondant à un seul caractère.

Pour plus d'informations, voir ProcédureDROP_BY_LIKE.

Utilisez DBMS_EXT_TABLE_CACHE.RETIRE_FILES pour supprimer un ou plusieurs fichiers en fonction de l'intervalle spécifié. Exemple :

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

Cet exemple supprime les fichiers qui datent de plus de trente (30) jours du cache et libère tout l'espace utilisé par les fichiers supprimés.

Pour plus d'informations, voir ProcédureRETIRE_FILES.

Les exemples ci-dessus suppriment un ou plusieurs fichiers du cache tout en conservant le cache. Vous pouvez charger à nouveau les fichiers dans le cache si nécessaire. Pour plus d'informations, voir Alimenter les fichiers dans la mémoire cache de table externe.

Exécutez DBMS_EXT_TABLE_CACHE.DISABLE pour désactiver la mémoire cache de table externe de la base de données. La désactivation d'une mémoire cache ne supprime pas les données de la mémoire cache; elle est marquée DISABLED et l'optimiseur ne peut pas utiliser la mémoire cache pour les réécritures d'interrogation.

Exemple

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

Cet exemple désactive la mémoire cache STORE_SALES.

Pour plus d'informations, voir Procédure DISABLE.

Après avoir désactivé une mémoire cache de table externe, utilisez DBMS_EXT_TABLE_CACHE.ENABLE pour activer la mémoire cache.

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

Cet exemple active la mémoire cache STORE_SALES.

Pour plus d'informations, voir Procédure ENABLE.

Exécutez DBMS_EXT_TABLE_CACHE.DROP_CACHE pour supprimer une mémoire cache de table externe. La procédure DBMS_EXT_TABLE_CACHE.DROP_CACHE supprime la mémoire cache de table externe spécifiée de la base de données et libère l'espace de stockage associé à la mémoire cache.

Exemple :

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

Cet exemple supprime la mémoire cache STORE_SALES du schéma SALES.

La suppression d'un cache supprime ses métadonnées du dictionnaire de données et supprime toutes ses données mises en cache.

Pour plus d'informations, voir ProcédureDROP_CACHE.

SELECT external_table_name, cached
  FROM user_external_tab_caches;

Pour plus d'informations, voir Vues DBA_EXTERNAL_TAB_CACHES et USER_EXTERNAL_TAB_CACHES.

Par défaut, la mémoire cache de table externe est désactivée pour un utilisateur. Pour activer et créer la mémoire cache de table externe, utilisez la procédure DBMS_EXT_TABLE_CACHE.CREATE_CACHE. Le cache est créé dans votre schéma par défaut et hérite des limites de quota d'espace définies pour votre schéma. Toutefois, vous pouvez également utiliser la procédure DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY pour définir des quotas d'espace pour la mémoire cache de table externe. Vous utilisez les paramètres PROPERTY_NAME et PROPERTY_VALUE de la procédure DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY pour définir les limites de quota d'espace.

Le paramètre PROPERTY_NAME accepte les valeurs MAX_CACHE_SIZE et MAX_CACHE_PERCENT. La propriété MAX_CACHE_SIZE spécifie la taille totale de la mémoire cache externe en octets. La propriété MAX_CACHE_PERCENT spécifie la taille totale de la mémoire cache externe en tant que pourcentage du quota de l'utilisateur spécifié.

Exemples

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

Cet exemple règle la préférence de mise en mémoire cache à MAX_CACHE_PERCENT pour le schéma SALES.

La valeur property_value est de 50 %, ce qui indique que le quota d'espace de mémoire cache pour le schéma SALES est un maximum de 50 % du quota d'espace total défini pour SALES.

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

Cet exemple règle la préférence de mise en mémoire cache à MAX_CACHE_SIZE pour le schéma SALES.

property_value est 5368709120, qui spécifie que la taille maximale de la mémoire cache pour le schéma SALES est de 5 Go au maximum.

Pour plus d'informations, voir Procédure SET_USER_PROPERTY et Procédure CREATE_CACHE.

Utilisez DBMS_EXT_TABLE_CACHE.GET_USER_PROPERTY pour extraire les propriétés de taille de mémoire cache.

Exemple :

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

Pour plus d'informations, voir Fonction GET_USER_PROPERTY.

Notez l'ordre de priorité suivant pour définir les propriétés de taille de cache :

Par défaut, la mise en mémoire cache automatique est désactivée. Vous pouvez activer la mise en mémoire cache automatique pour vos tables externes, globalement pour tous les utilisateurs de la base de données ou pour un utilisateur spécifique. Une fois la mise en cache automatique activée, la base de données crée automatiquement des mises en cache de tables externes. Tous les caches nouvellement créés sont marqués comme AUTO. Les caches existants continuent de suivre les paramètres de gestion du cache basés sur des stratégies.

Vous utilisez DBMS_CACHE.SET_GLOBAL_PROPERTY ou DBMS_CACHE.SET_USER_PROPERTY pour définir les propriétés de mise en mémoire cache AUTO, notamment les propriétés permettant d'activer la mise en mémoire cache automatique globalement ou pour un utilisateur spécifié, respectivement. Les préférences de mise en cache au niveau de l'utilisateur ont préséance sur les préférences de mise en cache globales. Utilisez les paramètres PROPERTY_NAME et PROPERTY_VALUE de ces procédures pour définir les limites de quota d'espace pour les mémoires caches de table externes.

Selon le quota d'espace spécifié, Oracle crée les caches et tente d'alimenter l'ensemble des données de la table externe dans le cache. Le processus d'alimentation échoue si la taille du cache n'est pas suffisante pour prendre en charge l'ensemble des données de la table externe.

Vous pouvez également utiliser la procédure DBMS_CACHE.REFRESH pour effectuer une actualisation sur demande pour tous les caches de l'utilisateur HR.

Au cours de chaque cycle d'actualisation, les caches non valides et les caches les moins récents sont supprimés de la base de données. Vous pouvez également utiliser la procédure DBMS_CACHE.CLEAR pour supprimer tous les caches d'un utilisateur spécifié.