Configurar o seu ambiente de desenvolvimento para utilizar bibliotecas de cliente Kusto

Saiba como configurar o seu ambiente para utilizar bibliotecas de cliente Kusto. Pode utilizar estas bibliotecas para criar aplicações que se ligam a um cluster e executam consultas ou ingerem dados.

Neste artigo, vai aprender a instalar pacotes de bibliotecas de cliente para o seu idioma preferido.

Pré-requisitos

Selecione os pré-requisitos para a linguagem de programação utilizada para criar a sua aplicação.

Nota

As bibliotecas de cliente Kusto são compatíveis com JavaScript e TypeScript. Para converter exemplos typeScript em JavaScript, remova simplesmente as anotações de tipo utilizadas para variáveis, parâmetros e valores devolvidos.

C#

Uma ou mais das seguintes arquiteturas do SDK .NET:

• SDK .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: numa shell de comandos, execute dotnet sdk check para verificar se as versões instaladas cumprem os requisitos mínimos.

Python

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

Typescript

• Nó 16 ou posterior criado com ES6

  • Certifique-se de que o node executável está no seu PATH
  • Verificar a instalação: numa shell de comandos, execute node --version para verificar se a versão é 3.7 ou posterior

• Uma aplicação Node.js ou uma aplicação Web baseada no browser, como uma aplicação React.

• Para aplicações Web baseadas no browser:

  • Se a sua aplicação tiver uma experiência de início de sessão, pode utilizar a biblioteca de @auzre/identidade para emitir um token de autorização e utilizar withTokenProvider para alimentar este token para o cliente Kusto:

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

  • Se a sua aplicação não tiver uma experiência de início de sessão ou preferir utilizar a biblioteca de cliente Kusto para pedir autenticação, tem de configurar um registo de aplicação com as permissões necessárias:

    1. Crie um Microsoft Entra registo de aplicações.
    2. No separador Autenticação , selecione + Adicionar uma plataforma. Em seguida, selecione Aplicação de página única.
    3. Introduza os URIs de Redirecionamento pretendidos, selecione as caixas para tokens e tokens de ID do Access e selecione Configurar. Para obter mais informações sobre URIs de redirecionamento, veja Aplicação de ambiente de trabalho que chama APIs Web.
    4. Configurar permissões delegadas para a aplicação.
    5. Conceda à aplicação acesso à base de dados do Azure Data Explorer.
    6. No separador Descrição Geral, copie o ID da Aplicação (cliente).

    Os exemplos ao longo dos seguintes tutoriais utilizam a biblioteca de cliente Kusto para pedir autenticação.

    Nota

    Se pertencer a uma organização, as restrições baseadas nas configurações da organização poderão impedi-lo de autenticar. Peça acesso a um administrador da organização ou tente novamente numa conta pessoal.

Java

• JDK 8 ou posterior
  • Certifique-se de que o java executável está no seu PATH
  • Verificar a instalação: numa shell de comandos, execute java -version para verificar se a versão é 8 ou posterior
• Maven 3.6.3 ou posterior
  • Certifique-se de que o mvn executável está no seu PATH
  • Verificar a instalação: numa shell de comandos, execute mvn -version para verificar se a versão é 3.6.3 ou posterior

Instalar o pacote

Esta secção orienta-o ao longo da instalação da biblioteca de cliente Kusto no seu ambiente.

A tabela seguinte lista as bibliotecas de cliente e os nomes dos pacotes correspondentes.

Nome da Biblioteca	Description
Biblioteca de dados do Kusto	Fornece um cliente para ligar a clusters. Utilize a biblioteca de cliente para consultar dados ou executar comandos de gestão.
Biblioteca de Ingestão de Kusto	Fornece um cliente para ingerir dados em clusters. Para obter mais informações, veja ingerir dados no cluster.

Adicione as bibliotecas de cliente Kusto para o seu idioma preferido ao seu projeto ou utilize o gestor de pacotes adequado para o 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

Typescript

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

Java

Ao criar aplicações, utilize o modelo maven-archetype-quickstart Maven para o pacote, da seguinte forma.

 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 do artefacto pelas versões mais recentes disponíveis no Maven Central para kusto-data e kusto-ingestão.

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

Também tem de adicionar os plug-ins 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 do Kusto contêm aplicações de exemplo de início rápido. Estas aplicações mostram como autenticar, administrar, consultar e ingerir dados com as bibliotecas de cliente Kusto. Pode utilizá-las como ponto de partida para a sua própria aplicação ao modificar o código ou incorporar secções específicas no seu projeto.

C#

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

Python

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

Typescript

• Aplicação de Início Rápido doNode.js
• Aplicação de Início Rápido do Browser

Java

Aplicação de Início Rápido java

Saiba como criar aplicações que utilizam bibliotecas de cliente

Os artigos seguintes explicam-lhe como criar aplicações que utilizam as bibliotecas de cliente Kusto.

• Criar a sua primeira aplicação
• Criar uma aplicação para executar consultas básicas
• Criar uma aplicação para executar comandos de gestão
• Criar uma aplicação para obter dados através da ingestão em fila

Conteúdo relacionado

• Referência rápida da KQL
• Assistente de gerador de aplicações de exemplo