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.

Hämta lagringsemulatorn

Lagringsemulatorn är tillgänglig som en del av Microsoft Azure SDK. 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 .

Så här fungerar lagringsemulatorn

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.

Lagringsemulatorn ansluter till SQL Server eller LocalDB med Windows-autentisering.

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 Lagringsemulatorn startar visas ett kommandotolkfönster. Du kan använda det här konsolfönstret för att starta och stoppa Lagringsemulatorn. 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.

När emulatorn körs visas en ikon i aktivitetsfältets meddelandefält i Windows.

När du stänger kommandotolken för Lagringsemulatorn fortsätter lagringsemulatorn 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 Lagringsemulatorn initieras den lokala lagringsmiljön åt dig. Initieringsprocessen skapar en databas i LocalDB och reserverar HTTP-portar för varje lokal lagringstjänst.

Lagringsemulatorn installeras som standard på C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator.

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

Du kan använda kommandoradsverktyget storage Emulator för att initiera Lagringsemulatorn så att den pekar på en annan SQL-databasinstans än standardinstansen 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.

Autentisera begäranden mot lagringsemulatorn

När du har installerat och startat Lagringsemulatorn kan du testa koden mot den. Varje begäran som du gör mot Lagringsemulatorn måste vara auktoriserad, såvida det inte är en anonym begäran. Du kan auktorisera begäranden mot Lagringsemulatorn med hjälp av autentisering med delad nyckel eller med en signatur för delad åtkomst (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==

Anslut 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

Vissa Azure Storage-klientbibliotek, till exempel Xamarin-biblioteket, stöder endast autentisering med en SAS-token (signatur för delad åtkomst). Du kan skapa SAS-token med Storage Explorer eller ett annat program som stöder autentisering med delad nyckel.

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=wl&sig=t%2BbzU9%2B7ry4okULN9S0wst/8MCUhTjrHyV9rDNLSe8g%3Dsss

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 utför inte domännamnsmatchning, vilket kräver att lagringsemulatorslutpunkterna är lokala adresser.

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

<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 har Lagringsemulatorn stöd för geo-redundant replikering med läsåtkomst (RA-GRS). Du kan komma åt den sekundära platsen genom att lägga till -secondary till kontonamnet. Följande adress kan till exempel användas för att komma åt en blob med hjälp av den skrivskyddade sekundära adressen i Lagringsemulatorn:

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

Kommandoradsverktygsreferens för Storage Emulator

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

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.

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 beror på att domännamnsmatchning är tillgänglig i molnet men inte på den lokala datorn.
• Från och med version 3.1 har Lagringsemulatorkontot stöd för geo-redundant replikering 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. Åtgärderna Hämta Blob Service Stats, Get Queue Service Stats och Get Table Service Stats stöds på kontot sekundärt och returnerar alltid värdet LastSyncTime för svarselementet som aktuell tid 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änster som inte stöds av emulatorn returnerar emulatorn ett VersionNotSupportedByEmulator-fel (HTTP-statuskod 400 – Felaktig begäran).

Skillnader för Blob Storage

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 sidintervallSiff 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

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

Version 5.8

• Lagringsemulatorn avvisar inte version 2018-11-09 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

Version 5.7

• Åtgärdade ett fel som skulle orsaka en krasch om loggning aktiverades.

Version 5.6

• Lagringsemulatorn stöder nu version 2018-03-28 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

Version 5.5

• Lagringsemulatorn stöder nu version 2017-11-09 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.
• Stöd har lagts till för egenskapen blob Skapad , vilket 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änder du alternativet -reserveports i init-kommandot för att ange dem.

Version 5.3

• Lagringsemulatorn stöder nu version 2017-07-29 av lagringstjänsterna på slutpunkterna Blob, Queue och Table.

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

• En bugg har åtgärdats där Lagringsemulatorn returnerade DataServiceVersion huvudet i vissa svar där tjänsten inte var 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. Databasen skapas fortfarande om det behövs som en del av starten.
• Databasskapande kräver inte längre utökade privilegier.
• 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. Vi rekommenderar att du använder 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.
• En bugg där ett konkurrenstillstånd gjorde att tabellentitetsdata var felaktiga under samtidiga sammanslagningsåtgärder.

Version 4.0

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

Version 3.2

• Lagringsemulatorn stöder nu version 2014-02-14 av lagringstjänsterna på slutpunkterna Blob, Queue och Table. Filtjänstslutpunkter stöds för närvarande inte i Lagringsemulatorn. Mer information om version 2014-02-14 finns i Versionshantering för Azure Storage Services .

Version 3.1

• Geo-redundant lagring med läsåtkomst (RA-GRS) stöds nu i Lagringsemulatorn. Get Blob Service StatsAPI:erna , Get Queue Service Statsoch Get Table Service Stats stöds för kontot sekundärt och returnerar alltid värdet för LastSyncTime-svarselementet som aktuell tid enligt den underliggande SQL-databasen. 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-referens.

Version 3.0

• Azure Storage-emulatorn levereras inte längre i samma paket som beräkningsemulatorn.
• Det grafiska användargränssnittet för Storage Emulator är inaktuellt. Det har ersatts av ett skriptbart kommandoradsgränssnitt. Mer information om kommandoradsgränssnittet finns i Kommandoradsverktygsreferens för Lagringsemulatorn. Det grafiska gränssnittet fortsätter att finnas i version 3.0, men det kan bara nås när Beräkningsemulatorn installeras genom att högerklicka på systemfältets ikon och välja Visa lagringsemulatorgränssnittet.
• Version 2013-08-15 av Azure Storage-tjänsterna stöds nu fullt ut. (Tidigare stöds endast den här versionen 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.
• Du kan använda Microsoft Azure Storage Explorer för att arbeta med resurser i ditt molnlagringskonto och i Lagringsemulatorn.

Se även

• Lokal Azure Storage-utveckling med Azurite, Azure SDK:er och Azure Storage Explorer