Realización de un rastreo SQL en Autonomous Database

Utilizar el rastreo SQL para ayudarle a identificar el origen de una carga de trabajo excesiva de la base de datos, como una sentencia SQL de carga alta en la aplicación.

Configuración del rastreo SQL en Autonomous Database

Muestra los pasos para configurar el rastreo SQL en Autonomous Database.

Nota

Si activa el rastreo SQL, el rendimiento de la aplicación para la sesión se puede degradar mientras la recopilación de rastreo está activada. Este impacto negativo en el rendimiento se espera debido a la sobrecarga que supone recopilar y guardar datos de rastreo.

Para configurar la base de datos para el rastreo SQL, haga lo siguiente:

  1. Cree un cubo para almacenar los archivos de rastreo en Cloud Object Storage.

    Para guardar los archivos de rastreo SQL, el cubo puede estar en cualquier almacén de objetos en la nube que soporte Autonomous Database.

    Por ejemplo, para crear un cubo en Oracle Cloud Infrastructure Object Storage, realice lo siguiente:

    1. Abra la consola de Oracle Cloud Infrastructure.
    2. Seleccione Almacenamiento en el menú.
    3. En Storage, seleccione Object Storage and Archive Storage.
    4. Haga clic en Crear cubo.
    5. En la página Crear cubo, introduzca el nombre de cubo y haga clic en Crear.

    Si utiliza Oracle Cloud Infrastructure Object Storage, tenga en cuenta que los archivos de rastreo SQL solo están soportados con cubos creados en el nivel de almacenamiento estándar, asegúrese de seleccionar Estándar como nivel de almacenamiento al crear el cubo. Consulte Visión general de Object Storage para obtener información sobre el nivel de Object Storage estándar.

  2. Cree una credencial para su cuenta de Cloud Object Storage mediante DBMS_CLOUD.CREATE_CREDENTIAL.

    Por ejemplo:

    BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'DEF_CRED_NAME',
        username => 'adb_user@example.com', 
        password => 'password'
    );
    END;
    /

    Para Oracle Cloud Infrastructure, username es el nombre de usuario de Oracle Cloud Infrastructure. password es el token de autenticación de Oracle Cloud Infrastructure. Consulte Trabajar con tokens de autenticación para obtener más información.

    Consulte el procedimiento CREATE_CREDENTIAL para obtener más información sobre los parámetros y sus valores, según el almacenamiento de objetos en la nube.

  3. Defina parámetros de inicialización para especificar la URL de Cloud Object Storage para un cubo para los archivos de rastreo SQL y para especificar las credenciales para acceder a Cloud Object Storage.
    1. Defina la propiedad de base de datos DEFAULT_LOGGING_BUCKET para especificar el cubo de registro en Cloud Object Storage.

      Por ejemplo, si crea el cubo con Oracle Cloud Infrastructure Object Storage:

      SET DEFINE OFF;
      ALTER DATABASE PROPERTY SET 
         DEFAULT_LOGGING_BUCKET = 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucket_name/o/';

      Donde namespace-string es el espacio de nombres de Oracle Cloud Infrastructure Object Storage y bucket_name es el nombre del cubo que ha creado anteriormente. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

      Consulte Regiones y dominios de disponibilidad para obtener una lista de regiones.

      El almacén de objetos en la nube que utiliza para los archivos de rastreo SQL puede ser cualquier almacén de objetos en la nube que soporte Autonomous Database.

    2. Defina la propiedad DEFAULT_CREDENTIAL de la base de datos en la credencial creada en el paso 2.

      Se necesita incluir el nombre del esquema con la credencial. En este ejemplo, el esquema es "ADMIN".

      Por ejemplo:

      ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME';

Activación del rastreo SQL en Autonomous Database

Muestra los pasos para activar el rastreo SQL para la sesión de base de datos.

Nota

Si activa el rastreo SQL, el rendimiento de la aplicación para la sesión se puede degradar mientras la recopilación de rastreo está activada. Este impacto negativo en el rendimiento se espera debido a la sobrecarga que supone recopilar y guardar datos de rastreo.

Antes de activar el rastreo SQL, debe configurar la base de datos para guardar los archivos de rastreo SQL. Consulte Configuración del rastreo SQL en Autonomous Database para obtener más información.

Para activar el rastreo SQL, realice lo siguiente:

  1. (Opcional) Defina un identificador de cliente para la aplicación. Este paso es opcional, pero se recomienda. El rastreo SQL utiliza el identificador de cliente como componente del nombre del archivo de rastreo cuando el archivo de rastreo se escribe en el almacén de objetos en la nube.

    Por ejemplo:

    BEGIN
      DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
    END;
    /
  2. (Opcional) Defina un nombre de módulo para la aplicación. Este paso es opcional, pero se recomienda. El rastreo SQL utiliza el nombre del módulo como componente del nombre del archivo de rastreo cuando este se escribe en el almacén de objetos en la nube.

    Por ejemplo:

    BEGIN
      DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
    END;
    /
  3. Active la utilidad SQL Trace.
    ALTER SESSION SET SQL_TRACE = TRUE;
  4. Ejecute la carga de trabajo.

    Este paso implica ejecutar toda la aplicación o partes específicas de la aplicación. Mientras ejecuta la carga de trabajo en la sesión de base de datos, se recopilan los datos de rastreo SQL.

  5. Desactive el rastreo SQL.

    Al desactivar el rastreo SQL, los datos recopilados para la sesión se escriben en una tabla de la sesión y en un archivo de rastreo del cubo que configure al configurar el rastreo SQL. Consulte Desactivación del rastreo SQL en Autonomous Database para obtener más información.

Desactivación del rastreo SQL en Autonomous Database

Muestra los pasos para desactivar el rastreo SQL en Autonomous Database.

Para desactivar el rastreo SQL, realice lo siguiente:

  1. Desactive la utilidad SQL Trace.
    ALTER SESSION SET SQL_TRACE = FALSE;
  2. (Opcional) según sea necesario para su entorno, puede que desee restablecer la propiedad de base de datos DEFAULT_LOGGING_BUCKET para borrar el valor del cubo de registro en Cloud Object Storage.

    Por ejemplo:

    ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

Al desactivar el rastreo SQL, los datos de rastreo recopilados mientras la sesión se ejecuta con el rastreo activado se copian en una tabla y se envían a un archivo de rastreo en el almacén de objetos en la nube. Tiene dos opciones para ver los datos de rastreo:

Ver archivo de rastreo guardado en el almacén de objetos en la nube en Autonomous Database

Describe la nomenclatura de archivos de salida para los archivos de rastreo SQL y muestra los comandos para utilizar TKPROF para organizar y ver los datos del archivo de rastreo.

Los datos del archivo de rastreo SQL se utilizan para analizar el rendimiento de la aplicación en Autonomous Database. Al desactivar el rastreo SQL en la sesión de base de datos, los datos se escriben en el cubo del almacén de objetos en la nube configurado con DEFAULT_LOGGING_BUCKET.

La utilidad SQL Trace escribe los datos de rastreo recopilados en la sesión en el almacén de objetos en la nube con el siguiente formato:

default_logging_bucket/sqltrace/clientID/moduleName/sqltrace_numID1_numID2.trc

Los componentes del nombre de archivo son:

  • default_logging_bucket: es el valor de la propiedad de base de datos DEFAULT_LOGGING_BUCKET. Consulte Configuración del rastreo SQL en Autonomous Database para obtener más información.

  • clientID: es el identificador de cliente. Consulte Activación del rastreo SQL en Autonomous Database para obtener más información.

  • moduleName: es el nombre del módulo. Consulte Activación del rastreo SQL en Autonomous Database para obtener más información.

  • numID1_numID2: son dos identificadores que proporciona la utilidad de rastreo SQL. Los valores numéricos numID1 y numID2 distinguen de forma única cada nombre de archivo de rastreo de otras sesiones mediante el rastreo y la creación de archivos de rastreo en el mismo cubo de Cloud Object Storage.

    Cuando el servicio de base de datos soporta el paralelismo y una sesión ejecuta una consulta paralela, la utilidad de rastreo SQL puede producir varios archivos de rastreo con diferentes valores numID1 y numID2.

Nota

Cuando el rastreo SQL se activa y desactiva varias veces en la misma sesión, cada iteración de rastreo genera un archivo de rastreo independiente en el almacén de objetos en la nube. Para evitar sobrescribir rastreos anteriores que se generaron en la sesión, los archivos generados posteriormente siguen la misma convención de nomenclatura y agregan un sufijo numérico al nombre del archivo de rastreo. Este sufijo numérico comienza con el número 1 y se incrementa en 1 para cada iteración de rastreo a partir de entonces.

Por ejemplo, a continuación se muestra un ejemplo de nombre de archivo de rastreo generado al definir el identificador de cliente en "sql_test" y el nombre de módulo en "modname":

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

Puede ejecutar TKPROF para convertir el archivo de rastreo en un archivo de salida legible.

  1. Copie el archivo de rastreo del almacén de objetos en el sistema local.
  2. Navegue hasta el directorio en el que se guarda el archivo de rastreo.
  3. Ejecute la utilidad TKPROF desde el indicador del sistema operativo con la siguiente sintaxis:
    tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
        [aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
        [explain=user/password] [record=filename4] [width=n]
    

    Los archivos de entrada y salida son los únicos argumentos necesarios.

  4. Para ver la ayuda en pantalla, llame a TKPROF sin argumentos.

Consulte "Herramientas para Rastreo Completo de Aplicaciones" en la Guía de Ajustes SQL de Oracle Database para obtener información sobre el uso de la utilidad TKPROF.

Visualización de datos de rastreo en la vista SESSION_CLOUD_TRACE en Autonomous Database

Al activar el rastreo SQL, la misma información de rastreo que se guarda en el archivo de rastreo en el almacén de objetos en la nube está disponible en la vista SESSION_CLOUD_TRACE de la sesión en la que se ha activado el rastreo.

Mientras sigue en la sesión de base de datos, puede ver los datos de rastreo SQL en la vista SESSION_CLOUD_TRACE. La vista SESSION_CLOUD_TRACE incluye dos columnas: ROW_NUMBER y TRACE:

DESC SESSION_CLOUD_TRACE

Name       Null? Type
---------- ----- ------------------------------
ROW_NUMBER       NUMBER
TRACE            VARCHAR2(32767)

ROW_NUMBER especifica el orden de los datos de rastreo encontrados en la columna TRACE. Cada línea de salida de rastreo escrita en un archivo de rastreo se convierte en una fila de la tabla y está disponible en la columna TRACE.

Después de desactivar el rastreo SQL para la sesión, puede ejecutar consultas en la vista SESSION_CLOUD_TRACE.

Por ejemplo:

SELECT trace FROM SESSION_CLOUD_TRACE ORDER BY row_number;

Los datos de SESSION_CLOUD_TRACE se mantienen durante la sesión. Después de cerrar la sesión o cerrarla, los datos ya no están disponibles.

Si SQL Trace está activado y desactivado varias veces en la misma sesión, SESSION_CLOUD_TRACE muestra los datos de rastreo de todas las iteraciones de forma acumulativa. Por lo tanto, la reactivación del rastreo en una sesión después de desactivar previamente el rastreo no elimina los datos de rastreo producidos por la iteración anterior.