Migrieren Ihres Clusters zur Unterstützung mehrerer Verfügbarkeitszonen (Vorschau)

1. Wechseln Sie im Azure-Portal zur Seite Overview Ihres Clusters.

2. Wählen Sie unter Einstellungen die Option Hochskalieren aus.

3. In der Zeile für Ihren Cluster werden die Verfügbarkeitszonen in der Spalte "Verfügbarkeitszonen" angezeigt.

   

Bevor Sie beginnen, stellen Sie sicher, dass Sie az.Kusto Cmdlets installiert haben und angemeldet sind. Führen Sie dann den folgenden Befehl aus, um die Liste der Verfügbarkeitszonen für die Region Ihres Clusters abzurufen:

1. Legen Sie die Ressourcen-ID Ihres Clusters fest. Sie können die Ressourcen-ID Ihres Clusters über das Azure Portal auf der Eigenschaftenseite Ihres Clusters abrufen.

   $resource_id = "<ClusterResourceID>"
   

2. Rufen Sie die Details Ihres Clusters ab.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Ermitteln Sie den Standort Ihres Clusters.

   Wichtig

   Get-AzLocation erfordert das Az.Resources-Modul. Wenn Sie es nicht installiert haben, führen Sie Install-Module Az.Resources aus.

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

4. Rufen Sie die ID Ihres Clusters ab.

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

5. Rufen Sie die Liste der Verfügbarkeitszonen für die Region Ihres Clusters ab.

   $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
   

Befolgen Sie die Anweisungen zum Bereitstellen einer Vorlage.

1. Tätigen Sie den REST-API-Aufruf am folgenden Endpunkt, und ersetzen Sie dort die Parameter durch Ihre Werte:

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

2. Geben Sie Ihre Verfügbarkeitszonen im Anforderungstext an. Um beispielsweise den Cluster für die Verwendung der Verfügbarkeitszonen 1, 2 und 3 zu konfigurieren, legen Sie den Text wie folgt fest:

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

1. Wenn Sie die Bibliotheken Azure.Identity und Azure.ResourceManager.Kusto nicht installiert haben, verwenden Sie die folgenden Befehle, um sie zu installieren.

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

2. Fügen Sie in Ihrer Anwendung den folgenden Code hinzu:

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

   Wenn Sie ihre Zonen beispielsweise auf 1, 2 und 3 in der Region „Europa, Norden“ festlegen möchten, verwenden Sie den folgenden Code:

   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. Führen Sie Ihre Anwendung aus.

1. Fügen Sie in Ihrer Anwendung den folgenden Code hinzu:

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

   Wenn Sie ihre Zonen beispielsweise auf 1, 2 und 3 in der Region „Europa, Norden“ festlegen möchten, verwenden Sie den folgenden Code:

   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. Führen Sie Ihre Anwendung aus.

Sie können den folgenden PowerShell-Befehl verwenden, um Ihren Cluster für die Verwendung von Verfügbarkeitszonen zu konfigurieren. Stellen Sie sicher, dass die Kusto-Toolsbibliotheken installiert sind, und ersetzen Sie die Parameter durch Ihre Werte.

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

1. Fügen Sie in Ihrer ARM-Vorlage der Ressource Microsoft.Kusto/clusters die folgende Eigenschaft hinzu:

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

   Verwenden Sie die folgende Vorlage, um Ihre Zonen auf 1, 2 und 3 in der Region Nordeuropa festzulegen:

   {
     "$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. Stellen Sie die ARM-Vorlage bereit. Weitere Informationen finden Sie unter Deploy resources with ARM templates and Azure CLI.