Beralih layanan menggunakan daftar drop-down Versi .
Pelajari selengkapnya tentang navigasi.
Berlaku untuk: ✅ Microsoft Fabric ✅ Azure Data Explorer
Siapkan lingkungan Anda untuk menggunakan pustaka klien Kusto. Pustaka ini memungkinkan Anda membuat aplikasi yang tersambung ke kluster, menjalankan kueri, atau menyerap data.
Artikel ini menjelaskan cara menginstal paket pustaka klien untuk bahasa pilihan Anda.
Prasyarat
Pilih prasyarat untuk bahasa pemrograman yang digunakan untuk membuat aplikasi Anda.
Nota
Pustaka klien Kusto kompatibel dengan JavaScript dan TypeScript. Untuk mengonversi contoh TypeScript ke JavaScript, hapus anotasi jenis yang digunakan untuk variabel, parameter, dan nilai pengembalian.
Satu atau beberapa kerangka kerja .NET SDK berikut:
- .NET SDK 5.0 atau yang lebih baru
- .NET Core 2.1 atau yang lebih baru
- .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 mengonfirmasi bahwa versi yang diinstal memenuhi persyaratan minimum.
-
Python 3.7 atau yang lebih baru
- Pastikan executable
python ada di PATH
- Verifikasi penginstalan: Dalam shell perintah, jalankan
python --version untuk mengonfirmasi bahwa versinya adalah 3.7 atau yang lebih baru.
Simpul 16 atau yang lebih baru dibangun dengan ES6
- Pastikan bahwa berkas yang dapat dieksekusi
node berada di PATH
- Verifikasi penginstalan: Dalam shell perintah, jalankan
node --version untuk mengonfirmasi bahwa 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, gunakan pustaka @auzre/identitas untuk mengeluarkan token otorisasi dan gunakan withTokenProvider untuk mengumpankan 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:
-
Membuat pendaftaran aplikasi Microsoft Entra
- Di tab Autentikasi , pilih + Tambahkan platform. Kemudian, pilih Aplikasi halaman tunggal.
- Masukkan URI Pengalihan yang diinginkan, pilih kotak untuk Token akses dan token ID, dan pilih Konfigurasikan. Pelajari selengkapnya tentang mengalihkan URI di aplikasi Desktop yang memanggil API web.
-
Konfigurasikan izin yang didelegasikan untuk aplikasi.
-
Berikan akses aplikasi ke database Anda.
- Di tab Gambaran Umum, salin ID Aplikasi (klien).
Contoh di seluruh tutorial berikut menggunakan pustaka klien Kusto untuk meminta autentikasi.
Nota
Jika Anda termasuk dalam organisasi, pembatasan berdasarkan konfigurasi organisasi mungkin mencegah Anda mengautentikasi. Minta akses dari admin organisasi atau coba lagi di akun pribadi.
- JDK 8 atau yang lebih baru
- Pastikan executable
java ada di PATH
- Verifikasi penginstalan: Dalam shell perintah, jalankan
java -version untuk mengonfirmasi bahwa versinya adalah 8 atau yang lebih baru.
- Maven 3.6.3 atau yang lebih baru
- Pastikan bahwa berkas yang dapat dieksekusi
mvn berada di PATH
- Verifikasi penginstalan: Di shell perintah, jalankan
mvn -version untuk memeriksa apakah versinya adalah 3.6.3 atau yang lebih baru
Pasang paketnya
Bagian ini membimbing Anda dalam menginstal pustaka klien Kusto di lingkungan Anda.
Tabel berikut mencantumkan pustaka klien dan nama paket yang sesuai.
| Nama Pustaka |
Description |
| 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 Gambaran umum pustaka Kusto Ingest pada kluster Anda. |
Tambahkan pustaka klien Kusto untuk bahasa pilihan Anda ke proyek Anda. Gunakan manajer paket yang sesuai untuk bahasa Anda untuk menginstal pustaka klien.
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
npm install azure-kusto-data
npm install azure-kusto-ingest
Gunakan templat Maven-archetype-quickstart maven untuk membuat aplikasi, sebagai berikut.
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId==my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
Tambahkan dependensi berikut ke pom.xmlAnda . 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>
Tambahkan plugin maven-compiler-plugin dan exec-maven-plugin ke pom.xmlAnda. Jika tidak 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 mencakup aplikasi contoh mulai cepat yang menunjukkan cara mengautentikasi, mengelola, melakukan kueri, dan memasukkan data menggunakan pustaka klien Kusto. Gunakan sebagai titik awal untuk aplikasi Anda dengan memodifikasi kode atau menggabungkan bagian tertentu ke dalam proyek Anda.
Pelajari cara membuat aplikasi yang menggunakan pustaka klien
Artikel berikut memandu Anda membuat aplikasi yang menggunakan pustaka klien Kusto.
Konten terkait