Nastavení vývojového prostředí pro použití klientských knihoven Kusto

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Nastavte své prostředí tak, aby používalo klientské knihovny Kusto. Tyto knihovny umožňují vytvářet aplikace, které se připojují ke clusteru, spouštějí dotazy nebo ingestují data.

Tento článek vysvětluje, jak nainstalovat balíčky klientské knihovny pro preferovaný jazyk.

Požadavky

Zvolte požadavky pro programovací jazyk použitý k vytvoření aplikace.

Poznámka

Klientské knihovny Kusto jsou kompatibilní s JavaScriptem a TypeScriptem. Pokud chcete převést příklady TypeScriptu na JavaScript, odeberte poznámky typu používané pro proměnné, parametry a návratové hodnoty.

jazyka C#

Minimálně jedna z následujících architektur .NET SDK:

• .NET SDK 5.0 nebo novější
• .NET Core 2.1 nebo novější
• .NET Standard 2.1 nebo novější
• .NET Framework 4.7.2 nebo novější

Ověřte instalaci: V příkazovém prostředí spusťte příkaz dotnet sdk check , abyste potvrdili, že nainstalované verze splňují minimální požadavky.

Python

• Python 3.7 nebo novější
  • Ujistěte se, že je python spustitelný soubor ve vašem PATH
  • Ověřte instalaci: V příkazovém prostředí spusťte příkaz a ověřte python --version , že verze je 3.7 nebo novější.

TypeScriptu

• Node 16 nebo novější sestavené pomocí ES6

  • Ujistěte se, že je ve vašem node spustitelný soubor PATH.
  • Ověřte instalaci: V příkazovém prostředí spusťte příkaz a ověřte node --version , že verze je 3.7 nebo novější.

• Aplikace Node.js nebo webová aplikace založená na prohlížeči, například aplikace React.

• Pro webové aplikace založené na prohlížeči:

  • Pokud má vaše aplikace přihlašovací funkci, použijte knihovnu @auzre/identity k vydání autorizačního tokenu a použijte withTokenProvider pro předání tohoto tokenu klientovi Kusto:

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

  • Pokud vaše aplikace nemá přihlašovací prostředí nebo chcete k zobrazení výzvy k ověření použít klientskou knihovnu Kusto, musíte nastavit registraci aplikace s potřebnými oprávněními:

    1. Vytvoření registrace aplikace Microsoft Entra
    2. Na kartě Ověřování vyberte + Přidat platformu. Pak vyberte jednostránkovou aplikaci.
    3. Zadejte požadované přesměrovací URI, vyberte pole pro přístupové tokeny a ID tokenya klikněte na Konfigurovat. Přečtěte si více o URI přesměrování v desktopové aplikaci, která volá webová rozhraní API.
    4. Konfigurace delegovaných oprávnění pro aplikace.
    5. Udělit aplikaci přístup k databázi.
    6. Na kartě Přehled zkopírujte ID aplikace (klienta) .

  Příklady v následujících kurzech používají klientskou knihovnu Kusto k zobrazení výzvy k ověření.

  Poznámka

  Pokud patříte do organizace, můžou vám omezení založená na konfiguracích organizace bránit v ověřování. Požádejte o přístup od správce organizace nebo zkuste to znovu u osobního účtu.

Java

• JDK 8 nebo novější
  • Ujistěte se, že java je spustitelný soubor ve vašem PATH
  • Ověřte instalaci: V příkazovém prostředí spusťte příkaz a ověřte java -version , že verze je 8 nebo novější.
• Maven 3.6.3 nebo novější
  • Ujistěte se, že je ve vašem mvn spustitelný soubor PATH.
  • Ověřte instalaci: V příkazovém prostředí spusťte mvn -version a zkontrolujte, jestli je verze 3.6.3 nebo novější.

Instalace balíčku

Tato část vás provede instalací klientské knihovny Kusto ve vašem prostředí.

Následující tabulka uvádí klientské knihovny a odpovídající názvy balíčků.

Název knihovny	Popis
Knihovna dat Kusto	Poskytuje klienta pro připojení ke clusterům. Pomocí klientské knihovny můžete dotazovat data nebo spouštět příkazy pro správu .
Knihovna Kusto Ingest	Poskytuje klienta pro příjem dat do clusterů. Další informace najdete v tématu Přehled knihovny Kusto Ingest ve vašem clusteru.

Přidejte do projektu klientské knihovny Kusto pro preferovaný jazyk. Pomocí správce balíčků vhodných pro váš jazyk nainstalujte klientské knihovny.

jazyka 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

TypeScriptu

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

Java

Pomocí šablony Maven maven-archetype-quickstart vytvořte aplikace následujícím způsobem.

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

Do pom.xmlpřidejte následující závislosti. Nahraďte verze artefaktů nejnovějšími dostupnými v Mavenu Central pro kusto-data a 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>

Přidejte maven-compiler-plugin a exec-maven-plugin do souboru pom.xml. Pokud neexistují, přidejte je následujícím způsobem.

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

Sady SDK Kusto zahrnují ukázkové aplikace pro rychlý start, které ukazují, jak ověřovat, spravovat, dotazovat a ingestovat data pomocí klientských knihoven Kusto. Použijte je jako výchozí bod pro vaši aplikaci úpravou kódu nebo integrací konkrétních částí do vašeho projektu.

jazyka C#

Rychlý start aplikace C#

Python

aplikace pro rychlý start v Pythonu

TypeScriptu

• Node.js Aplikace Quickstart
• Aplikace Rychlý start prohlížeče

Java

aplikace pro rychlý start v Javě

Naučte se vytvářet aplikace, které používají klientské knihovny.

Následující články vás provedou vytvářením aplikací, které používají klientské knihovny Kusto.

• Vytvořte svou první aplikaci
• Zabezpečte svou aplikaci
• Vytvoření aplikace pro spouštění základních dotazů
• Vytvoření aplikace pro spouštění příkazů pro správu
• Vytvoření aplikace pro přístup k datům pomocí frontového příjmu

Související obsah

• KQL – stručná referenční příručka

• Přečtěte si další informace o průvodci generátorem ukázkových aplikací.