Diagnóstico de consultas

Con el diagnóstico de consultas, puede comprender mejor lo que Power Query está haciendo en el momento de la creación y en el momento de la actualización en Power BI Desktop. Aunque esta característica se ampliará en el futuro, incluida la adición de la capacidad de usarla durante las actualizaciones completas, en este momento puede usarla para comprender qué tipo de consultas emite, qué ralentizaciones podría experimentar durante la actualización de la creación y qué tipo de eventos en segundo plano están ocurriendo.

Para usar Diagnósticos de consultas, vaya a la pestaña Herramientas de la cinta de opciones del editor de Power Query.

De forma predeterminada, los diagnósticos de consulta pueden requerir derechos administrativos para ejecutarse (en función de la directiva de TI). Si no puede ejecutar diagnósticos de consulta, abra la página de opciones de Power BI y, en la pestaña Diagnósticos, seleccione Habilitar en Editor de Power Query (no requiere ejecutarse como administrador). Esta selección le impide realizar un seguimiento de los diagnósticos al realizar una actualización completa en Power BI en lugar del editor de Power Query, pero le permite seguir utilizándolo al obtener una vista previa, crear, etc.

Cada vez que inicie el diagnóstico, Power Query comience a realizar el seguimiento de las evaluaciones que cause. La evaluación que la mayoría de los usuarios piensan es cuando se presiona la actualización, o cuando se recuperan datos por primera vez, pero hay muchas acciones que pueden provocar evaluaciones, en función del conector. Por ejemplo, con el conector SQL, cuando se recupera una lista de valores que se van a filtrar, esto también iniciará una evaluación, pero no se asocia a una consulta de usuario y se representa en los diagnósticos. Otras consultas generadas por el sistema pueden incluir el navegador o la experiencia de obtención de datos.

Al presionar Diagnosticar paso, Power Query ejecuta una evaluación especial de solo el paso que está examinando. A continuación, muestra los diagnósticos de ese paso, sin mostrar los diagnósticos de otros pasos de la consulta. Esto puede facilitar mucho la obtención de una vista estrecha de un problema.

Es importante que si está grabando todos los seguimientos desde Start Diagnostics (Iniciar diagnóstico) que presione Detener diagnóstico. Detener los diagnósticos permite al motor recopilar los seguimientos registrados y analizarlos en la salida adecuada. Sin este paso, perderá los seguimientos.

Tipos de diagnóstico

Actualmente proporcionamos tres tipos de diagnósticos, uno de los cuales tiene dos niveles de detalle.

El primero de estos diagnósticos es el diagnóstico principal, que tiene una vista detallada y una vista resumida. La vista resumida está destinada a proporcionarle una visión inmediata de dónde se invierte el tiempo en la consulta. La vista detallada es mucho más profunda, línea por línea y es, en general, solo necesaria para un diagnóstico grave por parte de los usuarios avanzados.

En esta vista, algunas funcionalidades, como la columna Consulta de origen de datos, solo están disponibles actualmente en determinados conectores. Trabajaremos para ampliar la amplitud de esta cobertura en el futuro.

Las particiones de privacidad de datos proporcionan una mejor comprensión de las particiones lógicas que se usan para la privacidad de los datos.

Nota

Power Query puede realizar evaluaciones que es posible que no haya desencadenado directamente. Algunas de estas evaluaciones se realizan con el fin de recuperar metadatos para que podamos optimizar mejor nuestras consultas o proporcionar una mejor experiencia de usuario (como recuperar la lista de valores distintos dentro de una columna que se muestra en la experiencia Filtrar filas). Otros pueden estar relacionados con el modo en que un conector controla las evaluaciones paralelas. Al mismo tiempo, si ve en los diagnósticos de consulta consultas repetidas que no cree que tengan sentido, no dude en ponerse en contacto a través de canales de soporte técnico normales, sus comentarios son cómo mejoramos nuestro producto.

Vista resumida frente a detallada

El diagnóstico de consultas proporciona dos vistas: resumidas y detalladas. La vista resumida "contrae" varias operaciones relacionadas en una sola operación. En este proceso, se combinan los detalles recopilados por cada operación y se sumarán las duraciones exclusivas. No se pierde información como parte de este proceso.

La vista resumida proporciona información general sobre lo que se produjo durante una evaluación para una revisión sencilla de alto nivel. Si se desea un desglose adicional para una operación específica, el usuario puede ver el identificador de grupo y ver las operaciones correspondientes agrupadas en la vista de detalles.

Explicación de varias evaluaciones

Al actualizar en el editor de Power Query, hay mucho hecho en segundo plano para intentar ofrecerte una experiencia fluida del usuario. Por ejemplo, al actualizar la versión preliminar, el evaluador ejecutará el paso final de cada consulta determinada. Pero, en segundo plano, ejecuta secuencialmente n-1 pasos, n-2, pasos, etc., de modo que, si recorre paso a paso los pasos, ya está disponible.

Para proporcionar un mayor rendimiento, actualmente se produce algún almacenamiento en caché para que no tenga que volver a ejecutar todas las partes del plan de consulta final, ya que vuelve a través de los pasos. Aunque este almacenamiento en caché es útil para la creación normal, significa que no siempre obtendrá información de comparación de pasos correcta debido a evaluaciones posteriores que extraen datos almacenados en caché.

Esquema de diagnóstico

Identificador

Al analizar los resultados de una grabación, es importante filtrar la sesión de grabación por id. de modo que las columnas como El porcentaje de duración exclusiva tengan sentido.

Id es un identificador compuesto. Está formado por dos números: uno antes del punto y otro después. El primer número es el mismo para todas las evaluaciones resultantes de una sola acción de usuario. En otras palabras, si presiona la actualización dos veces, habrá dos números diferentes que conducen al punto, uno para cada actividad de usuario realizada. Esta numeración es secuencial para una grabación de diagnóstico determinada.

El segundo número representa una evaluación por parte del motor. Este número es secuencial durante la duración del proceso en el que se pone en cola la evaluación. Si ejecuta varias sesiones de grabación de diagnóstico, verá que este número continúa creciendo en las distintas sesiones.

Para resumir, si inicia la grabación, presione la evaluación una vez y detenga la grabación, tendrá algún número de identificadores en los diagnósticos. Pero como solo has tomado una acción, todos serán 1.1, 1.2, 1.3, etc.

La combinación de activityId y evaluationId, separada por el punto, proporciona un identificador único para una evaluación de una sola sesión de grabación.

Consultar

Nombre de la consulta en el panel izquierdo del editor de Power Query.

Paso

Nombre del paso en el panel derecho del editor de Power Query. Los elementos como las listas desplegables de filtros suelen asociarse con el paso en el que está filtrando, incluso si no actualiza el paso.

Category

Categoría de la operación.

Tipo de origen de datos

Esto indica a qué tipo de origen de datos tiene acceso, como SQL o Oracle.

Operación

Operación real que se realiza. Esta operación puede incluir trabajo del evaluador, abrir conexiones, enviar consultas al origen de datos y mucho más.

Hora de inicio

Hora a la que se inició la operación.

Hora de finalización

Hora a la que finalizó la operación.

Duración exclusiva (%)

La columna Duración exclusiva de un evento es la cantidad de tiempo que el evento estaba activo. Esto contrasta con el valor "duration" que resulta de restar los valores de la columna Hora de inicio de un evento y la columna Hora de finalización. Este valor de "duración" representa el tiempo total transcurrido entre el momento en que se inició un evento y cuándo finalizó, lo que puede incluir las horas en que el evento estaba en un estado suspendido o inactivo y otro evento estaba consumiendo recursos.

El porcentaje de duración exclusiva suma aproximadamente un 100 % dentro de una evaluación determinada, tal como se representa en la columna Id. Por ejemplo, si filtra por filas con id. 1.x, los porcentajes de duración exclusiva sumarían aproximadamente un 100 %. Este no es el caso si suma los valores de % de duración exclusiva de todas las filas de una tabla de diagnóstico determinada.

Duración exclusiva

Tiempo absoluto, en lugar de %, de duración exclusiva. La duración total (es decir, duración exclusiva + tiempo en que el evento estaba inactivo) de una evaluación se puede calcular de una de estas dos maneras:

• Busque la operación denominada "Evaluación". La diferencia entre la hora de finalización y la hora de inicio da como resultado la duración total de un evento.

• Resta la hora de inicio mínima de todas las operaciones en un evento de la hora de finalización máxima. Tenga en cuenta que, en los casos en los que la información recopilada para un evento no tiene en cuenta la duración total, se genera una operación denominada "Brechas de seguimiento" para tener en cuenta este intervalo de tiempo.

Recurso

El recurso al que accede para los datos. El formato exacto de este recurso depende del origen de datos.

Consulta de origen de datos

Power Query hace algo denominado plegado, que es el acto de ejecutar tantas partes de la consulta en el origen de datos back-end como sea posible. En el modo Direct Query (en Power Query), donde está habilitado, solo se ejecutarán las transformaciones que se ejecutarán. En el modo de importación, las transformaciones que no se pueden plegar se ejecutarán localmente.

La columna Consulta del origen de datos permite ver la consulta o solicitud HTTP/respuesta enviada en el origen de datos back-end. A medida que cree la consulta en el editor, se emitirán muchas consultas de origen de datos. Algunas de ellas son la consulta de origen de datos final real para representar la vista previa, pero otras pueden ser para la generación de perfiles de datos, listas desplegables de filtros, información sobre combinaciones, recuperación de metadatos para esquemas y cualquier otro número de otras consultas pequeñas.

En general, no debe preocuparse por el número de consultas de origen de datos emitidas a menos que haya razones específicas para preocuparse. En su lugar, debe centrarse en asegurarse de que se recupera el contenido adecuado. Esta columna también puede ayudar a determinar si la evaluación de Power Query se ha plegado por completo.

Información adicional

Hay mucha información recuperada por nuestros conectores. Gran parte de ella es desigual y no encaja bien en una jerarquía de columnas estándar. Esta información se coloca en un registro en la columna de información adicional. La información registrada desde conectores personalizados también aparece aquí.

Recuento de filas

Número de filas devueltas por una consulta de origen de datos. No está habilitado en todos los conectores.

Longitud del contenido

Longitud de contenido devuelta por solicitudes HTTP, como se define normalmente. Esto no está habilitado en todos los conectores y no será preciso para los conectores que recuperan solicitudes en fragmentos.

¿Es una consulta de usuario?

Valor booleano que indica si es una consulta que ha creado el usuario y está presente en el panel izquierdo, o si se generó mediante alguna otra acción de usuario. Otras acciones de usuario pueden incluir elementos como la selección de filtros o el uso del navegador en la experiencia de obtención de datos.

Ruta de acceso

Path representa la ruta relativa de la operación cuando se ve como parte de un árbol de intervalos para todas las operaciones dentro de una sola evaluación. En la parte superior (raíz) del árbol, hay una sola operación denominada Evaluación con la ruta de acceso "0". La hora de inicio de esta evaluación corresponde al inicio de esta evaluación en su conjunto. La hora de finalización de esta evaluación muestra cuándo finalizó toda la evaluación. Esta operación de nivel superior tiene una duración exclusiva de 0, ya que su único propósito es servir como raíz del árbol.

Rama de operaciones adicionales de la raíz. Por ejemplo, una operación podría tener "0/1/5" como ruta de acceso. Esta ruta de acceso se entendería como:

• 0: raíz del árbol
• 1: elemento primario de la operación actual
• 5: índice de la operación actual

La operación "0/1/5" puede tener un nodo secundario, en cuyo caso, la ruta de acceso tiene el formato "0/1/5/8", con 8 que representa el índice del elemento secundario.

Identificador de grupo

La combinación de dos (o más) operaciones no se producirá si conduce a una pérdida de detalles. La agrupación está diseñada para aproximarse a los "comandos" ejecutados durante la evaluación. En la vista detallada, varias operaciones comparten un identificador de grupo, correspondiente a los grupos agregados en la vista Resumen.

Al igual que con la mayoría de las columnas, el identificador de grupo solo es relevante dentro de una evaluación específica, como filtra la columna Id.

Esquema de particiones de privacidad de datos

Identificador

Igual que el identificador de los demás resultados de diagnóstico de consulta. La parte entera representa un identificador de actividad único, mientras que la parte fraccionarcional representa una única evaluación.

Clave de partición

Corresponde a la consulta o paso que se usa como partición de firewall.

Grupo de firewall

Categorización que explica por qué esta partición se debe evaluar por separado, incluidos los detalles sobre el nivel de privacidad de la partición.

Recursos a los que se accede

Lista de rutas de acceso de recursos para todos los recursos a los que accede esta partición y, por lo general, identifica de forma única un origen de datos.

Entradas de partición

Lista de claves de partición en las que depende la partición actual (esta lista se puede usar para compilar un grafo).

Expression

Expresión que se evalúa sobre la consulta o el paso de la partición. En varios casos, coincide con la consulta o el paso.

Hora de inicio

Hora en que se inició la evaluación para esta partición.

Hora de finalización

Hora en la que la evaluación finalizó para esta partición.

Duration

Valor derivado de la hora de finalización menos la hora de inicio.

Duración exclusiva

Si se supone que las particiones se ejecutan en un único subproceso, la duración exclusiva es la duración "real" que se puede atribuir a esta partición.

% de duración exclusiva

Duración exclusiva como porcentaje.

Diagnóstico

Esta columna solo aparece cuando también se captura el diagnóstico de consulta "Agregado" o "Detallado", lo que permite al usuario corresponder entre las dos salidas de diagnóstico.

Esquema de contadores de rendimiento

Al ejecutar contadores de rendimiento, cada medio segundo Power Query toma una instantánea del uso de recursos. Esta instantánea no es útil para las consultas muy rápidas, pero puede ser útil para las consultas que usan muchos más recursos.

% de tiempo de procesador

Porcentaje de tiempo invertido por los procesadores en la consulta. Este porcentaje puede alcanzarse por encima del 100 % debido a varios procesadores.

Tiempo total del procesador

Duración total del tiempo de procesador empleado en la consulta.

Bytes de datos de E/S por segundo

Velocidad de rendimiento de los datos recibidos del origen de datos, expresados en bytes por segundo.

Confirmación (bytes)

Cantidad de memoria virtual reservada por la evaluación.

Conjunto de trabajo (bytes)

Cantidad de memoria reservada por la evaluación.

Otras lecturas

Cómo registrar diagnósticos en varios casos de uso

Más información sobre la lectura y visualización de los seguimientos grabados

Cómo comprender qué operaciones de consulta se doblan mediante diagnósticos de consulta