De Azure Storage Emulator gebruiken voor ontwikkeling en testen (afgeschaft)

De Microsoft Azure Storage Emulator is een hulpprogramma waarmee de Azure Blob-, Queue- en Table-services worden geëmuleren voor lokale ontwikkelingsdoeleinden. U kunt uw toepassing lokaal testen op de opslagservices zonder een Azure-abonnement te maken of eventuele kosten in rekening te brengen. Wanneer u tevreden bent over de werking van uw toepassing in de emulator, schakelt u over naar het gebruik van een Azure-opslagaccount in de cloud.

De opslagemulator ophalen

De opslagemulator is beschikbaar als onderdeel van de Microsoft Azure SDK. U kunt de opslagemulator ook installeren met behulp van het zelfstandige installatieprogramma (direct downloaden). Als u de opslagemulator wilt installeren, moet u beheerdersbevoegdheden hebben op uw computer.

De opslagemulator wordt momenteel alleen uitgevoerd in Windows. Gebruik de Azurite-emulator voor emulatie op Linux.

Hoe de Storage Emulator werkt

De opslagemulator maakt gebruik van een lokaal Exemplaar van Microsoft SQL Server 2012 Express LocalDB om Azure Storage-services te emuleren. U kunt ervoor kiezen om de Opslagemulator te configureren voor toegang tot een lokaal exemplaar van SQL Server in plaats van het LocalDB-exemplaar. Zie de sectie Start en initialiseer de sectie Opslagemulator verderop in dit artikel voor meer informatie.

De Storage Emulator maakt verbinding met SQL Server of LocalDB via Windows authentication.

Er bestaan enkele verschillen in functionaliteit tussen de opslagemulator en Azure-opslagservices. Zie de sectie Verschillen tussen de opslagemulator en Azure Storage verderop in dit artikel voor meer informatie over deze verschillen.

De opslagemulator starten en initialiseren

De Azure Storage Emulator starten:

1. Selecteer de startknop of druk op de Windows-toets .
2. Begin met typen Azure Storage Emulator.
3. Selecteer de emulator in de lijst met weergegeven toepassingen.

Wanneer de Storage Emulator start, verschijnt er een opdrachtpromptvenster. Gebruik dit consolevenster om de Storage Emulator te starten en te stoppen. U kunt ook gegevens wissen, status ophalen en de emulator initialiseren vanaf de opdrachtprompt. Zie verderop in dit artikel de sectie Naslaginformatie voor het opdrachtregelprogramma van Storage Emulator voor meer informatie.

Wanneer de emulator draait, zie je een pictogram in het Windows-taakbalk-notificatiegebied.

Wanneer je het venster Storage Emulator Command Prompt sluit, blijft de Storage Emulator draaien. Als u het consolevenster van de opslagemulator opnieuw wilt weergeven, volgt u de voorgaande stappen alsof u de opslagemulator start.

De eerste keer dat je de Storage Emulator gebruikt, initialiseert deze de lokale opslagomgeving. Het initialisatieproces maakt een database in LocalDB en reserveert HTTP-poorten voor elke lokale opslagservice.

Het standaard installatiepad voor de Storage Emulator is C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator.

Initialiseer de Storage Emulator om een andere SQL-database te gebruiken

Gebruik de Storage Emulator commandoregeltool om de Storage Emulator te initialiseren zodat deze naar een SQL-databaseinstantie verwijst anders dan de standaard LocalDB-instantie:

1. Open het consolevenster van de opslagemulator zoals beschreven in het gedeelte Start en initialiseer de sectie Opslagemulator .

2. Typ in het consolevenster de volgende opdracht, waarbij <SQLServerInstance> de naam van het SQL Server-exemplaar is. Als u LocalDB wilt gebruiken, geeft u (localdb)\MSSQLLocalDb op als het SQL Server-exemplaar.

   AzureStorageEmulator.exe init /server <SQLServerInstance>

   U kunt ook de volgende opdracht gebruiken, waarmee de emulator het standaard-SQL Server-exemplaar gebruikt:

   AzureStorageEmulator.exe init /server .

   U kunt ook de volgende opdracht gebruiken, waarmee de database wordt geïnitialiseerd naar het standaard LocalDB-exemplaar:

   AzureStorageEmulator.exe init /forceCreate

Zie de naslaginformatie over het opdrachtregelprogramma van Storage Emulator voor meer informatie over deze opdrachten.

Aanvragen verifiëren voor de opslagemulator

Nadat je de Storage Emulator hebt geïnstalleerd en gestart, kun je je code ermee testen. Elke aanvraag die u indient voor de opslagemulator, moet worden geautoriseerd, tenzij het een anonieme aanvraag is. Autoriseer verzoeken tegen de Storage Emulator door gebruik te maken van Shared Key-authenticatie of door een shared access-handtekening (SAS).

Authoriseren met Shared Key-referenties

De emulator ondersteunt één vast account en een bekende verificatiesleutel voor gedeelde sleutelverificatie. Dit account en de sleutel zijn de enige referenties voor gedeelde sleutels die zijn toegestaan voor gebruik met de emulator. Dit zijn:

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

Verbinding maken met het emulatoraccount met behulp van de snelkoppeling

De eenvoudigste manier om vanuit uw toepassing verbinding te maken met de emulator is door een verbindingsreeks te configureren in het configuratiebestand van uw toepassing dat verwijst naar de snelkoppelingUseDevelopmentStorage=true. De snelkoppeling is gelijk aan de volledige verbindingsreeks voor de emulator, waarmee de accountnaam, de accountsleutel en de emulatoreindpunten voor elk van de Azure Storage-services worden opgegeven:

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;

In het volgende .NET-codefragment ziet u hoe u de snelkoppeling kunt gebruiken vanuit een methode die een verbindingsreeks gebruikt. De constructor BlobContainerClient(String, String) neemt bijvoorbeeld een verbindingsreeks.

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

Zorg ervoor dat de emulator wordt uitgevoerd voordat u de code in het codefragment aanroept.

Zie Azure Storage-verbindingsreeks s configureren voor meer informatie over verbindingsreeks s.

Autoriseren met een handtekening voor gedeelde toegang

Je kunt een SAS-token aanmaken door gebruik te maken van Storage Explorer of een andere applicatie die Shared Key-authenticatie ondersteunt.

U kunt ook een SAS-token genereren met behulp van Azure PowerShell. In het volgende voorbeeld wordt een SAS-token met volledige machtigingen voor een blobcontainer gegenereerd:

1. Installeer Azure PowerShell als u dat nog niet hebt gedaan (het gebruik van de nieuwste versie van de Azure PowerShell-cmdlets wordt aanbevolen). Zie Azure PowerShell installeren en configureren voor installatie-instructies.
2. Open Azure PowerShell en voer de volgende opdrachten uit, waarbij u een naam van uw keuze vervangt CONTAINER_NAME :

$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

De resulterende handtekening-URI voor gedeelde toegang voor de nieuwe container moet vergelijkbaar zijn met:

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

De handtekening voor gedeelde toegang die met dit voorbeeld is gemaakt, is één dag geldig. De handtekening verleent volledige toegang (lezen, schrijven, verwijderen, lijst) aan blobs in de container.

Zie Beperkte toegang verlenen tot Azure Storage-resources met behulp van Sas (Shared Access Signatures ) voor meer informatie over handtekeningen voor gedeelde toegang.

Resources in de opslagemulator aanspreken

De service-eindpunten voor de opslagemulator verschillen van de eindpunten voor een Azure-opslagaccount. De lokale computer doet geen domeinnaamresolutie, dus de Storage Emulator-eindpunten zijn lokale adressen.

Wanneer u een resource in een Azure-opslagaccount adresseert, gebruikt u de volgende notatie. De accountnaam maakt deel uit van de hostnaam van de URI en de resource die wordt geadresseerd, maakt deel uit van het URI-pad:

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

De volgende URI is bijvoorbeeld een geldig adres voor een blob in een Azure-opslagaccount:

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

Omdat de lokale computer geen domeinnaamomzetting uitvoert, maakt de accountnaam deel uit van het URI-pad in plaats van de hostnaam. Gebruik de volgende URI-indeling voor een resource in de opslagemulator:

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

Het volgende adres kan bijvoorbeeld worden gebruikt voor toegang tot een blob in de opslagemulator:

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

De service-eindpunten voor de opslagemulator zijn:

• Blobservice: http://127.0.0.1:10000/<account-name>/<resource-path>
• Wachtrijservice: http://127.0.0.1:10001/<account-name>/<resource-path>
• Tafelbediening: http://127.0.0.1:10002/<account-name>/<resource-path>

De secundaire account adresseren met RA-GRS

Vanaf versie 3.1 ondersteunt de Storage Emulator geo-redundante opslag met leestoegang (RA-GRS). Je kunt de secundaire locatie bereiken door aan de accountnaam toe te voegen -secondary . Gebruik bijvoorbeeld het volgende adres om via de secundaire alleen-lezenopslag in de Storage Emulator toegang te krijgen tot een blob:

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

Naslaginformatie over opdrachtregelprogramma's voor opslagemulator

Vanaf versie 3.0 verschijnt er een consolevenster wanneer je de Storage Emulator start. Gebruik de opdrachtregel in het consolevenster om de emulator te starten en te stoppen. Je kunt ook naar status vragen en andere bewerkingen uitvoeren vanuit de opdrachtregel.

Syntaxis van de opdrachtregel

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

Opties

Typ /help bij de opdrachtprompt om een lijst met opties te zien.

Verschillen tussen de opslagemulator en Azure Storage

Omdat de opslagemulator een lokale geëmuleerde omgeving is, zijn er verschillen tussen het gebruik van de emulator en een Azure-opslagaccount in de cloud:

• De opslagemulator ondersteunt slechts één vast account en een bekende verificatiesleutel.
• De opslagemulator is geen schaalbare opslagservice en biedt geen ondersteuning voor een groot aantal gelijktijdige clients.
• Zoals beschreven in Adresseringsbronnen in de opslagemulator, worden resources anders behandeld in de opslagemulator en een Azure-opslagaccount. Het verschil bestaat omdat domeinnaamresolutie beschikbaar is in de cloud, maar niet op de lokale computer.
• Vanaf versie 3.1 ondersteunt het Storage Emulator-account geo-redundante opslag met leestoegang (RA-GRS). In de emulator is RA-GRS ingeschakeld voor alle accounts en is er nooit vertraging tussen de primaire en secundaire replica's. De bewerkingen Get Blob Service Stats, Get Queue Service Stats en Get Table Service Stats worden ondersteund op het secundaire account en geven altijd de waarde van het LastSyncTime antwoordelement terug als de huidige tijd volgens de onderliggende SQL-database.
• De fileservice- en SMB-protocolservice-eindpunten worden momenteel niet ondersteund in de opslagemulator.
• Als je een versie van de opslagservices gebruikt die de emulator niet ondersteunt, geeft de emulator een VersionNotSupportedByEmulator-foutmelding terug (HTTP-statuscode 400 - Bad Request).

Verschillen voor Blob Storage

De volgende verschillen zijn van toepassing op Blob Storage in de emulator:

• De opslagemulator ondersteunt alleen blobgrootten tot 2 GB.
• De maximale lengte van een blobnaam in de opslagemulator is 256 tekens, terwijl de maximale lengte van een blobnaam in Azure Storage 1024 tekens is.
• Met incrementeel kopiëren is het mogelijk momentopnamen van overschreven blobs te kopiëren, waarna de service een fout retourneert.
• Get Page Ranges Diff werkt niet tussen momentopnamen die zijn gekopieerd met behulp van Incremental Copy Blob.
• Een Put Blob-bewerking kan slagen op een blob die in de Storage Emulator bestaat met een actieve lease, zelfs als de lease-ID niet in de aanvraag is opgegeven.
• Toevoeg-blobbewerkingen worden niet ondersteund door de emulator. Een bewerking op een toevoeg-blob retourneert een FeatureNotSupportedByEmulator-fout (HTTP-statuscode 400 - Ongeldige aanvraag).

Verschillen voor Table Storage

De volgende verschillen zijn van toepassing op Table Storage in de emulator:

• Datumeigenschappen in de Tabelservice in de Opslagemulator ondersteunen alleen het bereik dat wordt ondersteund door SQL Server 2005 (deze moeten later zijn dan 1 januari 1753). Alle datums vóór 1 januari 1753 worden gewijzigd in deze waarde. De precisie van datums is beperkt tot de precisie van SQL Server 2005, wat betekent dat datums exact zijn tot 1/300e van een seconde.
• De opslagemulator ondersteunt eigenschapswaarden voor partitiesleutels en rijsleutels van elk minder dan 512 bytes. De totale grootte van de accountnaam, tabelnaam en sleuteleigenschapsnamen mag niet groter zijn dan 900 bytes.
• De totale grootte van een rij in een tabel in de opslagemulator is beperkt tot minder dan 1 MB.
• In de opslagemulator ondersteunen eigenschappen van het gegevenstype Edm.Guid of Edm.Binary alleen de Equal (eq) operatoren en NotEqual (ne) vergelijkingsoperatoren in queryfilterreeksen.

Verschillen voor Queue Storage

Er zijn geen verschillen die specifiek zijn voor Queue Storage in de emulator.

Releaseopmerkingen voor opslagemulator

Versie 5.10

• De opslagemulator weigert versie 2019-07-07 van de opslagservices op blob-, wachtrij- en tabelservice-eindpunten niet.

Versie 5.9

• De Storage Emulator weigert versie 2019-02-02 van de opslagservices op Blob-, Queue- en Table service-eindpunten niet.

Versie 5.8

• De Storage Emulator weigert versie 2018-11-09 van de opslagservices op Blob-, Queue- en Table-service-eindpunten niet.

Versie 5.7

• Een bug opgelost die crasht als loggen is ingeschakeld.

Versie 5.6

• De Storage Emulator ondersteunt versie 2018-03-28 van de opslagservices op de Blob-, Queue- en Table-service-eindpunten.

Versie 5.5

• De Storage Emulator ondersteunt versie 2017-11-09 van de opslagservices op Blob-, Queue- en Table-service-eindpunten.
• Ondersteuning toegevoegd voor de blob Created-eigenschap , die de creatietijd van de blob teruggeeft.

Versie 5.4

• Om de stabiliteit van de installatie te verbeteren, probeert de emulator geen poorten meer te reserveren tijdens de installatie. Als je poortreserveringen wilt, gebruik dan de -reserveports optie van het init-commando om ze aan te geven.

Versie 5.3

• De Storage Emulator ondersteunt versie 2017-07-29 van de opslagservices op Blob-, Queue- en Table-service-eindpunten.

Versie 5.2

• De opslagemulator ondersteunt nu versie 2017-04-17 van de opslagservices op Blob-, Queue- en Table-service-eindpunten.
• Er is een fout opgelost waarbij tabeleigenschapswaarden niet correct werden gecodeerd.

Versie 5.1

• Er is een fout opgelost waarbij de Storage Emulator in sommige reacties de header DataServiceVersion retourneerde, terwijl de service dat niet deed.

Versie 5.0

• Het installatieprogramma van de opslagemulator controleert niet meer op bestaande MSSQL- en .NET Framework-installaties.
• Het installatieprogramma van de opslagemulator maakt de database niet meer als onderdeel van de installatie. De installateur maakt de database nog steeds aan als dat nodig is tijdens het opstarten.
• Het maken van een database vereist geen uitbreiding meer.
• Poortreserveringen zijn niet meer nodig voor het opstarten.
• Voegt de volgende opties toe aan init: -reserveports (vereist uitbreiding), -unreserveports (vereist uitbreiding), -skipcreate.
• De optie 'Storage Emulator UI' in het pictogram in het systeemvak start nu de opdrachtregelinterface. De oude GUI is niet meer beschikbaar.
• Sommige DLL's zijn verwijderd of hernoemd.

Versie 4.6

• De opslagemulator ondersteunt nu versie 2016-05-31 van de opslagservices op blob-, wachtrij- en tabelservice-eindpunten.

Versie 4.5

• Er is een fout opgelost waardoor de installatie en initialisatie mislukken wanneer de naam van de back-updatabase is gewijzigd.

Versie 4.4

• De opslagemulator ondersteunt nu versie 2015-12-11 van de opslagservices op blob-, wachtrij- en tabelservice-eindpunten.
• Het opschonen van blobgegevens door de opslagemulator is nu efficiënter bij het verwerken van grote aantallen blobs.
• Er is een fout opgelost waardoor container-ACL XML enigszins anders werd gevalideerd dan de manier waarop de opslagservice dit doet.
• Er is een fout opgelost waardoor de maximale en minimale datum/tijd-waarden soms werden gerapporteerd in de onjuiste tijdzone.

Versie 4.3

• De opslagemulator ondersteunt nu versie 2015-07-08 van de opslagservices op blob-, wachtrij- en tabelservice-eindpunten.

Versie 4.2

• De opslagemulator ondersteunt nu versie 2015-04-05 van de opslagservices op Blob-, Queue- en Table-service-eindpunten.

Versie 4.1

• De opslagemulator ondersteunt nu versie 2015-02-21 van de opslagservices op Blob-, Queue- en Table-service-eindpunten. Het biedt geen ondersteuning voor de nieuwe toevoeg-blobfuncties.
• De emulator retourneert nu een zinvol foutbericht voor niet-ondersteunde versies van opslagservices. Gebruik de nieuwste versie van de emulator. Als u een VersionNotSupportedByEmulator-fout (HTTP-statuscode 400 - Ongeldige aanvraag) krijgt, downloadt u de nieuwste versie van de emulator.
• Een bug opgelost waarbij een raceconditie ervoor zorgde dat tabelentiteitsgegevens onjuist waren tijdens gelijktijdige samenvoegingsoperaties.

Versie 4.0

• Het uitvoerbare bestand van de opslagemulator is gewijzigd in AzureStorageEmulator.exe.

Versie 3.2

• De opslagemulator ondersteunt nu versie 2014-02-14 van de opslagservices op Blob-, Queue- en Table-service-eindpunten. Bestandsservice-eindpunten worden momenteel niet ondersteund in de opslagemulator. Zie Versiebeheer voor azure Storage Services voor meer informatie over versie 2014-02-14.

Versie 3.1

• De Storage Emulator ondersteunt nu leestoegang voor geo-redundante opslag (RA-GRS). Het ondersteunt de Get Blob Service Stats, Get Queue Service Stats, en Get Table Service Stats API's voor het secundaire account en geeft altijd de waarde van het LastSyncTime responselement terug als de huidige tijd volgens de onderliggende SQL-database. Gebruik de Storage-clientbibliotheek voor .NET versie 3.2 of hoger voor programmatische toegang tot de secundaire locatie met behulp van de Opslagemulator. Voor meer informatie, zie de Azure Storage clientbibliotheken voor .NET.

Versie 3.0

• De Azure Storage Emulator is niet langer inbegrepen in hetzelfde pakket als de compute-emulator.
• De grafische gebruikersinterface van de opslagemulator is afgeschaft. Microsoft verving het door een scriptbare commandoregelinterface. Voor details over de commandoregelinterface, zie Storage Emulator Command-Line Tool Reference. De grafische interface blijft in versie 3.0, maar je kunt er alleen bij komen als de Compute Emulator is geïnstalleerd. Om dit te openen, klik je met de rechtermuisknop op het pictogram in het systeemvak en selecteer je UI van Opslagemulator weergeven.
• De Storage Emulator ondersteunt nu volledig versies 2013-08-15 van de Azure opslagdiensten. (Voorheen werd deze versie alleen ondersteund door Storage Emulator versie 2.2.1 Preview.)

Volgende stappen

• Evalueer het platformoverschrijdende, door de community onderhouden opensource-opslagemulator Azurite.
• Azure Storage-voorbeelden met behulp van .NET bevat koppelingen naar verschillende codevoorbeelden die u kunt gebruiken bij het ontwikkelen van uw toepassing.
• Gebruik de Microsoft Azure Storage Explorer om te werken met resources in je cloud storage-account en in de Storage Emulator.

Zie ook

• Lokale ontwikkeling met Azure Storage, Azurite, Azure SDK's en Azure Storage Explorer