DBMS_AUTO_PARTITION-Package
Das Package DBMS_AUTO_PARTITION
bietet administrative Routinen zur Verwaltung der automatischen Partitionierung von Schemas und Tabellen.
- Prozedur CONFIGURE
Mit dieser Prozedur konfigurieren Sie Einstellungen für die automatische Partitionierung in Autonomous Database. - VALIDATE_CANDIDATE_TABLE-Funktion
Diese Funktion prüft, ob die angegebene Tabelle für die automatische Partitionierung in Autonomous Database in Frage kommt. - RECOMMEND_PARTITION_METHOD-Funktion
Diese Funktion gibt eine Empfehlungs-ID zurück, die mit der ProzedurAPPLY_RECOMMENDATION
verwendet werden kann, um die Empfehlung anzuwenden, oder mit der ViewDBA_AUTO_PARTITION_RECOMMENDATIONS
, um Details der Empfehlungen für die automatische Partitionierung in Autonomous Database abzurufen. - Prozedur APPLY_RECOMMENDATION
Diese Prozedur wendet die angegebene Empfehlung in einer Autonomous Database an. - REPORT_ACTIVITY-Funktion
Diese Funktion gibt einen Bericht über die automatischen Partitionierungsvorgänge zurück, die in einem bestimmten Zeitraum in einer Autonomous Database ausgeführt wurden. - REPORT_LAST_ACTIVITY-Funktion
Diese Funktion gibt einen Bericht über den letzten automatischen Partitionierungsvorgang zurück, der in einer Autonomous Database ausgeführt wurde.
Übergeordnetes Thema: Von Autonomous Database bereitgestellte Paketreferenz
Prozedur CONFIGURE
Mit diesem Verfahren konfigurieren Sie Einstellungen für die automatische Partitionierung in Autonomous Database.
Syntax
DBMS_AUTO_PARTITION.CONFIGURE (
PARAMETER_NAME IN VARCHAR2,
PARAMETER_VALUE IN VARCHAR2,
ALLOW IN BOOLEAN DEFAULT TRUE);
Parameter
Parameter | Beschreibung |
---|---|
|
Der zu aktualisierende Konfigurationsparameter der automatischen Partitionierung. Er kann einen der folgenden Werte haben:
AUTO_PARTITION_MODE bestimmt den Modus für den automatischen Partitionierungsvorgang und weist einen der folgenden Werte auf:
AUTO_PARTITION_SCHEMA legt Schemas fest, die bei der automatischen Partitionierung ein- oder ausgeschlossen werden sollen. Ihr Verhalten wird durch den Zulassungsparameter gesteuert. Der automatische Partitionierungsprozess verwaltet zwei Schemalisten.
Anfänglich sind beide Listen leer, und alle Schemas in der Datenbank können die automatische Partitionierung verwenden. Wenn die Inklusionsliste ein oder mehrere Schemas enthält, können nur die in der Inklusionsliste aufgeführten Schemas die automatische Partitionierung verwenden. Wenn die Inklusionsliste leer ist und die Exklusionsliste mindestens ein Schema enthält, verwenden alle Schemas mit Ausnahme der in der Exklusionsliste aufgeführten Schemas die automatische Partitionierung. Wenn beide Listen ein oder mehrere Schemas enthalten, verwenden alle Schemas mit Ausnahme der in der Exklusionsliste aufgeführten Schemas die automatische Partitionierung.
Anfänglich sind beide Listen leer, und alle Tabellen in der Datenbank können die automatische Partitionierung verwenden. Wenn die Inklusionsliste eine oder mehrere Tabellen enthält, können nur die in der Inklusionsliste aufgeführten Tabellen die automatische Partitionierung verwenden. Wenn die Inklusionsliste leer ist und die Exklusionsliste mindestens eine Tabelle enthält, verwenden alle Tabellen mit Ausnahme der in der Exklusionsliste aufgeführten automatische Partitionierung. Wenn beide Listen mindestens eine Tabelle enthalten, verwenden alle Tabellen mit Ausnahme der Tabellen, die in der Exklusionsliste aufgeführt sind, die automatische Partitionierung. Wenn eine Tabelle in keiner der Listen enthalten ist, entscheiden die Ein- und Ausschlusslisten für Schemas, ob eine Tabelle für die automatische Partitionierung in Frage kommt. Wenn ein Konflikt zwischen den Listen auf Schemaebene und den Listen auf Tabellenebene besteht, haben die Listen auf Tabellenebene Vorrang. So entfernen Sie alle Tabellen aus Ein- und Exklusionslisten:
|
|
Wert für die in |
|
Gilt nur für die Konfigurationseinstellungen
AUTO_PARTITION_SCHEMA oder AUTO_PARTITION_TABLE mit einem der folgenden Werte:
AUTO_PARTITION_SCHEMA und AUTO_PARTITION_TABLE .
|
Hinweise zur Verwendung
-
Sie können die aktuelle Einstellung für die automatische Partitionierungskonfiguration mit der folgenden SQL prüfen:
SELECT * FROM DBA_AUTO_PARTITION_CONFIG;
-
Im Gegensatz zur automatischen Indexierung wird die automatische Partitionierung nicht regelmäßig als Hintergrundaufgabe ausgeführt. Die automatische Partitionierung wird nur ausgeführt, wenn Sie sie mit der Funktion
DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD
aufrufen.
Übergeordnetes Thema: Paket DBMS_AUTO_PARTITION
VALIDATE_CANDIDATE_TABLE-Funktion
Diese Funktion prüft, ob die angegebene Tabelle für die automatische Partitionierung in Autonomous Database in Frage kommt.
Kriterien
- Die Tabelle besteht Einschluss- und Exklusionstests, die mit den Konfigurationsparametern
AUTO_PARTITION_SCHEMA
undAUTO_PARTITION_TABLE
angegeben werden. - Die Tabelle ist vorhanden und enthält aktuelle Statistiken.
- Die Tabelle umfasst mindestens 64 GB.
- Die Tabelle enthält 5 oder mehr Abfragen in dem SQL Tuning Set, das die Tabelle gescannt hat.
- Die Tabelle enthält keine Spalte mit Datentyp
LONG
. - Die Tabelle wurde nicht manuell partitioniert.
- Die Tabelle ist keine externe Tabelle, keine interne/externe Hybridtabelle, keine temporäre Tabelle, keine indexorganisierte Tabelle und keine geclusterte Tabelle.
- Die Tabelle hat keinen Domainindex oder Bitmap Join-Index.
- Die Tabelle ist keine Advanced Queuing-, Materialized View- oder Flashback Archive Storage-Tabelle.
- Die Tabelle enthält keine verschachtelten Tabellen und keine bestimmten anderen Objektfeatures.
VALID
, wenn die Tabelle ein gültiger Kandidat für die autonome Partitionierung istINVALID: <reason>
, wenn die Tabelle kein gültiger Kandidat für die autonome Partitionierung ist. <reason> ist eine Zeichenfolge, die beschreibt, warum die Tabelle kein gültiger Kandidat ist.
Syntax
DBMS_AUTO_PARTITION.VALIDATE_CANDIDATE_TABLE
( SQLSET_OWNER IN VARCHAR2 DEFAULT 'SYS',
SQLSET_NAME IN VARCHAR2 DEFAULT 'SYS_AUTO_STS',
TABLE_OWNER IN VARCHAR2,
TABLE_NAME IN VARCHAR2)
RETURN VARCHAR2;
Parameter
Parameter | Beschreibung |
---|---|
|
Name des SQL Tuning Sets, das die auszuwertende Workload darstellt. |
|
Name einer Tabelle, die als Kandidat für die automatische Partitionierung validiert werden soll. |
Hinweise zur Verwendung
- Beispiel: Sie können die Gültigkeit einer Beispieltabelle
LINEORDER
im SchemaTEST
mit der folgenden SQL prüfen:SELECT DBMS_AUTO_PARTITION.VALIDATE_CANDIDATE_TABLE ( TABLE_OWNER => 'TEST', TABLE_NAME => 'LINEORDER') FROM DUAL;
Übergeordnetes Thema: Paket DBMS_AUTO_PARTITION
Funktion RECOMMEND_PARTITION_METHOD
Diese Funktion gibt eine Empfehlungs-ID zurück, die mit der Prozedur APPLY_RECOMMENDATION
verwendet werden kann, um die Empfehlung anzuwenden, oder mit der View DBA_AUTO_PARTITION_RECOMMENDATIONS
, um Details der Empfehlungen für die automatische Partitionierung in Autonomous Database abzurufen.
Syntax
DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD
( SQLSET_OWNER IN VARCHAR2 DEFAULT 'SYS',
SQLSET_NAME IN VARCHAR2 DEFAULT 'SYS_AUTO_STS',
TABLE_OWNER IN VARCHAR2 DEFAULT NULL,
TABLE_NAME IN VARCHAR2 DEFAULT NULL,
TIME_LIMIT IN INTERVAL DAY TO SECOND DEFAULT INTERVAL '1' DAY,
REPORT_TYPE IN VARCHAR2 DEFAULT 'TEXT',
REPORT_SECTION IN VARCHAR2 DEFAULT 'SUMMARY',
REPORT_LEVEL IN VARCHAR2 DEFAULT 'TYPICAL')
RETURN RAW;
Parameter
Parameter | Beschreibung |
---|---|
|
Name des SQL Tuning Sets, das die auszuwertende Workload darstellt. |
|
Name einer Tabelle, die als Kandidat für die automatische Partitionierung validiert werden soll. |
|
Wenn die Funktion die Tabellen wählt, für die Empfehlungen generiert werden sollen ( |
|
Wird zum Generieren eines Berichts für die empfohlene Partitionsmethode verwendet. Weitere Einzelheiten finden Sie unter Funktion REPORT_ACTIVITY. |
|
Wird zum Generieren eines persistenten Berichts für die empfohlene Partitionsmethode verwendet. Weitere Einzelheiten finden Sie unter Funktion REPORT_ACTIVITY. |
|
Wird zum Generieren eines Berichts für die empfohlene Partitionsmethode verwendet. Weitere Einzelheiten finden Sie unter Funktion REPORT_ACTIVITY. |
Hinweise zur Verwendung
-
Die
AUTO_PARTITION_MODE
steuert die von dieser Funktion ausgeführten Aktionen:IMPLEMENT
: In diesem Modus generiert die automatische Partitionierung einen Bericht und ändert die vorhandene Tabelle mit der empfohlenen Partitionierungsmethode.REPORT ONLY
: In diesem Modus generiert die automatische Partitionierung einen Bericht, vorhandene Tabellen werden jedoch nicht geändert. Dies ist das Standardverhalten.OFF
: In diesem Modus konnte die automatische Partitionierung keine neuen Empfehlungen erzeugen, berücksichtigen oder anwenden. Vorhandene automatisch partitionierte Tabellen werden nicht deaktiviert.
-
Im Gegensatz zur automatischen Indexierung wird die automatische Partitionierung nicht regelmäßig als Hintergrundaufgabe ausgeführt. Die automatische Partitionierung wird nur ausgeführt, wenn Sie sie mit der Funktion
DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD
aufrufen.
Werte zurückgeben
Diese Funktion gibt eine Empfehlungs-ID zurück, die wie folgt verwendet werden kann: DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
, um die Empfehlung anzuwenden,
- Verwendung mit
DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
, um die Empfehlung anzuwenden. - Verwendung mit der View
DBA_AUTO_PARTITION_RECOMMENDATIONS
, um Details der Empfehlungen abzurufen. Beispiele:SELECT PARTITION_METHOD, PARTITION_KEY FROM DBA_AUTO_PARTITION_RECOMMENDATIONS WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
Übergeordnetes Thema: Paket DBMS_AUTO_PARTITION
APPLY_RECOMMENDATION-Prozedur
Diese Prozedur wendet die angegebene Empfehlung in einer Autonomous Database an.
Syntax
DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
( RECOMMENDATION_ID IN RAW,
TABLE_OWNER IN VARCHAR2 DEFAULT NULL,
TABLE_NAME IN VARCHAR2 DEFAULT NULL);
Parameter
Parameter | Beschreibung |
---|---|
|
Empfehlungs-ID, die von der Funktion |
|
Wenn eine einzelne Empfehlungs-ID Empfehlungen für mehrere Tabellen enthält, können Sie mit diesem optionalen Parameter steuern, welche Tabellen partitioniert werden.
|
Hinweis zur Verwendung:
Unabhängig von AUTO_PARTITION_MODE
löst diese Prozedur einen Fehler ORA-20000: recommendation_id was not found
aus, wenn entweder keine akzeptierten Empfehlungen mit der RECOMMENDATION_ID
verknüpft sind oder alle akzeptierten Empfehlungen, die mit der RECOMMENDATION_ID
verknüpft sind, bereits angewendet wurden. Der erste Fall trifft zu, wenn RECOMMENDATION_ID
mit AUTO_PARTITION_MODE = OFF
generiert wurde. Der zweite Fall trifft zu, wenn RECOMMENDATION_ID
mit AUTO_PARTITION_MODE = IMPLEMENT
generiert wurde.
Übergeordnetes Thema: Paket DBMS_AUTO_PARTITION
Funktion REPORT_ACTIVITY
Diese Funktion gibt einen Bericht über die automatischen Partitionierungsvorgänge zurück, die in einem bestimmten Zeitraum in einer Autonomous Database ausgeführt wurden.
Syntax
DBMS_AUTO_PARTITION.REPORT_ACTIVITY
( ACTIVITY_START IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
ACTIVITY_END IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
TYPE IN VARCHAR2 DEFAULT 'TEXT',
SECTION IN VARCHAR2 DEFAULT 'ALL',
LEVEL IN VARCHAR2 DEFAULT 'TYPICAL')
RETURN CLOB;
Parameter
Parameter | Beschreibung |
---|---|
|
Startzeit, ab der automatische Partitionierungsvorgänge für den Bericht verwendet werden sollen. Wenn kein Wert oder |
|
Endzeit, bis zu der automatische Partitionierungsvorgänge für den Bericht verwendet werden sollen. Wenn kein Wert oder |
|
Format des Berichts mit einem der folgenden Werte:
|
|
Abschnitte, die in den Bericht aufgenommen werden sollen, mit einem der folgenden Werte:
|
|
Informationsebene, die in den Bericht aufgenommen werden soll, mit einem der folgenden Werte:
|
Hinweise zur Verwendung
Gibt einen Performanceanalysebericht für die Workload zurück, der nach Anwendung der Empfehlung für die Datenbank ausgeführt wird. Dieser Bericht wird mit der Empfehlung nicht dauerhaft gespeichert.
Übergeordnetes Thema: Paket DBMS_AUTO_PARTITION
Funktion REPORT_LAST_ACTIVITY
Diese Funktion gibt einen Bericht über den letzten automatischen Partitionierungsvorgang zurück, der in einer Autonomous Database ausgeführt wurde.
Syntax
DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY
( TYPE IN VARCHAR2 DEFAULT 'TEXT',
SECTION IN VARCHAR2 DEFAULT 'ALL',
LEVEL IN VARCHAR2 DEFAULT 'TYPICAL')
RETURN CLOB;
Parameter
Parameter | Beschreibung |
---|---|
|
Informationen zum Ausgabeformat des Berichts finden Sie unter Funktion REPORT_ACTIVITY. |
|
Informationen zu den im Bericht enthaltenen Abschnitten finden Sie unter Funktion REPORT_ACTIVITY. |
|
Informationen zur Ebene der Informationen im Bericht finden Sie unter Funktion REPORT_ACTIVITY. |
Hinweise zur Verwendung
Gibt Folgendes zurück: einen Performanceanalysebericht für die Workload, der in der Datenbank ausgeführt wird, nachdem die letzte Empfehlung angewendet wurde. Dieser Bericht wird mit der Empfehlung nicht dauerhaft gespeichert.
Übergeordnetes Thema: Paket DBMS_AUTO_PARTITION