De Azure-opslag emulator gebruiken voor ontwikkelen en testenUse the Azure storage emulator for development and testing

De Microsoft Azure Storage emulator is een hulp programma waarmee de Azure Blob-, wachtrij-en tabel services worden geëmuleerd voor lokale ontwikkelings doeleinden.The Microsoft Azure storage emulator is a tool that emulates the Azure Blob, Queue, and Table services for local development purposes. U kunt uw toepassing lokaal testen op de opslag Services zonder een Azure-abonnement te maken of kosten te betalen.You can test your application against the storage services locally without creating an Azure subscription or incurring any costs. Als u tevreden bent over hoe uw toepassing werkt in de emulator, schakelt u over naar een Azure-opslag account in de Cloud.When you're satisfied with how your application is working in the emulator, switch to using an Azure storage account in the cloud.

De opslag emulator ophalenGet the storage emulator

De opslag emulator is beschikbaar als onderdeel van de Microsoft Azure SDK.The storage emulator is available as part of the Microsoft Azure SDK. U kunt de opslag emulator ook installeren met behulp van het zelfstandige installatie programma (direct downloaden).You can also install the storage emulator by using the standalone installer (direct download). Als u de opslag emulator wilt installeren, moet u beschikken over beheerders bevoegdheden op uw computer.To install the storage emulator, you must have administrative privileges on your computer.

De opslag emulator wordt momenteel alleen uitgevoerd in Windows.The storage emulator currently runs only on Windows. Als u een opslag emulator voor Linux nodig hebt, is een van de opties die door de community worden onderhouden, open-source Storage emulator- Azurite.If you need a storage emulator for Linux, one option is the community maintained, open-source storage emulator Azurite.

Notitie

Gegevens die in één versie van de opslag emulator zijn gemaakt, zijn niet gegarandeerd toegankelijk als u een andere versie gebruikt.Data created in one version of the storage emulator is not guaranteed to be accessible when using a different version. Als u uw gegevens voor de lange termijn wilt behouden, raden we u aan om die gegevens op te slaan in een Azure-opslag account, in plaats van in de-opslag emulator.If you need to persist your data for the long term, we recommended that you store that data in an Azure storage account, rather than in the storage emulator.

De opslag-emulator is afhankelijk van specifieke versies van de OData-bibliotheken.The storage emulator depends on specific versions of the OData libraries. Het vervangen van de OData-Dll's die worden gebruikt door de opslag emulator met andere versies wordt niet ondersteund en kan leiden tot onverwacht gedrag.Replacing the OData DLLs used by the storage emulator with other versions is unsupported, and may cause unexpected behavior. Elk versie van OData dat door de opslag service wordt ondersteund, kan echter worden gebruikt voor het verzenden van aanvragen naar de emulator.However, any version of OData supported by the storage service may be used to send requests to the emulator.

Hoe de opslag emulator werktHow the storage emulator works

De opslag emulator maakt gebruik van een lokaal Microsoft SQL Server 2012 Express LocalDB-exemplaar voor het emuleren van Azure Storage-services.The storage emulator uses a local Microsoft SQL Server 2012 Express LocalDB instance to emulate Azure storage services. U kunt ervoor kiezen om de opslag emulator te configureren voor toegang tot een lokaal exemplaar van SQL Server in plaats van het LocalDB-exemplaar.You can choose to configure the storage emulator to access a local instance of SQL Server instead of the LocalDB instance. Zie de sectie de opslag emulator starten en initialiseren verderop in dit artikel voor meer informatie.See the Start and initialize the storage emulator section later in this article to learn more.

De opslag emulator maakt verbinding met SQL Server of LocalDB met behulp van Windows-verificatie.The storage emulator connects to SQL Server or LocalDB using Windows authentication.

Er zijn enkele verschillen in functionaliteit tussen de opslag-emulator en Azure Storage-services.Some differences in functionality exist between the storage emulator and Azure storage services. Zie het gedeelte verschillen tussen de opslag emulator en de Azure Storage verderop in dit artikel voor meer informatie over deze verschillen.For more information about these differences, see the Differences between the storage emulator and Azure Storage section later in this article.

De opslag emulator starten en initialiserenStart and initialize the storage emulator

De Azure-opslag emulator starten:To start the Azure storage emulator:

  1. Selecteer de knop Start of druk op de Windows -toets.Select the Start button or press the Windows key.
  2. Begin met het typen van Azure Storage Emulator.Begin typing Azure Storage Emulator.
  3. Selecteer de emulator in de lijst met weer gegeven toepassingen.Select the emulator from the list of displayed applications.

Wanneer de opslag-emulator wordt gestart, wordt een opdracht prompt venster weer gegeven.When the storage emulator starts, a Command Prompt window will appear. U kunt dit console venster gebruiken om de opslag emulator te starten en te stoppen.You can use this console window to start and stop the storage emulator. U kunt ook gegevens wissen, status ophalen en de emulator initialiseren vanaf de opdracht prompt.You can also clear data, get status, and initialize the emulator from the command prompt. Zie voor meer informatie de sectie Naslag informatie over het opdracht regel hulpprogramma voor Storage emulator verderop in dit artikel.For more information, see the Storage emulator command-line tool reference section later in this article.

Notitie

De Azure Storage-emulator wordt mogelijk niet correct gestart als er een andere opslag emulator, zoals Azurite, op het systeem wordt uitgevoerd.The Azure storage emulator may not start correctly if another storage emulator, such as Azurite, is running on the system.

Wanneer de emulator wordt gestart, ziet u een pictogram in het systeemvak op de taakbalk van Windows.When the emulator is running, you'll see an icon in the Windows taskbar notification area.

Wanneer u het opdracht prompt venster voor de opslag-emulator sluit, blijft de opslag emulator actief.When you close the storage emulator Command Prompt window, the storage emulator will continue to run. Als u de opslag emulator console opnieuw wilt openen, volgt u de voor gaande stappen als u de opslag emulator start.To bring up the Storage Emulator console window again, follow the preceding steps as if starting the storage emulator.

De eerste keer dat u de opslag emulator uitvoert, wordt de lokale opslag omgeving voor u geïnitialiseerd.The first time you run the storage emulator, the local storage environment is initialized for you. Tijdens het initialisatie proces wordt een Data Base gemaakt in LocalDB en worden de HTTP-poorten voor elke lokale opslag service gereserveerd.The initialization process creates a database in LocalDB and reserves HTTP ports for each local storage service.

De opslag emulator wordt standaard geïnstalleerd op C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator.The storage emulator is installed by default to C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator.

Tip

U kunt de Microsoft Azure Storage Explorer gebruiken om met lokale Storage-emulator bronnen te werken.You can use the Microsoft Azure Storage Explorer to work with local storage emulator resources. Zoek naar ' (emulator-standaard poorten) (sleutel) ' onder ' lokale & gekoppeld ' in de structuur Storage Explorer resources Nadat u de opslag emulator hebt geïnstalleerd en gestart.Look for "(Emulator - Default Ports) (Key)" under "Local & Attached" in the Storage Explorer resources tree after you've installed and started the storage emulator.

Initialiseer de opslag emulator om een andere SQL database te gebruikenInitialize the storage emulator to use a different SQL database

U kunt het opdracht regel programma voor de opslag-emulator gebruiken om de opslag emulator te initialiseren zodat deze verwijst naar een ander SQL database exemplaar dan het standaard LocalDB-exemplaar:You can use the storage emulator command-line tool to initialize the storage emulator to point to a SQL database instance other than the default LocalDB instance:

  1. Open het venster Storage emulator console, zoals beschreven in de sectie de opslag emulator starten en initialiseren .Open the Storage Emulator console window as described in the Start and initialize the storage emulator section.

  2. Typ in het console venster de volgende opdracht, waarbij <SQLServerInstance> de naam van de SQL Server instantie is.In the console window, type the following command, where <SQLServerInstance> is the name of the SQL Server instance. Als u LocalDB wilt gebruiken, geeft u (localdb)\MSSQLLocalDb op als het SQL Server exemplaar.To use LocalDB, specify (localdb)\MSSQLLocalDb as the SQL Server instance.

    AzureStorageEmulator.exe init /server <SQLServerInstance>

    U kunt ook de volgende opdracht gebruiken, waarmee de emulator het standaard SQL Server-exemplaar gebruikt:You can also use the following command, which directs the emulator to use the default SQL Server instance:

    AzureStorageEmulator.exe init /server .

    U kunt ook de volgende opdracht gebruiken, waarmee de data base opnieuw wordt geïnitialiseerd naar het standaard LocalDB-exemplaar:Or, you can use the following command, which reinitializes the database to the default LocalDB instance:

    AzureStorageEmulator.exe init /forceCreate

Zie Naslag informatie over het opdracht regel programma voor opslag-emulatorvoor meer gegevens over deze opdrachten.For more information about these commands, see Storage emulator command-line tool reference.

Tip

U kunt de Microsoft SQL Server Management Studio (SSMS) gebruiken om uw SQL Server exemplaren te beheren, met inbegrip van de LocalDB-installatie.You can use the Microsoft SQL Server Management Studio (SSMS) to manage your SQL Server instances, including the LocalDB installation. Geef in het dialoog venster SMSS verbinding maken met server de (localdb)\MSSQLLocalDb op in het veld Server naam: om verbinding te maken met het LocalDB-exemplaar.In the SMSS Connect to Server dialog, specify (localdb)\MSSQLLocalDb in the Server name: field to connect to the LocalDB instance.

Aanvragen verifiëren op basis van de opslag emulatorAuthenticating requests against the storage emulator

Als u de opslag emulator hebt geïnstalleerd en gestart, kunt u de code hierop testen.Once you've installed and started the storage emulator, you can test your code against it. Elke aanvraag die u voor de opslag emulator maakt, moet worden geautoriseerd, tenzij dit een anonieme aanvraag is.Every request you make against the storage emulator must be authorized, unless it's an anonymous request. U kunt aanvragen voor de opslag emulator machtigen met behulp van gedeelde sleutel verificatie of met een Shared Access Signature (SAS).You can authorize requests against the storage emulator using Shared Key authentication or with a shared access signature (SAS).

Autoriseren met de referenties van de gedeelde sleutelAuthorize with Shared Key credentials

De opslagemulator ondersteunt één vast account en een bekende verificatiesleutel voor gedeelde sleutelverificatie.The storage emulator supports a single fixed account and a well-known authentication key for Shared Key authentication. Dit account en de sleutel zijn de enige gedeelde sleutel-referenties zijn toegestaan voor gebruik met de opslagemulator.This account and key are the only Shared Key credentials permitted for use with the storage emulator. Dit zijn:They are:

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

Notitie

De verificatiesleutel die wordt ondersteund door de opslagemulator is alleen bedoeld voor testen van de functionaliteit van uw client verificatiecode op te geven.The authentication key supported by the storage emulator is intended only for testing the functionality of your client authentication code. Deze worden niet elk doeleinde security dienen.It does not serve any security purpose. U kunt uw productie-opslagaccount en de sleutel niet gebruiken met de opslagemulator.You cannot use your production storage account and key with the storage emulator. U moet het account ontwikkeling niet gebruiken met productiegegevens.You should not use the development account with production data.

De opslagemulator ondersteunt alleen verbindingen via HTTP.The storage emulator supports connection via HTTP only. HTTPS is echter het aanbevolen-protocol voor toegang tot resources in een productie-Azure storage-account.However, HTTPS is the recommended protocol for accessing resources in a production Azure storage account.

Verbinding maken met de emulator-account met behulp van een snelkoppelingConnect to the emulator account using a shortcut

De eenvoudigste manier om verbinding maken met de opslagemulator vanuit uw toepassing is het configureren van een verbindingsreeks in het configuratiebestand van de toepassing die verwijst naar de snelkoppeling naar de UseDevelopmentStorage=true.The easiest way to connect to the storage emulator from your application is to configure a connection string in your application's configuration file that references the shortcut UseDevelopmentStorage=true. Hier volgt een voorbeeld van een verbindingsreeks voor de opslagemulator in een app.config bestand:Here's an example of a connection string to the storage emulator in an app.config file:

<appSettings>
  <add key="StorageConnectionString" value="UseDevelopmentStorage=true" />
</appSettings>

Verbinding maken met de emulator-account met behulp van de bekende accountnaam en -sleutelConnect to the emulator account using the well-known account name and key

Voor het maken van een verbindingsreeks die verwijst naar de emulator accountnaam en sleutel, moet u de eindpunten voor elk van de services die u wilt gebruiken van de emulator in de verbindingsreeks opgeven.To create a connection string that references the emulator account name and key, you must specify the endpoints for each of the services you wish to use from the emulator in the connection string. Dit is nodig zodat de verbindingsreeks verwijst naar de emulator-eindpunten anders dan die voor een productie-storage-account zijn.This is necessary so that the connection string will reference the emulator endpoints, which are different than those for a production storage account. Bijvoorbeeld, er de waarde van de verbindingsreeks als volgt:For example, the value of your connection string will look like this:

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

Deze waarde is gelijk aan de snelkoppeling naar de bovenstaande UseDevelopmentStorage=true.This value is identical to the shortcut shown above, UseDevelopmentStorage=true.

Geef een HTTP-proxySpecify an HTTP proxy

U kunt ook een HTTP-proxy moet worden gebruikt wanneer u bij het testen van uw service op basis van de opslagemulator opgeven.You can also specify an HTTP proxy to use when you're testing your service against the storage emulator. Dit kan nuttig zijn voor de naleving van HTTP-aanvragen en antwoorden tijdens de foutopsporing bewerkingen op de storage-services zijn.This can be useful for observing HTTP requests and responses while you're debugging operations against the storage services. Als u een proxy, voeg de DevelopmentStorageProxyUri optie in als de verbindingstekenreeks en stel de waarde op de proxy-URI.To specify a proxy, add the DevelopmentStorageProxyUri option to the connection string, and set its value to the proxy URI. Dit is bijvoorbeeld een verbindingsreeks die verwijst naar de opslagemulator en configureert u een HTTP-proxy:For example, here is a connection string that points to the storage emulator and configures an HTTP proxy:

UseDevelopmentStorage=true;DevelopmentStorageProxyUri=http://myProxyUri

Zie Azure Storage-verbindings reeksen configurerenvoor meer informatie over verbindings reeksen.For more information on connection strings, see Configure Azure Storage connection strings.

Autoriseren met een hand tekening voor gedeelde toegangAuthorize with a shared access signature

Notitie

Dit artikel is bijgewerkt voor het gebruik van de nieuwe Azure PowerShell Az-module.This article has been updated to use the new Azure PowerShell Az module. De AzureRM-module kan nog worden gebruikt en krijgt bugoplossingen tot ten minste december 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Zie voor meer informatie over de nieuwe Az-module en compatibiliteit met AzureRM Introductie van de nieuwe Az-module van Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Raadpleeg Azure PowerShell installeren voor instructies over de installatie van de Az-module.For Az module installation instructions, see Install Azure PowerShell.

Sommige client bibliotheken van Azure Storage, zoals de Xamarin-bibliotheek, bieden alleen ondersteuning voor verificatie met een SAS-token (Shared Access Signature).Some Azure storage client libraries, such as the Xamarin library, only support authentication with a shared access signature (SAS) token. U kunt het SAS-token maken met behulp van Storage Explorer of een andere toepassing die ondersteuning biedt voor verificatie op basis van gedeelde sleutels.You can create the SAS token using Storage Explorer or another application that supports Shared Key authentication.

U kunt ook een SAS-token genereren met behulp van Azure PowerShell.You can also generate a SAS token by using Azure PowerShell. In het volgende voor beeld wordt een SAS-token met volledige machtigingen voor een BLOB-container gegenereerd:The following example generates a SAS token with full permissions to a blob container:

  1. Installeer Azure PowerShell als u dit nog niet hebt gedaan (gebruik de nieuwste versie van de Azure PowerShell-cmdlets wordt aanbevolen).Install Azure PowerShell if you haven't already (using the latest version of the Azure PowerShell cmdlets is recommended). Zie Azure PowerShell installeren en configurerenvoor installatie-instructies.For installation instructions, see Install and configure Azure PowerShell.
  2. Open Azure PowerShell en voer de volgende opdrachten uit, waarbij u CONTAINER_NAME vervangt door de naam van uw keuze:Open Azure PowerShell and run the following commands, replacing CONTAINER_NAME with a name of your choosing:
$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 URI voor de Shared Access-hand tekening voor de nieuwe container moet er ongeveer als volgt uitzien:The resulting shared access signature URI for the new container should be similar to:

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%2F8MCUhTjrHyV9rDNLSe8g%3Dsss

De gedeelde toegangs handtekening die is gemaakt met dit voor beeld is één dag geldig.The shared access signature created with this example is valid for one day. De hand tekening verleent volledige toegang (lezen, schrijven, verwijderen, lijst) aan blobs in de container.The signature grants full access (read, write, delete, list) to blobs within the container.

Zie voor meer informatie over gedeelde toegangs handtekeningen beperkte toegang verlenen tot Azure storage-resources met behulp van Shared Access signatures (SAS).For more information on shared access signatures, see Grant limited access to Azure Storage resources using shared access signatures (SAS).

Resources adresseren in de opslag emulatorAddressing resources in the storage emulator

De service-eind punten voor de opslag emulator wijken af van de eind punten voor een Azure-opslag account.The service endpoints for the storage emulator are different from the endpoints for an Azure storage account. De lokale computer voert geen domein naam omzetting uit, waardoor de emulator-eind punten van de opslag lokale adressen zijn.The local computer doesn't do domain name resolution, requiring the storage emulator endpoints to be local addresses.

Wanneer u een resource in een Azure-opslag account adresseert, gebruikt u het volgende schema.When you address a resource in an Azure storage account, you use the following scheme. De account naam maakt deel uit van de URI-hostnaam en de bron die wordt geadresseerd, maakt deel uit van het URI-pad:The account name is part of the URI host name, and the resource being addressed is part of the URI path:

<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-opslag account:For example, the following URI is a valid address for a blob in an Azure storage account:

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

Omdat de lokale computer geen domein naam omzetting heeft, maakt de account naam deel uit van het URI-pad in plaats van de naam van de host.Because the local computer doesn't do domain name resolution, the account name is part of the URI path instead of the host name. Gebruik de volgende URI-indeling voor een bron in de-opslag emulator:Use the following URI format for a resource in the storage emulator:

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

Het volgende adres kan bijvoorbeeld worden gebruikt om toegang te krijgen tot een BLOB in de-opslag emulator:For example, the following address might be used for accessing a blob in the storage emulator:

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

De service-eind punten voor de opslag emulator zijn:The service endpoints for the storage emulator are:

  • Blob service: http://127.0.0.1:10000/<account-name>/<resource-path>Blob service: http://127.0.0.1:10000/<account-name>/<resource-path>
  • Queue-service: http://127.0.0.1:10001/<account-name>/<resource-path>Queue service: http://127.0.0.1:10001/<account-name>/<resource-path>
  • Table service: http://127.0.0.1:10002/<account-name>/<resource-path>Table service: http://127.0.0.1:10002/<account-name>/<resource-path>

Adresseren van het account secundair met RA-GRSAddressing the account secondary with RA-GRS

Vanaf versie 3,1 ondersteunt de opslag emulator geo-redundante replicatie met lees toegang (RA-GRS).Beginning with version 3.1, the storage emulator supports read-access geo-redundant replication (RA-GRS). U kunt toegang krijgen tot de secundaire locatie door deze toe te voegen-secundair aan de account naam.You can access the secondary location by appending -secondary to the account name. Het volgende adres kan bijvoorbeeld worden gebruikt voor toegang tot een blob met behulp van de alleen-lezen secundair in de opslag emulator:For example, the following address might be used for accessing a blob using the read-only secondary in the storage emulator:

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

Notitie

Gebruik de Storage-client bibliotheek voor .NET versie 3,2 of hoger voor programmatische toegang tot de secundaire met de opslag emulator.For programmatic access to the secondary with the storage emulator, use the Storage Client Library for .NET version 3.2 or later. Raadpleeg de Microsoft Azure Storage-client bibliotheek voor .net voor meer informatie.See the Microsoft Azure Storage Client Library for .NET for details.

Naslag informatie over het opdracht regel hulpprogramma voor opslag emulatorStorage emulator command-line tool reference

Vanaf versie 3,0 wordt een console venster weer gegeven wanneer u de opslag emulator start.Starting in version 3.0, a console window is displayed when you start the Storage Emulator. Gebruik de opdracht regel in het console venster om de emulator te starten en te stoppen.Use the command line in the console window to start and stop the emulator. U kunt ook een query uitvoeren voor de status en andere bewerkingen uitvoeren vanaf de opdracht regel.You can also query for status and do other operations from the command line.

Notitie

Als u de Microsoft Azure Compute emulator hebt geïnstalleerd, wordt er een pictogram van een systeemvak weer gegeven wanneer u de opslag emulator start.If you have the Microsoft Azure compute emulator installed, a system tray icon appears when you launch the Storage Emulator. Klik met de rechter muisknop op het pictogram om een menu weer te geven dat een grafische manier biedt om de opslag emulator te starten en te stoppen.Right-click on the icon to reveal a menu that provides a graphical way to start and stop the Storage Emulator.

De syntaxis van opdrachtregelCommand-line syntax

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

OptiesOptions

Typ /help bij de opdrachtprompt om een lijst met opties te zien.To view the list of options, type /help at the command prompt.

OptieOption BeschrijvingDescription OpdrachtCommand ArgumentenArguments
BeginnenStart Hiermee wordt de opslag emulator gestart.Starts up the storage emulator. AzureStorageEmulator.exe start [-inprocess] -Opnieuw verwerken: Start de emulator in het huidige proces in plaats van een nieuw proces te maken.-Reprocess: Start the emulator in the current process instead of creating a new process.
TabStop Hiermee stopt u de opslag emulator.Stops the storage emulator. AzureStorageEmulator.exe stop
StatusStatus Hiermee wordt de status van de opslag emulator afgedrukt.Prints the status of the storage emulator. AzureStorageEmulator.exe status
MaakClear Hiermee wist u de gegevens in alle services die zijn opgegeven op de opdracht regel.Clears the data in all services specified on the command line. AzureStorageEmulator.exe clear [blob] [table] [queue] [all] BLOB: verwijdert BLOB-gegevens.blob: Clears blob data.
Queue: Hiermee worden de wachtrij gegevens gewist.queue: Clears queue data.
tabel: tabel gegevens worden gewist.table: Clears table data.
all: Hiermee worden alle gegevens in alle services gewist.all: Clears all data in all services.
InitInit Voert eenmalige initialisatie uit om de emulator in te stellen.Does one-time initialization to set up the emulator. AzureStorageEmulator.exe init [-server serverName] [-sqlinstance instanceName] [-forcecreate|-skipcreate] [-reserveports|-unreserveports] [-inprocess] -Server serverName\instanceName: Hiermee geeft u de server die als host fungeert voor het SQL-exemplaar.-server serverName\instanceName: Specifies the server hosting the SQL instance.
-sqlinstance INSTANCENAME: Hiermee geeft u de naam op van het SQL-exemplaar dat moet worden gebruikt in het standaard Server exemplaar.-sqlinstance instanceName: Specifies the name of the SQL instance to be used in the default server instance.
-forcecreate: Hiermee wordt het maken van de SQL database afgedwongen, zelfs als dit al bestaat.-forcecreate: Forces creation of the SQL database, even if it already exists.
-skipcreate: Hiermee slaat u het maken van de SQL database over.-skipcreate: Skips creation of the SQL database. Dit heeft prioriteit boven-forcecreate.This takes precedence over -forcecreate.
-reserveports: probeert de HTTP-poorten te reserveren die aan de services zijn gekoppeld.-reserveports: Attempts to reserve the HTTP ports associated with the services.
-unreserveports: probeert reserve ringen te verwijderen voor de HTTP-poorten die zijn gekoppeld aan de services.-unreserveports: Attempts to remove reservations for the HTTP ports associated with the services. Dit heeft prioriteit boven-reserveports.This takes precedence over -reserveports.
-inproces: voert de initialisatie uit in het huidige proces in plaats van een nieuw proces te starten.-inprocess: Performs initialization in the current process instead of spawning a new process. Het huidige proces moet worden gestart met verhoogde machtigingen als poort reserveringen worden gewijzigd.The current process must be launched with elevated permissions if changing port reservations.

Verschillen tussen de opslag emulator en het Azure StorageDifferences between the storage emulator and Azure Storage

Omdat de opslag emulator een lokale geëmuleerde omgeving is, zijn er verschillen tussen het gebruik van de emulator en een Azure-opslag account in de Cloud:Because the storage emulator is a local emulated environment, there are differences between using the emulator and an Azure storage account in the cloud:

  • De opslag emulator ondersteunt slechts één vast account en een bekende verificatie sleutel.The storage emulator supports only a single fixed account and a well-known authentication key.
  • De opslag emulator is geen schaal bare opslag service en biedt geen ondersteuning voor een groot aantal gelijktijdige clients.The storage emulator isn't a scalable storage service and doesn't support a large number of concurrent clients.
  • Zoals beschreven in het adresseren van resources in de-opslag emulator, worden bronnen anders behandeld in de-opslag emulator versus een Azure-opslag account.As described in Addressing resources in the storage emulator, resources are addressed differently in the storage emulator versus an Azure storage account. Het verschil is dat het omzetten van de domein naam beschikbaar is in de Cloud, maar niet op de lokale computer.The difference is because domain name resolution is available in the cloud but not on the local computer.
  • Vanaf versie 3,1 ondersteunt het opslag emulator-account geo-redundante replicatie met lees toegang (RA-GRS).Beginning with version 3.1, the storage emulator account supports read-access geo-redundant replication (RA-GRS). In de emulator hebben alle accounts RA-GRS ingeschakeld en is er nooit enige vertraging tussen de primaire en secundaire replica's.In the emulator, all accounts have RA-GRS enabled and there's never any lag between the primary and secondary replicas. De bewerkingen BLOB-service statistieken ophalen, data base service-statistieken ophalen en Data Service statistieken ophalen worden ondersteund voor het account secundair en retour neren altijd de waarde van het element LastSyncTime als het huidige tijdstip volgens de onderliggende SQL database.The Get Blob Service Stats, Get Queue Service Stats, and Get Table Service Stats operations are supported on the account secondary and will always return the value of the LastSyncTime response element as the current time according to the underlying SQL database.
  • De service-eind punten van de bestands service en het SMB-protocol worden momenteel niet ondersteund in de-opslag emulator.The File service and SMB protocol service endpoints aren't currently supported in the storage emulator.
  • Als u een versie van de opslag Services gebruikt die niet wordt ondersteund door de emulator, retourneert de emulator een VersionNotSupportedByEmulator-fout (HTTP-status code 400-ongeldige aanvraag).If you use a version of the storage services that is not supported by the emulator, the emulator returns a VersionNotSupportedByEmulator error (HTTP status code 400 - Bad Request).

Verschillen voor Blob StorageDifferences for Blob storage

De volgende verschillen zijn van toepassing op Blob Storage in de emulator:The following differences apply to Blob storage in the emulator:

  • De opslag emulator ondersteunt alleen BLOB-grootten tot Maxi maal 2 GB.The storage emulator only supports blob sizes up to 2 GB.
  • De maximale lengte van een BLOB-naam in de opslag emulator is 256 tekens, terwijl de maximum lengte van een BLOB-naam in Azure Storage 1024 tekens is.The maximum length of a blob name in the storage emulator is 256 characters, while the maximum length of a blob name in Azure Storage is 1024 characters.
  • Met incrementele kopie kunnen moment opnamen van overschreven blobs worden gekopieerd. dit retourneert een fout bij de service.Incremental copy allows snapshots from overwritten blobs to be copied, which returns a failure on the service.
  • Het ophalen van paginabereiken verschilt niet tussen moment opnamen die zijn gekopieerd met een incrementele Kopieer-blob.Get Page Ranges Diff doesn't work between snapshots copied using Incremental Copy Blob.
  • Een put-BLOB-bewerking kan worden uitgevoerd op een blob die zich in de opslag emulator bevindt met een actieve lease, zelfs als de lease-ID niet is opgegeven in de aanvraag.A Put Blob operation may succeed against a blob that exists in the storage emulator with an active lease even if the lease ID hasn't been specified in the request.
  • Toevoeg-BLOB-bewerkingen worden niet ondersteund door de emulator.Append Blob operations are not supported by the emulator. Als u een bewerking probeert uit te voeren op een toevoeg-blob, wordt een FeatureNotSupportedByEmulator-fout geretourneerd (HTTP-status code 400-ongeldige aanvraag).Attempting an operation on an append blob returns a FeatureNotSupportedByEmulator error (HTTP status code 400 - Bad Request).

Verschillen voor tabel opslagDifferences for Table storage

De volgende verschillen zijn van toepassing op tabel opslag in de emulator:The following differences apply to Table storage in the emulator:

  • De datum eigenschappen in de Table service in de opslag emulator ondersteunen alleen het bereik dat wordt ondersteund door SQL Server 2005 (ze moeten later zijn dan 1 januari 1753).Date properties in the Table service in the storage emulator support only the range supported by SQL Server 2005 (they're required to be later than January 1, 1753). Alle datums vóór 1 januari 1753 worden gewijzigd in deze waarde.All dates before January 1, 1753 are changed to this value. De nauw keurigheid van datums is beperkt tot de nauw keurigheid van SQL Server 2005, wat betekent dat datums nauw keurig zijn tot 1/300th van een seconde.The precision of dates is limited to the precision of SQL Server 2005, meaning that dates are precise to 1/300th of a second.
  • De opslag emulator ondersteunt waarden van de eigenschappen van de partitie sleutel en de rijwaarden van minder dan 512 bytes.The storage emulator supports partition key and row key property values of less than 512 bytes each. De totale grootte van de account naam, de tabel naam en de naam van de sleutel eigenschap kan niet groter zijn dan 900 bytes.The total size of the account name, table name, and key property names together can't exceed 900 bytes.
  • De totale grootte van een rij in een tabel in de opslag emulator is beperkt tot minder dan 1 MB.The total size of a row in a table in the storage emulator is limited to less than 1 MB.
  • In de-opslag emulator worden eigenschappen van het gegevens type Edm.Guid of Edm.Binary alleen ondersteund door de Opera tors Equal (eq) en NotEqual (ne) in query filter-teken reeksen.In the storage emulator, properties of data type Edm.Guid or Edm.Binary support only the Equal (eq) and NotEqual (ne) comparison operators in query filter strings.

Verschillen voor wachtrij opslagDifferences for Queue storage

Er zijn geen verschillen die specifiek zijn voor de wachtrij opslag in de emulator.There are no differences specific to Queue storage in the emulator.

Release opmerkingen bij de opslag-emulatorStorage emulator release notes

Versie 5,10Version 5.10

  • De opslag emulator weigert versie 2019-07-07 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator won't reject version 2019-07-07 of the storage services on Blob, Queue, and Table service endpoints.

Versie 5,9Version 5.9

  • De opslag emulator weigert versie 2019-02-02 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator won't reject version 2019-02-02 of the storage services on Blob, Queue, and Table service endpoints.

Versie 5,8Version 5.8

  • De opslag emulator weigert versie 2018-11-09 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator won't reject version 2018-11-09 of the storage services on Blob, Queue, and Table service endpoints.

Versie 5,7Version 5.7

  • Er is een fout opgelost die kan leiden tot een storing als logboek registratie is ingeschakeld.Fixed a bug that would cause a crash if logging was enabled.

Versie 5,6Version 5.6

  • De opslag emulator ondersteunt nu versie 2018-03-28 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2018-03-28 of the storage services on Blob, Queue, and Table service endpoints.

Versie 5,5Version 5.5

  • De opslag emulator ondersteunt nu versie 2017-11-09 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2017-11-09 of the storage services on Blob, Queue, and Table service endpoints.
  • Er is ondersteuning toegevoegd voor de eigenschap created blob, waarmee de aanmaak tijd van de BLOB wordt geretourneerd.Support has been added for the blob Created property, which returns the blob's creation time.

Versie 5,4Version 5.4

  • Ter verbetering van de stabiliteit van de installatie probeert de emulator niet langer poorten te reserveren tijdens de installatie.To improve installation stability, the emulator no longer attempts to reserve ports at install time. Als u poort reserveringen wilt, gebruikt u de optie -reserveports van de opdracht init om deze op te geven.If you want port reservations, use the -reserveports option of the init command to specify them.

Versie 5,3Version 5.3

  • De opslag emulator ondersteunt nu versie 2017-07-29 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2017-07-29 of the storage services on Blob, Queue, and Table service endpoints.

Versie 5,2Version 5.2

  • De opslag emulator ondersteunt nu versie 2017-04-17 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2017-04-17 of the storage services on Blob, Queue, and Table service endpoints.
  • Er is een fout opgelost waarbij tabel eigenschaps waarden niet goed worden gecodeerd.Fixed a bug where table property values weren't being properly encoded.

Versie 5,1Version 5.1

  • Er is een fout opgelost waarbij de opslag emulator de DataServiceVersion-header retourneert in sommige antwoorden waarbij de service niet is.Fixed a bug where the storage emulator was returning the DataServiceVersion header in some responses where the service was not.

Versie 5,0Version 5.0

  • Het installatie programma voor de opslag emulator controleert niet meer op bestaande MSSQL-en .NET Framework-installaties.The storage emulator installer no longer checks for existing MSSQL and .NET Framework installs.
  • Het installatie programma voor de opslag emulator maakt de data base niet meer als onderdeel van de installatie.The storage emulator installer no longer creates the database as part of install. De data base wordt, indien nodig, nog steeds gemaakt als onderdeel van het opstarten.Database will still be created if needed as part of startup.
  • Voor het maken van de data base is geen uitbrei ding meer nodig.Database creation no longer requires elevation.
  • Poort reserveringen zijn niet meer nodig om te worden opgestart.Port reservations are no longer needed for startup.
  • Voegt de volgende opties toe aan init: -reserveports (vereist uitbrei ding), -unreserveports (vereist uitbrei ding), -skipcreate.Adds the following options to init: -reserveports (requires elevation), -unreserveports (requires elevation), -skipcreate.
  • Met de optie voor de gebruikers interface van de opslag emulator op het pictogram van het systeemvak wordt nu de opdracht regel interface gestart.The Storage Emulator UI option on the system tray icon now launches the command-line interface. De oude gebruikers interface is niet meer beschikbaar.The old GUI is no longer available.
  • Sommige Dll's zijn verwijderd of de naam ervan is gewijzigd.Some DLLs have been removed or renamed.

Versie 4,6Version 4.6

  • De opslag emulator ondersteunt nu versie 2016-05-31 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2016-05-31 of the storage services on Blob, Queue, and Table service endpoints.

Versie 4,5Version 4.5

  • Er is een fout opgelost die ertoe heeft geleid dat de installatie en initialisatie mislukt wanneer de naam van de back-up van de data base wordt gewijzigd.Fixed a bug that caused installation and initialization to fail when the backing database is renamed.

Versie 4,4Version 4.4

  • De opslag emulator ondersteunt nu versie 2015-12-11 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2015-12-11 of the storage services on Blob, Queue, and Table service endpoints.
  • De garbage collection van de opslag emulator van BLOB-gegevens is nu efficiënter bij het omgaan met een groot aantal blobs.The storage emulator's garbage collection of blob data is now more efficient when dealing with large numbers of blobs.
  • Er is een fout opgelost waardoor de XML van de container-ACL iets anders kan worden gevalideerd dan hoe de opslag service dit doet.Fixed a bug that caused container ACL XML to be validated slightly differently from how the storage service does it.
  • Er is een fout opgelost die soms de maximale en minimale datum/tijd-waarden in de verkeerde tijd zone heeft veroorzaakt.Fixed a bug that sometimes caused max and min DateTime values to be reported in the incorrect time zone.

Versie 4,3Version 4.3

  • De opslag emulator ondersteunt nu versie 2015-07-08 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2015-07-08 of the storage services on Blob, Queue, and Table service endpoints.

Versie 4,2Version 4.2

  • De opslag emulator ondersteunt nu versie 2015-04-05 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2015-04-05 of the storage services on Blob, Queue, and Table service endpoints.

Versie 4,1Version 4.1

  • De opslag emulator ondersteunt nu versie 2015-02-21 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2015-02-21 of the storage services on Blob, Queue, and Table service endpoints. De nieuwe toevoeg-BLOB-functies worden niet ondersteund.It doesn't support the new Append Blob features.
  • De emulator retourneert nu een zinvolle fout melding voor niet-ondersteunde versies van opslag Services.The emulator now returns a meaningful error message for unsupported versions of storage services. U kunt het beste de nieuwste versie van de emulator gebruiken.We recommend using the latest version of the emulator. Als u een VersionNotSupportedByEmulator-fout krijgt (HTTP-status code 400-ongeldige aanvraag), downloadt u de nieuwste versie van de emulator.If you get a VersionNotSupportedByEmulator error (HTTP status code 400 - Bad Request), download the latest version of the emulator.
  • Er is een probleem opgelost waarbij een race condition heeft geleid tot onjuiste tabel entiteit gegevens tijdens gelijktijdige samenvoeg bewerkingen.Fixed a bug wherein a race condition caused table entity data to be incorrect during concurrent merge operations.

Versie 4,0Version 4.0

  • De naam van het uitvoer bare bestand van de opslag-emulator is gewijzigd in AzureStorageEmulator. exe.The storage emulator executable has been renamed to AzureStorageEmulator.exe.

Versie 3,2Version 3.2

  • De opslag emulator ondersteunt nu versie 2014-02-14 van de opslag Services op blob-, wachtrij-en Table service-eind punten.The storage emulator now supports version 2014-02-14 of the storage services on Blob, Queue, and Table service endpoints. Bestands service-eind punten worden momenteel niet ondersteund in de-opslag emulator.File service endpoints aren't currently supported in the storage emulator. Zie versie beheer voor de Azure Storage-services voor meer informatie over versie 2014-02-14.See Versioning for the Azure Storage Services for details about version 2014-02-14.

Versie 3,1Version 3.1

  • Geografisch redundante opslag met lees toegang (RA-GRS) wordt nu ondersteund in de-opslag emulator.Read-access geo-redundant storage (RA-GRS) is now supported in the storage emulator. De Api's Get Blob Service Stats, Get Queue Service Stats en Get Table Service Stats worden ondersteund voor het account secundair en retour neren altijd de waarde van het LastSyncTime-antwoord element als de huidige tijd volgens de onderliggende SQL database.The Get Blob Service Stats, Get Queue Service Stats, and Get Table Service Stats APIs are supported for the account secondary and will always return the value of the LastSyncTime response element as the current time according to the underlying SQL database. Gebruik de Storage-client bibliotheek voor .NET versie 3,2 of hoger voor programmatische toegang tot de secundaire met de opslag emulator.For programmatic access to the secondary with the storage emulator, use the Storage Client Library for .NET version 3.2 or later. Zie de Microsoft Azure Storage-client bibliotheek voor .NET-referentie voor meer informatie.See the Microsoft Azure Storage Client Library for .NET Reference for details.

Versie 3,0Version 3.0

  • De Azure-opslag emulator wordt niet meer in hetzelfde pakket geleverd als de compute-emulator.The Azure storage emulator is no longer shipped in the same package as the compute emulator.
  • De Graphical User Interface van de opslag-emulator is afgeschaft.The storage emulator graphical user interface is deprecated. Het is vervangen door een script bare opdracht regel interface.It has been replaced by a scriptable command-line interface. Zie voor meer informatie over de opdracht regel interface Naslag informatie over het opdracht regel hulpprogramma van Storage emulator.For details on the command-line interface, see Storage Emulator Command-Line Tool Reference. De grafische interface blijft aanwezig in versie 3,0, maar kan alleen worden geopend wanneer de compute emulator wordt geïnstalleerd door met de rechter muisknop op het pictogram van het systeemvak te klikken en de gebruikers interface van de opslag emulator weer geven te selecteren.The graphical interface will continue to be present in version 3.0, but it can only be accessed when the Compute Emulator is installed by right-clicking on the system tray icon and selecting Show Storage Emulator UI.
  • Versie 2013-08-15 van de Azure Storage-services wordt nu volledig ondersteund.Version 2013-08-15 of the Azure storage services is now fully supported. (Eerder deze versie werd alleen ondersteund door de preview-versie van de opslag emulator.)(Previously this version was only supported by Storage Emulator version 2.2.1 Preview.)

Volgende stappenNext steps