Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Configure seu ambiente para usar bibliotecas de cliente Kusto. Essas bibliotecas permitem criar aplicativos que se conectam a um cluster, executam consultas ou ingerem dados.
Este artigo explica como instalar pacotes de biblioteca de cliente para o seu idioma preferido.
Pré-requisitos
Escolha 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, remova as anotações de tipo usadas para variáveis, parâmetros e valores de retorno.
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 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
- 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 confirmar 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 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 aplicações Web baseadas em browser:
Se o seu aplicativo tiver uma experiência de autenticação, use a biblioteca @auzre/identity para emitir um token de autorização e use withTokenProvider para fornecer este 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:
-
Criar um registro de aplicativo Microsoft Entra
- Na guia Autenticação, selecione + Adicionar uma plataforma. Em seguida, selecione Aplicativo de página única.
- Insira osde URIs de redirecionamento de desejados, selecione as caixas para tokens de do Access e tokens de ID de e selecione Configurar. Saiba mais sobre como redirecionar URIs no aplicativo Desktop que chama APIs da Web.
-
Configurar permissões delegadas para o aplicativo.
-
Conceda ao aplicativo acesso ao seu banco de dados.
- 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.
- JDK 8 ou posterior
- Certifique-se de que 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á 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. Use o gerenciador de pacotes apropriado para seu idioma para instalar as bibliotecas cliente.
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 seguintes dependências ao seu pom.xml. Substitua 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>
Adicione os plugins maven-compiler-plugin e exec-maven-plugin ao seu pom.xml. Se 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 incluem aplicativos de exemplo de início rápido que mostram como autenticar, administrar, consultar e ingerir dados usando as bibliotecas de cliente Kusto. Use-os como um ponto de partida para seu aplicativo, modificando o código ou incorporando seções específicas em seu projeto.
Saiba como criar aplicativos que usam bibliotecas de cliente
Os artigos a seguir guiam você através da criação de aplicativos que usam as bibliotecas de cliente Kusto.
Conteúdo relacionado