Guía de inicio rápido: Consulta de datos en Azure Data ExplorerQuickstart: Query data in Azure Data Explorer

El Explorador de datos de Azure es un servicio de exploración de datos altamente escalable y rápido para datos de telemetría y registro.Azure Data Explorer is a fast and highly scalable data exploration service for log and telemetry data. El Explorador de datos de Azure proporciona una aplicación web que le permite ejecutar y compartir consultas.Azure Data explorer provides a web application that enables you to run and share queries. La aplicación está disponible en Azure Portal como aplicación web independiente.The application is available in the Azure portal and as a stand-alone web application. En este artículo, trabaja en la versión independiente, que le permite conectarse a varios clústeres y compartir vínculos profundos a sus consultas.In this article, you work in the stand-alone version, which enables you to connect to multiple clusters and to share deep links to your queries.

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.If you don't have an Azure subscription, create a free Azure account before you begin.

Requisitos previosPrerequisites

Además de una suscripción de Azure, necesita un clúster y una base de datos de prueba para completar esta guía de inicio rápido.In addition to an Azure subscription, you need a test cluster and database to complete this quickstart.

Inicie sesión en la aplicación.Sign in to the application

Inicie sesión en la aplicación.Sign in to the application.

Agregar clústeresAdd clusters

Al abrir la aplicación por primera vez, no hay ninguna conexión.When you first open the application, there are no connections.

Agregar clúster

Debe agregar una conexión a al menos un clúster antes de poder empezar a ejecutar consultas.You must add a connection to at least one cluster before you can start running queries. En esta sección, agrega conexiones al clúster de ayuda del Explorador de datos de Azure que hemos configurado para facilitar el aprendizaje y al clúster de prueba que creó en una guía de inicio rápido anterior.In this section, you add connections to the Azure Data Explorer help cluster that we have set up to aid learning, and to the test cluster you created in a previous quickstart.

  1. En la parte superior izquierda de la aplicación, haga clic en Agregar clúster.In the upper-left of the application, select Add cluster.

  2. En el cuadro de diálogo Agregar clúster, escriba el identificador URI y, a continuación, seleccione Agregar.In the Add cluster dialog box, enter the URI, then select Add.

    Puede usar el identificador URI del clúster de ayuda, https://help.kusto.windows.net.You may use the help cluster URI, https://help.kusto.windows.net. Si tiene su propio clúster, proporcione su URI.If you have your own cluster, provide the URI of your cluster. Por ejemplo, https://mydataexplorercluster.westus.kusto.windows.net tal como se muestra en la siguiente imagen:For example, https://mydataexplorercluster.westus.kusto.windows.net as in the following image:

    Identificador URI de servidor en el portal

  3. En el panel izquierdo, debería ver ahora el clúster de ayuda.In the left pane, you should now see the help cluster. Expanda la base de datos de ejemplo para que pueda ver las tablas de ejemplo a las que tiene acceso.Expand the Samples database so that you can see the sample tables that you have access to.

    Bases de datos de ejemplo

    Usamos la tabla StormEvents posteriormente en esta guía de inicio rápido y en otros artículos del Explorador de datos de Azure.We use the StormEvents table later in this quickstart, and in other Azure Data Explorer articles.

Agregue ahora el clúster de prueba que creó.Now add the test cluster you created.

  1. Seleccione Agregar clúster.Select Add cluster.

  2. En el cuadro de diálogo Agregar clúster, escriba su dirección URL del clúster de prueba en el formulario https://<ClusterName>.<Region>.kusto.windows.net/ y, a continuación, seleccione Agregar.In the Add cluster dialog box, enter your test cluster URL in the form https://<ClusterName>.<Region>.kusto.windows.net/, then select Add.

    En el siguiente ejemplo, puede ver el clúster de ayuda y un nuevo clúster, docscluster.westus (la dirección URL completa es https://docscluster.westus.kusto.windows.net/).In the example below, you see the help cluster and a new cluster, docscluster.westus (full URL is https://docscluster.westus.kusto.windows.net/).

    Clúster de prueba

Ejecutar consultasRun queries

Ahora puede ejecutar consultas en cualquier clúster al que esté conectado (suponiendo que tenga datos en su clúster de prueba).You can now run queries against either cluster that you're connected to (assuming you have data in your test cluster). Nos centraremos en el clúster de ayuda.We'll focus on the help cluster.

  1. En el panel izquierdo, en el clúster de ayuda, seleccione la base de datos de ejemplo.In the left pane, under the help cluster, select the Samples database.

  2. Copie y pegue la siguiente consulta en la ventana de consulta.Copy and paste the following query into the query window. En la parte superior de la ventana, seleccione Examinar.At the top of the window, select Run.

    StormEvents
    | sort by StartTime desc
    | take 10
    

    Esta consulta devuelve los diez registros más recientes de la tabla StormEvents.This query returns the ten newest records in the StormEvents table. El lado izquierdo del resultado debe tener una apariencia similar a la de la tabla siguiente.The left side of the result should look like the following table.

    Resultados de la consulta

    En la siguiente imagen se muestra el estado en el que debería encontrarse la aplicación ahora, con clústeres agregados y una consulta con resultados.The following image shows the state that the application should now be in, with clusters added, and a query with results.

    Aplicación completa

  3. Copie y pegue la siguiente consulta en la ventana de consulta, después de la primera consulta.Copy and paste the following query into the query window, below the first query. Como puede ver, no se formatea en líneas independientes como la primera consulta.Notice how it's not formatted on separate lines like the first query.

    StormEvents | sort by StartTime desc | project StartTime, EndTime, State, EventType, DamageProperty, EpisodeNarrative | take 10
    
  4. Haga clic en el nueva consulta de la ventana, que selecciona la consulta.Click the new query in the window, which selects the query. Presione Mayús+Alt+F para formatear la consulta de modo que tenga el siguiente aspecto.Press Shift+Alt+F to format the query, so it looks like the following.

    Consulta con formato

  5. Presione Mayús+Entrar, que es un acceso directo para ejecutar una consulta.Press Shift+Enter, which is a shortcut to run a query.

    Esta consulta devuelve los mismos registros que la primera, pero incluye solo las columnas especificadas en la instrucción project.This query returns the same records as the first one, but includes only the columns specified in the project statement. El resultado debe tener un aspecto similar a la siguiente tabla.The result should look like the following table.

    Resultados de la consulta

  6. En la parte superior de la ventana de consulta, seleccione Recuperar.At the top of the query window, select Recall.

    Ahora, en la ventana de consulta se muestran los resultados de la primera consulta sin necesidad de volver a ejecutar la consulta.The query window now shows the result set from the first query without having to rerun the query. A menudo, durante el análisis, ejecuta varias consultas, y Recuperar le permite volver a visitar los resultados de consultas anteriores.Often during analysis, you run multiple queries, and Recall enables you to revisit the results of previous queries.

  7. Vamos a ejecutar una consulta más para ver un tipo de resultado distinto.Let's run one more query to see a different type of output.

    StormEvents
    | summarize event_count=count(), mid = avg(BeginLat) by State
    | sort by mid
    | where event_count > 1800
    | project State, event_count
    | render columnchart
    

    El resultado debe tener un aspecto similar al siguiente gráfico.The result should look like the following chart.

    Gráfico de columnas

Trabajar con la cuadrícula de tablaWork with the table grid

Ahora que ha visto cómo funcionan las consultas básicas, vamos a fijarnos en cómo podemos usar la cuadrícula de tabla para personalizar los resultados y realizar más análisis.Now you've seen how basic queries work, let's look at how you can use the table grid to customize results and do further analysis.

  1. Vuelva a ejecutar la primera consulta.Rerun the first query. Coloque el mouse sobre la columna Estado, seleccione el menú y seleccione Agrupar por estado.Mouse-over the State column, select the menu, and select Group by State.

    Agrupar por estado

  2. En la cuadrícula, expanda California para ver los registros correspondientes a ese estado.In the grid, expand California to see records for that state.

    Resultados de la consulta

    Este tipo de agrupación puede resultar de utilidad al realizar análisis exploratorios.This type of grouping can be helpful when doing exploratory analysis.

  3. Coloque el mouse sobre la columna Grupo y, a continuación, seleccione Restablecer columnas.Mouse-over the Group column, then select Reset columns.

    Restablecer columnas

    Esto devuelve la cuadrícula a su estado original.This returns the grid to its original state.

  4. Ejecute la siguiente consulta.Run the following query.

    StormEvents
    | sort by StartTime desc
    | where DamageProperty > 5000
    | project StartTime, State, EventType, DamageProperty, Source
    | take 10
    
  5. En el lado derecho de la cuadrícula, seleccione Columnas para ver el panel de herramientas.On the right side of the grid, select Columns to see the tool panel.

    Panel de herramientas

    Este panel funciona de forma similar a la lista de campos de tabla dinámica en Excel, lo que le permite realizar más análisis en la propia cuadrícula.This panel functions similarly to the pivot table field list in Excel, enabling you to do more analysis in the grid itself.

  6. Seleccione Modo de pivote y, después, arrastre las columnas de este modo: Estado a Grupos de filas, DamageProperty a Valores y EventType a Etiquetas de columna.Select Pivot Mode, then drag columns as follows: State to Row groups; DamageProperty to Values; and EventType to Column labels.

    Modo de pivote

    El resultado debe tener un aspecto similar a la siguiente tabla dinámica.The result should look like the following pivot table.

    Tabla dinámica

    Como puede ver, Vermont y Alabama tienen dos eventos pertenecientes a la misma categoría, mientras que Texas tiene dos eventos pertenecientes a categorías distintas.Notice how Vermont and Alabama each have two events under the same category, while Texas has two events under different categories. Las tablas dinámicas le permiten detectar de forma rápida cosas como esta; son una gran herramienta para realizar análisis rápidos.Pivot tables enable you to quickly spot things like this; they are a great tool for quick analysis.

Compartir consultasShare queries

Muchas veces, desea consultar las consultas que crea.Many times, you want to share the queries you create. Puede proporcionar un vínculo profundo de modo que otros usuarios con acceso al clúster puedan ejecutar las consultas.You can provide a deep link so that other users with access to the cluster can run the queries.

  1. En la ventana de consulta, seleccione la primera consulta en la que copió.In the query window, select the first query you copied in.

  2. En la parte superior de la ventana de consulta, seleccione Compartir.At the top of the query window, select Share.

  3. Seleccione Link, query to clipboard (Vincular consulta al Portapapeles).Select Link, query to clipboard.

  4. Copie el vínculo y la consulta en un archivo de texto.Copy the link and query to a text file.

  5. Pegue el vínculo en una nueva ventana del explorador.Paste the link into a new browser window. El resultado debe tener una apariencia similar a la siguiente tras ejecutarse la consulta.The result should look like the following after the query runs.

    Consulta compartida

Envío de comentariosProvide feedback

El Explorador de datos se encuentra actualmente en versión preliminar y recibimos con los brazos abiertos los comentarios sobre su experiencia.Data Explorer is currently in preview, and we welcome feedback on your experience. Puede hacerlo ahora o esperar hasta que haya pasado más tiempo con él.You can do this now or wait until you've spent more time with it.

  1. En la parte superior derecha de la aplicación, seleccione el icono de comentarios:In the upper-right of the application, select the feedback icon: Icono de comentarios..

  2. Escriba sus comentarios y, a continuación, seleccione Enviar.Enter your feedback, then select Submit.

Limpieza de recursosClean up resources

No creó ningún recurso en esta guía de inicio rápido, pero si desea quitar uno o ambos clústeres de la aplicación, haga clic con el botón derecho en el clúster y seleccione Quitar conexión.You didn't create any resources in this quickstart, but if you'd like to remove one or both clusters from the application, right-click the cluster and select Remove connection.

Pasos siguientesNext steps

Write queries for Azure Data Explorer (Escritura de consultas del Explorador de datos de Azure)Write queries for Azure Data Explorer