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

1. Wechseln Sie im Azure-Portal zur Übersichtsseite 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 aufgeführt.

   

Bevor Sie beginnen, stellen Sie sicher, dass Sie az.Kusto-Cmdlets installiert haben und angemeldet sind, und 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 finden die Ressourcen-ID Ihres Clusters im Azure-Portal auf der Eigenschaftenseite Ihres Clusters.

   $resource_id = "<ClusterResourceID>"
   

2. Rufen Sie die Details Ihres Clusters ab.

   $mycluster = Get-AzKustoCluster -InputObject $resource_id
   

3. Rufen Sie den Speicherort Ihres Clusters ab.

   Wichtig

   Get-AzLocation erfordert das Az.Resources-Modul. Sollte diese Komponente nicht vorhanden sein, 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 Microsoft.Kusto/clusters-Ressource die folgende Eigenschaft 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 die folgende Vorlage:

   {
     "$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 Bereitstellen von Ressourcen mit ARM-Vorlagen und der Azure CLI.