Configurar seu ambiente de desenvolvimento para usar bibliotecas de cliente Kusto

Saiba como configurar seu ambiente para usar bibliotecas de clientes Kusto. Você pode usar essas bibliotecas para criar aplicativos que se conectam a um cluster e executar consultas ou ingerir dados.

Neste artigo, você aprenderá a instalar pacotes de biblioteca de clientes 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 clientes 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 retornados.

C#

Uma ou mais das seguintes estruturas do SDK do .NET:

• SDK do .NET 5.0 ou posterior
• .NET Core 2.1 ou posterior
• .NET Standard 2.1 ou posterior
• .NET Framework 4.7.2 ou posterior

Verificar instalação: em um shell de comando, execute dotnet sdk check para marcar que as versões instaladas atendam aos requisitos mínimos.

Python

• Python 3.7 ou posterior
  • Verifique se o python executável está em seu PATH
  • Verificar a instalação: em um shell de comando, execute python --version para marcar que a versão é 3.7 ou posterior

Máquina

• Nó 16 ou posterior criado com ES6

  • Verifique se o node executável está em seu PATH
  • Verificar a instalação: em um shell de comando, execute node --version para marcar que a versão é 3.7 ou posterior

• Um aplicativo Node.js ou um aplicativo Web baseado em navegador, como um aplicativo React.

• Para aplicativos Web baseados em navegador:

  • Se seu aplicativo tiver uma experiência de logon, você poderá usar a biblioteca de @auzre/identidade para emitir um token de autorização e usar withTokenProvider para alimentar esse token para o cliente Kusto:

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

  • Se o aplicativo não tiver uma experiência de logon ou você preferir usar a biblioteca de clientes kusto para solicitar a autenticação, será necessário configurar um registro de aplicativo com as permissões necessárias:

    1. Crie um registro de aplicativo Microsoft Entra.
    2. Na guia Autenticação , selecione + Adicionar uma plataforma. Em seguida, selecione Aplicativo de página única.
    3. Insira os URIs de Redirecionamento desejados, selecione as caixas tokens de acesso e tokens de ID e selecione Configurar. Para obter mais informações sobre URIs de redirecionamento, consulte Aplicativo da área de trabalho que chama APIs Web.
    4. Configure permissões delegadas para o aplicativo.
    5. Conceda ao aplicativo acesso ao banco de dados do Azure Data Explorer.
    6. Na guia Visão geral, copie a ID do aplicativo (cliente).

    Os exemplos nos tutoriais a seguir usam a biblioteca de clientes kusto para solicitar a autenticação.

    Observação

    Se você pertencer a uma organização, as restrições com base nas configurações da organização poderão impedir que você se autentique. Peça acesso de um administrador da organização ou tente novamente em um conta pessoal.

Java

• JDK 8 ou posterior
  • Verifique se o java executável está em seu PATH
  • Verificar a instalação: em um shell de comando, execute java -version para marcar que a versão seja 8 ou posterior
• Maven 3.6.3 ou posterior
  • Verifique se o mvn executável está em seu PATH
  • Verificar instalação: em um shell de comando, execute mvn -version para marcar que a versão é 3.6.3 ou posterior

Instalar o pacote

Esta seção orienta você pela instalação da biblioteca de clientes Kusto em seu ambiente.

A tabela a seguir lista as bibliotecas de cliente e os nomes de pacote correspondentes.

Nome da biblioteca	Descrição
Biblioteca de dados do Kusto	Fornece um cliente para se conectar a clusters. Use a biblioteca de clientes para consultar dados ou executar comandos de gerenciamento.
Biblioteca de ingestão do Kusto	Fornece um cliente para ingerir dados em clusters. Para obter mais informações, consulte ingerir dados em seu cluster.

Adicione as bibliotecas de cliente Kusto para seu idioma preferido ao seu projeto ou use o gerenciador de pacotes apropriado para seu idioma para instalar as bibliotecas de 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

Máquina

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

Java

Ao criar aplicativos, use o modelo Maven maven-archetype-quickstart para o pacote, da seguinte maneira.

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

Em seguida, adicione as seguintes dependências ao pom.xml, substituindo as versões de artefato pelas mais recentes disponíveis no Maven Central para kusto-data e 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>

Você também precisa adicionar os plug-ins maven-compiler-plugin e exec-maven-plugin no pom.xml. Se eles ainda não existirem, adicione-os da seguinte maneira.

<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>

Os SDKs do 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.

C#

Aplicativo de Início Rápido do C#

Python

Aplicativo de Início Rápido do Python

Máquina

• Node.js Aplicativo de Início Rápido
• Aplicativo de Início Rápido do Navegador

Java

Aplicativo de Início Rápido do Java

Saiba como criar aplicativos que usam bibliotecas de clientes

Os artigos a seguir explicam como criar aplicativos que usam as bibliotecas de clientes kusto.

• Crie seu primeiro aplicativo
• Criar um aplicativo para executar consultas básicas
• Criar um aplicativo para executar comandos de gerenciamento
• Criar um aplicativo para obter dados usando a ingestão na fila

Conteúdo relacionado

• Referência rápida de KQL
• Assistente de gerador de aplicativo de exemplo