Gestion du partitionnement automatique sur Autonomous Database

Activer et implémenter les recommandations

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

Activer les recommandations, mais ne pas les implémenter

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

Désactiver les nouvelles recommandations et leur implémentation

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

Gérer les schémas et les tables pour le partitionnement automatique

• En supposant que la liste d'inclusion et la liste d'exclusion sont vides, ajoutez le schéma HR et la table SH.SALES à la liste d'exclusion, ce qui empêche uniquement ces objets d'effectuer une analyse de partitionnement automatique.

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

• Après l'exécution de l'exemple précédent, utilisez la commande suivante pour enlever le schéma HR de la liste d'exclusion.

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

• Utilisez la commande suivante pour enlever tous les schémas de la liste d'exclusion.

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

• En supposant que les listes d'inclusion et d'exclusion sont vides, l'exemple suivant ajoute le schéma HR à la liste d'inclusion. Dès que la liste d'inclusion n'est plus vide, seuls les schémas de la liste d'inclusion sont pris en compte.

  Dans cet exemple, seul le schéma HR peut être partitionné automatiquement.

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

Gérer la période de conservation du rapport de partitionnement automatique

Définissez la période de conservation des rapports de partitionnement automatique sur 365 jours.

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

Générer un état, en texte brut, des opérations de partitionnement automatique pour une période spécifique

Cet exemple génère un rapport contenant des informations standard sur les opérations de partitionnement automatique des dernières 24 heures. Le rapport est généré en texte brut par défaut.

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

Générer un état, au format HTML, des opérations de partitionnement automatique pour MAI 2021

Cet exemple génère un état contenant des informations de base sur les opérations de partitionnement automatique pour le mois de MAI 2021. Le rapport est généré au format HTML et ne comprend qu'un récapitulatif des opérations de partitionnement automatique.

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

Générer un état, en texte brut, de la dernière opération de partitionnement automatique

Cet exemple génère un rapport contenant des informations standard sur la dernière opération de partitionnement automatique. Le rapport est généré en texte brut par défaut.

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

Pour plus d'informations, reportez-vous à Fonction REPORT_ACTIVITY.

Pour plus d'informations, reportez-vous à Fonction REPORT_LAST_ACTIVITY.

Générer une recommandation pour une seule table et appliquer manuellement la recommandation

1. Définissez le paramètre AUTO_PARTITION_MODE sur REPORT ONLY pour activer une recommandation de partitionnement automatique à effectuer et à vérifier. La recommandation n'est pas appliquée à la table.

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

2. Vérifiez que la table TPCH.LINEITEM est candidate au partitionnement automatique. Cette étape est facultative et recommandée lorsque vous ciblez de manière sélective des tables uniques.

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

   Si la table est un candidat valide, lorsque vous appelez le partitionnement automatique pour une analyse de recommandation, elle renvoie la valeur VALID. Sinon, les critères de violation sont affichés.

   Reportez-vous à Fonction VALIDATE_CANDIDATE_TABLE pour obtenir la liste des critères pour les tables de candidats admissibles.

3. Appelez l'API DBMS_AUTO_PARTITION afin de générer une recommandation pour la table 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;
   /

   L'analyse et la vérification des recommandations que vous effectuez avec DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD peuvent nécessiter beaucoup de ressources et une longue durée d'exécution. Vous devez effectuer cette étape sur une base de données qui n'est pas votre système de production principal. Oracle recommande d'accorder à l'opération de vérification des ressources suffisantes en choisissant le service HIGH.

4. Vérifiez la recommandation. La vue DBA_AUTO_PARTITION_RECOMMENDATIONS contient les informations sur la recommandation. Dans cet exemple, vérifiez la clé de partition et la méthode de partition recommandées.

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

   En outre, interrogez la même vue pour obtenir le rapport d'analyse des performances généré pour la charge globale après le partitionnement de la table conformément à la recommandation.

   SELECT REPORT
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

5. Une fois la recommandation validée manuellement, appliquez-la. Si vous appliquez la recommandation dans la base de données où l'analyse de recommandation a eu lieu, appliquez-la en exécutant la procédure APPLY_RECOMMENDATION.

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

   Si vous souhaitez appliquer la recommandation à une autre base de données, telle que votre environnement de production, extrayez le code LDD de modification. Exécutez ensuite le script LDD de modification extrait dans la base de données cible. L'interrogation permettant d'extraire le code LDD de modification est la suivante :

   SELECT MODIFY_TABLE_DDL
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

   Exemple de sortie du code LDD de modification :

   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. Vérifiez que la table a été partitionnée automatiquement, interrogez les vues du catalogue.

   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;
   

   Utilisez cette requête pour identifier le moment où le partitionnement automatique a été appliqué à une table donnée.

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

Pour plus d'informations, reportez-vous à la section CONFIGURE Procedure.

Pour plus d'informations, reportez-vous à VALIDATE_CANDIDATE_TABLE Function.

Pour plus d'informations, reportez-vous à RECOMMEND_PARTITION_METHOD Function.

Pour plus d'informations, reportez-vous à Procédure APPLY_RECOMMENDATION.

Générer une recommandation pour les tables admissibles et appliquer manuellement la recommandation

1. Définissez le paramètre AUTO_PARTITION_MODE sur REPORT ONLY pour activer une recommandation de partitionnement automatique à effectuer et à vérifier. La recommandation n'est pas appliquée aux tables existantes.

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

2. Appelez l'API DBMS_AUTO_PARTITION pour générer une table de recommandations.

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

   L'analyse et la vérification des recommandations consomment beaucoup de ressources et sont longues et peuvent prendre beaucoup de temps. Sur les bases de données secondaires hors production, Oracle recommande d'accorder à la vérification des ressources suffisantes en choisissant le service HIGH.

3. Interrogez la vue DBA_AUTO_PARTITION_RECOMMENDATIONS pour voir quelles tables ont été analysées.

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

4. Utilisez cette requête pour effectuer une analyse descendante dans le rapport pour une table spécifique analysée lors de l'exécution, à savoir la table TPCH.LINEITEM dans cet exemple.

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

5. Appliquez la recommandation en exécutant la procédure APPLY_RECOMMENDATION.

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

   Vous pouvez également appliquer des recommandations pour une table spécifique analysée, à savoir la table TPCH.LINEITEM dans cet exemple.

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

Pour plus d'informations, reportez-vous à la section CONFIGURE Procedure.

Pour plus d'informations, reportez-vous à RECOMMEND_PARTITION_METHOD Function.

Pour plus d'informations, reportez-vous à Procédure APPLY_RECOMMENDATION.

Générer et appliquer automatiquement des recommandations pour les tables éligibles

1. Définissez le paramètre AUTO_PARTITION_MODE sur REPORT ONLY pour activer une recommandation de partitionnement automatique à effectuer et à vérifier. La recommandation n'est pas appliquée aux tables existantes.

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

2. Appelez l'API DBMS_AUTO_PARTITION pour générer une table de recommandations.

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

   L'analyse et la vérification des recommandations consomment beaucoup de ressources et sont longues et peuvent prendre beaucoup de temps. Sur les bases de données secondaires hors production, Oracle recommande d'accorder à la vérification des ressources suffisantes en choisissant le service HIGH.

3. Interrogez la vue DBA_AUTO_PARTITION_RECOMMENDATIONS pour voir quelles tables ont été analysées.

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

4. Utilisez la fonction REPORT_LAST_ACTIVITY pour extraire le rapport sur les actions effectuées lors de la dernière exécution.

   SELECT DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY() FROM DUAL;
   

Pour plus d'informations, reportez-vous à la section CONFIGURE Procedure.

Pour plus d'informations, reportez-vous à RECOMMEND_PARTITION_METHOD Function.

Pour plus d'informations, reportez-vous à REPORT_LAST_ACTIVITY Function.