DBMS_AUTO_PARTITIONパッケージ
DBMS_AUTO_PARTITION
パッケージは、スキーマおよび表の自動パーティション化を管理するための管理ルーチンを提供します。
- CONFIGUREプロシージャ
このプロシージャでは、Autonomous Databaseでの自動パーティション化の設定を構成します。 - VALIDATE_CANDIDATE_TABLEファンクション
このファンクションは、指定された表がAutonomous Databaseでの自動パーティション化の有効な候補かどうかを確認します。 - RECOMMEND_PARTITION_METHODファンクション
このファンクションは、APPLY_RECOMMENDATION
プロシージャとともに使用して推奨事項を適用できる推奨事項IDを返します。または、DBA_AUTO_PARTITION_RECOMMENDATIONS
ビューとともに使用して、Autonomous Databaseの自動パーティション化の推奨事項の詳細を取得できます。 - APPLY_RECOMMENDATIONプロシージャ
このプロシージャは、Autonomous Databaseで指定された推奨事項を適用します。 - REPORT_ACTIVITYファンクション
このファンクションは、特定の期間中にAutonomous Databaseで実行された自動パーティション化操作のレポートを返します。 - REPORT_LAST_ACTIVITYファンクション
このファンクションは、Autonomous Databaseで実行された最新の自動パーティション化操作のレポートを返します。
CONFIGUREプロシージャ
このプロシージャでは、Autonomous Databaseでの自動パーティション化の設定を構成します。
構文
DBMS_AUTO_PARTITION.CONFIGURE (
PARAMETER_NAME IN VARCHAR2,
PARAMETER_VALUE IN VARCHAR2,
ALLOW IN BOOLEAN DEFAULT TRUE);
パラメータ
パラメータ | 説明 |
---|---|
|
更新する自動パーティション化構成パラメータの名前。値は次のいずれかです。
AUTO_PARTITION_MODE は、自動パーティション化操作のモードを設定し、次のいずれかの値を持ちます:
AUTO_PARTITION_SCHEMA は、自動パーティション化の使用の対象または対象外のスキーマを設定します。動作の制御には、allowパラメータを使用します。自動パーティション化プロセスは、2つのスキーマ・リストを管理します。
最初はいずれのリストも空で、データベース内のすべてのスキーマで自動パーティション化を使用できます。包含リストに1つ以上のスキーマが含まれている場合は、包含リストにリストされているスキーマのみが自動パーティション化を使用できます。包含リストが空で、除外リストに1つ以上のスキーマが含まれている場合は、除外リストにリストされたスキーマ以外のすべてのスキーマで自動パーティション化が使用されます。両方のリストに1つ以上のスキーマが含まれている場合は、除外リストにリストされたスキーマ以外のすべてのスキーマで自動パーティション化が使用されます。
最初は、両方のリストが空で、データベース内のすべての表が自動パーティション化を使用できます。包含リストに1つ以上の表が含まれている場合、包含リストにリストされている表のみが自動パーティション化を使用できます。包含リストが空で、除外リストに1つ以上の表が含まれている場合、除外リストにリストされている表を除き、すべての表で自動パーティション化が使用されます。両方のリストに1つ以上の表が含まれている場合、除外リストにリストされている表を除き、すべての表で自動パーティション化が使用されます。表がいずれのリストにもない場合、表が自動パーティション化の候補表かどうかは、スキーマの包含リストと除外リストによって決まります。スキーマ・レベル・リストと表レベル・リストの間に矛盾がある場合、表レベル・リストが優先されます。 包含リストからすべての表を削除するには、次を実行します:
|
|
|
|
次のいずれかの値を持つ
AUTO_PARTITION_SCHEMA またはAUTO_PARTITION_TABLE 構成設定にのみ適用できます:
AUTO_PARTITION_SCHEMA およびAUTO_PARTITION_TABLE 構成設定の説明を参照してください。
|
使用上のノート
-
次のSQLを使用して、自動パーティション化構成の現在の設定を確認できます:
SELECT * FROM DBA_AUTO_PARTITION_CONFIG;
-
自動索引作成とは異なり、自動パーティション化はバックグラウンド・タスクとして定期的に実行されません。自動パーティションは、
DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD
ファンクションを使用して起動した場合にのみ実行されます。
親トピック: DBMS_AUTO_PARTITIONパッケージ化
VALIDATE_CANDIDATE_TABLEファンクション
この関数は、指定された表がAutonomous Databaseでの自動パーティション化の有効な候補かどうかを確認します。
有効な候補
- 表が、
AUTO_PARTITION_SCHEMA
およびAUTO_PARTITION_TABLE
構成パラメータで指定された包含および除外テストを渡します。 - 表が存在し、最新の統計があります。
- 表は64 GB以上です。
- 表に、表をスキャンしたSQLチューニング・セット内の5つ以上の問合せがあります。
- 表に
LONG
データ型の列がありません。 - 表は手動でパーティション化されていません。
- テーブルは、外部テーブル、内部/外部ハイブリッドテーブル、一時テーブル、インデックス構成テーブル、またはクラスタ化テーブルではありません。
- 表にドメイン索引またはビットマップ結合索引がありません。
- 表は、拡張キューイング、マテリアライズド・ビューまたはフラッシュバック・アーカイブ記憶域表ではありません。
- 表に、ネストされた表、または他の特定のオブジェクト機能がありません。
- 表が自律型パーティション化の有効な候補である場合は、
VALID
- 表が自律型パーティション化の有効な候補でない場合は
INVALID: <reason>
で、<reason>は、表が有効な候補ではない理由を説明する文字列です。
構文
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;
パラメータ
パラメータ | 説明 |
---|---|
|
評価するワークロードを表すSQLチューニング・セットの名前。 |
|
自動パーティション化の候補として検証する表の名前。 |
使用上のノート
- たとえば、次のSQLを使用して、スキーマ
TEST
のサンプル表LINEORDER
の有効性をチェックできます:SELECT DBMS_AUTO_PARTITION.VALIDATE_CANDIDATE_TABLE ( TABLE_OWNER => 'TEST', TABLE_NAME => 'LINEORDER') FROM DUAL;
親トピック: DBMS_AUTO_PARTITIONパッケージ化
RECOMMEND_PARTITION_METHODファンクション
このファンクションは、APPLY_RECOMMENDATION
プロシージャとともに使用して推奨事項を適用できる推奨事項IDを返します。または、DBA_AUTO_PARTITION_RECOMMENDATIONS
ビューとともに使用して、Autonomous Databaseの自動パーティション化の推奨事項の詳細を取得できます。
構文
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;
パラメータ
パラメータ | 説明 |
---|---|
|
評価するワークロードを表すSQLチューニング・セットの名前。 |
|
自動パーティション化の候補として検証する表の名前。 |
|
ファンクションが推奨事項を生成する表を選択する場合、 |
|
推奨パーティション・メソッドのレポートを生成するために使用されます。詳細は、REPORT_ACTIVITY関数を参照してください。 |
|
推奨パーティション・メソッドの永続レポートを生成するために使用されます。詳細は、REPORT_ACTIVITY関数を参照してください。 |
|
推奨パーティション・メソッドのレポートを生成するために使用されます。詳細は、REPORT_ACTIVITY関数を参照してください。 |
使用上のノート
-
AUTO_PARTITION_MODE
は、このファンクションで実行されるアクションを制御します:IMPLEMENT
: このモードでは、自動パーティション化によってレポートが生成され、推奨されるパーティション・メソッドを使用して既存の表が変更されます。REPORT ONLY
: このモードでは、自動パーティション化によってレポートが生成されますが、既存の表は変更されません。これはデフォルト値です。OFF
: このモードでは、自動パーティション化は新しい推奨事項を作成、検討または適用できません。既存の自動パーティション表は無効化されません。
-
自動索引作成とは異なり、自動パーティション化はバックグラウンド・タスクとして定期的に実行されません。自動パーティションは、
DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD
ファンクションを使用して起動した場合にのみ実行されます。
戻り値
このファンクションは、DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
を使用して推奨事項を適用できる推奨事項IDを返します。
DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
を使用して、推奨事項を適用します。DBA_AUTO_PARTITION_RECOMMENDATIONS
ビューとともに使用して、推奨事項の詳細を取得します。たとえば、次のとおりです。SELECT PARTITION_METHOD, PARTITION_KEY FROM DBA_AUTO_PARTITION_RECOMMENDATIONS WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
親トピック: DBMS_AUTO_PARTITIONパッケージ化
APPLY_RECOMMENDATIONプロシージャ
このプロシージャは、Autonomous Databaseで指定された推奨事項を適用します。
構文
DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
( RECOMMENDATION_ID IN RAW,
TABLE_OWNER IN VARCHAR2 DEFAULT NULL,
TABLE_NAME IN VARCHAR2 DEFAULT NULL);
パラメータ
パラメータ | 説明 |
---|---|
|
|
|
単一の推奨事項IDに複数の表の推奨事項がある場合、このオプション・パラメータを使用すると、パーティション化される表を制御できます。
|
使用方法
AUTO_PARTITION_MODE
に関係なく、RECOMMENDATION_ID
に関連付けられている、受け入れられた推奨事項がない場合、またはRECOMMENDATION_ID
に関連付けられている、すべての受け入れられた推奨事項がすでに適用されている場合、このプロシージャはORA-20000: recommendation_id was not found
を生成します。最初のケースは、AUTO_PARTITION_MODE = OFF
を使用してRECOMMENDATION_ID
が生成された場合に適用されます。2番目のケースは、RECOMMENDATION_ID
がAUTO_PARTITION_MODE = IMPLEMENT
で生成された場合に適用されます。
親トピック: DBMS_AUTO_PARTITIONパッケージ化
REPORT_ACTIVITYファンクション
このファンクションは、Autonomous Databaseの特定の期間中に実行された自動パーティション化操作のレポートを返します。
構文
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;
パラメータ
パラメータ | 説明 |
---|---|
|
自動パーティション化操作がレポートに使用する開始時間。値を指定しない場合、または |
|
自動パーティション化操作がレポートに使用する終了時間。値を指定しない場合、または |
|
次のいずれかの値を持つレポートのフォーマット:
|
|
次のいずれかの値を持つレポートに含まれるセクション:
|
|
次のいずれかの値を持つレポートに含める情報のレベル:
|
使用上のノート
返品: 推奨事項の適用後にデータベースで実行されたワークロードのパフォーマンス分析レポート。このレポートは、推奨事項とともに永続的に格納されません。
親トピック: DBMS_AUTO_PARTITIONパッケージ化
REPORT_LAST_ACTIVITYファンクション
このファンクションは、Autonomous Databaseで実行された最新の自動パーティション化操作のレポートを返します。
構文
DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY
( TYPE IN VARCHAR2 DEFAULT 'TEXT',
SECTION IN VARCHAR2 DEFAULT 'ALL',
LEVEL IN VARCHAR2 DEFAULT 'TYPICAL')
RETURN CLOB;
パラメータ
パラメータ | 説明 |
---|---|
|
レポートの出力形式。詳細は、REPORT_ACTIVITY関数を参照してください。 |
|
レポートに含まれるセクション。詳細は、REPORT_ACTIVITY関数を参照してください。 |
|
レポートに含まれる情報のレベル。詳細は、REPORT_ACTIVITY関数を参照してください。 |
使用上のノート
戻り値: 最新の推奨事項の適用後にデータベースで実行されたワークロードのパフォーマンス分析レポート。このレポートは、推奨事項とともに永続的に格納されません。
親トピック: DBMS_AUTO_PARTITIONパッケージ化