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

  • 發行項

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

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

必要條件

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

建立 Azure Data Explorer 叢集

本節將引導您完成建立 Azure Data Explorer 叢集的程式。 選擇您慣用方法的相關索引標籤，以建立叢集。

  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。
    tier 標準 SKU 層。
    處理能力 number 叢集的實例數目。
    resourceGroupName testrg 將在其中建立叢集的資源群組名稱。

    注意

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

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

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

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

建立 Azure Data Explorer 資料庫

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

  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;

下一步