共用方式為

建立 Azure 資料總管叢集與資料庫

  • 發行項

Azure Data Explorer 是快速、完全受控的資料分析服務，可即時分析來自應用程式、網站、IoT 裝置等的大量資料流。 若要使用 Azure 數據總管，請先建立叢集，然後在該叢集中建立一或多個資料庫。 然後，您可以將數據擷取（載入）到資料庫中，並針對它執行查詢。

在本文中，您將瞭解如何使用 C#、Python、Go、Azure CLI、PowerShell 或 Azure Resource Manager （ARM） 範本來建立叢集和資料庫。 若要瞭解如何使用 Azure 入口網站 建立叢集和資料庫，請參閱快速入門：建立 Azure 數據總管叢集和資料庫。

必要條件

叢集和資料庫建立方法的必要條件：

建立 Azure 數據總管叢集

本節會引導您完成建立 Azure 數據總管叢集的程式。 選擇您慣用方法的相關索引標籤，以建立叢集。

  1. 使用下列程式代碼建立叢集：

    var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
var clientSecret = "PlaceholderClientSecret"; //Client Secret
var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var authClient = ConfidentialClientApplicationBuilder.Create(clientId)
    .WithAuthority($"https://login.microsoftonline.com/{tenantId}")
    .WithClientSecret(clientSecret)
    .Build();
var result = authClient.AcquireTokenForClient(new[] { "https://management.core.windows.net/" }).ExecuteAsync().Result;
var credentials = new TokenCredentials(result.AccessToken, result.TokenType);
var kustoManagementClient = new KustoManagementClient(credentials) { SubscriptionId = subscriptionId };
var resourceGroupName = "testrg";
var clusterName = "mykustocluster";
var skuName = KustoSkuName.StandardE8adsV5;
var skuTier = KustoSkuTier.Standard;
var capacity = 5;
var clusterData = new Cluster(
    location: "Central US",
    sku: new AzureSku(skuName, skuTier, capacity)
);
await kustoManagementClient.Clusters.CreateOrUpdateAsync(resourceGroupName, clusterName, clusterData);
    設定 建議的值 欄位描述
    clusterName mykustocluster 叢集所需的名稱。
    skuName Standard_E8ads_v5 將用於叢集的 SKU。
    階層 標準 SKU 層。
    capacity number 叢集實例的數目。
    resourceGroupName testrg 將建立叢集的資源組名。

    注意

    建立叢集 是長時間執行的作業，因此強烈建議使用 CreateOrUpdateAsync，而不是 CreateOrUpdate。

  2. 執行下列命令來檢查您的叢集是否已成功建立：

    clusterData = await kustoManagementClient.Clusters.GetAsync(resourceGroupName, clusterName);

  3. 確認成功建立叢集，方法是確認結果包含 provisioningState 為 Succeeded。

建立 Azure 數據總管資料庫

在本節中，您將在上一節中建立的叢集內建立資料庫。

  1. 使用下列程式代碼建立資料庫：

    var databaseName = "mykustodatabase";
var softDeletePeriod = TimeSpan.FromDays(3650);
var hotCachePeriod = TimeSpan.FromDays(3650);
var databaseData = new ReadWriteDatabase(
    location: clusterData.Location, softDeletePeriod: softDeletePeriod, hotCachePeriod: hotCachePeriod
);
await kustoManagementClient.Databases.CreateOrUpdateAsync(resourceGroupName, clusterName, databaseName, databaseData);

    注意

    如果您使用 C# 2.0.0 版或更新版本，請使用 Database 而非 ReadWriteDatabase。

    設定 建議的值 欄位描述
    clusterName mykustocluster 將建立資料庫之叢集的名稱。
    databaseName mykustodatabase 您的資料庫名稱。
    resourceGroupName testrg 將建立叢集的資源組名。
    softDeletePeriod 3650:00:00:00 數據可供查詢的時間量。
    hotCachePeriod 3650:00:00:00 數據將保留在快取中的時間量。

  2. 執行下列命令以檢視您所建立的資料庫：

    databaseData = await kustoManagementClient.Databases.GetAsync(resourceGroupName, clusterName, databaseName) as ReadWriteDatabase;

下一步