推奨事項を有効化および実装します

EXEC DBMS_AUTO_PARTITION.CONFIGURE('AUTO_PARTITION_MODE','IMPLEMENT');

推奨事項を有効にしますが、これらの推奨事項は実装しません

EXEC DBMS_AUTO_PARTITION.CONFIGURE('AUTO_PARTITION_MODE','REPORT ONLY');

新しい推奨事項とそれらの新しい推奨事項の実装を無効にします

EXEC DBMS_AUTO_PARTITION.CONFIGURE('AUTO_PARTITION_MODE','OFF');

自動パーティション化のためのスキーマおよび表の管理

• 包含リストと除外リストが空であると想定して、HRスキーマおよびSH.SALES表を除外リストに追加し、これらのオブジェクトのみが自動パーティション化分析されないようにします。

  BEGIN
      DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_SCHEMA', 
           PARAMETER_VALUE => 'HR',
           ALLOW           => FALSE);
  
      DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_TABLE', 
           PARAMETER_VALUE => 'SH.SALES',
           ALLOW           => FALSE);
  END;
  /

• 前の例の実行後、次を使用して除外リストからHRスキーマを削除します。

  BEGIN
      DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_SCHEMA', 
           PARAMETER_VALUE => 'HR',
           ALLOW           => NULL);
  END;
  /

• 次のコマンドを使用して、除外リストからすべてのスキーマを削除します。

  BEGIN
      DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_SCHEMA', 
           PARAMETER_VALUE => NULL,
           ALLOW           => TRUE);
  END;
  /

• 次の例では、包含リストおよび除外リストが空であると想定すると、HRスキーマが包含リストに追加されます。包含リストが空でなくなるとすぐに、包含リスト内のスキーマのみが考慮されます。

  この例では、HRスキーマのみが自動パーティション化の候補です。

  BEGIN
      DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_SCHEMA', 
           PARAMETER_VALUE => 'HR',
           ALLOW           => TRUE);
  END;
  /

自動パーティション化レポート保持期間の管理

自動パーティション・レポートの保持期間を365日に設定します。

BEGIN
    DBMS_AUTO_PARTITION.CONFIGURE(
         PARAMETER_NAME  => 'AUTO_PARTITION_REPORT_RETENTION', 
         PARAMETER_VALUE => '365');
END;
/

特定の期間における自動パーティション化操作のレポートをプレーン・テキスト形式で生成します

この例では、過去24時間の自動パーティション化操作に関する一般的な情報を含むレポートを生成します。デフォルトでは、このレポートはプレーン・テキスト形式で生成されます。

DECLARE
  Report clob := NULL
BEGIN
    Report := DBMS_AUTO_PARTITION.REPORT_ACTIVITY();
END;
/

2021年5月の自動パーティション化操作のレポートをHTML形式で生成します

この例では、2021年5月の自動パーティション化操作に関する基本情報を含むレポートを生成します。このレポートはHTML形式で生成され、自動パーティション化操作のサマリーのみを含んでいます。

DECLARE
  Report clob := NULL
BEGIN
    Report := DBMS_AUTO_PARTITION.REPORT_ACTIVITY(
                       ACTIVITY_START => TO_TIMESTAMP('2021-05-01', 'YYYY-MM-DD'),
                       ACTIVITY_END   => TO_TIMESTAMP('2021-06-01', 'YYYY-MM-DD'),
                       TYPE           => 'HTML',
                       SECTION        => 'SUMMARY',
                       LEVEL          => 'BASIC' );
END;
/

最後の自動パーティション化操作のレポートをプレーン・テキスト形式で生成します

この例では、最後の自動パーティション化操作に関する一般的な情報を含むレポートを生成します。デフォルトでは、このレポートはプレーン・テキスト形式で生成されます。

DECLARE
  Report clob := NULL
BEGIN
    Report := DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY();
END;
/

詳細は、REPORT_ACTIVITYファンクションを参照してください。

詳細は、REPORT_LAST_ACTIVITY関数を参照してください。

単一の表に対する推奨事項を生成し、推奨事項を手動で適用します

1. 自動パーティション化推奨事項の作成および検証を有効にするには、AUTO_PARTITION_MODEパラメータをREPORT ONLYに設定します。推奨事項は表に適用されません。

   BEGIN
       DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_MODE', 
           PARAMETER_VALUE => 'REPORT ONLY');
   END;
   /

2. TPCH.LINEITEM表が自動パーティション化の候補であることを確認します。このステップはオプションであり、1つの表を選択的にターゲットにすることをお薦めします。

   SELECT DBMS_AUTO_PARTITION.VALIDATE_CANDIDATE_TABLE(
              TABLE_OWNER => 'TPCH',
              TABLE_NAME  => 'LINEITEM')
   FROM DUAL;

   表が有効な候補の場合、推奨分析に対して自動パーティション化を起動すると、VALIDとして返されます。そうでない場合は、違反条件が表示されます。

   適格な候補表の基準のリストは、VALIDATE_CANDIDATE_TABLEファンクションを参照してください。

3. DBMS_AUTO_PARTITION APIを起動して、TPCH.LINEITEM表の推奨事項を生成します。

   -- DEFINE SQLPLUS BIND VARIABLE FOR RECOMMENDATION ID
   VARIABLE RECOMMENDATION_ID VARCHAR2(32);
   BEGIN
     :RECOMMENDATION_ID := DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD(
                                TABLE_OWNER => 'TPCH',
                                TABLE_NAME  => 'LINEITEM');
   END;
   /

   DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHODで実行する推奨事項の分析および検証は、大量のリソースを使用する長時間実行操作であり、かなりの時間がかかる場合があります。このステップは、プライマリ本番システムではないデータベースで実行する必要があります。Oracleでは、HIGHサービスを選択することによって検証操作に十分なリソースを提供することをお薦めします。

4. 推奨事項を確認します。ビューDBA_AUTO_PARTITION_RECOMMENDATIONSには、推奨事項に関する情報が含まれています。この例では、推奨されるパーティション・キーおよびパーティション・メソッドを確認します。

   SELECT PARTITION_METHOD, PARTITION_KEY
     FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
     WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

   さらに、同じビューを問い合せて、推奨事項に従って表がパーティション化された後、ワークロードに対して生成されたパフォーマンス分析レポートを取得します。

   SELECT REPORT
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

5. 推奨を手動で検証した後、推奨事項を適用します。推奨事項分析が実行されたデータベースで推奨事項を適用する場合は、APPLY_RECOMMENDATIONプロシージャを実行して推奨事項を適用します。

   BEGIN
       DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION(
            RECOMMENDATION_ID => :RECOMMENDATION_ID);
   END;
   /

   本番環境などの別のデータベースに推奨事項を適用する場合は、変更DDLを抽出します。次に、抽出した変更DDLをターゲット・データベースで実行します。変更DDLを抽出する問合せは次のとおりです:

   SELECT MODIFY_TABLE_DDL
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

   変更DDLの出力例:

   BEGIN
       -- DBMS_AUTO_PARTITION RECOMMENDATION_ID C3F7A59E085C2F25E05333885A0A55EA
       --   FOR TABLE "TPCH"."LINEITEM"
       --   GENERATED AT 06/04/2021 20:52:29
       DBMS_AUTO_PARTITION.BEGIN_APPLY(EXPECTED_NUMBER_OF_PARTITIONS => 10);
   
       EXECUTE IMMEDIATE
       'ALTER TABLE "TPCH"."LINEITEM"
       MODIFY PARTITION BYLIST(SYS_OP_INTERVAL_HIGH_BOUND
           ("L_SHIPDATE", INTERVAL ''10'' MONTH, TIMESTAMP ''1992-01-01 00:00:00''))
       AUTOMATIC /* SCORE=23533.11;  */
       (PARTITION P_NULL VALUES(NULL))
       AUTO ONLINE PARALLEL';
   
       DBMS_AUTO_PARTITION.END_APPLY;
   EXCEPTION WHEN OTHERS THEN
       DBMS_AUTO_PARTITION.END_APPLY;
       RAISE;
   END;
   

6. 表が自動的にパーティション化されていることを確認し、カタログ・ビューを問い合せます。

   SELECT T.AUTO, T.PARTITIONING_TYPE, C.COLUMN_NAME
       FROM DBA_PART_TABLES T, DBA_PART_KEY_COLUMNS C
       WHERE T.OWNER = 'TPCH' AND T.TABLE_NAME = 'LINEITEM'
           AND T.OWNER = C.OWNER AND T.TABLE_NAME = C.NAME;
   

   この問合せを使用して、特定の表に自動パーティション化がいつ適用されたかを識別します。

   SELECT APPLY_TIMESTAMP_START, APPLY_TIMESTAMP_END
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE TABLE_OWNER = 'TPCH' AND TABLE_NAME = 'LINEITEM';
   

詳細は、CONFIGUREプロシージャを参照してください。

詳細は、VALIDATE_CANDIDATE_TABLE関数を参照してください。

詳細は、RECOMMEND_PARTITION_METHODファンクションを参照してください。

詳細は、APPLY_RECOMMENDATIONプロシージャを参照してください。

適格な表に対する推奨事項を生成し、推奨事項を手動で適用します

1. 自動パーティション化推奨事項の作成および検証を有効にするには、AUTO_PARTITION_MODEパラメータをREPORT ONLYに設定します。推奨事項は既存の表には適用されません。

   BEGIN
       DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_MODE', 
           PARAMETER_VALUE => 'REPORT ONLY');
   END;
   /

2. DBMS_AUTO_PARTITION APIを起動して推奨事項表を生成します。

   -- DEFINE SQLPLUS BIND VARIABLE FOR RECOMMENDATION ID
   VARIABLE RECOMMENDATION_ID VARCHAR2(32);
   BEGIN
     :RECOMMENDATION_ID := DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD();
   END;
   /

   推奨事項の分析と検証は、リソース集中型の長時間実行操作であり、かなりの時間が必要になる場合があります。Oracleでは、本番以外のセカンダリ・データベースで、サービスHIGHを選択することで検証に十分なリソースを提供することをお薦めします。

3. DBA_AUTO_PARTITION_RECOMMENDATIONSビューを問い合せて、分析された表を確認します。

   SELECT TABLE_OWNER, TABLE_NAME, PARTITION_METHOD, PARTITION_KEY
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID
       ORDER BY RECOMMENDATION_SEQ;
   

4. この問合せを使用して、実行で分析された特定の表(この例ではTPCH.LINEITEM表)のレポートをドリルダウンします。

   SELECT REPORT
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID
           AND TABLE_OWNER = 'TPCH'
           AND TABLE_NAME  = 'LINEITEM';
   

5. APPLY_RECOMMENDATIONプロシージャを実行して、推奨事項を適用します。

   BEGIN
       DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION(
            RECOMMENDATION_ID => :RECOMMENDATION_ID);
   END;
   /

   または、分析された特定の表(この例ではTPCH.LINEITEM表)の推奨事項を適用します。

   BEGIN
       DBMS_AUTO_PARTITION.APPLY_RECOMMENDATION(
           RECOMMENDATION_ID => :RECOMMENDATION_ID,
           TABLE_OWNER       => 'TPCH',
           TABLE_NAME        => 'LINEITEM');
   END;
   /

詳細は、CONFIGUREプロシージャを参照してください。

詳細は、RECOMMEND_PARTITION_METHODファンクションを参照してください。

詳細は、APPLY_RECOMMENDATIONプロシージャを参照してください。

適格な表の推奨事項を生成して自動的に適用します

1. 自動パーティション化推奨事項の作成および検証を有効にするには、AUTO_PARTITION_MODEパラメータをREPORT ONLYに設定します。推奨事項は既存の表には適用されません。

   BEGIN
       DBMS_AUTO_PARTITION.CONFIGURE(
           PARAMETER_NAME  => 'AUTO_PARTITION_MODE', 
           PARAMETER_VALUE => 'IMPLEMENT');
   END;
   /

2. DBMS_AUTO_PARTITION APIを起動して推奨事項表を生成します。

   -- DEFINE SQLPLUS BIND VARIABLE FOR RECOMMENDATION ID
   VARIABLE RECOMMENDATION_ID VARCHAR2(32);
   BEGIN
     :RECOMMENDATION_ID := DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD();
   END;
   /

   推奨事項の分析と検証は、リソース集中型の長時間実行操作であり、かなりの時間が必要になる場合があります。Oracleでは、本番以外のセカンダリ・データベースで、サービスHIGHを選択することで検証に十分なリソースを提供することをお薦めします。

3. DBA_AUTO_PARTITION_RECOMMENDATIONSビューを問い合せて、分析された表を確認します。

   SELECT TABLE_OWNER, TABLE_NAME, PARTITION_METHOD, PARTITION_KEY
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID
       ORDER BY RECOMMENDATION_SEQ;
   

4. REPORT_LAST_ACTIVITYファンクションを使用して、最後に実行したアクションに関するレポートを取得します。

   SELECT DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY() FROM DUAL;
   

詳細は、CONFIGUREプロシージャを参照してください。

詳細は、RECOMMEND_PARTITION_METHODファンクションを参照してください。

詳細は、REPORT_LAST_ACTIVITYファンクションを参照してください。