Gestión de la partición automática en Autonomous Database

Activar e implantar recomendaciones

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

Activar recomendaciones, pero no implantar dichas recomendaciones

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

Desactivar nuevas recomendaciones y aplicar esas nuevas recomendaciones

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

Gestionar esquemas y tablas para la partición automática

• Suponiendo que la lista de inclusión y la lista de exclusión están vacías, agregue el esquema HR y la tabla SH.SALES a la lista de exclusión, evitando que solo esos objetos realicen un análisis de partición automático.

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

• Después de ejecutar el ejemplo anterior, utilice lo siguiente para eliminar el esquema HR de la lista de exclusión.

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

• Utilice el siguiente comando para eliminar todos los esquemas de la lista de exclusión.

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

• Si las listas de inclusión y exclusión están vacías, en el siguiente ejemplo se agrega el esquema HR a la lista de inclusión. Tan pronto como la lista de inclusión deje de estar vacía, solo se tendrán en cuenta los esquemas de la lista de inclusión.

  Con este ejemplo, solo el esquema HR es un candidato para la partición automática.

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

Gestionar período de retención de informe de partición automática

Defina el período de retención para los informes de partición automática en 365 días.

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

Generar un informe, en formato de texto sin formato, de operaciones de partición automática para un período específico

En este ejemplo, se genera un informe que contiene información típica sobre las operaciones de partición automática de las últimas 24 horas. El informe se genera en formato de texto sin formato de forma predeterminada.

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

Generar un informe, en formato HTML, de las operaciones de partición automática para MAYO 2021

Este ejemplo genera un informe que contiene información básica sobre las operaciones de partición automática para el mes de mayo de 2021. El informe se genera en formato HTML y sólo incluye un resumen de las operaciones de partición automática.

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

Generar un informe, en formato de texto sin formato, de la última operación de partición automática

En este ejemplo, se genera un informe que contiene información típica sobre la última operación de partición automática. El informe se genera en formato de texto sin formato de forma predeterminada.

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

Consulte REPORT_ACTIVITY Function para obtener más información.

Consulte REPORT_LAST_ACTIVITY Function para obtener más información.

Generar una recomendación para una tabla única y aplicarla manualmente

1. Defina el parámetro AUTO_PARTITION_MODE en REPORT ONLY para activar una recomendación de partición automática que se va a realizar y verificar. La recomendación no se aplica a la tabla.

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

2. Valide que la tabla TPCH.LINEITEM es candidata para la partición automática. Este paso es opcional y se recomienda cuando se dirige de forma selectiva a tablas únicas.

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

   Si la tabla es un candidato válido, al llamar a la partición automática para un análisis de recomendación, se devuelve como VALID. De lo contrario, se muestran los criterios de infracción.

   Consulte VALIDATE_CANDIDATE_TABLE Function para obtener una lista de criterios para las tablas de candidatos elegibles.

3. Llame a la API DBMS_AUTO_PARTITION para generar una recomendación para la tabla 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;
   /

   El análisis y la verificación de recomendaciones que realice con DBMS_AUTO_PARTITION.RECOMMEND_PARTITION_METHOD puede ser una operación que consume muchos recursos y que dura mucho tiempo, y puede llevar mucho tiempo. Debe realizar este paso en una base de datos que no sea su sistema de producción principal. Oracle recomienda proporcionar a la operación de verificación recursos suficientes seleccionando el servicio HIGH.

4. Compruebe la recomendación. La vista DBA_AUTO_PARTITION_RECOMMENDATIONS contiene la información sobre la recomendación. En este ejemplo, compruebe la clave de partición y el método de partición recomendados.

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

   Además, consulte la misma vista para obtener el informe de análisis de rendimiento generado para la carga de trabajo después de particionar la tabla según la recomendación.

   SELECT REPORT
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

5. Después de la validación manual de la recomendación, aplique la recomendación. Si está aplicando la recomendación en la base de datos donde se ha realizado el análisis de recomendación, aplique la recomendación ejecutando el procedimiento APPLY_RECOMMENDATION.

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

   Si desea aplicar la recomendación a una base de datos diferente, como su entorno de producción, extraiga el DDL de modificación. A continuación, ejecute el DDL de modificación extraído en la base de datos destino. La consulta para extraer el DDL de modificación es la siguiente:

   SELECT MODIFY_TABLE_DDL
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

   Ejemplo de salida de modificación de 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. Verifique que la tabla se ha particionado automáticamente y consulte las vistas del catálogo.

   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;
   

   Utilice esta consulta para identificar cuándo se ha aplicado la partición automática a una tabla determinada.

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

Consulte CONFIGURE Procedure para obtener información.

Consulte VALIDATE_CANDIDATE_TABLE Function para obtener información.

Consulte RECOMMEND_PARTITION_METHOD Function para obtener información.

Consulte APPLY_RECOMMENDATION Procedure para obtener información.

Generar una recomendación para las tablas elegibles y aplicarla manualmente

1. Defina el parámetro AUTO_PARTITION_MODE en REPORT ONLY para activar una recomendación de partición automática que se va a realizar y verificar. La recomendación no se aplica a las tablas existentes.

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

2. Llame a la API DBMS_AUTO_PARTITION para generar una tabla de recomendaciones.

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

   El análisis y la verificación de las recomendaciones son una operación que requiere muchos recursos y que dura mucho tiempo y puede llevar mucho tiempo. En bases de datos secundarias que no son de producción, Oracle recomienda proporcionar a la verificación recursos suficientes eligiendo el servicio ALTO.

3. Consulte la vista DBA_AUTO_PARTITION_RECOMMENDATIONS para ver qué tablas se han analizado.

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

4. Utilice esta consulta para aumentar detalle en el informe para una tabla específica que se ha analizado en la ejecución, la tabla TPCH.LINEITEM de este ejemplo.

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

5. Aplique la recomendación ejecutando el procedimiento APPLY_RECOMMENDATION.

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

   Como alternativa, aplique recomendaciones para una tabla específica que se haya analizado, la tabla TPCH.LINEITEM de este ejemplo.

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

Consulte CONFIGURE Procedure para obtener información.

Consulte RECOMMEND_PARTITION_METHOD Function para obtener información.

Consulte APPLY_RECOMMENDATION Procedure para obtener información.

Generar y aplicar automáticamente recomendaciones para tablas elegibles

1. Defina el parámetro AUTO_PARTITION_MODE en REPORT ONLY para activar una recomendación de partición automática que se va a realizar y verificar. La recomendación no se aplica a las tablas existentes.

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

2. Llame a la API DBMS_AUTO_PARTITION para generar una tabla de recomendaciones.

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

   El análisis y la verificación de las recomendaciones son una operación que requiere muchos recursos y que dura mucho tiempo y puede llevar mucho tiempo. En bases de datos secundarias que no son de producción, Oracle recomienda proporcionar a la verificación recursos suficientes eligiendo el servicio ALTO.

3. Consulte la vista DBA_AUTO_PARTITION_RECOMMENDATIONS para ver qué tablas se han analizado.

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

4. Utilice la función REPORT_LAST_ACTIVITY para recuperar el informe sobre las acciones realizadas durante la última ejecución.

   SELECT DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY() FROM DUAL;
   

Consulte CONFIGURE Procedure para obtener información.

Consulte RECOMMEND_PARTITION_METHOD Function para obtener información.

Consulte REPORT_LAST_ACTIVITY Function para obtener información.