Configuración del entorno de desarrollo para usar bibliotecas cliente de Kusto
Artículo
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.
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.
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:
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:
En la pestaña Autenticación , seleccione + Agregar una plataforma. A continuación, seleccione Aplicación de página única.
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.
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.
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.
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.
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.
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.
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.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.