Configurar seu ambiente de desenvolvimento para usar bibliotecas de clientes do Kusto

Aplica-se a: ✅Microsoft Fabric✅ do Azure Data Explorer

Saiba como configurar seu ambiente para usar bibliotecas de clientes do 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 clientes para seu idioma preferido.

Pré-requisitos

Selecione os pré-requisitos para a linguagem de programação usada para criar seu aplicativo.

Nota

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 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 a instalação: em um shell de comando, execute dotnet sdk check para verificar se as versões instaladas atendem aos requisitos mínimos.

Python

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

TypeScript

• Node 16 ou posterior criados com ES6

  • Verifique se o executável node está em 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 aplicativos Web baseados em navegador:

  • Se seu aplicativo tiver uma experiência de login, você poderá usar a biblioteca de @auzre/identidade para emitir um token de autorização e usar withTokenProvider para fornecer esse token ao 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 do Kusto para solicitar a autenticação, será necessário configurar um registro de aplicativo com as permissões necessárias:

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

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

    Nota

    Se você pertencer a uma organização, as restrições baseadas nas configurações da organização poderão impedir a autenticação. Solicite acesso de um administrador da organização ou tente novamente em uma conta pessoal.

Java

• JDK 8 ou posterior
  • Verifique se o executável java está em 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
  • Verifique se o executável mvn está em 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 orienta você pela instalação da biblioteca de clientes do 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 execute comandos de gerenciamento.
Biblioteca de ingestão do Kusto	Fornece um cliente para ingerir dados em clusters. Para obter mais informações, confira Visão geral da biblioteca de ingestão do Kusto 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 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

TypeScript

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

Java

Ao criar aplicativos, use o modelo maven-archetype-quickstart Maven 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 do 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 plugins maven-compiler-plugin e exec-maven-plugin em seu 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 clientes do Kusto. Você pode usá-las como ponto de partida para seu próprio aplicativo modificando o código ou incorporando seções específicas ao seu projeto.

C#

Aplicativo C# para Início Rápido

Python

Aplicativo de Início Rápido do Python

TypeScript

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

Java

Aplicativo Java de Início Rápido

Saiba como criar aplicativos que usam bibliotecas de clientes

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

• Criar seu primeiro aplicativo
• proteger seu aplicativo
• Criar um aplicativo para executar consultas básicas
• Criar um aplicativo para executar comandos de gerenciamento
• Criar um aplicativo para captar dados usando a ingestão em fila

Conteúdo relacionado

• Referência rápida do KQL

• Assistente do gerador de exemplos de aplicativos