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

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Zjistěte, jak nastavit prostředí tak, aby používalo klientské knihovny Kusto. Pomocí těchto knihoven můžete vytvářet aplikace, které se připojují ke clusteru a spouštějí dotazy nebo ingestují data.

V tomto článku se dozvíte, jak nainstalovat balíčky klientské knihovny pro preferovaný jazyk.

Požadavky

Vyberte 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, jednoduše 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 dotnet sdk check a zkontrolujte, jestli nainstalované verze splňují minimální požadavky.

Python

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

TypeScriptu

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

  • Ujistěte se, že je spustitelný soubor node ve vašem PATH.
  • Ověřte instalaci: V příkazovém prostředí spusťte node --version a zkontrolujte, jestli je verze 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í prostředí, můžete k vydání autorizačního tokenu použít knihovny @auzre/identity a použít k podává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řit registraci 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. Další informace o přesměrovacích URI najdete v části Desktopová aplikace, 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 je java spustitelný soubor ve vašem PATH.
  • Ověřte instalaci: V příkazovém prostředí spusťte java -version a zkontrolujte, jestli je verze 8 nebo novější.
• Maven 3.6.3 nebo novější
  • Ujistěte se, že je spustitelný soubor mvn ve vašem 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 klientské knihovny Kusto pro preferovaný jazyk do projektu nebo použijte správce balíčků vhodný pro váš jazyk k instalaci klientských knihoven.

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

Při vytváření aplikací použijte maven-archetype-quickstart šablonu Mavenu pro balíček 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

Potom přidejte následující závislosti do svého pom.xmla nahraďte verze artefaktů nejnovějšími dostupnými v Maven 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>

Musíte také přidat pluginy maven-compiler-plugin a exec-maven-plugin ve vašem pom.xml. Pokud ještě 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 obsahují ukázkové aplikace pro rychlý start. Tyto aplikace ukazují, jak ověřovat, spravovat, dotazovat a ingestovat data pomocí klientských knihoven Kusto. Můžete je použít jako výchozí bod pro vaši vlastní aplikaci úpravou kódu nebo začleněním konkrétních částí do vašeho projektu.

C#

Rychlý start aplikace C#

Python

aplikace pro rychlý start v Pythonu

TypeScript

• 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

• Průvodce generátorem ukázkových aplikací