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

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 confirmar se as versões instaladas atendem aos requisitos mínimos.

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

• Node 16 ou posterior criados com ES6

  • Certifique-se de que o executável node está localizado em seu PATH
  • Verificar a instalação: em um shell de comando, execute node --version para confirmar 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, use a biblioteca @auzre/identity para emitir um token de autorização e use 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. Saiba mais sobre URIs de redirecionamento no aplicativo Desktop que chama APIs 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.

• JDK 8 ou posterior
  • Verifique se o java executável está no seu PATH
  • Verificar a instalação: em um shell de comando, execute java -version para confirmar se a versão é 8 ou posterior.
• Maven 3.6.3 ou posterior
  • Certifique-se de que o executável mvn está localizado 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

dotnet add package Microsoft.Azure.Kusto.Data --version 11.2.2
dotnet add package Microsoft.Azure.Kusto.Ingest --version 11.2.2

python -m pip install azure-kusto-data
python -m pip install azure-kusto-ingest

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

Use o modelo maven-archetype-quickstart Maven para criar aplicativos, da seguinte maneira.

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

Adicione as dependências a seguir ao pom.xml. Substitua as versões dos artefatos pelas versões 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>

Adicione os plug-ins maven-compiler-plugin e exec-maven-plugin ao pom.xml. Se eles 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>

Aplicativo C# para Início Rápido

Aplicativo de Início Rápido do Python

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

Aplicativo Java de Início Rápido