Configure seu ambiente de desenvolvimento para usar bibliotecas de cliente Kusto

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

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.

C#

Uma ou mais das seguintes estruturas do .NET SDK:

• .NET SDK 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 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á no seu PATH
  • Verificar a instalação: em um shell de comando, execute python --version para verificar se a versão é 3.7 ou posterior

• Node 16 ou posterior construído com ES6

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

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

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

    1. Criar um registo de aplicação Microsoft Entra.
    2. Na guia Autenticação, selecione + Adicionar uma plataforma. Em seguida, selecione Aplicativo de página única.
    3. 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.
    4. Configurar permissões delegadas para o aplicativo.
    5. Conceda ao aplicativo acesso ao seu banco de dados.
    6. 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.

Java

• 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 .
Biblioteca Kusto Ingest	Fornece um cliente para ingestão de dados em clusters. Para obter mais informações, consulte visão geral da biblioteca Kusto Ingest em seu cluster.

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.

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

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 seu pom.xml, substituindo as versões dos artefatos 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 no seu pom.xml. Se ainda não existirem, adicione-os da seguinte forma.

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

Aplicação de Início Rápido em C#

Python

Aplicação de Início Rápido em Python

• Node.js do aplicativo de início rápido
• Aplicação de Início Rápido do Navegador

Java

Aplicativo Java Quickstart

Saiba como criar aplicativos que usam bibliotecas de cliente

Os artigos a seguir orientam você na criação de aplicativos que usam as bibliotecas de cliente Kusto.

• Crie seu primeiro aplicativo
• Proteja seu aplicativo
• Criar um aplicativo para executar consultas básicas
• Criar um aplicativo para executar comandos de gerenciamento
• Crie uma aplicação para obter dados usando o método de ingestão em fila

Conteúdo relacionado

• Referência Rápida do KQL

• assistente do gerador de aplicativos de exemplo