Använda Azure Storage-emulatorn för utveckling och testning (inaktuell)

Microsoft Azure Storage-emulatorn är ett verktyg som emulerar Azure Blob-, Queue- och Table-tjänsterna för lokal utveckling. Du kan testa ditt program mot lagringstjänsterna lokalt utan att skapa en Azure-prenumeration eller medföra några kostnader. När du är nöjd med hur programmet fungerar i emulatorn växlar du till att använda ett Azure-lagringskonto i molnet.

Viktigt!

Azure Storage-emulatorn är nu inaktuell. Microsoft rekommenderar att du använder Azurite-emulatorn för lokal utveckling med Azure Storage. Azurite ersätter Azure Storage-emulatorn. Azurite fortsätter att uppdateras för att stödja de senaste versionerna av Azure Storage-API:er. Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

Hämta lagringsemulatorn

Lagringsemulatorn är tillgänglig som en del av Microsoft Azure SDKs. Du kan också installera Lagringsemulatorn med hjälp av det fristående installationsprogrammet (direktnedladdning). Om du vill installera Lagringsemulatorn måste du ha administratörsbehörighet på datorn.

Lagringsemulatorn körs för närvarande endast i Windows. För emulering i Linux använder du Azurite-emulatorn .

Anteckning

Data som skapas i en version av Storage Emulator är inte garanterat att vara tillgänglig när man använder en annan version. Om du behöver spara dina data på lång sikt, lagra den i ett Azure-lagringskonto istället för i Storage Emulator.

Lagringsemulatorn är beroende av specifika versioner av OData-biblioteken. Att ersätta OData-DLL:erna som används av Storage Emulator med andra versioner stöds inte och kan orsaka oväntat beteende. Dock kan vilken version av OData som helst som stöds av lagringstjänsten användas för att skicka förfrågningar till emulatorn.

Hur Storage Emulator fungerar

Lagringsemulatorn använder en lokal Microsoft SQL Server 2012 Express LocalDB-instans för att emulera Azure Storage-tjänster. Du kan välja att konfigurera Lagringsemulatorn så att den får åtkomst till en lokal instans av SQL Server i stället för LocalDB-instansen. Mer information finns i avsnittet Starta och initiera Lagringsemulatorn senare i den här artikeln.

Storage Emulator ansluter till SQL Server eller LocalDB genom att använda Windows authentication.

Det finns vissa skillnader i funktionalitet mellan Lagringsemulatorn och Azure Storage-tjänsterna. Mer information om dessa skillnader finns i avsnittet Skillnader mellan lagringsemulatorn och Azure Storage senare i den här artikeln.

Starta och initiera Lagringsemulatorn

Så här startar du Azure Storage-emulatorn:

  1. Välj knappen Start eller tryck på Windows-tangenten.
  2. Börja skriva Azure Storage Emulator.
  3. Välj emulatorn i listan över program som visas.

När Storage Emulator startar visas ett kommandopromptfönster. Använd detta konsolfönster för att starta och avsluta Storage Emulator. Du kan också rensa data, hämta status och initiera emulatorn från kommandotolken. Mer information finns i kommandoradsverktygsreferensen för Storage Emulator senare i den här artikeln.

Anteckning

Azure Storage Emulator kanske inte startar korrekt om en annan lagringsemulator, som Azurite, körs på systemet.

När emulatorn körs ser du en ikon i Windows aktivitetsfälts notifikationsområde.

När du stänger kommandopromptfönstret för Storage Emulator fortsätter Storage Emulator att köras. Om du vill öppna konsolfönstret för Lagringsemulatorn igen följer du föregående steg som om du startade Lagringsemulatorn.

Första gången du kör Storage Emulator initierar den den lokala lagringsmiljön. Initieringsprocessen skapar en databas i LocalDB och reserverar HTTP-portar för varje lokal lagringstjänst.

Standardinstallationsvägen för Storage Emulator är C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator.

Tips

Använd Microsoft Azure Storage Explorer för att arbeta med lokala Storage Emulator-resurser. Sök efter (Emulator - standardportar) (Nyckel) under Lokala och anslutna i resursträdet i Storage Explorer när du har installerat och startat Storage Emulator.

Initiera Storage Emulator för att använda en annan SQL-databas

Använd kommandoradsverktyget Storage Emulator för att initiera Storage Emulator så att den pekar på en SQL-databasinstans som inte är standardinstansen i LocalDB:

  1. Öppna konsolfönstret Storage Emulator enligt beskrivningen i avsnittet Starta och initiera Storage Emulator .

  2. I konsolfönstret skriver du följande kommando, där <SQLServerInstance> är namnet på SQL Server-instansen. Om du vill använda LocalDB anger du (localdb)\MSSQLLocalDb som SQL Server-instans.

    AzureStorageEmulator.exe init /server <SQLServerInstance>

    Du kan också använda följande kommando, som instruerar emulatorn att använda SQL Server-standardinstansen:

    AzureStorageEmulator.exe init /server .

    Eller så kan du använda följande kommando, som initierar databasen till standardinstansen LocalDB:

    AzureStorageEmulator.exe init /forceCreate

Mer information om dessa kommandon finns i Kommandoradsverktygsreferens för Storage Emulator.

Tips

Använd Microsoft SQL Server Management Studio (SSMS) för att hantera dina SQL Server-instanser, inklusive installationen av LocalDB. I dialogen SSMS Connect to Server , ange (localdb)\MSSQLLocalDb i fältet Servernamn: att ansluta till LocalDB-instansen.

Autentisera begäranden mot lagringsemulatorn

Efter att du installerat och startat Storage Emulator kan du testa din kod mot den. Varje begäran som du gör mot Lagringsemulatorn måste vara auktoriserad, såvida det inte är en anonym begäran. Auktorisera förfrågningar mot Storage Emulator genom att använda Shared Key-autentisering eller genom att använda en shared access-signatur (SAS).

Auktorisera med autentiseringsuppgifter för delad nyckel

Emulatorn stöder ett enda fast konto och en välkänd autentiseringsnyckel för autentisering med delad nyckel. Det här kontot och nyckeln är de enda autentiseringsuppgifterna för delad nyckel som tillåts för användning med emulatorn. Dessa är:

Account name: devstoreaccount1
Account key: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Anteckning

Autentiseringsnyckeln som stöds av emulatorn är endast avsedd för att testa funktionerna i din klientautentiseringskod. Det tjänar inte något säkerhetssyfte. Du kan inte använda ditt produktionslagringskonto och din nyckel med emulatorn. Du bör inte använda utvecklingskontot med produktionsdata.

Emulatorn stöder endast anslutning via HTTP. HTTPS är dock det rekommenderade protokollet för åtkomst till resurser i ett Azure-lagringskonto för produktion.

Ansluta till emulatorkontot med hjälp av genvägen

Det enklaste sättet att ansluta till emulatorn från ditt program är att konfigurera en anslutningssträng i programmets konfigurationsfil som refererar till genvägen UseDevelopmentStorage=true. Genvägen motsvarar den fullständiga anslutningssträng för emulatorn, som anger kontonamnet, kontonyckeln och emulatorns slutpunkter för var och en av Azure Storage-tjänsterna:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;
AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;
BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;
QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;
TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;

Följande .NET-kodfragment visar hur du kan använda genvägen från en metod som tar en anslutningssträng. Till exempel tar konstruktorn BlobContainerClient(String, String) en anslutningssträng.

BlobContainerClient blobContainerClient = new BlobContainerClient("UseDevelopmentStorage=true", "sample-container");
blobContainerClient.CreateIfNotExists();

Kontrollera att emulatorn körs innan du anropar koden i kodfragmentet.

Mer information om anslutningssträng finns i Konfigurera Azure Storage-anslutningssträng.

Auktorisera med en signatur för delad åtkomst

Anteckning

Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Se Installera Azure PowerShell för att komma igång. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.

Du kan skapa en SAS-token genom att använda Storage Explorer eller en annan applikation som stödjer Shared Key-autentisering.

Du kan också generera en SAS-token med hjälp av Azure PowerShell. I följande exempel genereras en SAS-token med fullständig behörighet till en blobcontainer:

  1. Installera Azure PowerShell om du inte redan har gjort det (med den senaste versionen av Azure PowerShell-cmdletarna rekommenderas). Installationsinstruktioner finns i Installera och konfigurera Azure PowerShell.
  2. Öppna Azure PowerShell och kör följande kommandon och ersätt CONTAINER_NAME med ett valfritt namn:
$context = New-AzStorageContext -Local

New-AzStorageContainer CONTAINER_NAME -Permission Off -Context $context

$now = Get-Date

New-AzStorageContainerSASToken -Name CONTAINER_NAME -Permission rwdl -ExpiryTime $now.AddDays(1.0) -Context $context -FullUri

Den resulterande signatur-URI:n för delad åtkomst för den nya containern bör likna:

http://127.0.0.1:10000/devstoreaccount1/sascontainer?sv=2012-02-12&se=2015-07-08T00%3A12%3A08Z&sr=c&sp=rwdl&sig=t%2BbzU9%2B7ry4okULN9S0wst/8MCUhTjrHyV9rDNLSe8g%3D

Signaturen för delad åtkomst som skapats med det här exemplet är giltig för en dag. Signaturen ger fullständig åtkomst (läsa, skriva, ta bort, lista) till blobar i containern.

Mer information om signaturer för delad åtkomst finns i Bevilja begränsad åtkomst till Azure Storage-resurser med hjälp av signaturer för delad åtkomst (SAS).

Adressera resurser i lagringsemulatorn

Tjänstslutpunkterna för Lagringsemulatorn skiljer sig från slutpunkterna för ett Azure-lagringskonto. Den lokala datorn gör inte domännamnsupplösning, så Storage Emulator-endpoints är lokala adresser.

När du adresserar en resurs i ett Azure-lagringskonto använder du följande schema. Kontonamnet är en del av värdnamnet i URI:n och resursen som adresseras är en del av sökvägen i URI:n.

<http|https>://<account-name>.<service-name>.core.windows.net/<resource-path>

Följande URI är till exempel en giltig adress för en blob i ett Azure Storage-konto:

https://myaccount.blob.core.windows.net/mycontainer/myblob.txt

Eftersom den lokala datorn inte utför domännamnsmatchning är kontonamnet en del av URI-sökvägen i stället för värdnamnet. Använd följande URI-format för en resurs i Lagringsemulatorn:

http://<local-machine-address>:<port>/<account-name>/<resource-path>

Följande adress kan till exempel användas för att komma åt en blob i Lagringsemulatorn:

http://127.0.0.1:10000/myaccount/mycontainer/myblob.txt

Tjänstslutpunkterna för Lagringsemulatorn är:

  • Blobtjänst: http://127.0.0.1:10000/<account-name>/<resource-path>
  • Kötjänst: http://127.0.0.1:10001/<account-name>/<resource-path>
  • Tabelltjänst: http://127.0.0.1:10002/<account-name>/<resource-path>

Adressera kontot sekundärt med RA-GRS

Från och med version 3.1 stöder Storage Emulator georedundant lagring med läsåtkomst (RA-GRS). Du kan komma åt den sekundära platsen genom att lägga -secondary till kontonamnet. Använd till exempel följande adress för att komma åt en blob via den skrivskyddade sekundären i Storage Emulator:

http://127.0.0.1:10000/myaccount-secondary/mycontainer/myblob.txt

Anteckning

För programmatisk åtkomst till den sekundära med Lagringsemulatorn använder du Lagringsklientbiblioteket för .NET version 3.2 eller senare. Mer information finns i Microsoft Azure Storage-klientbiblioteket för .NET .

Kommandoradsverktygsreferens för Storage Emulator

Från och med version 3.0 visas ett konsolfönster när du startar Storage Emulator. Använd kommandoraden i konsolfönstret för att starta och stoppa emulatorn. Du kan också fråga efter status och utföra andra operationer från kommandoraden.

Anteckning

Om du har installerat Microsoft Azure Compute-emulatorn visas en ikon för systemfältet när du startar Lagringsemulatorn. Högerklicka på ikonen för att visa en meny som ger ett grafiskt sätt att starta och stoppa Storage Emulator.

Syntax för kommandorad

AzureStorageEmulator.exe [start] [stop] [status] [clear] [init] [help]

Alternativ

Om du vill visa en lista över alternativ skriver du /help i kommandotolken.

Alternativ Beskrivning Kommando Argument
Start Startar lagringsemulatorn. AzureStorageEmulator.exe start [-inprocess] -inprocess: Starta emulatorn i den nuvarande processen istället för att skapa en ny process.
Stopp Stoppar lagringsemulatorn. AzureStorageEmulator.exe stop
Status Skriver ut status för lagringsemulatorn. AzureStorageEmulator.exe status
Klar Rensar data i alla tjänster som anges på kommandoraden. AzureStorageEmulator.exe clear [blob] [table] [queue] [all] blob: Rensar blobdata.
queue: Rensar ködata.
table: Rensar tabelldata.
alla: Rensar alla data i alla tjänster.
Init Gör en engångsinitiering för att konfigurera emulatorn. AzureStorageEmulator.exe init [-server serverName] [-sqlinstance instanceName] [-forcecreate|-skipcreate] [-reserveports|-unreserveports] [-inprocess] -server serverName\instanceName: Anger servern som är värd för SQL-instansen.
-sqlinstance instanceName: Specificerar namnet på SQL-instansen som ska användas i standardserverinstansen.
-forcecreate: Tvingar fram skapandet av SQL-databasen, även om den redan finns.
-skipcreate: Hoppar över skapandet av SQL-databasen. Detta argument går före -forcecreate.
-reserveports: Försöker reservera DE HTTP-portar som är associerade med tjänsterna.
-unreserveports: Försöker ta bort reservationer för DE HTTP-portar som är associerade med tjänsterna. Detta argument har företräde framför -reserveports.
-inprocess: Utför initiering i den aktuella processen i stället för att skapa en ny process. Den aktuella processen måste startas med utökade behörigheter om ändringar av portinställningar görs.

Skillnader mellan lagringsemulatorn och Azure Storage

Eftersom Lagringsemulatorn är en lokal emulerad miljö finns det skillnader mellan att använda emulatorn och ett Azure Storage-konto i molnet:

  • Lagringsemulatorn stöder endast ett enda fast konto och en välkänd autentiseringsnyckel.
  • Lagringsemulatorn är inte en skalbar lagringstjänst och stöder inte ett stort antal samtidiga klienter.
  • Enligt beskrivningen i Adressering av resurser i lagringsemulatorn behandlas resurser på olika sätt i Lagringsemulatorn jämfört med ett Azure-lagringskonto. Skillnaden finns eftersom domännamnsupplösning finns tillgänglig i molnet men inte på den lokala datorn.
  • Från och med version 3.1 stöder kontot för Storage Emulator georedundant lagring med läsåtkomst (RA-GRS). I emulatorn har alla konton RA-GRS aktiverat och det finns aldrig någon fördröjning mellan de primära och sekundära replikerna. Operationerna Get Blob Service Stats, Get Queue Service Stats och Get Table Service Stats stöds på kontots sekundära slutpunkt och returnerar alltid värdet för responselementet LastSyncTime som den aktuella tiden enligt den underliggande SQL-databasen.
  • Tjänstslutpunkterna För filtjänsten och SMB-protokollet stöds för närvarande inte i Lagringsemulatorn.
  • Om du använder en version av lagringstjänsterna som emulatorn inte stödjer, returnerar emulatorn ett VersionNotSupportedByEmulator-fel (HTTP-statuskod 400 - Bad Request).

Skillnader för Bloblagring

Följande skillnader gäller för Blob Storage i emulatorn:

  • Lagringsemulatorn stöder endast blobstorlekar på upp till 2 GB.
  • Den maximala längden på ett blobnamn i Lagringsemulatorn är 256 tecken, medan den maximala längden på ett blobnamn i Azure Storage är 1 024 tecken.
  • Inkrementell kopiering gör att ögonblicksbilder från överskrivna blobar kan kopieras, vilket returnerar ett fel i tjänsten.
  • Hämta sidintervallsdiff fungerar inte mellan ögonblicksbilder som kopieras med inkrementell kopieringsblob.
  • En Put Blob-åtgärd kan lyckas mot en blob som finns i lagringsemulatorn med ett aktivt lån även om låne-ID:t inte har angetts i begäran.
  • Tilläggsblobåtgärder stöds inte av emulatorn. Om du försöker utföra en åtgärd på en tilläggsblob returneras ett FeatureNotSupportedByEmulator-fel (HTTP-statuskod 400 – Felaktig begäran).

Skillnader för Table Storage

Följande skillnader gäller för Tabelllagring i emulatorn:

  • Datumegenskaper i tabelltjänsten i Lagringsemulatorn stöder endast det intervall som stöds av SQL Server 2005 (de måste vara senare än den 1 januari 1753). Alla datum före den 1 januari 1753 ändras till det här värdet. Datumprecisionen är begränsad till precisionen för SQL Server 2005, vilket innebär att datumen är exakta till 1/300 av en sekund.
  • Lagringsemulatorn stöder egenskapsvärden för partitionsnyckel och radnyckel på mindre än 512 byte vardera. Den totala storleken på kontonamn, tabellnamn och nyckelegenskapsnamn tillsammans får inte överstiga 900 byte.
  • Den totala storleken på en rad i en tabell i Lagringsemulatorn är begränsad till mindre än 1 MB.
  • I Storage-emulatorn stöder egenskaper av datatyp Edm.Guid eller Edm.Binary endast operatorerna Equal (eq) och NotEqual (ne) jämförelsen i frågefiltersträngar.

Skillnader för kölagring

Det finns inga skillnader som är specifika för Kölagring i emulatorn.

Viktig information om Storage Emulator

Version 5.10

  • Lagringsemulatorn avvisar inte version 2019-07-07 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

Version 5.9

  • Storage Emulator avvisar inte version 2019-02-02 av lagringstjänsterna på Blob-, Kö- och Tabelltjänst-endpoints.

Version 5.8

  • Storage Emulator avvisar inte version 2018-11-09 av lagringstjänsterna på Blob-, Queue- och Table service-endpoints.

Version 5.7

  • Fixade en bugg som orsakar krascher om loggning är aktiverad.

Version 5.6

  • Storage Emulator stöder version 2018-03-28 av lagringstjänsterna på Blob-, Queue- och Table-tjänsteändpunkterna.

Version 5.5

  • Storage Emulator stöder versionen 2017-11-09 av lagringstjänsterna för Blob-, Queue- och Table-tjänstslutpunkterna.
  • Stöd för egenskapen blob Created har lagts till, som returnerar blobens skapandetid.

Version 5.4

  • För att förbättra installationsstabiliteten försöker emulatorn inte längre reservera portar vid installationstillfället. Om du vill ha portreservationer, använd -reserveports alternativet init-kommandot för att specificera dem.

Version 5.3

  • Storage Emulator stöder versionen 2017-07-29 av lagringstjänsterna för slutpunkterna för Blob-, Queue- och Table-tjänsterna.

Version 5.2

  • Lagringsemulatorn stöder nu version 2017-04-17 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.
  • En bugg där tabellegenskapsvärdena inte kodades korrekt har åtgärdats.

Version 5.1

  • Fixade en bugg där Lagringsemulatorn returnerade DataServiceVersion headern i vissa svar där tjänsten inte gjorde det.

Version 5.0

  • Installationsprogrammet för Storage Emulator söker inte längre efter befintliga MSSQL- och .NET Framework-installationer.
  • Installationsprogrammet för Storage Emulator skapar inte längre databasen som en del av installationen. Installatören skapar fortfarande databasen om det behövs vid uppstart.
  • Databasskapande kräver inte längre behörighetshöjning.
  • Portreservationer behövs inte längre för start.
  • Lägger till följande alternativ i init: -reserveports (kräver utökade privilegier), -unreserveports (kräver utökade privilegier), -skipcreate.
  • Alternativet Användargränssnitt för lagringsemulatorn på systemfältets ikon startar nu kommandoradsgränssnittet. Det gamla användargränssnittet är inte längre tillgängligt.
  • Vissa DLL:er har tagits bort eller bytt namn.

Version 4.6

  • Lagringsemulatorn stöder nu version 2016-05-31 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

Version 4.5

  • En bugg som gjorde att installationen och initieringen misslyckades när bakgrundsdatabasen bytte namn har åtgärdats.

Version 4.4

  • Lagringsemulatorn stöder nu version 2015-12-11 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.
  • Lagringsemulatorns skräpinsamling av blobdata är nu mer effektiv när du hanterar ett stort antal blobar.
  • Åtgärdade ett fel som gjorde att containerns ACL XML verifierades något annorlunda än hur lagringstjänsten gör det.
  • Åtgärdade en bugg som ibland gjorde att max- och min DateTime-värden rapporterades i fel tidszon.

Version 4.3

  • Lagringsemulatorn har nu stöd för version 2015-07-08 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

Version 4.2

  • Lagringsemulatorn stöder nu version 2015-04-05 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

Version 4.1

  • Lagringsemulatorn stöder nu version 2015-02-21 av lagringstjänsterna på slutpunkterna Blob, Queue och Table. Den stöder inte de nya tilläggsblobfunktionerna.
  • Emulatorn returnerar nu ett meningsfullt felmeddelande för versioner av lagringstjänster som inte stöds. Använd den senaste versionen av emulatorn. Om du får ett VersionNotSupportedByEmulator-fel (HTTP-statuskod 400 – Felaktig begäran) laddar du ned den senaste versionen av emulatorn.
  • Fixade en bugg där ett tävlingsvillkor gjorde att tabellens entitetsdata var felaktiga under samtidiga sammanslagningsoperationer.

Version 4.0

  • Den körbara lagringsemulatorn har bytt namn till AzureStorageEmulator.exe.

Version 3.2

Version 3.1

  • Storage Emulator stöder nu läsåtkomst geo-redundant lagring (RA-GRS). Den stöder Get Blob Service Stats, , och Get Table Service Stats API:erna för kontots sekundära och returnerar alltid värdet av svarselementet LastSyncTime som aktuell tid enligt den underliggande SQL-databasenGet Queue Service Stats. För programmatisk åtkomst till den sekundära med Lagringsemulatorn använder du Lagringsklientbiblioteket för .NET version 3.2 eller senare. För mer information, se Azure Storage-klientbiblioteken för .NET.

Version 3.0

  • Azure Storage Emulator ingår inte längre i samma paket som beräkningsemulatorn.
  • Det grafiska användargränssnittet för Storage Emulator är inaktuellt. Microsoft ersatte det med ett skriptbart kommandoradsgränssnitt. För detaljer om kommandoradsgränssnittet, se Storage Emulator Command-Line Tool Reference. Det grafiska gränssnittet finns kvar i version 3.0, men du kan bara komma åt det när Compute Emulator är installerad. För att komma åt den, högerklicka på ikonen i systemfältet och välj Visa Storage Emulator UI.
  • Storage Emulator stöder nu fullt ut versioner 2013-08-15 av Azure-lagringstjänsterna. (Tidigare stöddes denna version endast av Storage Emulator version 2.2.1 Preview.)

Nästa steg

  • Utvärdera den plattformsoberoende, community-underhållna lagringsemulatorn Azurite med öppen källkod.
  • Azure Storage-exempel med .NET innehåller länkar till flera kodexempel som du kan använda när du utvecklar ditt program.
  • Använd Microsoft Azure Storage Explorer för att arbeta med resurser i ditt molnlagringskonto och i Storage Emulator.

Se även

  • Last updated on