Menyiapkan lingkungan pengembangan Anda untuk menggunakan pustaka klien Kusto

Pelajari cara menyiapkan lingkungan Anda untuk menggunakan pustaka klien Kusto. Anda dapat menggunakan pustaka ini untuk membuat aplikasi yang terhubung dengan kluster dan menjalankan kueri atau menyerap data.

Dalam artikel ini, Anda mempelajari cara menginstal paket pustaka klien untuk bahasa pilihan Anda.

Prasyarat

Pilih prasyarat untuk bahasa pemrograman yang digunakan untuk membuat aplikasi Anda.

Catatan

Pustaka klien Kusto kompatibel dengan JavaScript dan TypeScript. Untuk mengonversi contoh TypeScript ke JavaScript, cukup hapus anotasi jenis yang digunakan untuk variabel, parameter, dan nilai pengembalian.

C#

Satu atau beberapa kerangka kerja .NET SDK berikut:

• .NET SDK 5.0 atau yang lebih baru
• .NET Core 2.1 atau yang terbaru
• .NET Standard 2.1 atau yang lebih baru
• .NET Framework 4.7.2 atau yang lebih baru

Verifikasi penginstalan: Dalam shell perintah, jalankan dotnet sdk check untuk memeriksa apakah versi yang diinstal memenuhi persyaratan minimum.

Python

• Python 3.7 atau yang lebih baru
  • Pastikan executable python ada di PATH
  • Verifikasi penginstalan: Dalam shell perintah, jalankan python --version untuk memeriksa apakah versinya adalah 3.7 atau yang lebih baru

Typescript

• Simpul 16 atau yang lebih baru dibangun dengan ES6

  • Pastikan executable node ada di PATH
  • Verifikasi penginstalan: Dalam shell perintah, jalankan node --version untuk memeriksa apakah versinya adalah 3.7 atau yang lebih baru

• Aplikasi Node.js atau aplikasi web berbasis browser, seperti aplikasi React.

• Untuk aplikasi web berbasis browser:

  • Jika aplikasi Anda memiliki pengalaman masuk, Anda dapat menggunakan pustaka @auzre/identitas untuk mengeluarkan token otorisasi dan menggunakan withTokenProvider untuk memberi umpan token ini ke klien Kusto:

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

  • Jika aplikasi Anda tidak memiliki pengalaman masuk, atau Anda lebih suka menggunakan pustaka klien Kusto untuk meminta autentikasi, Anda perlu menyiapkan pendaftaran aplikasi dengan izin yang diperlukan:

    1. Buat pendaftaran aplikasi Microsoft Entra.
    2. Di tab Autentikasi , pilih + Tambahkan platform. Kemudian, pilih Aplikasi satu halaman.
    3. Masukkan URI Pengalihan yang diinginkan, pilih kotak untuk Token akses dan token ID, dan pilih Konfigurasikan. Untuk informasi selengkapnya tentang URI pengalihan, lihat Aplikasi desktop yang memanggil API web.
    4. Mengonfigurasi izin yang didelegasikan untuk aplikasi.
    5. Berikan akses aplikasi ke database Azure Data Explorer Anda.
    6. Di tab Gambaran Umum, salin ID Aplikasi (klien).

    Contoh di seluruh tutorial berikut menggunakan pustaka klien Kusto untuk meminta autentikasi.

    Catatan

    Jika Anda termasuk dalam organisasi, pembatasan berdasarkan konfigurasi organisasi mungkin mencegah Anda mengautentikasi. Minta akses dari admin organisasi atau coba lagi di akun pribadi.

Java

• JDK 8 atau yang lebih baru
  • Pastikan executable java ada di PATH
  • Verifikasi penginstalan: Dalam shell perintah, jalankan java -version untuk memeriksa apakah versinya adalah 8 atau yang lebih baru
• Maven 3.6.3 atau yang lebih baru
  • Pastikan executable mvn ada di PATH
  • Verifikasi penginstalan: Di shell perintah, jalankan mvn -version untuk memeriksa apakah versinya adalah 3.6.3 atau yang lebih baru

Instal paketnya

Bagian ini memanding Anda menginstal pustaka klien Kusto di lingkungan Anda.

Tabel berikut ini mencantumkan pustaka klien dan nama paket terkait.

Nama Pustaka	Deskripsi
Pustaka Data Kusto	Menyediakan klien untuk menyambungkan ke kluster. Gunakan pustaka klien untuk mengkueri data atau menjalankan perintah manajemen.
Pustaka Kusto Ingest	Menyediakan klien untuk menyerap data ke dalam kluster. Untuk informasi selengkapnya, lihat menyerap data ke dalam kluster Anda.

Tambahkan pustaka klien Kusto untuk bahasa pilihan Anda ke proyek Anda, atau gunakan manajer paket yang sesuai untuk bahasa Anda untuk menginstal pustaka klien.

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

Saat membuat aplikasi, gunakan templat Maven-archetype-quickstart untuk paket, sebagai berikut.

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

Kemudian tambahkan dependensi berikut ke pom.xml Anda, ganti versi artefak dengan versi terbaru yang tersedia di Maven Central untuk kusto-data dan 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>

Anda juga perlu menambahkan plugin maven-compiler-plugin dan exec-maven-plugin di pom.xml Anda. Jika belum ada, tambahkan sebagai berikut.

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

SDK Kusto berisi aplikasi sampel mulai cepat. Aplikasi ini menunjukkan cara mengautentikasi, mengelola, mengkueri, dan menyerap data menggunakan pustaka klien Kusto. Anda dapat menggunakannya sebagai titik awal untuk aplikasi Anda sendiri dengan memodifikasi kode atau memasukkan bagian tertentu ke dalam proyek Anda.

C#

Aplikasi Mulai Cepat C#

Python

Aplikasi Mulai Cepat Python

Typescript

• Aplikasi Mulai CepatNode.js
• Aplikasi Mulai Cepat Browser

Java

Aplikasi Mulai Cepat Java

Pelajari cara membuat aplikasi yang menggunakan pustaka klien

Artikel berikut memandu Anda membuat aplikasi yang menggunakan pustaka klien Kusto.

• Buat aplikasi pertama Anda
• Membuat aplikasi untuk menjalankan kueri dasar
• Membuat aplikasi untuk menjalankan perintah manajemen
• Membuat aplikasi untuk mendapatkan data menggunakan penyerapan antrean

Konten terkait

• Referensi cepat KQL
• Wizard generator aplikasi sampel