Ensemble DBMS_EXT_TABLE_CACHE

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

Sous-programme	Description
Procédure ADD_BY_LIKE	Ajoute un ou plusieurs fichiers correspondant aux filtres spécifiés dans une mémoire cache de table externe.
Procédure ADD_FILE	Ajoute un fichier dans la mémoire cache de la table externe.
Procédure ADD_TABLE	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.
Procédure CREATE_CACHE	Crée une mémoire cache de table externe.
DÉSACTIVER la procédure	Désactive une mémoire cache de table externe.
Procédure DROP_BY_LIKE	Déposez des fichiers d'une mémoire cache de table externe en fonction des filtres spécifiés.
Procédure DROP_CACHE	Supprime un cache de table externe.
Procédure DROP_FILE	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.
Procédure RETIRE_FILES	Supprime un ou plusieurs fichiers du cache qui sont plus anciens que l'intervalle spécifié.
Procédure SET_USER_PROPERTY	Spécifie la préférence de mise en cache pour une mémoire cache de table externe.
Procédure VALIDER	Valide une mémoire cache de table externe.

Procédure ADD_BY_LIKE

La procédure DBMS_EXT_TABLE_CACHE.ADD_BY_LIKE charge un ou plusieurs fichiers spécifiés 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 des 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.

Procédure ADD_FILE

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é.

Procédure ADD_LATEST_FILES

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 de 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.

Procédure ADD_TABLE

La procédure DBMS_EXT_TABLE_CACHE.ADD_TABLE charge une table entière ou un certain pourcentage de la table externe dans le 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;
/

Procédure CREATE_CACHE

La procédure DBMS_EXT_TABLE_CACHE.CREATE_CACHE crée une mémoire cache de table externe dans une instance de base de données d'intelligence artificielle autonome.

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 Indique 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 de base de données du service d'intelligence artificielle autonome. 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.

Procédure DROP_BY_LIKE

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

Procédure DROP_CACHE

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.

Procédure DROP_FILE

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

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.

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

Procédure RETIRE_FILES

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

Procédure SET_USER_PROPERTY

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

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.

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 VALIDER

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

Contenu connexe

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