Uppgradera Azure Blob Storage med Azure Data Lake Storage Gen2-funktioner

Artikel
01/19/2024

Den här artikeln hjälper dig att aktivera en hierarkisk namnrymd och upplåsningsfunktioner som säkerhet på fil- och katalognivå och snabbare åtgärder. De här funktionerna används ofta av stordataanalysarbetsbelastningar och kallas tillsammans Azure Data Lake Storage Gen2.

Mer information om dessa funktioner och utvärdera effekten av den här uppgraderingen på arbetsbelastningar, program, kostnader, tjänstintegreringar, verktyg, funktioner och dokumentation finns i Uppgradera Azure Blob Storage med Azure Data Lake Storage Gen2-funktioner.

Viktigt!

Uppgraderingar sker bara åt ena hållet. Det går inte att återställa ditt konto när du väl har utfört uppgraderingen. Vi rekommenderar att du verifierar uppgraderingen i en icke-produktionsmiljö.

Förbereda uppgraderingen

Så här förbereder du för att uppgradera ditt lagringskonto till Data Lake Storage Gen2:

Granska funktionsstöd
Se till att segmenten för varje blobsökväg namnges
Förhindra skrivaktivitet till lagringskontot

Granska funktionsstöd

Ditt lagringskonto kan vara konfigurerat för att använda funktioner som ännu inte stöds i Data Lake Storage Gen2-aktiverade konton. Om ditt konto använder sådana funktioner godkänns inte verifieringssteget av uppgraderingen. Läs artikeln om stöd för Blob Storage-funktioner i Azure Storage-konton för att identifiera funktioner som inte stöds. Om du använder sådana funktioner i ditt konto inaktiverar du dem innan du påbörjar uppgraderingen.

Följande funktioner stöds för Data Lake Storage Gen2-konton, men stöds inte av uppgraderingsprocessen:

Blobögonblicksbilder
Krypteringsomfång
Oföränderlig lagring
Spårning av senaste åtkomsttid för livscykelhantering
Mjuk borttagning för blobar
Mjuk borttagning för cotainrar

Om lagringskontot har aktiverat sådana funktioner måste du inaktivera dem innan du utför uppgraderingen. Om du vill återuppta användningen av funktionerna när uppgraderingen är klar aktiverar du dem igen.

I vissa fall måste du tillåta tid för rensningsåtgärder när en funktion har inaktiverats innan du uppgraderar. Ett exempel är funktionen för mjuk borttagning av blobar. Du måste inaktivera mjuk borttagning av blobar och sedan tillåta att alla blobbar med mjuk borttagning upphör att gälla innan du kan uppgradera kontot.

Viktigt!

Du kan inte uppgradera ett lagringskonto till Data Lake Storage Gen2 som någonsin har aktiverat ändringsflödesfunktionen. Om du bara inaktiverar ändringsflödet kan du inte utföra en uppgradering. I stället måste du skapa ett konto med den hierarkiska namnområdesfunktionen aktiverad och flytta och sedan överföra dina data till det kontot.

Se till att segmenten för varje blobsökväg namnges

Migreringsprocessen skapar en katalog för varje sökvägssegment i en blob. Data Lake Storage Gen2-kataloger måste ha ett namn så för att migreringen ska lyckas måste varje sökvägssegment i en virtuell katalog ha ett namn. Samma krav gäller för segment som bara namnges med ett blankstegstecken. Om några sökvägssegment antingen är namnlösa (//) eller bara namngivna med ett blankstegstecken (_) måste du kopiera blobarna till en ny sökväg som är kompatibel med dessa namngivningskrav innan du fortsätter med migreringen.

Förhindra skrivaktivitet till lagringskontot

Uppgraderingen kan misslyckas om ett program skriver till lagringskontot under uppgraderingen. Så här förhindrar du sådan skrivaktivitet:

Skicka in alla program eller tjänster som kan utföra skrivåtgärder.
Frigöra eller bryta befintliga lån på containrar och blobar i lagringskontot.

När uppgraderingen har slutförts bryter du lånen som du skapade för att återuppta så att skrivåtkomst till containrar och blobar tillåts.

Varning

Om du bryter ett aktivt lån utan att korrekt inaktivera program eller virtuella datorer som för närvarande har åtkomst till dessa resurser kan det få oväntade resultat. Var noga med att quiesce alla aktuella skrivaktiviteter innan du bryter några aktuella lån.

Genomför uppgraderingen

Kom igång genom att logga in på Azure-portalen.
Leta upp ditt lagringskonto och visa kontoöversikten.
Välj Data Lake Gen2-migrering.

Konfigurationssidan Uppgradera till ett lagringskonto med Azure Data Lake Gen2-funktioner visas.
Expandera avsnittet Steg 1: Granska kontoändringar innan du uppgraderar och klicka på Granska och godkänn ändringar.
På sidan Granska kontoändringar markerar du kryssrutan och klickar sedan på Godkänn ändringar.
Expandera avsnittet Steg 2: Verifiera kontot innan du uppgraderar och klicka sedan på Starta verifiering.

Om verifieringen misslyckas visas ett fel på sidan. I vissa fall visas länken Visa fel . Om länken visas väljer du den.

Välj sedan Ladda ned på snabbmenyn i filen error.json.

Öppna den nedladdade filen för att avgöra varför kontot inte klarade valideringssteget. Följande JSON anger att en inkompatibel funktion är aktiverad för kontot. I det här fallet inaktiverar du funktionen och startar sedan valideringsprocessen igen.
```
{
 "startTime": "2021-08-04T18:40:31.8465320Z",
 "id": "45c84a6d-6746-4142-8130-5ae9cfe013a0",
 "incompatibleFeatures": [
     "Blob Delete Retention Enabled"
 ],
 "blobValidationErrors": [],
 "scannedBlobCount": 0,
 "invalidBlobCount": 0,
 "endTime": "2021-08-04T18:40:34.9371480Z"
}
```
När ditt konto har verifierats expanderar du avsnittet Steg 3: Uppgradera konto och klickar sedan på Starta uppgradering.

Viktigt!

Skrivåtgärder inaktiveras medan ditt konto uppgraderas. Läsåtgärder är inte inaktiverade, men vi rekommenderar starkt att du pausar läsåtgärder eftersom de kan destabilisera uppgraderingsprocessen.

När migreringen har slutförts visas ett meddelande som liknar följande.

Öppna ett Windows PowerShell-kommandofönster.
Kontrollera att du har den senaste Azure PowerShell-modulen. Se Installera Azure PowerShell-modulen.
Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.
```
Connect-AzAccount
```
Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
<subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.
Verifiera ditt lagringskonto med hjälp av följande kommando.
```
$result = Invoke-AzStorageAccountHierarchicalNamespaceUpgrade -ResourceGroupName "<resource-group-name>" -Name "<storage-account-name>" -RequestType Validation -AsJob
```
- <resource-group-name> Ersätt platshållarvärdet med namnet på resursgruppen.
- Ersätt platshållarvärdet <storage-account-name> med namnet på ditt lagringskonto.
Beroende på storleken på ditt konto kan den här processen ta lite tid. Du kan använda växeln asJob för att köra kommandot i ett bakgrundsjobb så att klienten inte blockeras. Kommandot körs via fjärranslutning, men jobbet finns på den lokala datorn eller den virtuella dator som du kör kommandot från. Resultaten överförs till den lokala datorn eller den virtuella datorn.
Om du vill kontrollera jobbets status och visa alla egenskaper för jobbet i en lista skickar du returvariabeln till cmdleten Format-List .
```
$result | Format-List -Property *
```
Om valideringen lyckas anges egenskapen State till Slutförd.

Om verifieringen misslyckas anges egenskapen State till Failed (Misslyckades) och egenskapen Error (Fel ) visar verifieringsfel.

Följande utdata anger att en inkompatibel funktion är aktiverad för kontot. I det här fallet inaktiverar du funktionen och startar sedan valideringsprocessen igen.

I vissa fall ger egenskapen Error en sökväg till en fil med namnet error.json. Du kan öppna filen för att avgöra varför kontot inte klarade valideringssteget.

Följande JSON anger att en inkompatibel funktion är aktiverad för kontot. I det här fallet inaktiverar du funktionen och startar sedan valideringsprocessen igen.
```
{
 "startTime": "2021-08-04T18:40:31.8465320Z",
 "id": "45c84a6d-6746-4142-8130-5ae9cfe013a0",
 "incompatibleFeatures": [
     "Blob Delete Retention Enabled"
 ],
 "blobValidationErrors": [],
 "scannedBlobCount": 0,
 "invalidBlobCount": 0,
 "endTime": "2021-08-04T18:40:34.9371480Z"
}
```
När ditt konto har verifierats startar du uppgraderingen genom att köra följande kommando.
```
$result = Invoke-AzStorageAccountHierarchicalNamespaceUpgrade -ResourceGroupName "<resource-group-name>" -Name "<storage-account-name>" -RequestType Upgrade -AsJob -Force
```
Precis som i valideringsexemplet ovan använder det här exemplet växeln asJob för att köra kommandot i ett bakgrundsjobb. Växeln Force åsidosätter uppmaningar om att bekräfta uppgraderingen. Om du inte använder växeln AsJob behöver du inte använda växeln Force eftersom du bara kan svara på anvisningarna.

Viktigt!

Skrivåtgärder inaktiveras medan ditt konto uppgraderas. Läsåtgärder är inte inaktiverade, men vi rekommenderar starkt att du pausar läsåtgärder eftersom de kan destabilisera uppgraderingsprocessen.

Om du vill kontrollera jobbets status använder du samma tekniker som beskrivs i föregående steg. När processen körs anges egenskapen Tillstånd till Körs.

När migreringen har slutförts ställs egenskapen Tillstånd in på Slutförd och egenskapen Fel visar inga fel.

Viktigt!

En grov uppskattning av uppgraderingstiden skulle vara cirka 5–10 minuter per 2 miljoner blobar. Om kontot till exempel har 10 miljoner blobar tar uppgraderingen cirka 25–50 minuter. Konton som innehåller färre än 2 miljoner blobar uppgraderas vanligtvis på mindre än 10 minuter.

Öppna först Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.
Kontrollera att den version av Azure CLI som har installerats är 2.29.0 eller högre med hjälp av följande kommando.
```
 az --version
```
Om din version av Azure CLI är lägre än 2.29.0installerar du den senaste versionen. Mer information finns i Installera Azure CLI.
Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration.
```
   az account set --subscription <subscription-id>
```
<subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.
Verifiera ditt lagringskonto med hjälp av följande kommando.
```
az storage account hns-migration start --type validation -n <storage-account-name> -g <resource-group-name>
```
- <resource-group-name> Ersätt platshållarvärdet med namnet på resursgruppen.
- Ersätt platshållarvärdet <storage-account-name> med namnet på ditt lagringskonto.
Om valideringen lyckas slutförs processen och inga fel visas.

Om verifieringen misslyckas visas ett verifieringsfel i konsolen. Felet (IncompatibleValuesForAccountProperties) Values for account properties are incompatible: Versioning Enabled anger till exempel att en inkompatibel funktion (versionshantering) är aktiverad för kontot. I det här fallet inaktiverar du funktionen och startar sedan valideringsprocessen igen.

I vissa fall visas sökvägen till en fil med namnet error.json i konsolen. Du kan öppna filen för att avgöra varför kontot inte klarade valideringssteget.

Följande JSON anger att en inkompatibel funktion är aktiverad för kontot. I det här fallet inaktiverar du funktionen och startar sedan valideringsprocessen igen.
```
{
 "startTime": "2021-08-04T18:40:31.8465320Z",
 "id": "45c84a6d-6746-4142-8130-5ae9cfe013a0",
 "incompatibleFeatures": [
     "Blob Delete Retention Enabled"
 ],
 "blobValidationErrors": [],
 "scannedBlobCount": 0,
 "invalidBlobCount": 0,
 "endTime": "2021-08-04T18:40:34.9371480Z"
}
```
När ditt konto har verifierats startar du uppgraderingen genom att köra följande kommando.
```
az storage account hns-migration start --type upgrade -n storage-account-name -g <resource-group-name>
```
Viktigt!

Skrivåtgärder inaktiveras medan ditt konto uppgraderas. Läsåtgärder är inte inaktiverade, men vi rekommenderar starkt att du pausar läsåtgärder eftersom de kan destabilisera uppgraderingsprocessen.

Om migreringen lyckas slutförs processen och inga fel visas.

Stoppa uppgraderingen

Du kan stoppa migreringen innan den slutförs.

Om du vill stoppa uppgraderingen innan den är klar väljer du Avbryt uppgraderingen medan uppgraderingen pågår.

Cancel upgrade

Om du vill stoppa uppgraderingen innan den är klar använder du Stop-AzStorageAccountHierarchicalNamespaceUpgrade kommandot .

Stop-AzStorageAccountHierarchicalNamespaceUpgrade -ResourceGroupName <resource-group-name> -Name <storage-account-name>

Om du vill stoppa uppgraderingen innan den är klar använder du az storage account hns-migration stop kommandot .

az storage account hns-migration stop -n <storage-account-name> -g <resource-group-name>

Migrera data, arbetsbelastningar och program

Konfigurera tjänster i dina arbetsbelastningar så att de pekar på blobtjänstslutpunkten eller Data Lake-lagringsslutpunkten.
För Hadoop-arbetsbelastningar som använder Windows Azure Storage Blob-drivrutin eller WASB-drivrutin måste du ändra dem så att de använder ABFS-drivrutinen (Azure Blob File System). Till skillnad från DEN WASB-drivrutin som skickar begäranden till blobtjänstslutpunkten skickar ABFS-drivrutinen begäranden till Data Lake Storage-slutpunkten för ditt konto.
Testa anpassade program för att säkerställa att de fungerar som förväntat med ditt uppgraderade konto.

Med åtkomst med flera protokoll på Data Lake Storage kan de flesta program fortsätta använda Blob-API:er utan ändringar. Om du stöter på problem eller om du vill använda API:er för att arbeta med katalogåtgärder och ACL:er kan du överväga att flytta en del av koden för att använda Data Lake Storage Gen2-API:er. Se guider för .NET, Java, Python, Node.js och REST.
Testa eventuella anpassade skript för att säkerställa att de fungerar som förväntat med ditt uppgraderade konto.

Precis som med Blob-API:er fungerar förmodligen många av dina skript utan att du behöver ändra dem. Om det behövs kan du dock uppgradera skriptfiler till att använda PowerShell-cmdletar för Data Lake Storage Gen2 och Azure CLI-kommandon.

Se även

Introduktion till Azure Data Lake Storage Gen2