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

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

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

Z tego artykułu dowiesz się, jak zainstalować pakiety bibliotek klienta dla preferowanego języka.

Warunki wstępne

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

Notatka

Biblioteki klienta Kusto są zgodne z językami JavaScript i TypeScript. Aby przekonwertować przykłady języka TypeScript na język JavaScript, po prostu 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ę: uruchom dotnet sdk check w wierszu poleceń, aby sprawdzić, czy zainstalowane wersje spełniają minimalne wymagania.

• python w wersji 3.7 lub nowszej
  • Upewnij się, że plik wykonywalny python znajduje się w PATH
  • Sprawdź instalację: w terminalu uruchom python --version, aby sprawdzić, czy 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 node --version, aby sprawdzić, czy 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, możesz użyć biblioteki @auzre/identity do wystawiania tokenu uwierzytelniającego i użyć withTokenProvider do podawania tego tokenu klientowi Usługi 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. Utwórz rejestrację aplikacji Microsoft Entra.
    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. Aby uzyskać więcej informacji na temat identyfikatorów URI przekierowania, zobacz Aplikacja komputerowa, 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 wykonywalny java znajduje się w PATH
  • Sprawdź instalację: w powłoce poleceń uruchom java -version, aby sprawdzić, czy wersja jest 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 lub użyj menedżera pakietów odpowiedniego dla danego 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

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

Podczas tworzenia aplikacji użyj szablonu Maven maven-archetype-quickstart dla pakietu 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

Następnie dodaj następujące zależności do pom.xml, zastępując wersje artefaktów najnowszymi dostępnymi w usłudze Maven Central dla kusto-data i pozyskiwania 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>

Należy również dodać wtyczki maven-compiler-plugin i exec-maven-plugin w pom.xml. Jeśli jeszcze 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 zawierają przykładowe aplikacje typu 'Szybki start'. Te aplikacje przedstawiają sposób uwierzytelniania, administrowania, wykonywania zapytań i pozyskiwania danych przy użyciu bibliotek klienckich usługi Kusto. Można ich używać jako punktu wyjścia dla własnej aplikacji, modyfikując kod lub włą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

• Kreator przykładowego generatora aplikacji