Activación e implantación de recomendaciones

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

Activación de recomendaciones, pero no implantación de esas recomendaciones

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

Desactivar las nuevas recomendaciones y la implantación de estas

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 solo esos objetos del análisis de particiones automáticas.

  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 ya no esté 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 el período de retención del 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, como texto plano, de operaciones de partición automáticas para un período específico

Este ejemplo genera un informe que contiene información típica sobre las operaciones de partición automáticas de las últimas 24 horas. El informe se genera como texto sin formato por defecto.

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

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

Este ejemplo genera un informe que contiene información básica sobre las operaciones de partición automáticas para el mes de MAYO de 2021. El informe se genera en formato HTML e incluye solo un resumen de las operaciones de partición automáticas.

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, como texto plano, de la última operación de partición automática

Este ejemplo genera un informe que contiene información típica sobre la última operación de partición automática. El informe se genera como texto sin formato por defecto.

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

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

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

Generar una recomendación para una tabla única y aplicar manualmente la recomendación

1. Defina el parámetro AUTO_PARTITION_MODE en REPORT ONLY para permitir que se realice y verifique una recomendación de partición automática. 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 sea 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 invocar 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 Función VALIDATE_CANDIDATE_TABLE 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 pueden ser una operación que utiliza muchos recursos y que dura 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 tras la partición de 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 en la que 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 la DDL de modificación. A continuación, ejecute el DDL de modificación extraído en la base de datos de destino. La consulta para extraer la DDL de modificación es la siguiente:

   SELECT MODIFY_TABLE_DDL
       FROM DBA_AUTO_PARTITION_RECOMMENDATIONS
       WHERE RECOMMENDATION_ID = :RECOMMENDATION_ID;
   

   Salida de ejemplo de DDL de modificación:

   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 dividido automáticamente y consulte las vistas de 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 Procedimiento CONFIGURE para obtener información.

Consulte VALIDATE_CANDIDATE_TABLE Función para obtener más información.

Consulte Función RECOMMEND_PARTITION_METHOD para obtener información.

Consulte Procedimiento APPLY_RECOMMENDATION para obtener información.

Generación de una recomendación para tablas elegibles y aplicación manual de la recomendación

1. Defina el parámetro AUTO_PARTITION_MODE en REPORT ONLY para permitir que se realice y verifique una recomendación de partición automática. La recomendación no se aplica a 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 verificación de recomendaciones es una operación que requiere muchos recursos y que dura mucho tiempo y puede llevar mucho tiempo. En bases de datos secundarias, no de producción, Oracle recomienda proporcionar a la verificación recursos suficientes mediante la selección del servicio HIGH.

3. Consulte la vista DBA_AUTO_PARTITION_RECOMMENDATIONS para ver las tablas que 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 de una tabla específica que se haya analizado en la ejecución, la tabla TPCH.LINEITEM en este ejemplo.

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

5. Ejecute el procedimiento APPLY_RECOMMENDATION para aplicar la recomendación.

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

   También puede aplicar recomendaciones para una tabla específica que se analice, la tabla TPCH.LINEITEM en este ejemplo.

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

Consulte Procedimiento CONFIGURE para obtener información.

Consulte Función RECOMMEND_PARTITION_METHOD para obtener información.

Consulte Procedimiento APPLY_RECOMMENDATION para obtener información.

Generar y aplicar recomendaciones automáticamente para las tablas elegibles

1. Defina el parámetro AUTO_PARTITION_MODE en REPORT ONLY para permitir que se realice y verifique una recomendación de partición automática. La recomendación no se aplica a 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 verificación de recomendaciones es una operación que requiere muchos recursos y que dura mucho tiempo y puede llevar mucho tiempo. En bases de datos secundarias, no de producción, Oracle recomienda proporcionar a la verificación recursos suficientes mediante la selección del servicio HIGH.

3. Consulte la vista DBA_AUTO_PARTITION_RECOMMENDATIONS para ver las tablas que 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. La función REPORT_LAST_ACTIVITY se utiliza para recuperar el informe sobre las acciones realizadas durante la última ejecución.

   SELECT DBMS_AUTO_PARTITION.REPORT_LAST_ACTIVITY() FROM DUAL;
   

Consulte Procedimiento CONFIGURE para obtener información.

Consulte Función RECOMMEND_PARTITION_METHOD para obtener información.

Consulte Función REPORT_LAST_ACTIVITY para obtener información.