DBMS_AUTO_PARTITIONパッケージ

DBMS_AUTO_PARTITIONパッケージは、スキーマおよび表の自動パーティション化を管理するための管理ルーチンを提供します。

CONFIGUREプロシージャ

このプロシージャでは、Autonomous Databaseでの自動パーティション化の設定を構成します。

構文

DBMS_AUTO_PARTITION.CONFIGURE (
     PARAMETER_NAME     IN VARCHAR2,
     PARAMETER_VALUE    IN VARCHAR2,
     ALLOW              IN BOOLEAN    DEFAULT TRUE);

パラメータ

パラメータ 説明

PARAMETER_NAME

更新する自動パーティション化構成パラメータの名前。値は次のいずれかです。

  • AUTO_PARTITION_MODE
  • AUTO_PARTITION_SCHEMA
  • AUTO_PARTITION_TABLE
  • AUTO_PARTITION_REPORT_RETENTION
AUTO_PARTITION_MODEは、自動パーティション化操作のモードを設定し、次のいずれかの値を持ちます:
  • IMPLEMENT: このモードでは、自動パーティション化によってレポートが生成され、推奨されるパーティション・メソッドを使用して既存の表が変更されます。
  • REPORT ONLY: このモードでは、自動パーティション化によってレポートが生成されますが、既存の表は変更されません。これはデフォルト値です。
  • OFF: このモードでは、自動パーティションで推奨事項の生成、検討または適用ができません。既存の自動パーティション表は無効化されません。
AUTO_PARTITION_SCHEMAは、自動パーティション化の使用の対象または対象外のスキーマを設定します。動作の制御には、allowパラメータを使用します。自動パーティション化プロセスは、2つのスキーマ・リストを管理します。
  1. 包含リストは、自動パーティション化を使用できるスキーマのリストで、大文字と小文字が区別されます。
  2. 除外リストは、自動パーティション化を使用できないスキーマのリストで、大文字と小文字が区別されます。

最初はいずれのリストも空で、データベース内のすべてのスキーマで自動パーティション化を使用できます。包含リストに1つ以上のスキーマが含まれている場合は、包含リストにリストされているスキーマのみが自動パーティション化を使用できます。包含リストが空で、除外リストに1つ以上のスキーマが含まれている場合は、除外リストにリストされたスキーマ以外のすべてのスキーマで自動パーティション化が使用されます。両方のリストに1つ以上のスキーマが含まれている場合は、除外リストにリストされたスキーマ以外のすべてのスキーマで自動パーティション化が使用されます。AUTO_PARTITION_TABLEは、自動パーティション化の使用の対象または対象外にする表を設定します。パラメータ値は<schema_name>.<table_name>です。自動パーティション化プロセスは、2つの表リストを管理します。

  1. 包含リストは、自動パーティション化を使用できる表のリストで、大文字と小文字が区別されます。
  2. 除外リストは、自動パーティション化を使用できない表のリストで、大文字と小文字が区別されます。

最初は、両方のリストが空で、データベース内のすべての表が自動パーティション化を使用できます。包含リストに1つ以上の表が含まれている場合、包含リストにリストされている表のみが自動パーティション化を使用できます。包含リストが空で、除外リストに1つ以上の表が含まれている場合、除外リストにリストされている表を除き、すべての表で自動パーティション化が使用されます。両方のリストに1つ以上の表が含まれている場合、除外リストにリストされている表を除き、すべての表で自動パーティション化が使用されます。表がいずれのリストにもない場合、表が自動パーティション化の候補表かどうかは、スキーマの包含リストと除外リストによって決まります。スキーマ・レベル・リストと表レベル・リストの間に矛盾がある場合、表レベル・リストが優先されます。

包含リストからすべての表を削除するには、次を実行します:
DBMS_AUTO_PARTITION.CONFIGURE('AUTO_PARTITION_TABLE', NULL);

AUTO_PARTITION_REPORT_RETENTIONは、自動パーティション化のログが削除されるまでデータベースに保持される日数を設定します。この値に指定された値を超える期間では、自動パーティション化レポートを生成できません。デフォルト値は90日です。

PARAMETER_VALUE

parameter_nameで指定した構成設定の値。NULLに設定すると、構成設定にそのデフォルトが割り当てられます。

ALLOW

次のいずれかの値を持つAUTO_PARTITION_SCHEMAまたはAUTO_PARTITION_TABLE構成設定にのみ適用できます:
  • TRUEは、指定したスキーマまたは表を包含リストに追加します。
  • FALSEは、指定したスキーマまたは表を除外リストから削除します。
  • NULLは、現在割り当てられているリストから、指定されたスキーマまたは表を削除します。
包含リストおよび除外リストの詳細は、AUTO_PARTITION_SCHEMAおよびAUTO_PARTITION_TABLE構成設定の説明を参照してください。

使用上のノート

  • 次のSQLを使用して、自動パーティション化構成の現在の設定を確認できます:

    SELECT * FROM DBA_AUTO_PARTITION_CONFIG;
  • 自動索引作成とは異なり、自動パーティション化はバックグラウンド・タスクとして定期的に実行されません。自動パーティションは、DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHODファンクションを使用して起動した場合にのみ実行されます。

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;

パラメータ

パラメータ 説明

SQLSET_OWNER, SQLSET_NAME

評価するワークロードを表すSQLチューニング・セットの名前。

TABLE_OWNER, TABLE_NAME

自動パーティション化の候補として検証する表の名前。

使用上のノート

  • たとえば、次のSQLを使用して、スキーマTESTのサンプル表LINEORDERの有効性をチェックできます:
    SELECT DBMS_AUTO_PARTITION.VALIDATE_CANDIDATE_TABLE
        ( TABLE_OWNER => 'TEST',
          TABLE_NAME  => 'LINEORDER')
    FROM DUAL;
    

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;

パラメータ

パラメータ 説明

SQLSET_OWNER, SQLSET_NAME

評価するワークロードを表すSQLチューニング・セットの名前。

TABLE_OWNER, TABLE_NAME

自動パーティション化の候補として検証する表の名前。

TIME_LIMIT

ファンクションが推奨事項を生成する表を選択する場合、TABLE_OWNERおよびTABLE_NAMENULLであり、パラメータは、パーティション化する新しい候補表の検索を停止するまでにファンクションが実行される期間を制限します。表の処理が開始されると、プロセスは終了しません。ファンクションがこのパラメータより長く実行される可能性があります。このパラメータがNULLの場合、時間制限はありません。デフォルトは1日です。

REPORT_TYPE

推奨パーティション・メソッドのレポートを生成するために使用されます。詳細は、REPORT_ACTIVITY関数を参照してください。

REPORT_SECTION

推奨パーティション・メソッドの永続レポートを生成するために使用されます。詳細は、REPORT_ACTIVITY関数を参照してください。

REPORT_LEVEL

推奨パーティション・メソッドのレポートを生成するために使用されます。詳細は、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;

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

パラメータ

パラメータ 説明

RECOMMENDATION_ID

RECOMMEND_PARTITION_METHODファンクションから返されたか、DBA_AUTO_PARTITION_RECOMMENDATIONSビューから返された推奨ID。

TABLE_OWNER, TABLE_NAME

単一の推奨事項IDに複数の表の推奨事項がある場合、このオプション・パラメータを使用すると、パーティション化される表を制御できます。
  • パラメータがNULLの場合、指定された推奨IDで推奨されたすべての表をパーティション化します。
  • 表名が指定されている場合は、指定された表のみをパーティション化します。
  • TABLE_OWNERまたはTABLE_NAMEのいずれかがNOT NULLの場合、両方ともNOT NULLである必要があります。

使用方法

AUTO_PARTITION_MODEに関係なく、RECOMMENDATION_IDに関連付けられている、受け入れられた推奨事項がない場合、またはRECOMMENDATION_IDに関連付けられている、すべての受け入れられた推奨事項がすでに適用されている場合、このプロシージャはORA-20000: recommendation_id was not foundを生成します。最初のケースは、AUTO_PARTITION_MODE = OFFを使用してRECOMMENDATION_IDが生成された場合に適用されます。2番目のケースは、RECOMMENDATION_IDAUTO_PARTITION_MODE = IMPLEMENTで生成された場合に適用されます。

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;

パラメータ

パラメータ 説明

ACTIVITY_START

自動パーティション化操作がレポートに使用する開始時間。値を指定しない場合、またはNULLを指定すると、実行された最後の自動パーティション化操作についてレポートが生成されます。

ACTIVITY_END

自動パーティション化操作がレポートに使用する終了時間。値を指定しない場合、またはNULLを指定すると、実行された最後の自動パーティション化操作についてレポートが生成されます。

TYPE

次のいずれかの値を持つレポートのフォーマット:
  • TEXT (デフォルト)
  • HTML
  • XML

SECTION

次のいずれかの値を持つレポートに含まれるセクション:
  • SUMMARY: ワークロード・サマリーのみをレポートに追加します。
  • ALL = レポートにすべてのセクションを含めます。(デフォルト)

level

次のいずれかの値を持つレポートに含める情報のレベル:
  • TYPICAL - 一般的な自動パーティション化情報をレポートに追加します(デフォルト)。
  • CHANGED: パフォーマンスが変更されたSQLのみをレポートに追加します。
  • IMPROVED: パフォーマンスが向上したSQLのみをレポートに追加します。
  • REGRESSED: パフォーマンスが低下したSQLのみをレポートに追加します。
  • UNCHANGED: パフォーマンスが変更されていないSQLのみをレポートに追加します。
  • ALL - すべての自動パーティション化情報をレポートに追加します。

使用上のノート

返品: 推奨事項の適用後にデータベースで実行されたワークロードのパフォーマンス分析レポート。このレポートは、推奨事項とともに永続的に格納されません。

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;

パラメータ

パラメータ 説明

TYPE

レポートの出力形式。詳細は、REPORT_ACTIVITY関数を参照してください。

SECTION

レポートに含まれるセクション。詳細は、REPORT_ACTIVITY関数を参照してください。

LEVEL

レポートに含まれる情報のレベル。詳細は、REPORT_ACTIVITY関数を参照してください。

使用上のノート

戻り値: 最新の推奨事項の適用後にデータベースで実行されたワークロードのパフォーマンス分析レポート。このレポートは、推奨事項とともに永続的に格納されません。