Ensemble DBMS_EXT_TABLE

Ensemble DBMS_EXT_TABLE_CACHE

Ce tableau résume les sous-programmes inclus dans l'ensemble DBMS_EXT_TABLE_CACHE.

Sous-programme	Description
ADD_BY_LIKE Procédure	Ajoute un ou plusieurs fichiers correspondant aux filtres spécifiés dans une mémoire cache de table externe.
ADD_FILE Procédure	Ajoute un fichier dans la mémoire cache de la table externe.
ADD_TABLE Procédure	Ajoute les fichiers de la table externe indiquée dans un cache de table externe.
Procédure de nettoyage	Efface la mémoire cache d'une table externe.
CREATE_CACHE Procédure	Crée une mémoire cache de table externe.
DÉSACTIVER la procédure	Désactive une mémoire cache de table externe.
DROP_BY_LIKE Procédure	Déposez des fichiers d'une mémoire cache de table externe en fonction des filtres spécifiés.
DROP_CACHE Procédure	Supprime un cache de table externe.
DROP_FILE Procédure	Supprime le fichier de table externe spécifié de la mémoire cache de table externe.
Procédure ENABLE	Active une mémoire cache de table externe précédemment désactivée.
Fonction GET_USER_PROPERTY	Extrait la préférence de mise en cache pour une mémoire cache de table externe.
RETIRE_FILES Procédure	Supprime un ou plusieurs fichiers du cache qui sont plus anciens que l'intervalle spécifié.
SET_USER_PROPERTY Procédure	Spécifie la préférence de mise en cache pour une mémoire cache de table externe.
Procédure VALIDATE	Valide une mémoire cache de table externe.

Rubriques connexes

Améliorer le rendement des interrogations avec la mémoire cache de table externe

ADD_BY_LIKE Procédure

La procédure DBMS_EXT_TABLE_CACHE.ADD_BY_LIKE charge un ou plusieurs fichiers spécifiés à partir du magasin d'objets dans la mémoire cache de table externe.

Syntaxe

DBMS_EXT_TABLE_CACHE.ADD_BY_LIKE (       
      owner        IN VARCHAR2,
      table_name   IN VARCHAR2,
      path_filters IN CLOB,
      esc_char     IN VARCHAR2 DEFAULT NULL,
      force        IN BOOLEAN  DEFAULT FALSE);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`path_filters`	`PATH_FILTERS` est un JSON_ARRAY de filtres de chemin utilisés pour rechercher les modèles spécifiés dans les URL de fichier.
`esc_char`	Spécifie le caractère d'échappement à utiliser dans les filtres de chemin. Si le caractère d'échappement précède le caractère '`%`' ou '`_`' dans le modèle, le caractère spécial est interprété littéralement, et non comme un caractère spécial de correspondance de modèle. Ce paramètre est facultatif et la valeur par défaut de ce paramètre est `NULL`.
`force`	Force l'écrasement des fichiers existants spécifiés dans le cache même si les fichiers n'ont pas été modifiés. Ce paramètre est facultatif et la valeur par défaut du paramètre `force` est `FALSE`.

Exemple

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/salesdata1.parquet",
                      "https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/salesdata2.parquet"]'
);
END;
/

Note d'utilisation

Par défaut, la procédure DBMS_EXT_TABLE_CACHE.ADD_BY_LIKE ignore le chargement des fichiers lorsque :
- Les fichiers étaient précédemment mis en cache et toujours disponibles dans le cache.
- Les fichiers n'ont pas été modifiés depuis leur dernière mise en cache.
Toutefois, vous pouvez utiliser le paramètre force pour remplacer les fichiers dans la mémoire cache même si les fichiers n'ont pas été modifiés.

ADD_FILE Procédure

La procédure DBMS_EXT_TABLE_CACHE.ADD_FILE charge le fichier spécifié dans la mémoire cache de la table externe.

Syntaxe

DBMS_EXT_TABLE_CACHE.ADD_FILE (       
      owner        IN VARCHAR2,
      table_name   IN VARCHAR2,
      file_url     IN VARCHAR2,
      force        IN BOOLEAN DEFAULT FALSE);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`file_url`	Spécifie l'URL du fichier.
`force`	Force l'écrasement des fichiers existants spécifiés dans le cache même si les fichiers n'ont pas été modifiés. Ce paramètre est facultatif et la valeur par défaut du paramètre `force` est `FALSE`.

Exemple

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

Notes d'utilisation

La procédure DBMS_EXT_TABLE_CACHE.ADD_FILE ignore le chargement du fichier dans la mémoire cache si le fichier spécifié existe dans la mémoire cache et n'a pas été modifié depuis la dernière mise en mémoire cache du fichier.
Vous pouvez utiliser le paramètre force pour remplacer le fichier dans la mémoire cache même si le fichier n'a pas été modifié.

ADD_LATEST_FILES Procédure

DBMS_EXT_TABLE_CACHE.ADD_LATEST_FILES charge un ou plusieurs fichiers dans la mémoire cache de la table externe. Les fichiers sont chargés en fonction de l'intervalle de temps déterminé par l'argument SINCE et l'horodatage courant.

Syntaxe

DBMS_EXT_TABLE_CACHE.ADD_LATEST_FILES (       
      owner        IN  VARCHAR2,
      table_name   IN  VARCHAR2,
      since        IN  INTERVAL DAY TO SECOND,
      max_files    IN  NUMBER,
      force        IN  BOOLEAN DEFAULT FALSE);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`since`	Le paramètre `since` accepte une valeur `INTERVAL DAY TO SECOND` et est utilisé pour calculer l'intervalle de temps entre la valeur `since` et l'horodatage courant. L'intervalle de temps résultant est ensuite utilisé pour charger les fichiers, en fonction de leur heure de dernière modification.
`max_files`	Spécifiez la valeur `max_files` pour limiter le nombre de fichiers pouvant être chargés dans la mémoire cache de la table externe. Ce paramètre est facultatif et prend par défaut la valeur Illimitée lorsqu'il n'est pas spécifié.
`force`	Force l'écrasement des fichiers existants spécifiés dans le cache même si les fichiers n'ont pas été modifiés. Ce paramètre est facultatif et la valeur par défaut pour ce paramètre est `FALSE`.

Exemple

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

Note d'utilisation

Par défaut, la procédure DBMS_EXT_TABLE_CACHE.ADD_LATEST_FILES ignore le chargement des fichiers lorsque :
- Les fichiers spécifiés étaient précédemment mis en cache et toujours disponibles dans le cache.
- Les fichiers spécifiés n'ont pas été modifiés depuis leur dernière mise en cache.
Toutefois, vous pouvez utiliser le paramètre force pour remplacer les fichiers dans la mémoire cache même si les fichiers n'ont pas été modifiés.

ADD_TABLE Procédure

La procédure DBMS_EXT_TABLE_CACHE.ADD_TABLE charge une table entière ou un certain pourcentage de la table externe dans la mémoire cache.

Syntaxe

DBMS_EXT_TABLE_CACHE.ADD_TABLE (       
      owner         IN VARCHAR2,
      table_name    IN VARCHAR2,
      percent_files IN NUMBER DEFAULT NULL,
      force         IN BOOLEAN DEFAULT FALSE);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`percent_files`	Indique le pourcentage des données de table à mettre en mémoire cache. Par exemple, 1 à 100. Par défaut, tous les fichiers sont chargés.
`force`	Force l'écrasement des fichiers spécifiés dans le cache même si les fichiers n'ont pas été modifiés. Ce paramètre est facultatif et la valeur par défaut pour `force` est `FALSE`.

Exemple

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

Notes d'utilisation

DBMS_EXT_TABLE_CACHE.ADD_TABLE tente de mettre en mémoire cache la table entière ou un pourcentage spécifié du contenu du fichier dans la mémoire cache.
Les paramètres percent_files et force s'excluent mutuellement.
Par défaut, la procédure DBMS_EXT_TABLE_CACHE.ADD_TABLE ignore le chargement des fichiers lorsque :
- Les fichiers spécifiés étaient précédemment mis en cache et toujours disponibles dans le cache.
- Les fichiers spécifiés n'ont pas été modifiés depuis leur dernière mise en cache.
Toutefois, vous pouvez utiliser le paramètre force pour remplacer les fichiers dans la mémoire cache même si les fichiers n'ont pas été modifiés.

Procédure de nettoyage

La procédure DBMS_EXT_TABLE_CACHE.CLEAR supprime tous les fichiers d'une mémoire cache de table externe tout en conservant la mémoire cache.

Syntaxe

DBMS_EXT_TABLE_CACHE.CLEAR (       
      owner         IN VARCHAR2,
      table_name    IN VARCHAR2);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.

Exemple

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

CREATE_CACHE Procédure

La procédure DBMS_EXT_TABLE_CACHE.CREATE_CACHE crée une mémoire cache de table externe dans une instance Autonomous Database.

Syntaxe

DBMS_EXT_TABLE_CACHE.CREATE_CACHE (       
      owner            IN    VARCHAR2,
      table_name       IN    VARCHAR2,
      partition_type   IN    VARCHAR2);

Paramètres

Paramètre Description

owner

Spécifie le nom du schéma.

table_name

Spécifie le nom de la table externe.

partition_type

Les valeurs valides pour le paramètre partition_type sont les suivantes :

FILE : partitionne la mémoire cache de table externe à l'aide des colonnes invisibles FILE$PATH et FILE$NAME.
PATH : partitionne la mémoire cache de table externe à l'aide de la colonne invisible FILE$PATH.

file$path : Spécifie le texte du chemin d'accès au fichier jusqu'au début du nom de l'objet.

file$name : Spécifie le nom de l'objet, y compris tout le texte qui suit le dernier '/'.

Pour plus d'informations, voir Colonnes de métadonnées de table externe.

Exemple

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

Note d'utilisation

DBMS_EXT_TABLE_CACHE.CREATE_CACHE crée la mémoire cache de table externe dans une instance Autonomous Database. La création d'un cache est similaire à la création d'une table dans le schéma de base de données.

DÉSACTIVER la procédure

La procédure DBMS_EXT_TABLE_CACHE.DISABLE désactive la mémoire cache de table externe spécifiée. Le cache est marqué comme désactivé. Toutefois, les données du cache sont conservées.

Syntaxe

DBMS_EXT_TABLE_CACHE.DISABLE (       
      owner        IN VARCHAR2,
      table_name   IN VARCHAR2
);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.

Exemple

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

Note d'utilisation

DBMS_EXT_TABLE_CACHE.DISABLE ne supprime aucune donnée de la mémoire cache de table externe. Au lieu de cela, il marque le cache comme DISABLED, ce qui signifie que l'optimiseur ne peut pas utiliser le cache pour les réécritures d'interrogation.

DROP_BY_LIKE Procédure

La procédure DBMS_EXT_TABLE_CACHE.DROP_BY_LIKE supprime un ou plusieurs fichiers de la mémoire cache de table externe. Les fichiers sont supprimés en fonction des filtres spécifiés.

Syntaxe

DBMS_EXT_TABLE_CACHE.DROP_BY_LIKE (       
      owner        IN VARCHAR2,
      table_name   IN VARCHAR2,
      path_filters IN CLOB,
      esc_char     IN VARCHAR2 DEFAULT NULL);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`path_filters`	`PATH_FILTERS` est un JSON_ARRAY de filtres de chemin utilisés pour rechercher les modèles spécifiés dans les URL de fichier.
`esc_char`	Spécifie le caractère d'échappement à utiliser dans les filtres de chemin. Si le caractère d'échappement précède le caractère '`%`' ou '`_`' dans le modèle, le caractère spécial est interprété littéralement, et non comme un caractère spécial de correspondance de modèle. Ce paramètre est facultatif et la valeur par défaut de ce paramètre est `NULL`.

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/salesdata1.parquet",
                      "https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/your_namespace/your_bucket/salesdata2.parquet"]'
);
END;
/

DROP_CACHE Procédure

La procédure DBMS_EXT_TABLE_CACHE.DROP_CACHE supprime la mémoire cache de table externe spécifiée. Cette procédure supprime le cache et libère l'espace de stockage associé au cache.

Syntaxe

DBMS_EXT_TABLE_CACHE.DROP_CACHE (       
      owner            IN    VARCHAR2,
      table_name       IN    VARCHAR2
);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.

Exemple

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

Note d'utilisation

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

DROP_FILE Procédure

La procédure DBMS_EXT_TABLE_CACHE.DROP_FILE supprime le fichier spécifié d'une mémoire cache de table externe.

Syntaxe

DBMS_EXT_TABLE_CACHE.DROP_FILE (       
      owner        IN VARCHAR2,
      table_name   IN VARCHAR2,
      file_url     IN VARCHAR2);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`file_url`	Spécifie l'URL du fichier.

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

Procédure ENABLE

La procédure DBMS_EXT_TABLE_CACHE.ENABLE active une mémoire cache de table externe précédemment désactivée. Lorsqu'un cache est créé, il est activé par défaut.

Syntaxe

DBMS_EXT_TABLE_CACHE.ENABLE (       
    owner         IN    VARCHAR2,
    table_name    IN    VARCHAR2
);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.

Exemple

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

Fonction GET_USER_PROPERTY

La fonction retourne la préférence de mise en mémoire cache pour le schéma spécifié et retourne une valeur Number.

Syntaxe


DBMS_EXT_TABLE_CACHE.GET_USER_PROPERTY (
    property_name   IN   VARCHAR2,
    owner           IN   VARCHAR2 DEFAULT NULL);

RETURN NUMBER;

Paramètres

Paramètre	Description
`property_name`	Spécifie le nom de la propriété. Les valeurs valides pour `property_name` sont les suivantes : `MAX_CACHE_PERCENT` `MAX_CACHE_SIZE`
`owner`	Spécifie le nom du schéma.

Valeurs retournées

Valeur retournée	Description
La valeur `MAX_CACHE_SIZE` ou `MAX_CACHE_SIZE` est numérique.	Selon le paramètre `property_name`, le nombre retourné est la valeur `MAX_CACHE_SIZE` ou `MAX_CACHE_SIZE`.

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

RETIRE_FILES Procédure

DBMS_EXT_TABLE_CACHE.RETIRE_FILES supprime des fichiers de la mémoire cache qui sont plus anciens que l'intervalle spécifié. Les fichiers sont supprimés en fonction de l'intervalle de temps calculé à l'aide de la valeur du paramètre BEFORE.

Syntaxe

DBMS_EXT_TABLE_CACHE.RETIRE_FILES (       
    owner        IN VARCHAR2,
    table_name   IN VARCHAR2,
    before       IN INTERVAL DAY TO SECOND
);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`before`	Le paramètre `before` accepte une valeur `INTERVAL DAY TO SECOND` et est utilisé pour calculer l'intervalle de temps entre la valeur `before` et l'horodatage courant. L'intervalle de temps résultant est ensuite utilisé pour supprimer les fichiers du cache.

Exemple

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

SET_USER_PROPERTY Procédure

La procédure DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY définit la préférence de mise en mémoire cache pour un schéma.

Syntaxe

DBMS_EXT_TABLE_CACHE.SET_USER_PROPERTY (         
    property_name    IN    VARCHAR2,         
    property_value   IN    NUMBER,                   
    owner            IN    VARCHAR2 DEFAULT NULL);

Paramètres

Paramètre	Description
`property_name`	Spécifie le nom de la propriété. Les valeurs valides pour `property_name` sont les suivantes : `MAX_CACHE_PERCENT` `MAX_CACHE_SIZE`
`property_value`	Spécifie la valeur de la propriété.
`owner`	Spécifie le nom du schéma.

Exemple

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

Procédure VALIDATE

La procédure DBMS_EXT_TABLE_CACHE.VALIDATE valide la mémoire cache de la table externe. Une erreur est signalée si la table externe référencée est introuvable dans la base de données.

Syntaxe

DBMS_EXT_TABLE_CACHE.VALIDATE (       
      owner            IN    VARCHAR2,
      table_name       IN    VARCHAR2,
      raise_errors     IN    BOOLEAN DEFAULT TRUE);

Paramètres

Paramètre	Description
`owner`	Spécifie le nom du schéma.
`table_name`	Indique le nom de la table externe.
`raise_errors`	Indique lorsqu'une mémoire cache de table externe est marquée comme non valide.

Exemple

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

Titre et informations sur les droits d'auteur

Oracle et/ou ses sociétés affiliées.

Accessibilité de la documentation

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Accès à Oracle Support

Les clients Oracle accéderont aux services de soutien Oracle et utiliseront ces services conformément aux conditions générales spécifiées dans leur commande Oracle pour les services applicables.