Kusto istemci kitaplıklarını kullanmak için geliştirme ortamınızı ayarlama

Sürüm açılan listesini kullanarak hizmetler arasında geçiş yapın. Gezinti hakkında daha fazla bilgi edinin.
Şunlar için geçerlidir: ✅ Microsoft Fabric ✅ Azure Veri Gezgini

Ortamınızı Kusto istemci kitaplıklarını kullanacak şekilde ayarlayın. Bu kitaplıklar bir kümeye bağlanan, sorgu çalıştıran veya veri alan uygulamalar oluşturmanıza olanak sağlar.

Bu makalede, tercih ettiğiniz dil için istemci kitaplığı paketlerinin nasıl yükleneceği açıklanmaktadır.

Önkoşullar

Uygulamanızı oluşturmak için kullanılan programlama dili için önkoşulları seçin.

Uyarı

Kusto istemci kitaplıkları JavaScript ve TypeScript ile uyumludur. TypeScript örneklerini JavaScript'e dönüştürmek için değişkenler, parametreler ve dönüş değerleri için kullanılan tür ek açıklamalarını kaldırın.

C#

Aşağıdaki .NET SDK çerçevelerinden biri veya daha fazlası:

• .NET SDK 5.0 veya üzeri
• .NET Core 2.1 veya üzeri
• .NET Standard 2.1 veya üzeri
• .NET Framework 4.7.2 veya sonraki bir sürümü

Yüklemeyi doğrulama: Bir komut kabuğunda, yüklü sürümlerin en düşük gereksinimleri karşıladığını onaylamak için komutunu çalıştırın dotnet sdk check .

Python

• Python 3.7 veya üzeri
  • Yürütülebilir dosyanın python içinde olduğundan emin olun PATH.
  • Yüklemeyi doğrulama: Komut kabuğunda komutunu çalıştırarak python --version sürümün 3.7 veya üzeri olduğunu doğrulayın.

TypeScript

• ES6 ile oluşturulan Node 16 veya daha üstü

  • Kullanıcı dizininizde node yürütülebilir dosyanın bulunduğundan emin olun.
  • Yüklemeyi doğrulama: Komut kabuğunda komutunu çalıştırarak node --version sürümün 3.7 veya üzeri olduğunu doğrulayın.

• Node.js uygulaması veya React uygulaması gibi tarayıcı tabanlı bir web uygulaması.

• Tarayıcı tabanlı web uygulamaları için:

  • Uygulamanızda bir oturum açma deneyimi varsa, bir kimlik doğrulama belirteci vermek için @auzre/kimlik kitaplığını kullanın ve Kusto istemcisine bu belirteci aktarmak için withTokenProvider kullanın.

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

  • Uygulamanızın oturum açma deneyimi yoksa veya kimlik doğrulaması istemde bulunmak için Kusto istemci kitaplığını kullanmayı tercih ediyorsanız, gerekli izinlere sahip bir uygulama kaydı ayarlamanız gerekir:

    1. Microsoft Entra uygulama kaydı oluşturma
    2. Kimlik Doğrulaması sekmesinde + Platform ekle'yi seçin. Ardından Tek sayfalı uygulama'yı seçin.
    3. İstediğiniz Yeniden Yönlendirme URI'lerini girin, Erişim belirteçleri ve kimlik belirteçleri kutularını seçin ve Yapılandır'ı seçin. Web API'lerini çağıran Masaüstü uygulamasında yeniden yönlendirme URI'leri hakkında daha fazla bilgi edinin.
    4. Uygulama için temsilci izinlerini yapılandırın.
    5. Uygulamaya veritabanınıza erişim izni verin.
    6. Genel Bakış sekmesinde Uygulama (istemci) kimliğini kopyalayın.

  Aşağıdaki öğreticilerdeki örnekler, kimlik doğrulaması yapmak için Kusto istemci kitaplığını kullanır.

  Uyarı

  Bir kuruluşa aitseniz, kuruluş yapılandırmalarına dayalı kısıtlamalar kimlik doğrulamanızı engelleyebilir. Kuruluş yöneticisinden erişim isteyin veya kişisel bir hesapta yeniden deneyin.

Java

• JDK 8 veya üzeri
  • Yürütülebilir dosyanın java içinde olduğundan emin olun PATH.
  • Yüklemeyi doğrulama: Komut kabuğunda komutunu çalıştırarak java -version sürümün 8 veya üzeri olduğunu doğrulayın.
• Maven 3.6.3 veya üzeri
  • Kullanıcı dizininizde mvn yürütülebilir dosyanın bulunduğundan emin olun.
  • Yüklemeyi doğrulama: Komut kabuğunda komutunu çalıştırarak mvn -version sürümün 3.6.3 veya üzeri olup olmadığını denetleyin

Paketi yükle

Bu bölüm, kusto istemci kitaplığını ortamınıza yükleme işleminde size yol gösterir.

Aşağıdaki tabloda istemci kitaplıkları ve buna karşılık gelen paket adları listeleniyor.

Kitaplık Adı	Description
Kusto Veri kitaplığı	Kümelere bağlanmak için bir istemci sağlar. Verileri sorgulamak veya yönetim komutlarını çalıştırmak için istemci kitaplığını kullanın.
Kusto Ingest kitaplığı	Verileri kümelere aktarmak için bir istemci sağlar. Daha fazla bilgi için bkz. Kusto Ingest kitaplığına genel bakış kümenizde.

Tercih ettiğiniz dil için Kusto istemci kitaplıklarını projenize ekleyin. İstemci kitaplıklarını yüklemek için dilinize uygun paket yöneticisini kullanın.

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

Uygulamaları oluşturmak için maven-archetype-quickstart Maven şablonunu aşağıdaki gibi kullanın.

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

"Şu bağımlılıkları pom.xml dosyanıza ekleyin." kusto-data ve kusto-ingest için yapıt sürümlerini, Maven Central'da bulunan en son sürümlerle değiştirin.

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

pom.xml dosyasına maven-compiler-plugin ve exec-maven-plugin eklentilerini ekleyin. Mevcut değillerse, onları şu şekilde ekleyin.

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

Kusto SDK'ları Kusto istemci kitaplıklarını kullanarak verilerin nasıl doğrulandığını, yönetildiğini, sorgulandığını ve alındığını gösteren hızlı başlangıç örnek uygulamaları içerir. Kodu değiştirerek veya projenize belirli bölümleri ekleyerek bunları uygulamanız için başlangıç noktası olarak kullanın.

C#

C# Hızlı Başlangıç Uygulaması

Python

Python Hızlı Başlangıç Uygulaması

TypeScript

• Node.js Hızlı Başlangıç Uygulaması
• Tarayıcı Hızlı Başlangıç Uygulaması

Java

Java Hızlı Başlangıç Uygulaması

İstemci kitaplıklarını kullanan uygulamalar oluşturmayı öğrenin

Aşağıdaki makaleler Kusto istemci kitaplıklarını kullanan uygulamalar oluşturma işleminde size yol gösterir.

• İlk uygulamanızı oluşturma
• Uygulamanızın güvenliğini sağlama
• Temel sorguları çalıştırmak için uygulama oluşturma
• Yönetim komutlarını çalıştırmak için uygulama oluşturma
• Kuyruğa alınmış alımı kullanarak veri almak için uygulama oluşturma

İlgili içerik

• KQL hızlı referans

• Örnek uygulama oluşturucu sihirbazı hakkında daha fazla bilgi edinin.