Konfigurowanie środowiska projektowego do korzystania z bibliotek klienckich usługi Kusto

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Skonfiguruj środowisko do korzystania z bibliotek klienckich usługi Kusto. Te biblioteki umożliwiają tworzenie aplikacji łączących się z klastrem, uruchamianie zapytań lub pozyskiwanie danych.

W tym artykule wyjaśniono, jak zainstalować pakiety biblioteki klienta dla preferowanego języka.

Warunki wstępne

Wybierz wymagania wstępne dotyczące języka programowania używanego do tworzenia aplikacji.

Notatka

Biblioteki klienta Kusto są zgodne z językami JavaScript i TypeScript. Aby przekonwertować przykłady języka TypeScript na język JavaScript, usuń adnotacje typu używane dla zmiennych, parametrów i zwracanych wartości.

C#

Co najmniej jedna z następujących platform .NET SDK:

• .NET SDK 5.0 lub nowszy
• .NET Core 2.1 lub nowszy
• .NET Standard 2.1 lub nowszy
• .NET Framework 4.7.2 lub nowszy

Sprawdź instalację: w powłoce poleceń uruchom polecenie dotnet sdk check , aby potwierdzić, że zainstalowane wersje spełniają minimalne wymagania.

• python w wersji 3.7 lub nowszej
  • Upewnij się, że plik python wykonywalny znajduje się w pliku PATH
  • Sprawdź instalację: w wierszu poleceń uruchom polecenie python --version aby potwierdzić, że wersja to 3.7 lub nowsza.

TypeScript

• Node 16 lub nowszym zbudowany przy użyciu ES6

  • Upewnij się, że plik wykonywalny node znajduje się w PATH
  • Sprawdź instalację: w konsoli poleceń uruchom polecenie node --version aby potwierdzić, że wersja to 3.7 lub nowsza.

• Aplikacja Node.js lub aplikacja internetowa oparta na przeglądarce, taka jak aplikacja React.

• W przypadku aplikacji internetowych opartych na przeglądarce:

  • Jeśli aplikacja ma środowisko logowania, użyj biblioteki @azure/identity, aby wydać token autoryzacji i użyj go w withTokenProvider do przekazania tego tokenu klientowi Kusto.

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

  • Jeśli aplikacja nie ma doświadczenia logowania lub wolisz używać biblioteki klienta Kusto do wyświetlenia monitu uwierzytelniania, musisz skonfigurować rejestrację aplikacji z niezbędnymi uprawnieniami:

    1. Tworzenie rejestracji aplikacji Entra firmy Microsoft
    2. Na karcie uwierzytelniania wybierz pozycję + Dodaj platformę. Następnie wybierz pozycję aplikacja jednostronicowa.
    3. Wprowadź żądane identyfikatory URI przekierowania , zaznacz pola dla tokenów dostępu oraz tokenów ID , a następnie wybierz opcję Konfiguruj. Dowiedz się więcej o identyfikatorach URI przekierowania w aplikacji na komputer stacjonarny, która wywołuje internetowe interfejsy API.
    4. Konfigurowanie delegowanych uprawnień dla aplikacji.
    5. udziel aplikacji dostępu do bazy danych.
    6. Na karcie Przegląd skopiuj identyfikatoraplikacji (klienta) .

  Przykłady w poniższych samouczkach używają biblioteki klienta Kusto do wywoływania uwierzytelnienia.

  Notatka

  Jeśli należysz do organizacji, ograniczenia oparte na konfiguracjach organizacji mogą uniemożliwić uwierzytelnianie. Poproś o dostęp od administratora organizacji lub spróbuj ponownie na koncie osobistym.

• JDK 8 lub nowszy
  • Upewnij się, że plik java wykonywalny znajduje się w pliku PATH
  • Sprawdź instalację: w powłoce poleceń uruchom polecenie java -version, aby potwierdzić, że wersja to 8 lub nowsza.
• Maven 3.6.3 lub nowszy
  • Upewnij się, że plik wykonywalny mvn znajduje się w PATH
  • Sprawdź instalację: otwórz powłokę poleceń i uruchom mvn -version, aby upewnić się, że wersja to 3.6.3 lub nowsza

Instalowanie pakietu

Ta sekcja przeprowadzi Cię przez proces instalowania biblioteki klienta Kusto w środowisku.

W poniższej tabeli wymieniono biblioteki klienta i odpowiadające im nazwy pakietów.

Nazwa biblioteki	Opis
Biblioteka danych Kusto	Udostępnia klienta do nawiązywania połączenia z klastrami. Użyj biblioteki klienta, aby wykonywać zapytania dotyczące danych lub uruchamiać polecenia zarządzania .
Biblioteka Ingest Kusto	Udostępnia klienta do wprowadzania danych do klastrów. Aby uzyskać więcej informacji, zobacz omówienie biblioteki Kusto Ingest integrującej się z twoim klastrem.

Dodaj biblioteki klienta Kusto dla preferowanego języka do projektu. Użyj menedżera pakietów odpowiedniego dla języka, aby zainstalować biblioteki klienckie.

C#

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

TypeScript

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

Użyj szablonu maven-archetype-quickstart Maven, aby utworzyć aplikacje w następujący sposób.

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

Dodaj następujące zależności do pom.xml. Zastąp wersje artefaktów najnowszymi dostępnymi w Maven Central dla kusto-data i 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>

Dodaj wtyczkę maven-compiler-plugin i wtyczki exec-maven-plugin do pom.xml. Jeśli nie istnieją, dodaj je w następujący sposób.

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

Zestawy SDK Kusto obejmują aplikacje przykładowe do szybkiego startu, które pokazują, jak wykonywać uwierzytelnianie, administrację, zapytania i pozyskiwanie danych z wykorzystaniem bibliotek klienckich Kusto. Użyj ich jako punktu wyjścia dla aplikacji, modyfikując kod lub dołączając określone sekcje do projektu.

C#

Aplikacja Szybki początek w C#

Aplikacja szybkiego startu dla Pythona

TypeScript

• Node.js Aplikacja Quickstart
• Aplikacja Szybki Start Przeglądarki

Aplikacja Szybki Start Java

Dowiedz się, jak tworzyć aplikacje korzystające z bibliotek klienckich

W poniższych artykułach opisano tworzenie aplikacji korzystających z bibliotek klienckich usługi Kusto.

• Tworzenie pierwszej aplikacji
• Zabezpieczanie aplikacji
• Tworzenie aplikacji w celu uruchamiania podstawowych zapytań
• Tworzenie aplikacji do uruchamiania poleceń zarządzania
• Stwórz aplikację do pobierania danych z wykorzystaniem kolejkowania

Powiązana zawartość

• Szybkie odniesienie języka KQL

• Dowiedz się więcej o kreatorze generatora przykładowych aplikacji.