Saiba como configurar seu ambiente para usar bibliotecas de cliente Kusto. Você pode usar essas bibliotecas para criar aplicativos que se conectam a um cluster e executam consultas ou ingerem dados.
Neste artigo, você aprenderá a instalar pacotes de biblioteca de cliente para seu idioma preferido.
Pré-requisitos
Selecione os pré-requisitos para a linguagem de programação usada para criar seu aplicativo.
Observação
As bibliotecas de cliente Kusto são compatíveis com JavaScript e TypeScript. Para converter exemplos de TypeScript em JavaScript, basta remover as anotações de tipo usadas para variáveis, parâmetros e valores de retorno.
Certifique-se de que o executável node está no seu PATH
Verificar a instalação: em um shell de comando, execute node --version para verificar se a versão é 3.7 ou posterior
Um aplicativo Node.js ou um aplicativo Web baseado em navegador, como um aplicativo React.
Para aplicações Web baseadas em browser:
Se o seu aplicativo tiver uma experiência de login, poderá usar a biblioteca @auzre/identidade para emitir um token de autorização e usá-lo withTokenProvider para fornecer esse token ao cliente Kusto:
Se seu aplicativo não tiver uma experiência de login, ou se você preferir usar a biblioteca de cliente Kusto para solicitar autenticação, você precisará configurar um registro de aplicativo com as permissões necessárias:
Na guia Autenticação, selecione + Adicionar uma plataforma. Em seguida, selecione Aplicativo de página única.
Insira osde URIs de redirecionamento de desejados, selecione as caixas para tokens de do Access e tokens de ID de e selecione Configurar. Para obter mais informações sobre URIs de redirecionamento, consulte aplicação de ambiente de trabalho que chama APIs da Web.
Na guia Visão Geral, copie o ID do Aplicativo (cliente) .
Os exemplos ao longo dos tutoriais a seguir usam a biblioteca de cliente Kusto para solicitar autenticação.
Observação
Se pertencer a uma organização, as restrições baseadas nas configurações da organização poderão impedi-lo de se autenticar. Peça acesso a um administrador da organização ou tente novamente em uma conta pessoal.
JDK 8 ou posterior
Certifique-se de que o executável java está no seu PATH
Verificar a instalação: em um shell de comando, execute java -version para verificar se a versão é 8 ou posterior
Maven 3.6.3 ou posterior
Certifique-se de que o executável mvn está no seu PATH
Verificar a instalação: Em um shell de comando, execute mvn -version para verificar se a versão é 3.6.3 ou posterior
Instalar o pacote
Esta seção o orienta na instalação da biblioteca de cliente Kusto em seu ambiente.
A tabela a seguir lista as bibliotecas de cliente e os nomes de pacotes correspondentes.
Nome da biblioteca
Descrição
Biblioteca de dados Kusto
Fornece um cliente para conexão a clusters. Use a biblioteca de cliente para de dados de consulta ou executar comandos de gerenciamento de .
Adicione as bibliotecas de cliente Kusto para o seu idioma preferido ao seu projeto, ou use o gerenciador de pacotes apropriado para o seu idioma para instalar as bibliotecas cliente.
Em seguida, adicione as seguintes dependências ao seu pom.xml, substituindo as versões dos artefatos pelas mais recentes disponíveis no Maven Central para kusto-data e kusto-ingest .
Você também precisa adicionar os plugins maven-compiler-plugin e exec-maven-plugin no seu pom.xml. Se ainda não existirem, adicione-os da seguinte forma.
Os SDKs Kusto contêm aplicativos de exemplo de início rápido. Esses aplicativos mostram como autenticar, administrar, consultar e ingerir dados usando as bibliotecas de cliente Kusto. Você pode usá-los como um ponto de partida para seu próprio aplicativo, modificando o código ou incorporando seções específicas em seu projeto.