Configuración del entorno de desarrollo para usar bibliotecas cliente de Kusto

Obtenga información sobre cómo configurar el entorno para usar bibliotecas cliente de Kusto. Puede usar estas bibliotecas para crear aplicaciones que se conecten con un clúster y ejecuten consultas o ingerir datos.

En este artículo, aprenderá a instalar paquetes de biblioteca cliente para su idioma preferido.

Requisitos previos

Seleccione los requisitos previos para el lenguaje de programación que se usa para crear la aplicación.

Nota:

Las bibliotecas cliente de Kusto son compatibles con JavaScript y TypeScript. Para convertir ejemplos de TypeScript en JavaScript, basta con quitar las anotaciones de tipo usadas para variables, parámetros y valores devueltos.

C#

Uno o varios de los siguientes marcos del SDK de .NET:

• SDK de .NET 5.0 o versiones posteriores.
• .NET Core 2.1 o posterior
• .NET Standard 2.1 o posterior
• .NET Framework 4.7.2 o una versión posterior

Comprobar la instalación: en un shell de comandos, ejecute dotnet sdk check para comprobar que las versiones instaladas cumplen los requisitos mínimos.

Python

• Python 3.7 o versiones posteriores
  • Asegúrese de que el python ejecutable está en el PATH
  • Comprobar la instalación: en un shell de comandos, ejecute python --version para comprobar que la versión es 3.7 o posterior.

Typescript

• Nodo 16 o posterior compilado con ES6

  • Asegúrese de que el node ejecutable está en el PATH
  • Comprobar la instalación: en un shell de comandos, ejecute node --version para comprobar que la versión es 3.7 o posterior.

• Una aplicación Node.js o una aplicación web basada en explorador, como una aplicación React.

• Para aplicaciones web basadas en explorador:

  • Si la aplicación tiene una experiencia de inicio de sesión, puede usar la biblioteca de @auzre/identidad para emitir un token de autorización y usar withTokenProvider para alimentar este token al cliente de Kusto:

    const tokenProvider =  () => Promise.resolve("someToken")
    KustoConnectionStringBuilder.withTokenProvider(clusterUri, tokenProvider)
    

  • Si la aplicación no tiene una experiencia de inicio de sesión o prefiere usar la biblioteca cliente de Kusto para solicitar la autenticación, debe configurar un registro de aplicación con los permisos necesarios:

    1. Cree un registro de aplicación Microsoft Entra.
    2. En la pestaña Autenticación , seleccione + Agregar una plataforma. A continuación, seleccione Aplicación de página única.
    3. Escriba los URI de redirección deseados, seleccione los cuadros tokens de acceso y tokens de identificador y seleccione Configurar. Para obtener más información sobre los URI de redirección, consulte Aplicación de escritorio que llama a las API web.
    4. Configure permisos delegados para la aplicación.
    5. Conceda a la aplicación acceso a la base de datos de Azure Data Explorer.
    6. En la pestaña Información general, copie el identificador de aplicación (cliente).

    En los ejemplos de los siguientes tutoriales se usa la biblioteca cliente de Kusto para solicitar la autenticación.

    Nota:

    Si pertenece a una organización, las restricciones basadas en las configuraciones de la organización podrían impedir que se autentique. Pida acceso desde un administrador de la organización o vuelva a intentarlo en una cuenta personal.

Java

• JDK 8 o posterior
  • Asegúrese de que el java ejecutable está en el PATH
  • Comprobar la instalación: en un shell de comandos, ejecute java -version para comprobar que la versión es 8 o posterior.
• Maven 3.6.3 o posterior
  • Asegúrese de que el mvn ejecutable está en el PATH
  • Comprobar la instalación: en un shell de comandos, ejecute mvn -version para comprobar que la versión es 3.6.3 o posterior.

Instalar el paquete

Esta sección le guiará por la instalación de la biblioteca cliente de Kusto en su entorno.

En la tabla siguiente se enumeran las bibliotecas cliente y los nombres de paquete correspondientes.

Nombre de la biblioteca	Descripción
Biblioteca de datos de Kusto	Proporciona un cliente para conectarse a clústeres. Use la biblioteca cliente para consultar datos o ejecutar comandos de administración.
Biblioteca de ingesta de Kusto	Proporciona un cliente para ingerir datos en clústeres. Para más información, consulte Ingesta de datos en el clúster.

Agregue las bibliotecas cliente de Kusto para su idioma preferido al proyecto o use el administrador de paquetes adecuado para su idioma para instalar las bibliotecas cliente.

C#

dotnet add package Microsoft.Azure.Kusto.Data --version 11.2.2
dotnet add package Microsoft.Azure.Kusto.Ingest --version 11.2.2

Python

python -m pip install azure-kusto-data
python -m pip install azure-kusto-ingest

Typescript

npm install azure-kusto-data
npm install azure-kusto-ingest

Java

Al crear aplicaciones, use la plantilla maven-archetype-quickstart maven para el paquete, como se indica a continuación.

 mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

A continuación, agregue las siguientes dependencias a la pom.xml, reemplazando las versiones de artefacto por la versión más reciente disponible en Maven Central para kusto-data y kusto-ingest.

<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-data</artifactId>
  <version>5.0.0</version>
</dependency>
<dependency>
  <groupId>com.microsoft.azure.kusto</groupId>
  <artifactId>kusto-ingest</artifactId>
  <version>5.0.0</version>
</dependency>

También debe agregar los complementos maven-compiler-plugin y exec-maven-plugin en el pom.xml. Si aún no existen, agréguelos como se indica a continuación.

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>${maven-compiler-plugin.version}</version>
  <configuration>
    <source>${java.version}</source>
    <target>${java.version}</target>
  </configuration>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
</plugin>

Los SDK de Kusto contienen aplicaciones de ejemplo de inicio rápido. Estas aplicaciones muestran cómo autenticar, administrar, consultar e ingerir datos mediante las bibliotecas cliente de Kusto. Puede usarlos como punto de partida para su propia aplicación modificando el código o incorporando secciones específicas en el proyecto.

C#

Aplicación de inicio rápido de C#

Python

Aplicación de inicio rápido de Python

Typescript

• aplicación de inicio rápido deNode.js
• Aplicación de inicio rápido del explorador

Java

Aplicación de inicio rápido de Java

Obtenga información sobre cómo crear aplicaciones que usan bibliotecas cliente

Los siguientes artículos le guiarán por la creación de aplicaciones que usan las bibliotecas cliente de Kusto.

• Crear la primera aplicación
• Creación de una aplicación para ejecutar consultas básicas
• Creación de una aplicación para ejecutar comandos de administración
• Creación de una aplicación para obtener datos mediante la ingesta en cola

Contenido relacionado

• Referencia rápida de KQL
• Asistente del generador de aplicaciones de ejemplo