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

Se aplica a: ✅Microsoft Fabric✅azure Data Explorer

Obtenga información sobre cómo configurar el entorno para usar las 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.

Prerrequisitos

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 marcos del SDK de .NET siguientes:

• SDK de .NET 5.0 o posterior
• .NET Core 2.1 o posterior
• .NET Standard 2.1 o posterior
• .NET Framework 4.7.2 o 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 posterior
  • Asegúrese de que el archivo ejecutable de python esté en 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

• Node 16 o posterior compilado con ES6

  • Asegúrese de que el archivo ejecutable de node esté en 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 tu aplicación tiene una experiencia de inicio de sesión, puedes usar la @auzre/librería de identidades para emitir un token de autorización y usar withTokenProvider para proveer 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 de 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 para los 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. Configurar permisos delegados para la aplicación.
    5. Conceder a la aplicación acceso a la base de datos.
    6. En la pestaña Información general, copie el Id. 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 pueden 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 archivo ejecutable de java esté en su 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 archivo ejecutable de mvn esté en 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

Instalación del paquete

En esta sección se explica cómo instalar 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 de cliente para consultar datos o ejecutar comandos de gestión .
Biblioteca de ingesta de Kusto	Proporciona un cliente para ingerir datos en clústeres. Para obtener más información, consulte la información general sobre la biblioteca de ingesta de Kusto en su clúster.

Agregue las bibliotecas cliente de Kusto para su lenguaje 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 de Maven para el paquete, de la siguiente manera.

 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 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 a su archivo 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ápidoNode.js
• Aplicación de Inicio Rápido del Navegador

Java

Aplicación de inicio rápido de Java

Aprenda a crear aplicaciones que usan bibliotecas cliente

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

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

Contenido relacionado

• Referencia rápida de KQL

• Asistente del generador de aplicaciones de ejemplo