Hello Kusto: Creación de la primera aplicación

En este artículo aprenderá a:

• Creación de la primera aplicación cliente
• Uso de la autenticación interactiva
• Ejecute una consulta básica que imprima Hello Kusto.

Requisitos previos

Configure el entorno de desarrollo para usar la biblioteca cliente de Kusto.

Creación de una aplicación

En el IDE o editor de texto que prefiera, cree un proyecto o un archivo denominado hello kusto con la convención adecuada para su idioma preferido. Después agregue el siguiente código:

1. Agregue las clases de generador de cadenas y cliente de Kusto.

   C#

   using Kusto.Data;
   using Kusto.Data.Net.Client;
   

   Python

   from azure.kusto.data import KustoClient, KustoConnectionStringBuilder
   

   Typescript

   import { Client as KustoClient, KustoConnectionStringBuilder } from "azure-kusto-data";
   import { InteractiveBrowserCredentialInBrowserOptions } from "@azure/identity";
   

   Nota

   Para Node.js aplicaciones, use InteractiveBrowserCredentialNodeOptions en lugar de InteractiveBrowserCredentialInBrowserOptions.

   Java

   import com.microsoft.azure.kusto.data.Client;
   import com.microsoft.azure.kusto.data.ClientFactory;
   import com.microsoft.azure.kusto.data.KustoOperationResult;
   import com.microsoft.azure.kusto.data.KustoResultSetTable;
   import com.microsoft.azure.kusto.data.auth.ConnectionStringBuilder;
   

2. Defina una función vacía denominada main y llámala.

   C#

   namespace HelloKusto {
     class HelloKusto {
       static void Main(string[] args) {
       }
     }
   }
   

   Python

   def main():
   
   if __name__ == "__main__":
     main()
   

   Typescript

   async function main()
   {
   }
   
   main();
   

   Java

   public class HelloKusto 
   {
     public static void main(String[] args) throws Exception {
       try {
       }
     }
   }
   

3. Cree un objeto de generador de cadena de conexión que defina el URI del clúster y establezca el modo de autenticación en interactivo. Para más información sobre el URI del clúster, consulte Cadenas de conexión de Kusto.

   C#

   var clusterUri = "https://help.kusto.windows.net/";
   var kcsb = new KustoConnectionStringBuilder(clusterUri).WithAadUserPromptAuthentication();
   

   Python

   cluster_uri = "https://help.kusto.windows.net"
   kcsb = KustoConnectionStringBuilder.with_interactive_login(cluster_uri)
   

   Typescript

   y proceden del registro de aplicaciones de Microsoft Entra que creó en la sección Requisitos previos de Configuración del entorno de desarrollo.redirectUriclientId

   const clusterUri = "https://help.kusto.windows.net";
   const authOptions = {
     clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
     redirectUri: "http://localhost:5173",
   } as InteractiveBrowserCredentialInBrowserOptions;
   const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
   

   Nota:

   Para Node.js aplicaciones, use InteractiveBrowserCredentialNodeOptions en lugar de InteractiveBrowserCredentialInBrowserOptions.

   Java

   String clusterUri = "https://help.kusto.windows.net/";
   ConnectionStringBuilder kcsb = ConnectionStringBuilder.createWithUserPrompt(clusterUri);
   

   Nota:

   Para la autenticación interactiva, necesita una cuenta microsoft o una identidad de usuario Microsoft Entra. No se necesita una suscripción a Azure.

   En C#, es posible que el proceso de autenticación interactiva no solicite al usuario si:

   • El usuario ya está autenticado en el dispositivo
   • Hay una autenticación de interfaz de usuario web de Kusto.Explorer o Azure Date Explorer existente en el dispositivo.

4. Cree un objeto de cliente que use el objeto de generador de cadena de conexión para conectarse al clúster.

   Nota:

   Se recomienda encarecidamente almacenar en caché y reutilizar la instancia de cliente de Kusto. Con frecuencia, volver a crear clientes de Kusto puede provocar una degradación del rendimiento en la aplicación y una mayor carga en el clúster.

   C#

   using (var kustoClient = KustoClientFactory.CreateCslQueryProvider(kcsb)) {
   }
   

   Python

   with KustoClient(kcsb) as kusto_client:
   

   Typescript

   const kustoClient = new KustoClient(kcsb);
   

   Java

   try (Client kustoClient = ClientFactory.createClient(kcsb)) {
   }
   

5. Defina la base de datos y la consulta que se va a ejecutar. La consulta imprime Hello Kusto! en una columna denominada Welcome.

   C#

   var database = "Samples";
   var query = "print Welcome='Hello Kusto!'";
   

   Python

   database = "Samples"
   query = "print Welcome='Hello Kusto!'"
   

   Typescript

   const database = "Samples";
   const query = "print Welcome='Hello Kusto!'";
   

   Java

   String database = "Samples";
   String query = "print Welcome='Hello Kusto!'";
   

6. Ejecute la consulta e imprima el resultado.

   C#

   using (var response = kustoClient.ExecuteQuery(database, query, null)) {
     response.Read();
     int columnNo = response.GetOrdinal("Welcome");
     Console.WriteLine(response.GetString(columnNo));
   }
   

   Python

   response = kusto_client.execute(database, query)
   
   print(response.primary_results[0][0]["Welcome"])
   

   Typescript

   const response = await kustoClient.execute(database, query);
   
   console.log(response.primaryResults[0][0]["Welcome"].toString());
   

   Java

   KustoOperationResult response = kustoClient.execute(database, query);
   
   KustoResultSetTable primary_results = response.getPrimaryResults();
   primary_results.next();
   System.out.println(primary_results.getString("Welcome"));
   

   Nota

   La salida de la consulta se devuelve en la respuesta como un objeto que contiene una o varias tablas, formadas por unas filas y columnas más. El formato del objeto depende del idioma de la biblioteca cliente.

   La consulta kusto print devuelve una sola tabla con una fila y columna.

   C#

   La respuesta es un objeto DataReader . Puede hacer referencia al resultado, como se indica a continuación:

   • Usar el método Read() para leer la primera fila
   • Use el método GetString() para obtener el valor de la primera columna.

   Python/TypeScript

   Respuesta en el objeto JSON de resultados principales. El objeto contiene una matriz de tablas, que a su vez contiene una matriz de filas. Cada fila contiene datos organizados en un diccionario de columnas. Puede hacer referencia al resultado, como se indica a continuación:

   • El primer índice [0] de matriz hace referencia a la primera tabla
   • El segundo índice [0] de matriz hace referencia a la primera fila
   • La clave ["Welcome"] de diccionario hace referencia a la columna Welcome

   Java

   La respuesta es un objeto KustoOperationResult. Puede hacer referencia al resultado, como se indica a continuación:

   • Use el método getPrimaryResults() para obtener la tabla de resultados principal.
   • el método next() para leer la primera fila
   • el método getString() para obtener el valor de la primera columna

El código completo debe tener este aspecto:

C#

using Kusto.Data;
using Kusto.Data.Net.Client;

namespace HelloKusto {
  class HelloKusto {
    static void Main(string[] args) {
      string clusterUri = "https://help.kusto.windows.net/";
      var kcsb = new KustoConnectionStringBuilder(clusterUri).WithAadUserPromptAuthentication();
    
      using (var kustoClient = KustoClientFactory.CreateCslQueryProvider(kcsb)) {
        string database = "Samples";
        string query = "print Welcome='Hello Kusto!'";

        using (var response = kustoClient.ExecuteQuery(database, query, null)) {
          response.Read();
          int columnNo = response.GetOrdinal("Welcome");
          Console.WriteLine(response.GetString(columnNo));
        }
      }
    }
  }
}

Python

from azure.kusto.data import KustoClient, KustoConnectionStringBuilder

def main():
  cluster_uri = "https://help.kusto.windows.net"
  kcsb = KustoConnectionStringBuilder.with_interactive_login(cluster_uri)

  with KustoClient(kcsb) as kusto_client:

    database = "Samples"
    query = "print Welcome='Hello Kusto!'"
    response = kusto_client.execute(database, query)

    print(response.primary_results[0][0]["Welcome"])

if __name__ == "__main__":
  main()

Typescript

import { Client as KustoClient, KustoConnectionStringBuilder } from "azure-kusto-data/";
import { InteractiveBrowserCredentialInBrowserOptions } from "@azure/identity";

async function main()
{
  const clusterUri = "https://help.kusto.windows.net";
  const authOptions = {
    clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
    redirectUri: "http://localhost:5173",
  } as InteractiveBrowserCredentialInBrowserOptions;
  const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
  const kustoClient = new KustoClient(kcsb);

  const database = "Samples";
  const query = "print Welcome='Hello Kusto!'";
  const response = await kustoClient.execute(database, query);

  console.log(response.primaryResults[0][0]["Welcome"].toString());
}

main();

Nota

Para Node.js aplicaciones, use InteractiveBrowserCredentialNodeOptions en lugar de InteractiveBrowserCredentialInBrowserOptions.

Java

import com.microsoft.azure.kusto.data.Client;
import com.microsoft.azure.kusto.data.ClientFactory;
import com.microsoft.azure.kusto.data.KustoOperationResult;
import com.microsoft.azure.kusto.data.KustoResultSetTable;
import com.microsoft.azure.kusto.data.auth.ConnectionStringBuilder;

public class HelloKusto {
  public static void main(String[] args) throws Exception {
    try {
      String clusterUri = "https://help.kusto.windows.net/";
      ConnectionStringBuilder kcsb = ConnectionStringBuilder.createWithUserPrompt(clusterUri);

      try (Client kustoClient = ClientFactory.createClient(kcsb)) {
        String database = "Samples";
        String query = "print Welcome='Hello Kusto!'";
        KustoOperationResult response = kustoClient.execute(database, query);

        KustoResultSetTable primaryResults = response.getPrimaryResults();
        primaryResults.next();
        System.out.println(primaryResults.getString("Welcome"));
      }
    }
  }
}

Ejecutar la aplicación

En un shell de comandos, use el siguiente comando para ejecutar la aplicación:

C#

# Change directory to the folder that contains the hello world project
dotnet run .

Python

python hello_kusto.py

Typescript

En un entorno de Node.js:

node hello-kusto.js

En un entorno del explorador, use el comando adecuado para ejecutar la aplicación. Por ejemplo, para Vite-React:

npm run dev

Nota:

En un entorno del explorador, abra la consola de herramientas de desarrollo para ver la salida.

Java

mvn install exec:java -Dexec.mainClass="<groupId>.HelloKusto"

Debería ver un resultado similar al siguiente:

Hello Kusto!

Paso siguiente

Creación de una aplicación para ejecutar consultas básicas