Gérer le partitionnement automatique sur la base de données Autonomous AI Database

Activer et mettre en œuvre les recommandations

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

Activer les recommandations, mais ne pas les mettre en oeuvre

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

Désactiver les nouvelles recommandations et leur mise en œuvre

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

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

• Si 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, empêchant 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 les éléments suivants pour supprimer 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 supprimer 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;
  /

• Si 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 est candidat au partitionnement automatique.

  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 rapport en texte brut sur les opérations de partitionnement automatique pour une période spécifique

Cet exemple génère un rapport contenant des informations types sur les opérations de partitionnement automatique au cours des 24 dernières 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 rapport, au format HTML, sur les opérations de partitionnement automatique pour MAI 2021

Cet exemple génère un rapport 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 sommaire 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 rapport, en texte brut, de la dernière opération de partitionnement automatique

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

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

Pour plus d'informations, voir Fonction REPORT_ACTIVITY.

Pour plus d'informations, voir Fonction REPORT_LAST_ACTIVITY.

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

1. Réglez le paramètre AUTO_PARTITION_MODE à REPORT ONLY pour activer une recommandation de partitionnement automatique à établir 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 sélectivement 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 retourne VALID. Sinon, les critères de violation sont affichés.

   Voir Fonction VALIDATE_CANDIDATE_TABLE pour une liste de critères pour les tables de candidats admissibles.

3. Appelez l'API DBMS_AUTO_PARTITION pour 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 être une opération longue et gourmande en ressources et peut prendre beaucoup de temps. Vous devez effectuer cette étape sur une base de données qui n'est pas votre système de production principal. Oracle recommande d'affecter à l'opération de vérification des ressources suffisantes en choisissant le service HAUT.

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 de performance 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. Après validation manuelle de la recommandation, appliquez-la. Si vous appliquez la recommandation dans la base de données où l'analyse des recommandations 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 l'énoncé LDD de modification. Exécutez ensuite le code LDD de modification extrait dans la base de données cible. L'interrogation pour extraire l'énoncé LDD de modification est la suivante :

   SELECT MODIFY_TABLE_DDL
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

   Exemple de sortie 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 interrogation 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, voir Procédure de configuration.

Pour plus d'informations, voir Fonction VALIDATE_CANDIDATE_TABLE.

Pour plus d'informations, voir Fonction RECOMMEND_PARTITION_METHOD.

Pour plus d'informations, voir ProcédureAPPLY_RECOMMENDATION.

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

1. Réglez le paramètre AUTO_PARTITION_MODE à REPORT ONLY pour activer une recommandation de partitionnement automatique à établir 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 recommandation.

   -- 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 sont une opération longue et gourmande en ressources et peuvent prendre beaucoup de temps. Sur les bases de données secondaires hors production, Oracle recommande d'affecter suffisamment de ressources à la vérification en choisissant le service ÉLEVÉ.

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 interrogation pour forer dans le rapport pour une table spécifique qui a été analysée lors de l'exécution, 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 qui a été analysée, 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, voir Procédure de configuration.

Pour plus d'informations, voir Fonction RECOMMEND_PARTITION_METHOD.

Pour plus d'informations, voir ProcédureAPPLY_RECOMMENDATION.

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

1. Réglez le paramètre AUTO_PARTITION_MODE à REPORT ONLY pour activer une recommandation de partitionnement automatique à établir 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 recommandation.

   -- 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 sont une opération longue et gourmande en ressources et peuvent prendre beaucoup de temps. Sur les bases de données secondaires hors production, Oracle recommande d'affecter suffisamment de ressources à la vérification en choisissant le service ÉLEVÉ.

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, voir Procédure de configuration.

Pour plus d'informations, voir Fonction RECOMMEND_PARTITION_METHOD.

Pour plus d'informations, voir Fonction REPORT_LAST_ACTIVITY.