Azure Data Explorer クラスターとデータベースを作成する

  • [アーティクル]

Azure Data Explorer は、アプリケーション、Web サイト、IoT デバイスなどからの大量のデータ ストリーミングをリアルタイムに分析するためのフル マネージドのデータ分析サービスです。 Azure Data Explorer を使用するには、最初にクラスターを作成し、そのクラスター内に 1 つまたは複数のデータベースを作成します。 その後、データベースにデータを取り込み(読み込み)、それに対してクエリを実行できます。

この記事では、C#、Python、Go、Azure CLI、PowerShell、または Azure Resource Manager (ARM) テンプレートを使用してクラスターとデータベースを作成する方法について説明します。 Azure portalを使用してクラスターとデータベースを作成する方法については、「クイック スタート: 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。
    レベル Standard SKU レベル。
    capacity number クラスターのインスタンスの数。
    resourceGroupName testrg クラスターが作成されるリソース グループの名前。

    注意

    クラスターの作成 は長時間実行される動作であるため、CreateOrUpdate の代わりに CreateOrUpdateAsync を使用することを強くお勧めします。

  2. クラスターが正常に作成されたかどうかを確認するには、次のコマンドを実行します。

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

  3. 結果に が 含Succeededまれていることを確認して、クラスターの正常な作成をprovisioningState確認します。

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 以前を使用している場合は、ReadWriteDatabase ではなく Database を使用します。

    設定 推奨値 フィールドの説明
    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;

次のステップ