A fejlesztési környezet beállítása Kusto-ügyfélkódtárak használatára

Megtudhatja, hogyan állíthatja be a környezetet a Kusto-ügyfélkódtárak használatára. Ezekkel a kódtárakkal olyan alkalmazásokat hozhat létre, amelyek egy fürthöz csatlakoznak, és lekérdezéseket futtatnak vagy adatokat betöltenek.

Ebből a cikkből megtudhatja, hogyan telepíthet ügyfélkódtár-csomagokat az előnyben részesített nyelvhez.

Előfeltételek

Válassza ki az alkalmazás létrehozásához használt programozási nyelv előfeltételeit.

Megjegyzés

A Kusto-ügyfélkódtárak kompatibilisek a JavaScripttel és a TypeScripttel. A TypeScript-példák JavaScriptre való konvertálásához egyszerűen távolítsa el a változókhoz, paraméterekhez és visszatérési értékekhez használt típusjegyzeteket.

C#

Az alábbi .NET SDK-keretrendszerek közül legalább egy:

• .NET SDK 5.0 vagy újabb
• .NET Core 2.1 vagy újabb
• .NET Standard 2.1 vagy újabb
• A .NET-keretrendszer 4.7.2-es vagy újabb verziója

Telepítés ellenőrzése: Futtassa a parancshéjat dotnet sdk check annak ellenőrzéséhez, hogy a telepített verziók megfelelnek-e a minimális követelményeknek.

Python

• Python 3.7 vagy újabb
  • Győződjön meg arról, hogy a python végrehajtható fájl a PATH
  • Telepítés ellenőrzése: Parancshéjban futtassa a parancsot python --version annak ellenőrzéséhez, hogy a verzió 3.7-es vagy újabb-e

Typescript

• Es6-tal készült 16-os vagy újabb csomópont

  • Győződjön meg arról, hogy a node végrehajtható fájl a PATH
  • Telepítés ellenőrzése: Parancshéjban futtassa a parancsot node --version annak ellenőrzéséhez, hogy a verzió 3.7-es vagy újabb-e

• Node.js vagy böngészőalapú webalkalmazás, például React alkalmazás.

• Böngészőalapú webalkalmazások esetén:

  • Ha az alkalmazás bejelentkezési felülettel rendelkezik, a @auzre/identitástár használatával engedélyezési jogkivonatot állíthat ki, és a withTokenProvider kusto-ügyfélnek adhatja át ezt a jogkivonatot:

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

  • Ha az alkalmazás nem rendelkezik bejelentkezési felülettel, vagy inkább a Kusto ügyfélkódtárat használja a hitelesítés kéréséhez, be kell állítania egy alkalmazásregisztrációt a szükséges engedélyekkel:

    1. Hozzon létre egy Microsoft Entra alkalmazásregisztrációt.
    2. A Hitelesítés lapon válassza a + Platform hozzáadása lehetőséget. Ezután válassza az Egyoldalas alkalmazás lehetőséget.
    3. Adja meg a kívánt átirányítási URI-kat, jelölje ki az Access-jogkivonatok és -azonosító jogkivonatok mezőit, majd válassza a Konfigurálás lehetőséget. Az átirányítási URI-kkal kapcsolatos további információkért lásd: Webes API-kat meghívó asztali alkalmazás.
    4. Konfigurálja az alkalmazás delegált engedélyeit.
    5. Adjon hozzáférést az alkalmazásnak az Azure Data Explorer-adatbázishoz.
    6. Az Áttekintés lapon másolja ki az alkalmazás (ügyfél) azonosítóját.

    Az alábbi oktatóanyagok példái a Kusto ügyfélkódtár használatával kérik a hitelesítést.

    Megjegyzés

    Ha Ön egy szervezethez tartozik, a szervezeti konfigurációkon alapuló korlátozások megakadályozhatják a hitelesítést. Kérjen hozzáférést egy szervezet rendszergazdájától, vagy próbálkozzon újra egy személyes fiókkal.

Java

• JDK 8 vagy újabb
  • Győződjön meg arról, hogy a java végrehajtható fájl a PATH
  • Telepítés ellenőrzése: Parancshéjban futtassa a parancsot java -version annak ellenőrzéséhez, hogy a verzió 8 vagy újabb-e
• Maven 3.6.3 vagy újabb
  • Győződjön meg arról, hogy a mvn végrehajtható fájl a PATH
  • Telepítés ellenőrzése: Parancshéjban futtassa a parancsot mvn -version annak ellenőrzéséhez, hogy a verzió 3.6.3-at vagy újabb verziót tartalmaz-e

A csomag telepítése

Ez a szakasz végigvezeti a Kusto ügyfélkódtár telepítésén a környezetben.

Az alábbi táblázat az ügyfélkódtárakat és a megfelelő csomagneveket sorolja fel.

Tár neve	Description
Kusto-adattár	Biztosít egy ügyfelet a fürtökhöz való csatlakozáshoz. Az ügyfélkódtár használatával lekérdezheti az adatokat , vagy futtathat felügyeleti parancsokat.
Kusto Ingest-kódtár	Egy ügyfelet biztosít az adatok fürtökbe való betöltéséhez. További információ: Adatok betöltése a fürtbe.

Adja hozzá az ön által előnyben részesített nyelvhez tartozó Kusto-ügyfélkódtárakat a projekthez, vagy használja a nyelvének megfelelő csomagkezelőt az ügyfélkódtárak telepítéséhez.

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

Alkalmazások létrehozásakor használja a csomag maven-archetype-quickstart Maven sablonját az alábbiak szerint.

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

Ezután adja hozzá a következő függőségeket a pom.xml, és cserélje le az összetevők verzióit a Maven Central legújabb elérhető verziójára a kusto-data és a kusto-ingest esetében.

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

A maven-compiler-plugin és az exec-maven-plugin beépülő modulokat is hozzá kell adnia a pom.xml. Ha még nem léteznek, adja hozzá őket az alábbiak szerint.

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

A Kusto SDK-k gyors üzembe helyezési mintaalkalmazásokat tartalmaznak. Ezek az alkalmazások bemutatják, hogyan hitelesítheti, felügyelheti, kérdezheti le és betöltheti az adatokat a Kusto-ügyfélkódtárak használatával. Használhatja őket kiindulási pontként a saját alkalmazásához a kód módosításával vagy adott szakaszok projektbe való beépítésével.

C#

C# – Rövid útmutató alkalmazás

Python

Python gyorsútmutató alkalmazás

Typescript

• Node.js rövid útmutató alkalmazás
• Böngésző – rövid útmutató alkalmazás

Java

Java rövid útmutató alkalmazás

Megtudhatja, hogyan hozhat létre ügyfélkódtárakat használó alkalmazásokat

Az alábbi cikkek végigvezetik a Kusto-ügyfélkódtárakat használó alkalmazások létrehozásán.

• Az első alkalmazás létrehozása
• Alkalmazás létrehozása alapszintű lekérdezések futtatásához
• Alkalmazás létrehozása felügyeleti parancsok futtatásához
• Alkalmazás létrehozása az adatok várólista-betöltéssel történő lekéréséhez

Kapcsolódó tartalom

• KQL – rövid áttekintés
• Mintaalkalmazás-generátor varázsló