Glosario

Los términos del informe y del trace 10046, agrupados por la inicial del término en la edición en portugués. Los nombres en negrita son los que muestra la consola; los campos del trace están en Líneas del trace 10046 que lee WaitScope.

A

hallazgo

Elemento del Diagnóstico: un patrón que suele explicar el perfil, como la espera por la aplicación, la lectura lenta o el hard parse. Cada hallazgo tiene una gravedad, un título y, cuando corresponde, la parte del tiempo total involucrada. El código del hallazgo, como TEMPO_NA_APLICACAO, no aparece en pantalla: la API lo devuelve en el campo code. Es una pista para el análisis, no una conclusión. Vea Diagnóstico.

acción

El valor de ACTION NAME, que la aplicación informa a la base de datos para decir qué está haciendo. El informe lista las acciones del trace en Acción, en la tarjeta Sesión y entorno, sin máscara.

B

bind (variable de bind)

Marcador en el texto del SQL, como :1 o :b1, cuyo valor va separado de la sentencia. Con bind, el mismo cursor sirve para valores diferentes. El trace graba los valores en el bloque BINDS, en los niveles 4 y 12 del 10046; WaitScope ignora ese bloque, y los valores nunca entran en el informe.

C

c

Tiempo de CPU de una llamada, en el campo c= de las líneas PARSE, EXEC, FETCH y CLOSE. En el perfil, se convierte en las filas CPU: PARSE dbcalls, CPU: EXEC dbcalls y así sucesivamente, sin la CPU de las llamadas recursivas.

llamada

Pedido de la sesión a la base de datos, en una línea del trace con su tipo y sus números: PARSE, EXEC, FETCH, CLOSE y, menos frecuentes, UNMAP, SORT UNMAP y las llamadas de LOB. El resumen las cuenta todas, a cualquier profundidad, en Llamadas a la base de datos.

llamada de nivel 0

Llamada con dep=0, hecha directamente por la aplicación. Las recursivas ocurren dentro de ella. El intervalo entre el final de una llamada de nivel 0 y el inicio de la siguiente es tiempo entre llamadas: espera por la aplicación o tiempo no contabilizado entre llamadas.

clase de espera

El grupo del evento de espera en Oracle (wait_class), como User I/O, System I/O, Commit, Concurrency, Network e Idle. El perfil por clase suma los componentes de cada una, con CPU, No contabilizado y No clasificado aparte, y la suma también da el tiempo total. El evento que WaitScope no sabe clasificar queda en No clasificado. Vea clases de espera y SQL recursivo.

CLOSE

Llamada que cierra el cursor. Trae CPU, duración, profundidad y el tipo de cierre, y suele ser rápida.

colección

Varios archivos de trace analizados como uno solo. Es el caso de la aplicación que cambia el tracefile_identifier y reparte la misma sesión en varios archivos. WaitScope pone los tramos en el orden del tim; con más de una sesión, el tiempo total es la suma del tiempo de cada una. Vea analizar varios traces juntos.

sentencia

Un SQL o bloque PL/SQL distinto del trace, por el sql_id o, en un trace sin él, por el hash value. Sentencias distintas, en el resumen, cuenta cuántas son, una a una, aunque las listas junten en una forma las que solo difieren en los literales. Cuando el recuento es estimado, aparece como alrededor de N.

componente

Cada fila del perfil del tiempo de respuesta: la CPU de un tipo de llamada, un evento de espera o una de las dos filas de tiempo no contabilizado. Sumados, los componentes dan el tiempo total.

contribución

Cuánto pesa una sentencia en el tiempo total: la duración de sus llamadas de nivel 0 sumada a las esperas entre llamadas en su cursor. La lista Sentencias SQL por contribución se ordena por ella. La diferencia entre el tiempo total y la suma de las contribuciones aparece como tiempo no atribuido a ninguna sentencia. Compare con inclusivo.

cr

Lecturas consistentes (consistent reads): bloques leídos en la versión que vale para el inicio de la consulta. Campo cr= de las llamadas y de las líneas STAT, columna Consistente (CR). Sumado al cu, da el LIO.

cu

Lecturas en modo actual (current): bloques leídos en su versión actual, en general para modificar datos. Campo cu=, columna Actual (CU). Sumado al cr, da el LIO.

cursor

El área que Oracle usa para ejecutar una sentencia en la sesión. Cada línea del trace trae el número del cursor (#1), que une PARSE, EXEC, FETCH, WAIT y STAT al texto del PARSING IN CURSOR. El mismo número puede reutilizarse más tarde para otra sentencia.

costo

La estimación del optimizador para una operación del plan (cost= en la línea STAT), en una unidad interna de Oracle. No es tiempo. Columna Costo en el plan.

D

deadlock

Dos o más sesiones esperándose entre sí. Oracle deshace el bloqueo mutuo con el error ORA-00060 en una de ellas y graba el bloque DEADLOCK DETECTED en el trace de esa sesión. WaitScope lee el bloque en el trace solo de deadlock o dentro de un 10046. Vea Deadlocks.

dep

La profundidad de la llamada (dep=): 0 para lo que llamó la aplicación, 1 para el SQL que ejecutó esa sentencia, 2 para el SQL disparado por el de nivel 1, y así sucesivamente. Columna Prof. en la lista de sentencias.

E

e

La duración de la llamada (elapsed), en el campo e=. Incluye la CPU, las esperas dentro de ella y las llamadas recursivas. Lo que sobra después de quitar todo eso es tiempo no contabilizado dentro de la llamada.

ela

La duración de una espera, en el campo ela= de la línea WAIT.

espera

Tiempo en que la sesión se detuvo a la espera de algo: disco, red, bloqueo, la aplicación. Cada espera es una línea WAIT con el nombre del evento (nam=) y la duración (ela=). Solo aparece con el nivel 8 o 12 del 10046.

esperas entre llamadas

Las esperas fuera de cualquier llamada, entre una llamada de nivel 0 y la siguiente, como SQL*Net message from client. El resumen muestra su tiempo en Esperas, como “N s entre llamadas”.

estimado

Las filas que el optimizador previó para una operación del plan (card= en la línea STAT). El detalle de la sentencia las compara con las filas reales por ejecución y marca en rojo el error de 10 veces o más. Vea estimación de filas errónea.

EXEC

Llamada que ejecuta el cursor: ejecuta el DML, abre la consulta o ejecuta el bloque PL/SQL. Columna Exec en la lista de sentencias.

F

FETCH

Llamada que trae filas de una consulta. Cada FETCH trae un lote de filas (r=); muchas llamadas con pocas filas cada una indican un lote pequeño. Vea muchos FETCH con pocas filas.

forma

El texto de una sentencia con los literales reemplazados por marcadores: :s en lugar del texto entre comillas y :n en lugar del número. Las sentencias que solo difieren en los literales tienen la misma forma y, en las listas del informe, se convierten en una sola fila, con los totales sumados y la etiqueta N variantes. Vea Textos compartibles y literales en lugar de bind.

H

hard parse

PARSE que tiene que armar el cursor desde cero, con el análisis del texto y la elección del plan por el optimizador, porque no encontró uno igual listo en la memoria compartida. Aparece como mis=1 en la línea PARSE. Es frecuente en SQL con literales en lugar de bind. Vea muchos hard parses.

I

Idle

La clase de espera de cuando la sesión aguarda trabajo. En un trace de sesión, es casi siempre SQL*Net message from client: el tiempo de la aplicación, de la red y del usuario.

inclusivo

La suma de la duración de todas las llamadas de una sentencia, a cualquier profundidad, con el SQL recursivo que disparan. Compare con contribución.

L

latencia

La distribución de la duración de las esperas y de las llamadas en rangos de potencias de 10. Muestra si el tiempo viene de muchas ocurrencias rápidas o de pocas lentas. Vea Latencia.

línea STAT

Línea del trace con una operación del plan de ejecución: la operación, el objeto, las filas producidas, las lecturas, el tiempo y la estimación del optimizador. Juntas, las líneas STAT de un cursor forman el plan que muestra el informe. Vea la línea STAT.

LIO

Lecturas lógicas: la suma de cr y cu, en bloques. Columna LIO en la lista de sentencias.

literal

Valor escrito directamente en el texto del SQL, como 'EXEMPLO' o 42, en lugar de un bind. Cada valor diferente se convierte en un texto diferente para la base de datos. La máscara de literales oculta esos valores en el informe. Vea Literales ocultos en el SQL.

M

mis

Los fallos en la library cache (misses) de una llamada, en el campo mis=. En la línea PARSE, mis=1 es hard parse. Columna Misses en Tipos de llamada.

módulo

El valor de MODULE NAME, que la aplicación informa a la base de datos. El informe lista los módulos del trace en Módulo, en la tarjeta Sesión y entorno, sin máscara.

N

nivel del 10046

Cuánto graba el evento 10046: el nivel 1 graba las llamadas, el 4 agrega los valores de bind, el 8 agrega las esperas y el 12 agrega binds y esperas. El perfil necesita las esperas: use el nivel 8. Vea niveles del evento 10046.

O

obj#

El número del objeto (object_id) en la línea WAIT. Une la espera a la tabla o al índice leído y es la base de Objetos con más tiempo de espera. El nombre viene de las líneas STAT del trace, cuando existen.

ocurrencias

Cuántas veces ocurrió un componente: el número de esperas de un evento o de llamadas de un tipo.

og

El objetivo del optimizador, en el campo og= de las llamadas. WaitScope no usa este campo.

P

p

Los bloques leídos del disco por una llamada, en el campo p=. Columna Disco (PIO) en Tipos de llamada y PIO en la lista de sentencias.

PARSE

Llamada que analiza el texto del SQL y prepara el cursor. Puede ser hard parse (mis=1), cuando arma el cursor desde cero, o reutilizar un cursor listo. Un PARSE en cada ejecución indica un cursor abierto y cerrado cada vez. Vea un PARSE en cada ejecución.

PARSING IN CURSOR

La línea que trae el texto del SQL de un cursor, hasta END OF STMT, con la longitud, la profundidad, el tipo de sentencia y el sql_id.

perfil del tiempo de respuesta

La tabla que divide el tiempo total en componentes: CPU por tipo de llamada, cada evento de espera y el tiempo no contabilizado. La suma de las filas es exactamente el tiempo total. Vea Perfil y el perfil del informe de ejemplo.

perfil exclusivo

El perfil de una sentencia sin el SQL recursivo que dispara. Es lo que usa Sentencias principales por componente y por clase.

período

La fecha y la hora del inicio y del final del trace, calculadas a partir del tim con las líneas *** que traen fecha y hora. Aparece en Período, en el resumen.

PIO

Lecturas físicas: bloques leídos del disco, en el campo p= de las llamadas y pr= de las líneas STAT.

plan de ejecución

Las operaciones que Oracle usó para ejecutar la sentencia, armadas a partir de las líneas STAT del trace. Muestra, para cada operación, las filas, las lecturas y el tiempo, y destaca las que más pesan. Vea Plan de ejecución.

plh

El plan hash value, en el campo plh= de las llamadas: identifica el plan usado. En el detalle de la sentencia, aparece junto al título de cada Plan de ejecución.

pr

Los bloques leídos del disco por una operación del plan, en el campo pr= de la línea STAT, sumados a los de las operaciones hijas.

pw

Los bloques grabados en el disco por una operación del plan, en el campo pw= de la línea STAT, como en la ordenación que no cabe en memoria. Sumados a los de las operaciones hijas, como el pr.

R

R (tiempo de respuesta)

El tiempo total de la sesión en el trace, desde el inicio de la primera llamada o espera hasta el último tim. Es el Tiempo total del resumen y el 100% del perfil. En una colección con varias sesiones, es la suma del tiempo de cada una.

r

Las filas procesadas por la llamada, en el campo r=: las devueltas en el FETCH o las modificadas en el EXEC de un DML. Columna Filas.

recursivo (SQL recursivo)

SQL ejecutado dentro de otra llamada, con dep mayor que 0: el SQL de una función o procedimiento PL/SQL, de un trigger o las consultas de Oracle al diccionario. En el detalle de la sentencia, aparece en SQL recursivo ejecutado por esta sentencia. Vea la tarjeta del SQL recursivo en el informe de ejemplo.

relectura

La lectura del disco de un bloque que la sesión ya había leído antes en el mismo trace. La relectura frecuente indica una caché pequeña o el acceso repetido al mismo dato. Vea Lecturas.

S

sesión

La identificación de la sesión rastreada, de la línea *** SESSION ID: el SID y el serial#, seguidos del pid del proceso en el servidor, en Sesión, en la tarjeta Sesión y entorno.

gravedad

El peso de un hallazgo en el diagnóstico: alta, media, baja o información. El diagnóstico lista los hallazgos de la gravedad más alta a la más baja.

sql_id

El identificador de 13 caracteres que Oracle da al texto de una sentencia. Viene en el campo sqlid= del PARSING IN CURSOR y sirve para encontrar la misma sentencia en la base de datos, por ejemplo en V$SQL. Columna SQL ID. En un trace antiguo, sin él, WaitScope usa el hash value (hv=).

SQL*Net message from client

La espera de la sesión por el próximo pedido de la aplicación. Queda entre las llamadas y mide el tiempo de la aplicación, de la red y del usuario: el ajuste del SQL no reduce ese tiempo. Vea sesión esperando a la aplicación.

STAT

Vea línea STAT.

T

tiempo no contabilizado dentro de las llamadas

La parte de la duración (e) de cada llamada que no es CPU (c), ni espera registrada dentro de ella, ni llamada recursiva. Suele ser cola de CPU, paginación de memoria o código sin instrumentación. El valor negativo viene de la granularidad de la medición de CPU. Vea tiempo no contabilizado dentro de las llamadas.

tiempo no contabilizado entre llamadas

El tiempo entre el final de una llamada de nivel 0 y el inicio de la siguiente sin ninguna espera registrada: la diferencia entre el tiempo total y la suma de las llamadas de nivel 0 y de las esperas entre ellas. Crece cuando el trace se activó o desactivó a la mitad, cuando el proceso quedó fuera de la CPU o cuando falta un archivo de la colección. Vea tiempo no contabilizado entre llamadas.

tiempo propio

En el plan, el tiempo de una operación sin el de las operaciones hijas. El LIO propio sigue la misma cuenta.

tiempo total

Vea R (tiempo de respuesta).

textos compartibles

La sección del informe con las formas, las sentencias que solo difieren en los literales. Con bind, un único cursor serviría para todas las variantes de una forma, y los hard parses caerían. Vea Textos compartibles.

tim

El instante en que terminó una llamada o una espera, en microsegundos (en centésimas de segundo en los traces de Oracle 7 y 8). El inicio es el tim menos el e, o menos el ela. WaitScope usa el tim para ordenar todo, medir el tiempo total y juntar los archivos de una colección.

trace 10046

El SQL trace de Oracle, activado por el evento 10046 o por DBMS_MONITOR: un archivo de texto con cada llamada, espera y plan de la sesión. Es lo que lee WaitScope. Vea el contenido del trace.

U

unidad de tiempo

La unidad de los tiempos del trace: microsegundos desde Oracle 9i, centésimas de segundo en los traces de Oracle 7 y 8. El resumen muestra cuál en Unidad de tiempo. Vea unidad de tiempo en el trace.

V

variante

Cada sentencia que pertenece a una forma, con sus propios literales. La etiqueta N variantes cuenta cuántas tiene la forma, o muestra alrededor de N cuando el recuento es estimado. En el detalle de la forma, la tabla Variantes que más gastaron trae el SQL ID y los literales de cada una; con la Privacidad de los informes activada, los literales salen con *** y el SQL ID no aparece. Vea Variantes que más gastaron.

W

WAIT

Vea espera.

X

XCTEND

La línea del final de una transacción: rlbk=0 es commit y rlbk=1 es rollback. El resumen cuenta los dos, como “N commits · N rollbacks”.