クラスターを移行して複数の可用性ゾーンをサポートする (プレビュー)

1. Azure portal で、クラスターの [概要] ページに移動します。

2. [設定] で、[スケール アップ] を選択します。

3. そのクラスターの行で、可用性ゾーンが [可用性ゾーン] 列に一覧表示されます。

   

開始する前に、az.Kusto コマンドレットがインストールされてサインインされていることを確認し、次のコマンドを実行して、クラスターのリージョンの可用性ゾーンの一覧を取得します。

1. クラスターのリソース ID を設定します。 クラスターのリソース ID は、Azure portal のクラスターの [プロパティ] ページからから取得できます。

   $resource_id = "<ClusterResourceID>"
   

2. クラスターの詳細を取得します。

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. クラスターの場所を取得します。

   重要

   Get-AzLocation には、Az.Resources モジュールが必要です。 これがインストールされていない場合は、Install-Module Az.Resources を実行します。

   $___location = (Get-AzLocation | where DisplayName -EQ $mycluster.Location).___location
   

4. クラスターの ID を取得します。

   $mycluster.Id  -match "/subscriptions/(.*?)/" | Out-Null; $subscription = $Matches[1]
   

5. 対象クラスターのリージョン用の可用性ゾーンの一覧を取得します。

   $bearer = (Get-AzAccessToken).Token
   $rest_result = (Invoke-RestMethod -Uri https://management.azure.com/subscriptions/$subscription/providers/Microsoft.Kusto/locations/${___location}/skus?api-version=2022-11-11 -Headers @{Authorization="Bearer $bearer"})
   $zones = $rest_result | select -ExpandProperty Value | where name -eq $mycluster.SkuName | select -ExpandProperty locationInfo | select zones
   $zones
   

テンプレートをデプロイする方法の指示に従います。

1. パラメーターを実際の値に置き換えた次のエンドポイントへの REST API 呼び出しを行います。

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}?api-version={apiVersion}
   

2. 要求本文内で可用性ゾーンを指定します。 たとえば、可用性ゾーン 1、2、3 を使用するようにクラスターを構成するには、本文を次のように設定します。

   { "zones": [ "{zone1}", "{zone2}", "{zone3}" ] }
   

1. Azure.Identity ライブラリと Azure.ResourceManager.Kusto ライブラリがインストールされていない場合は、次のコマンドを使用してインストールします。

   dotnet add package Azure.Identity
   dotnet add package Azure.ResourceManager.Kusto
   

2. お使いのアプリケーション内で、次のコードを追加します。

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   たとえば、北ヨーロッパ リージョンでゾーンを 1、2、3 に設定するには、次のコードを使用します。

   using Azure.Core;
   using Azure.ResourceManager.Kusto;
   using Azure.ResourceManager.Kusto.Models;
   using ArmClient = Azure.ResourceManager.ArmClient;
   using ClientSecretCredential = Azure.Identity.ClientSecretCredential;
   using WaitUntil = Azure.WaitUntil;
   
   var tenantId = "{tenantId}";
   var clientId = "{clientId}";
   var clientSecret = "{clientSecret}";
   var subscriptionId = "{subscriptionId}";
   var resourceGroupName = "{resourceGroupName}";
   var clusterName = "{clusterName}";
   
   var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
   var resourceManagementClient = new ArmClient(credentials, subscriptionId);
   var resourceIdentifier = new ResourceIdentifier($"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/Clusters/{clusterName}");
   var cluster = resourceManagementClient.GetKustoClusterResource(resourceIdentifier);
   
   var kustoClusterPatch = new KustoClusterPatch(AzureLocation.NorthEurope);
   kustoClusterPatch.Zones.Clear();
   kustoClusterPatch.Zones.Add("1");
   kustoClusterPatch.Zones.Add("2");
   kustoClusterPatch.Zones.Add("3");
   
   var armOperation = await cluster.UpdateAsync(WaitUntil.Started, kustoClusterPatch).ConfigureAwait(false);
   
   var response = armOperation.UpdateStatus();
   Console.WriteLine($"ClientRequestId: {response.ClientRequestId}");
   
   while (true)
   {
     Console.WriteLine($"{DateTime.UtcNow:o} {response.Status, -5} {response.ReasonPhrase}");
     if (armOperation.HasCompleted)
       break;
   
     await Task.Delay(60000).ConfigureAwait(false);
     response = await armOperation.UpdateStatusAsync().ConfigureAwait(false);
   }
   

3. アプリケーションを実行します。

1. お使いのアプリケーション内で、次のコードを追加します。

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   たとえば、北ヨーロッパ リージョンでゾーンを 1、2、3 に設定するには、次のコードを使用します。

   from azure.identity import DefaultAzureCredential
   from azure.mgmt.kusto import KustoManagementClient
   from azure.mgmt.kusto import models
   import time
   from azure.core.exceptions import HttpResponseError 
   
   subscription_id = "{subscriptionId}"
   resource_group_name = "{resourceGroupName}"
   cluster_name = "{clusterName}"
   
   client = KustoManagementClient(DefaultAzureCredential(), subscription_id)
   lro_poller = client.clusters.begin_update(resource_group_name, cluster_name, models.ClusterUpdate.from_dict({"zones": ["1", "2", "3"]}))
   
   while (not(lro_poller.done())):
       time.sleep(60)
   
   print (f"status: {lro_poller.status()}")
   
   try:
       lro_poller.result()
   except HttpResponseError as e:
       print (f"Exception: {e}")
   

2. アプリケーションを実行します。

次の PowerShell コマンドを使用して、可用性ゾーンを使用するようにクラスターを構成できます。 Kusto ツール ライブラリがインストールされていることを確認し、パラメーターを実際の値に置き換えます。

Update-AzKustoCluster -SubscriptionId {subscriptionId} -ResourceGroupName {resourceGroupName} -Name {clusterName} -Zone "{zone1}", "{zone2}", "{zone3}"

1. ARM テンプレートで、Microsoft.Kusto/clusters リソースに次のプロパティを追加します。

   "zones": [ "{zone1}", "{zone2}", "{zone3}" ]
   

   たとえば、北ヨーロッパ リージョンでゾーンを 1、2、3 に設定するには、次のテンプレートを使用します。

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
         "clusters_clusterName_name": {
             "defaultValue": "clusterName",
             "type": "string"
         }
     },
     "variables": {},
     "resources": [
         {
             "type": "Microsoft.Kusto/clusters",
             "apiVersion": "2023-05-02",
             "name": "[parameters('clusters_clusterName_name')]",
             "___location": "North Europe",
             "sku": {
                 "name": "{skuName}",
                 "tier": "Basic",
                 "capacity": 1
             },
             "zones": ["1","2","3"],
             "identity": {
                 "type": "SystemAssigned"
             },
             "properties": {
                 "trustedExternalTenants": [],
                 "enableDiskEncryption": false,
                 "enableStreamingIngest": false,
                 "languageExtensions": {
                     "value": []
                 },
                 "enablePurge": false,
                 "enableDoubleEncryption": false,
                 "engineType": "V3",
                 "acceptedAudiences": [],
                 "restrictOutboundNetworkAccess": "Disabled",
                 "allowedFqdnList": [],
                 "publicNetworkAccess": "Enabled",
                 "allowedIpRangeList": [],
                 "enableAutoStop": true,
                 "publicIPType": "IPv4"
             }
         }
     ]
   }
   

2. ARM テンプレートをデプロイする。 詳細については、ARM テンプレートと Azure CLI でのリソースのデプロイに関するページを参照してください。