DBMS_AUTO_PARTITIONパッケージ

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

CONFIGUREプロシージャ

この手順では、Autonomous AI Databaseでの自動パーティション化の設定を構成します。

構文

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

パラメータ

DBMS_AUTO_PARTITION.CONFIGURE('AUTO_PARTITION_TABLE', NULL);

使用上のノート

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

SELECT * FROM DBA_AUTO_PARTITION_CONFIG;

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

VALIDATE_CANDIDATE_TABLEファンクション

この関数は、指定された表がAutonomous AI Databaseでの自動パーティション化の有効な候補かどうかをチェックします。

有効な候補者

有効な候補になるには、次のテストに合格する必要があります。

• 表は、AUTO_PARTITION_SCHEMAおよびAUTO_PARTITION_TABLE構成パラメータで指定された包含テストおよび除外テストに合格します。

• 表が存在し、最新の統計があります。

• 表は64 GB以上です。

• 表には、表をスキャンしたSQLチューニング・セットに5つ以上の問合せがあります。

• 表にLONGデータ型列が含まれていません。

• 表は手動でパーティション化されていません。

• 表は、外部表、内部/外部ハイブリッド表、一時表、索引編成表またはクラスタ表ではありません。

• 表にドメイン索引またはビットマップ結合索引がありません。

• 表は、事前キューイング、マテリアライズド・ビューまたはフラッシュバック・アーカイブ・ストレージ表ではありません。

• 表にはネストした表や、その他の特定のオブジェクト機能はありません。

戻り値:

• 表が自律型パーティション化の有効な候補である場合はVALID

• 表が自律型パーティション化の有効な候補ではなく、<reason>が表が有効な候補ではない理由を説明する文字列である場合は、INVALID: <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を使用して、サンプル表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 AI 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;

パラメータ

使用上のノート

• 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プロシージャ

この手順では、自律型AIデータベース内の指定された推奨事項を適用します。

構文

DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION
    ( RECOMMENDATION_ID  IN RAW,
      TABLE_OWNER        IN VARCHAR2   DEFAULT NULL,
      TABLE_NAME         IN VARCHAR2   DEFAULT NULL);

パラメータ

使用上のノート

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

REPORT_ACTIVITYファンクション

このファンクションは、特定の期間中に自律型AIデータベースで実行された自動パーティション化操作のレポートを返します。

構文

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;

パラメータ

使用上のノート

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

REPORT_LAST_ACTIVITYファンクション

このファンクションは、Autonomous AI Databaseで実行された最新の自動パーティション化操作のレポートを返します。

構文

DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY
    ( TYPE    IN VARCHAR2 DEFAULT 'TEXT',
      SECTION IN VARCHAR2 DEFAULT 'ALL',
      LEVEL   IN VARCHAR2 DEFAULT 'TYPICAL')
RETURN CLOB;

パラメータ

使用上のノート

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