Sdílet prostřednictvím

Hello Kusto: Vytvoření první aplikace

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

V tomto článku se naučíte:

  • Vytvoření první klientské aplikace
  • Použití interaktivního ověřování
  • Spusťte základní dotaz, který vytiskne Hello Kusto!

Požadavky

Nastavte vývojové prostředí tak, aby používalo klientskou knihovnu Kusto.

Vytvoření aplikace

V preferovaném integrovaném vývojovém prostředí nebo textovém editoru vytvořte projekt nebo soubor s názvem hello kusto pomocí konvence vhodné pro váš preferovaný jazyk. Pak přidejte následující kód:

  1. Přidejte třídy klienta Kusto a tvůrce řetězců.

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

  2. Definujte prázdnou funkci s názvem main a volejte ji.

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

  3. Vytvořte objekt tvůrce připojovacích řetězců, který definuje identifikátor URI clusteru a nastaví režim ověřování na interaktivní. Další informace o identifikátoru URI clusteru najdete v části Kusto připojovací řetězce.

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

    Poznámka

    K interaktivnímu ověřování potřebujete účet Microsoft nebo identitu uživatele Microsoft Entra. Předplatné Azure není povinné.

    V jazyce C# nemusí interaktivní proces ověřování uživatele vyzvat, pokud:

    • Uživatel je už na zařízení ověřený.
    • Na zařízení probíhá ověřování webového rozhraní Kusto.Explorer nebo Azure Data Explorer.

  4. Vytvořte objekt klienta, který pro připojení ke clusteru používá objekt tvůrce připojovacích řetězců.

    Poznámka

    Důrazně doporučujeme ukládat do mezipaměti a opakovaně používat instanci klienta Kusto. Časté opětovné vytvoření klientů Kusto může vést ke snížení výkonu aplikace a zvýšení zatížení clusteru.

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

  5. Definujte databázi a dotaz, který se má spustit. Dotaz zobrazí Hello Kusto! ve sloupci s názvem Welcome.

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

  6. Spusťte dotaz a vytiskněte výsledek.

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

    Poznámka

    Výstup dotazu se vrátí v odpovědi jako objekt, který obsahuje jednu nebo více tabulek, která se skládá z jednoho více řádků a sloupců. Formát objektu závisí na jazyce klientské knihovny.

    Výpis kusto dotazu vrátí jednu tabulku s jedním řádkem a sloupcem.

    Odpověď je objekt DataReader. Na výsledek můžete odkazovat následujícím způsobem:

    • Čtení prvního řádku pomocí metody Read()
    • K získání hodnoty prvního sloupce použijte metodu GetString().

Celý kód by měl vypadat takto:

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));
        }
      }
    }
  }
}

Spuštění aplikace

V příkazovém prostředí spusťte aplikaci pomocí následujícího příkazu:

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

Měl by se zobrazit výsledek podobný následujícímu:

Hello Kusto!

Další krok

Zabezpečte svou aplikaci