Aracılığıyla paylaş

Hello Kusto: İlk uygulamanızı oluşturma

  • Makale

Bu makalede şunları öğreneceksiniz:

  • İlk istemci uygulamanızı oluşturma
  • Etkileşimli kimlik doğrulamayı kullanma
  • Hello Kusto!'yu yazdıran temel bir sorgu çalıştırın!

Önkoşullar

Kusto istemci kitaplığını kullanmak için geliştirme ortamınızı ayarlayın.

Uygulamanızı oluşturma

Tercih ettiğiniz IDE veya metin düzenleyicisinde, tercih ettiğiniz dile uygun kuralı kullanarak hello kusto adlı bir proje veya dosya oluşturun. Ardından aşağıdaki kodu ekleyin:

  1. Kusto istemci ve dize oluşturucu sınıflarını ekleyin.

    using Kusto.Data;
using Kusto.Data.Net.Client;

  2. adlı main boş bir işlev tanımlayın ve bunu çağırin.

    namespace HelloKusto {
  class HelloKusto {
    static void Main(string[] args) {
    }
  }
}

  3. Küme URI'sini tanımlayan ve kimlik doğrulama modunu etkileşimli olarak ayarlayan bir bağlantı dizesi oluşturucu nesnesi oluşturun. Küme URI'si hakkında daha fazla bilgi için bkz . Kusto bağlantı dizeleri.

    var clusterUri = "https://help.kusto.windows.net/";
var kcsb = new KustoConnectionStringBuilder(clusterUri).WithAadUserPromptAuthentication();

    Not

    Etkileşimli kimlik doğrulaması için bir Microsoft hesabına veya Microsoft Entra kullanıcı kimliğine ihtiyacınız vardır. Azure aboneliği gerekli değildir.

    C# dilinde etkileşimli kimlik doğrulama işlemi aşağıdaki durumlarda kullanıcıya soru sormayabilir:

    • Kullanıcının kimliği cihazda zaten doğrulanmış
    • Cihazda mevcut bir Kusto.Explorer veya Azure Tarih Gezgini web kullanıcı arabirimi kimlik doğrulaması var

  4. Kümeye bağlanmak için bağlantı dizesi oluşturucu nesnesini kullanan bir istemci nesnesi oluşturun.

    Not

    Kusto istemci örneğini önbelleğe alıp yeniden kullanmanızı kesinlikle öneririz. Kusto istemcilerinin sık sık yeniden oluşturması, uygulamanızda performans düşüşü ve kümenizdeki yükün artmasına neden olabilir.

    using (var kustoClient = KustoClientFactory.CreateCslQueryProvider(kcsb)) {
}

  5. Çalıştırılacak veritabanını ve sorguyu tanımlayın. Sorgu Hello Kusto! ifadesini Hoş Geldiniz adlı bir sütuna yazdırır.

    var database = "Samples";
var query = "print Welcome='Hello Kusto!'";

  6. Sorguyu çalıştırın ve sonucu yazdırın.

    using (var response = kustoClient.ExecuteQuery(database, query, null)) {
  response.Read();
  int columnNo = response.GetOrdinal("Welcome");
  Console.WriteLine(response.GetString(columnNo));
}

    Not

    Sorgu çıktısı yanıtta bir veya daha fazla satır ve sütundan oluşan bir veya daha fazla tablo içeren bir nesne olarak döndürülür. Nesnenin biçimi istemci kitaplığı diline bağlıdır.

    Print kusto sorgusu, tek satır ve sütun içeren tek bir tablo döndürür.

    Yanıt bir DataReader nesnesidir. Sonuma aşağıdaki gibi başvurabilirsiniz:

    • İlk satırı okumak için Read() yöntemini kullanma
    • İlk sütunun değerini almak için GetString() yöntemini kullanın

Kodun tamamı şöyle görünmelidir:

using Kusto.Data;
using Kusto.Data.Net.Client;

namespace HelloKusto {
  class HelloKusto {
    static void Main(string[] args) {
      string clusterUri = "https://help.kusto.windows.net/";
      var kcsb = new KustoConnectionStringBuilder(clusterUri).WithAadUserPromptAuthentication();
    
      using (var kustoClient = KustoClientFactory.CreateCslQueryProvider(kcsb)) {
        string database = "Samples";
        string query = "print Welcome='Hello Kusto!'";

        using (var response = kustoClient.ExecuteQuery(database, query, null)) {
          response.Read();
          int columnNo = response.GetOrdinal("Welcome");
          Console.WriteLine(response.GetString(columnNo));
        }
      }
    }
  }
}

Uygulamanızı çalıştırma

Bir komut kabuğunda, uygulamanızı çalıştırmak için aşağıdaki komutu kullanın:

# Change directory to the folder that contains the hello world project
dotnet run .

Aşağıdakine benzer bir sonuç görmeniz gerekir:

Hello Kusto!

Sonraki adım

Temel sorguları çalıştırmak için uygulama oluşturma