Migrera klustret för att stödja flera tillgänglighetszoner (förhandsversion)

Många Azure regioner tillhandahåller tillgänglighetszoner, som är avgränsade grupper av datacenter i en region. Tillgänglighetszoner är tillräckligt nära för att ha anslutningar med låg latens till andra tillgänglighetszoner. De är anslutna via ett högpresterande nätverk med en svarstid på mindre än 2 ms. Tillgänglighetszoner är dock tillräckligt långt ifrån varandra för att minska sannolikheten för att lokala avbrott eller väder påverkar mer än en tillgänglighetszon. Varje tillgänglighetszon har oberoende infrastruktur för ström, kylning och nätverk. De är utformade så att om en zon drabbas av ett avbrott stöder de återstående zonerna regionala tjänster, kapacitet och hög tillgänglighet. Mer information finns i Azure Availability Zones.

Du kan konfigurera Azure Data Explorer kluster att använda tillgänglighetszoner i regioner som stöds. Med hjälp av tillgänglighetszoner kan ett kluster bättre motstå fel i ett enda datacenter i en region för att stödja scenarier med affärskontinuitet .

Du kan konfigurera tillgänglighetszoner när du skapar ett kluster i Azure-portalen eller programmatiskt med någon av följande metoder:

REST-API
C#-SDK
Python SDK
PowerShell
ARM template

Viktig

När du har konfigurerat ett kluster med tillgänglighetszoner kan du inte ändra klustret så att det inte använder tillgänglighetszoner.
Alla regioner stöder inte flera zoner. Därför kan du inte konfigurera kluster i dessa regioner för att använda tillgänglighetszoner.
Användning av tillgänglighetszoner medför extra kostnader för lagring.

Not

Innan du fortsätter kontrollerar du att du är bekant med migreringsprocessen och övervägandena.
Du kan också använda de här stegen för att ändra zonerna för ett befintligt kluster som använder tillgänglighetszoner.

I den här artikeln lär du dig mer om:

Så här konfigurerar du klustret för att stödja tillgänglighetszoner
Arkitekturen för kluster med tillgänglighetszoner
Migreringsprocessen och överväganden

Förutsättningar

Kontrollera att klustret finns i en region där flera tillgänglighetszoner stöds.
Om du vill migrera ett kluster för att stödja tillgänglighetszoner behöver du ett kluster som du har distribuerat utan stöd för tillgänglighetszoner.
Om du vill ändra zonerna i ett kluster behöver du ett kluster som är konfigurerat med tillgänglighetszoner.
För REST API kan du bekanta dig med Hantera Azure resurser med hjälp av REST API.
Andra programmatiska metoder finns i Krav.

Hämta listan över tillgänglighetszoner för klustrets region

Du kan hämta en lista över tillgänglighetszoner för klustret på följande sätt:

Azure Portal
PowerShell

Gå till klustrets Overview i Azure-portalen.
Under Inställningar väljer du Skala upp.
På raden för klustret visas tillgänglighetszonerna i kolumnen Tillgänglighetszoner .

Innan du börjar, se till att du har az.Kusto cmdlets installerade och är inloggad. Kör sedan följande kommando för att hämta listan över tillgänglighetszoner för klustrets region:

Ange resurs-ID för klustret. Du kan hämta klustrets resurs-ID från Azure-portalen på klustrets egenskapssida.
```
$resource_id = "<ClusterResourceID>"
```

Hämta klustrets uppgifter.

$mycluster = Get-AzKustoCluster -InputObject $resource_id

Hämta platsen för ditt kluster.

Viktig

Get-AzLocation kräver modulen Az.Resources. Om du inte har installerat den kör du Install-Module Az.Resources.
```
$location = (Get-AzLocation | where DisplayName -EQ $mycluster.Location).location
```

Hämta klustrets ID.

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

Hämta listan över tillgänglighetszoner för klustrets region.

$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

Konfigurera klustret för att stödja tillgänglighetszoner

Om du vill lägga till tillgänglighetszoner i ett befintligt kluster uppdaterar du klusterattributet zones med en lista över måltillgänglighetszonerna. Följ anvisningarna för den metod du föredrar med hjälp av informationen i följande tabell:

Parameter	Värde
`subscriptionId`	Klustrets prenumerations-ID
`resourceGroupName`	Klustrets resursgruppsnamn
`clusterName`	Namnet på klustret
`apiVersion`	`2023-05-02` eller senare

Följ anvisningarna om hur du distribuerar en mall.

Gör REST API-anropet till följande slutpunkt där du ersätter parametrarna med dina värden:

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

Ange dina tillgänglighetszoner i begärandetexten. Om du till exempel vill konfigurera klustret att använda tillgänglighetszonerna 1, 2 och 3 anger du brödtexten på följande sätt:
```
{ "zones": [ "{zone1}", "{zone2}", "{zone3}" ] }
```

Om du inte har Azure. Identitet och Azure. ResourceManager.Kusto bibliotek installerade använder du följande kommandon för att installera dem:
```
dotnet add package Azure.Identity
dotnet add package Azure.ResourceManager.Kusto
```

Lägg till följande kod i programmet:

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

Om du till exempel vill ange dina zoner till 1, 2 och 3 i regionen Europa, norra använder du följande kod:

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);
}

Kör din ansökan.

Lägg till följande kod i programmet:

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

Om du till exempel vill ange dina zoner till 1, 2 och 3 i regionen Europa, norra använder du följande kod:

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}")

Kör din ansökan.

Du kan använda följande PowerShell-kommando för att konfigurera klustret att använda tillgänglighetszoner. Kontrollera att Kusto-verktygsbiblioteken är installerade och ersätt parametrarna med dina värden.

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

I ARM-mallen lägger du till följande egenskap i resursen Microsoft.Kusto/clusters:

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

Använd följande mall för att ställa in dina zoner till 1, 2 och 3 i regionen Norra Europa:

{
  "$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"
          }
      }
  ]
}

Distribuera ARM-mallen. Mer information finns i Distribuera resurser med ARM-mallar och Azure CLI.

Under migreringen visas följande meddelande i Azure portalen på klustrets översiktssida. Meddelandet tas bort när migreringen har slutförts.

Zonindelningsändring för lagringen av det här klustret pågår. Uppdateringstiden kan variera beroende på mängden data.

Arkitektur för kluster med tillgänglighetszoner

När du konfigurerar tillgänglighetszoner distribuerar klustret resurser på följande sätt:

Compute layer: Azure Data Explorer är en distribuerad databehandlingsplattform som har två eller flera noder. Om du konfigurerar tillgänglighetszoner distribuerar klustret beräkningsnoder över de definierade tillgänglighetszonerna för maximal återhämtning inom regionen. Ett zonfel kan försämra klusterprestanda tills de misslyckade beräkningsresurserna distribueras om i de överlevande zonerna. Konfigurera maximalt antal tillgängliga zoner i en region.
Not
- I vissa fall är endast partiella tillgänglighetszoner tillgängliga för beräkningsskiktet på grund av begränsningar i beräkningskapaciteten.
- Ett klusters beräkningslager använder en princip enligt bästa förmåga för att jämnt sprida instanser mellan de valda zonerna.
Beständigt lagringslager: Kluster använder Azure Storage som ett beständigt beständigt lager. Om du konfigurerar tillgänglighetszoner aktiverar klustret ZRS och placerar tre lagringsrepliker i flera tillgänglighetszoner för maximal återhämtning inom regionen.
Not
- ZRS medför en extra kostnad.
- När du inte konfigurerar tillgänglighetszoner använder lagringsresurser standardinställningen Lokalt redundant lagring (LRS) och placerar alla tre replikerna i en enda zon.

Migreringsprocess och överväganden

När du konfigurerar ett befintligt kluster som du har distribuerat utan några tillgänglighetszoner för att stödja tillgänglighetszoner utför migreringsprocessen följande steg:

Distribuerar beräkningsresurser mellan de definierade tillgänglighetszonerna

Processen för att omdistribuera beräkningsresurser omfattar ett förberedelsesteg där zonindelad beräkningsresurscache värms upp. Under förberedelsefasen fortsätter det befintliga klustrets beräkningsresurser att fungera, vilket säkerställer oavbruten tjänst. Den här förberedelsefasen kan ta upp till tiotals minuter. Övergången till de nya beräkningsresurserna sker bara när de är helt förberedda och i drift. Den här parallella bearbetningsmetoden garanterar en relativt sömlös upplevelse, med endast minimala avbrott i tjänsten under övergången, som vanligtvis varar mellan en till tre minuter. Frågeprestanda kan dock påverkas under SKU-migreringen. Graden av påverkan kan variera beroende på specifika användningsmönster.
Migrerar historiska beständiga lagringsdata till ZRS

Migreringsprocessen beror på regionalt stöd för övergången från LRS till ZRS-lagring och den tillgängliga lagringskontokapaciteten i de valda zonerna. Överföringen av historiska data kan vara en tidskrävande process som kan ta flera timmar eller till och med sträcka sig över flera veckor.
Skriver alla nya data till ZRS

När du har initierat begäran om migrering till tillgänglighetszoner replikerar och lagrar systemet alla nya data i ZRS-konfigurationen.
Not
- Efter migreringsbegäran kan det uppstå en fördröjning på upp till flera minuter innan alla nya data börjar skrivas i ZRS-konfigurationen.
- Om ett kluster har strömmande inmatning kan det ta upp till 30 dagar att återanvända nya data som ska skrivas som ZRS-data.
Uppdaterar zonstatus

När migreringsbegäran till tillgänglighetszoner har slutförts uppdaterar systemet zonstatusen så att den återspeglar de zoner som stöds. Om zonstatusen är zoninkonsekvens indikerar det att vissa beräknings- eller lagringsresurser inte kunde migreras och inte är zonindeliga. Det här villkoret uppstår vanligtvis när det inte finns tillräckligt med zonindelad kapacitet för vissa resurser. I sådana fall gör du ett nytt försök med migreringen senare när kapaciteten är tillgänglig.

Överväganden vid migrering

Kapacitetsbegränsningar kan förhindra en lyckad migreringsbegäran. För en lyckad migrering måste tillräcklig beräknings- och lagringskapacitet stödja migreringen. Om kapacitetsbegränsningar finns får du ett felmeddelande som anger problemet.

Översikt över affärskontinuitet och haveriberedskap

Feedback

Var den här sidan till hjälp?

Last updated on 2026-06-21