機械翻訳について

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で実行された最新の自動パーティション化操作のレポートを返します。

親トピック: Autonomous Database提供されているパッケージ参照

CONFIGUREプロシージャ

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

構文

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

パラメータ

パラメータ 説明

PARAMETER_NAME

更新する自動パーティション化構成パラメータの名前。 次の値のうち1つを取ることができます。

  • 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関数を使用して起動した場合のみです。

親トピック: 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;

パラメータ

パラメータ 説明

SQLSET_OWNER, SQLSET_NAME

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

TABLE_OWNER, TABLE_NAME

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

使用上のノート

  • たとえば、スキーマTESTでサンプル表LINEORDERの有効性を確認し、次のSQLを使用します:
    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;

パラメータ

パラメータ 説明

SQLSET_OWNER, SQLSET_NAME

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

TABLE_OWNER, TABLE_NAME

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

TIME_LIMIT

推奨事項を生成する表(TABLE_OWNERおよびTABLE_NAMEはNULL)を選択した場合、パラメータは、パーティション化する新しい候補表の検索を停止する前に、ファンクションの実行時間を制限します。 表の処理を開始すると、プロセスは終了しません。 関数がこのパラメータより長く実行される可能性があります。 このパラメータが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関数を使用して起動した場合のみです。

戻り値

この関数は、次のように使用できる推奨IDを返します: DBMS_AUTO_PARTITION.APPLY_RECOMMENDATIONを使用して推奨事項を適用

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

パラメータ

パラメータ 説明

RECOMMENDATION_ID

RECOMMEND_PARTITION_METHODファンクションから返されるか、DBA_AUTO_PARTITION_RECOMMENDATIONSビューから問合せされた推奨事項ID。

TABLE_OWNER, TABLE_NAME
1つの推奨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が発生します。 最初のケースは、RECOMMENDATION_IDがAUTO_PARTITION_MODE = OFFで生成された場合に適用されます。 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;

パラメータ

パラメータ 説明

ACTIVITY_START

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

ACTIVITY_END

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

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

SECTION
次のいずれかの値があるレポートに含めるセクション:
  • SUMMARY - ワークロード要約のみをレポートに含める
  • ALL =レポートのすべてのセクションを含めます(デフォルト)

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

使用上のノート

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

親トピック: 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;

パラメータ

パラメータ 説明

TYPE

レポートの出力形式。詳細は、「REPORT_ACTIVITYファンクション」を参照してください。

SECTION

レポートに含まれるセクションについては、「REPORT_ACTIVITYファンクション」を参照してください。

LEVEL

レポートに含まれる情報のレベルについては、「REPORT_ACTIVITYファンクション」を参照してください。

使用上のノート

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

親トピック: DBMS_AUTO_PARTITIONパッケージ