DBMS_CACHE-Package
Das Package DBMS_CACHE vereinfacht das automatische Caching für Lake-Caches in einer autonomen AI-Datenbankinstanz, einschließlich Caches, die für externe Tabellen und für Tabellen erstellt wurden, die über gemountete Kataloge bereitgestellt werden.
Zusammenfassung der DBMS_CACHE-Unterprogramme
In dieser Tabelle werden die Unterprogramme zusammengefasst, die im Package DBMS_CACHE enthalten sind.
| Unterprogramm | Beschreibung |
|---|---|
| CLEAR-Verfahren | Löscht alle Lake-Caches für einen angegebenen Benutzer. |
| Prozedur ENABLE_AUTO | Aktiviert das automatische Caching global oder für mindestens ein Schema und legt optional GLOBAL_CACHE_SIZE oder GLOBAL_CACHE_PERCENT fest. |
| Prozedur GET_GLOBAL_PROPERTY | Ruft automatische Lake Cache-Eigenschaften ab. |
| Prozedur GET_USER_PROPERTY | Ruft automatische Lake Cache-Eigenschaften für einen angegebenen Benutzer ab. |
| REFRESH-Verfahren | Aktualisiert alle Lake-Caches für einen angegebenen Benutzer. |
| Prozedur SET_GLOBAL_PROPERTY | Gibt die automatische Lake Cache-Voreinstellung für alle Datenbankbenutzer an. |
| SET_USER_PROPERTY-Prozedur | Gibt die automatische Lake Cache-Voreinstellung für einen angegebenen Benutzer an. |
CLEAR-Verfahren
Verwenden Sie die Prozedur DBMS_CACHE.CLEAR, um alle Lake-Caches für einen angegebenen Benutzer zu löschen.
Die Prozedur DBMS_CACHE.CLEAR löscht alle Lake-Caches und gibt den Speicherplatz frei, ähnlich wie der Befehl DROP für eine Datenbanktabelle.
Syntax
DBMS_CACHE.CLEAR (
owner IN VARCHAR2
);Parameter
| Parameter | Beschreibung |
|---|---|
owner |
Legt den Schemanamen fest. |
Beispiel
BEGIN
DBMS_CACHE.CLEAR (
owner => 'SALES');
END;
/Hinweis zur Verwendung
- Sie müssen als Benutzer
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_CACHEverfügen, um einen Cache zu löschen.
Prozedur ENABLE_AUTO
Mit der Prozedur DBMS_CACHE.ENABLE_AUTO können Sie das automatische Caching global oder für mindestens ein Schema aktivieren und optional die globale Cache-Quota festlegen.
Syntax
DBMS_CACHE.ENABLE_AUTO (
users IN CLOB DEFAULT NULL,
global_cache_size IN NUMBER DEFAULT NULL,
global_cache_pct IN NUMBER DEFAULT NULL
);Parameter
| Parameter | Beschreibung |
|---|---|
users |
Gibt ein JSON-Array im CLOB-Format an, das Schemanamen enthält. Wenn users NULL ist, wird das automatische Caching global für alle Benutzer aktiviert. |
global_cache_size |
Gibt die maximale globale Cache-Quota in Byte für die Datenbank an. |
global_cache_pct |
Gibt die Quota für den globalen Cache als Prozentsatz der maximalen Datenbankgröße an. |
Hinweise zur Verwendung
-
Die Prozedur aktiviert das automatische Caching, indem
AUTO_CACHEfestgelegt wird. -
Wenn
global_cache_sizeoderglobal_cache_pctangegeben ist, legt die Prozedur die entsprechende globale Quota-Eigenschaft fest. -
Wenn weder
global_cache_sizenochglobal_cache_pctangegeben ist, setzt die ProzedurGLOBAL_CACHE_PERCENTauf20. -
Verwenden Sie
DBMS_CACHE.SET_GLOBAL_PROPERTYoderDBMS_CACHE.SET_USER_PROPERTYmitAUTO_CACHE = 0, um das automatische Caching zu deaktivieren.
Beispiele
Beispiel für die globale Aktivierung von automatischem Caching:
BEGIN
DBMS_CACHE.ENABLE_AUTO(
users => NULL,
global_cache_pct => 20);
END;
/Beispiel für die Aktivierung des automatischen Caches für ausgewählte Schemas:
DECLARE
l_users CLOB := '["HR","SALES"]';
BEGIN
DBMS_CACHE.ENABLE_AUTO(
users => l_users,
global_cache_size => 21474836480);
END;
/Prozedur GET_GLOBAL_PROPERTY
Die Prozedur DBMS_CACHE.GET_GLOBAL_PROPERTY ruft die automatischen Lake Cache-Voreinstellungen für alle Benutzer in der Datenbank ab. Diese Prozedur ist überladen.
Syntax
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);Parameter
| Parameter | Beschreibung |
|---|---|
property_name |
Gibt den Namen der Eigenschaft an. Folgende gültige Werte sind für
|
property_value_num |
Ruft einen NUMBER-Wert für den angegebenen Eigenschaftsnamen ab. |
property_value_str |
Ruft einen STRING-Wert für den angegebenen Eigenschaftsnamen ab. |
Beispiel
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;
/Hinweise zur Verwendung
-
Sie müssen als Benutzer
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_CACHEverfügen, um diese Prozedur ausführen zu können. -
GLOBAL_CACHE_SIZEundGLOBAL_CACHE_PERCENTdefinieren nur Quota. Sie aktivieren kein automatisches Caching. Verwenden SieAUTO_CACHEoderDBMS_CACHE.ENABLE_AUTO, um das automatische Caching zu aktivieren. -
Wenn sowohl
GLOBAL_CACHE_SIZEals auchGLOBAL_CACHE_PERCENTfestgelegt sind, wird der größere Wert verwendet. Wenn keine globale Quota-Eigenschaft explizit festgelegt ist, lautet der Standardwert fürGLOBAL_CACHE_PERCENT20. -
Wenn sowohl
MAX_CACHE_SIZEals auchMAX_CACHE_PERCENTfestgelegt sind, wird der größere Wert verwendet. Wenn keine der Standard-Quota-Eigenschaften explizit festgelegt ist, lautet der Standardwert fürMAX_CACHE_PERCENT20.
Prozedur SET_GLOBAL_PROPERTY
Verwenden Sie DBMS_CACHE.SET_GLOBAL_PROPERTY, um globale automatische Caching-Eigenschaften für die Datenbank festzulegen. Diese Prozedur ist überladen.
AUTO_CACHE aktiviert oder deaktiviert das automatische Caching im Datenbankgeltungsbereich. GLOBAL_CACHE_SIZE und GLOBAL_CACHE_PERCENT definieren die globale Cache-Quota für alle externen Tabellencaches. MAX_CACHE_SIZE und MAX_CACHE_PERCENT definieren Standardvoreinstellungen für Quota auf Schemaebene für Schemas, die keine Überschreibung auf Benutzerebene aufweisen. Wenn Sie GLOBAL_CACHE_SIZE, GLOBAL_CACHE_PERCENT, MAX_CACHE_SIZE oder MAX_CACHE_PERCENT festlegen, wird das automatische Caching allein nicht aktiviert.
Syntax
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);Parameter
| Parameter | Beschreibung |
|---|---|
property_name |
Gibt den Namen der Eigenschaft an. Folgende gültige Werte sind für
|
property_value_num |
Stellt einen NUMBER-Wert für den angegebenen Eigenschaftsnamen bereit. |
property_value_str |
Stellt einen STRING-Wert für den angegebenen Eigenschaftsnamen bereit. |
Beispiele
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;
/Hinweise zur Verwendung
-
Sie müssen als Benutzer
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_CACHEverfügen, um diese Prozedur ausführen zu können. -
Wenn sowohl
GLOBAL_CACHE_SIZEals auchGLOBAL_CACHE_PERCENTfestgelegt sind, wird der größere Wert verwendet. -
Wenn keine globale Quota-Eigenschaft explizit festgelegt ist, lautet der Standardwert für
GLOBAL_CACHE_PERCENT20. -
Wenn sowohl
MAX_CACHE_SIZEals auchMAX_CACHE_PERCENTfestgelegt sind, wird der größere Wert verwendet. -
Wenn keine der Standard-Quota-Eigenschaften explizit festgelegt ist, lautet der Standardwert für
MAX_CACHE_PERCENT20. -
Wenn
MAX_CACHE_SIZEgrößer alsGLOBAL_CACHE_SIZEfestgelegt ist, löst die Datenbank einen Fehler aus. -
Manuelle Caches und
AUTO-Caches belegen denselben Quota-Pool. -
Die Eigenschaft
MAX_REFRESH_WINDOWgibt in Sekunden an, wie lange maximal Lake-Caches aktualisiert werden dürfen. Wenn die Aktualisierung den angegebenen Grenzwert überschreitet, wird die Cacheaktualisierung normal beendet, und alle verbleibenden zulässigen Caches werden für den nächsten Aktualisierungszyklus in die Queue gestellt. -
Wenn Sie Caches mit der Prozedur
DBMS_CACHE.REFRESHaktualisieren, hat der Prozedurparameter Vorrang vor der EigenschaftAUTO_REFRESH_MODE.Weitere Informationen finden Sie unter Prozedur REFRESH.
REFRESH-Verfahren
Verwenden Sie die Prozedur DBMS_CACHE.REFRESH, um alle AUTO-Lake-Caches für einen angegebenen Benutzer zu aktualisieren.
Syntax
DBMS_CACHE.REFRESH (
owner IN VARCHAR2,
refresh_type IN VARCHAR2 DEFAULT ALL
);Parameter
| Parameter | Beschreibung |
|---|---|
owner |
Legt den Schemanamen fest. |
refresh_type |
Gibt die Aktualisierungsoption an. Folgende gültige
Dieser Parameter ist optional und standardmäßig |
Beispiel
BEGIN
DBMS_CACHE.REFRESH (
owner => 'SALES',
refresh_type => 'CURRENT');
END;
/Hinweise zur Verwendung
-
Sie müssen als Benutzer
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_CACHEverfügen, um diese Prozedur ausführen zu können. -
Wenn Sie keinen Wert für den Parameter
refresh_typeangeben, führt Oracle eine Aktualisierung basierend auf dem Wertauto_refresh_modedurch. Der Standardwert fürauto_refresh_modeistALL. -
Wenn die Eigenschaft
MAX_REFRESH_WINDOWfestgelegt ist, versucht Oracle, eine Aktualisierung im angegebenen Fenster durchzuführen. Wenn die Aktualisierung den angegebenen Grenzwert überschreitet, wird die Cacheaktualisierung normal beendet, und alle verbleibenden zulässigen Caches werden für den nächsten Aktualisierungszyklus in die Queue gestellt. -
Alle AUTO-Caches in der Datenbank werden mit einem Räumungsalgorithmus verwaltet, der dem LRU (Least Recently Used) ähnelt. Unter Speicherplatzdruck werden Caches, auf die zuletzt zugegriffen wurde, während des Aktualisierungsprozesses automatisch gelöscht, um den Speicherplatz freizugeben.
Prozedur GET_USER_PROPERTY
Verwenden Sie die Prozedur DBMS_CACHE.GET_USER_PROPERTY, um automatische Caching-Eigenschaften für einen Benutzer abzurufen.
Syntax
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);Parameter
| Parameter | Beschreibung |
|---|---|
property_name |
Gibt den Namen der Eigenschaft an. Folgende gültige Werte sind für
|
owner |
Legt den Schemanamen fest. Dieser Parameter ist optional und standardmäßig das aktuelle Schema. |
property_value_str |
Ruft einen STRING-Wert für den angegebenen Eigenschaftsnamen ab. |
property_value_num |
Ruft einen NUMBER-Wert für den angegebenen Eigenschaftsnamen ab. |
Beispiel
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;
/Hinweise zur Verwendung
-
Sie müssen als Benutzer
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_CACHEverfügen, um diese Prozedur ausführen zu können. -
MAX_CACHE_SIZEundMAX_CACHE_PERCENTsind Quota-Steuerelemente auf Schemaebene. Sie aktivieren das automatische Caching nicht selbst. MitAUTO_CACHEkönnen Sie das automatische Caching für das angegebene Schema aktivieren oder deaktivieren. -
Wenn sowohl
MAX_CACHE_SIZEals auchMAX_CACHE_PERCENTfestgelegt sind, wird der größere Wert verwendet. Wenn keine Quota-Eigenschaft auf Schemaebene explizit festgelegt ist, lautet der Standardwert fürMAX_CACHE_PERCENT20.
Prozedur SET_USER_PROPERTY
Verwenden Sie DBMS_CACHE.SET_USER_PROPERTY, um Eigenschaften für das automatische Caching für ein angegebenes Schema festzulegen. Verwenden Sie AUTO_CACHE, um das automatische Caching für das Schema zu aktivieren oder zu deaktivieren. Verwenden Sie MAX_CACHE_SIZE und MAX_CACHE_PERCENT, um Quota-Voreinstellungen auf Schemaebene im globalen Quota-Modell festzulegen.
Syntax
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
);Parameter
| Parameter | Beschreibung |
|---|---|
property_name |
Gibt den Namen der Eigenschaft an. Folgende gültige Werte sind für
|
property_value_num |
Stellt einen NUMBER-Wert für den angegebenen Eigenschaftsnamen bereit. |
property_value_str |
Stellt einen STRING-Wert für den angegebenen Eigenschaftsnamen bereit. |
owner |
Legt den Schemanamen fest. Dieser Parameter ist optional und standardmäßig das aktuelle Schema. |
Beispiele
Beispiel für die Aktivierung von automatischem Caching für ein Schema:
BEGIN
DBMS_CACHE.SET_USER_PROPERTY(
property_name => 'AUTO_CACHE',
property_value_num => 1,
owner => 'SALES');
END;
/Beispiel zum Festlegen einer Cache-Quota auf Schemaebene:
BEGIN
DBMS_CACHE.SET_USER_PROPERTY(
property_name => 'MAX_CACHE_SIZE',
property_value_num => 5368709120,
owner => 'SALES');
END;
/Hinweise zur Verwendung
-
Sie müssen als Benutzer
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_CACHEverfügen, um diese Prozedur ausführen zu können. -
Einstellungen auf Benutzerebene überschreiben globale Einstellungen.
-
MAX_CACHE_SIZEundMAX_CACHE_PERCENTaktivieren das automatische Caching nicht selbst. -
Wenn sowohl
MAX_CACHE_SIZEals auchMAX_CACHE_PERCENTfestgelegt sind, wird der größere Wert verwendet. -
Wenn keine Quota-Eigenschaft auf Schemaebene explizit festgelegt ist, lautet der Standardwert für
MAX_CACHE_PERCENT20. -
Wenn
MAX_CACHE_SIZEgrößer alsGLOBAL_CACHE_SIZEfestgelegt ist, löst die Datenbank einen Fehler aus. -
Manuelle Policys setzen automatisches Verhalten immer außer Kraft.