Az Azure Storage Emulator használata fejlesztéshez és teszteléshezUse the Azure Storage Emulator for development and testing

A Microsoft Azure Storage Emulator egy olyan eszköz, amely az Azure Blob-, üzenetsor-és Table Services-t emulálja helyi fejlesztési célokra.The Microsoft Azure Storage Emulator is a tool that emulates the Azure Blob, Queue, and Table services for local development purposes. Az alkalmazást helyileg tesztelheti az Azure-előfizetés létrehozása vagy a költségek felmerülése nélkül.You can test your application against the storage services locally without creating an Azure subscription or incurring any costs. Ha meggyőződött arról, hogy az alkalmazás hogyan működik az emulátorban, váltson egy Azure Storage-fiók használatára a felhőben.When you're satisfied with how your application is working in the emulator, switch to using an Azure storage account in the cloud.

Fontos

Az Azure Storage-emulátor már nincs aktívan kifejlesztve.The Azure Storage Emulator is no longer being actively developed. A Azurite a Storage Emulator platform tovább tart.Azurite is the Storage Emulator platform going forward. A Azurite felülírja az Azure Storage-emulátort.Azurite supersedes the Azure Storage Emulator. A Azurite továbbra is frissülni fog az Azure Storage API-k legújabb verzióinak támogatásához.Azurite will continue to be updated to support the latest versions of Azure Storage APIs. További információ: a Azurite Emulator használata a helyi Azure Storage-fejlesztéshez.For more information, see Use the Azurite emulator for local Azure Storage development.

A Storage Emulator beszerzéseGet the Storage Emulator

A Storage Emulator a Microsoft Azure SDKrészeként érhető el.The Storage Emulator is available as part of the Microsoft Azure SDK. A Storage Emulatort a különálló telepítő (közvetlen letöltés) használatával is telepítheti.You can also install the Storage Emulator by using the standalone installer (direct download). A Storage Emulator telepítéséhez rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.To install the Storage Emulator, you must have administrative privileges on your computer.

A Storage Emulator jelenleg csak Windows rendszeren fut.The Storage Emulator currently runs only on Windows. Ha a Linux rendszerhez készült Storage Emulatorra van szüksége, az egyik lehetőség a Közösség által karbantartott, nyílt forráskódú Storage Emulator- Azurite.If you need a Storage Emulator for Linux, one option is the community maintained, open-source Storage Emulator Azurite.

Megjegyzés

A Storage Emulator egyik verziójában létrehozott adatmennyiség nem garantált, hogy más verzió használata esetén nem érhető el.Data created in one version of the Storage Emulator is not guaranteed to be accessible when using a different version. Ha hosszú távon is meg kell őriznie az adatait, javasoljuk, hogy az adatait egy Azure Storage-fiókban tárolja, nem pedig a Storage Emulatorban.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.

A Storage Emulator a OData-kódtárak adott verzióitól függ.The Storage Emulator depends on specific versions of the OData libraries. A Storage Emulator által más verziókkal használt OData DLL-ek nem támogatottak, és nem várt viselkedést okozhatnak.Replacing the OData DLLs used by the Storage Emulator with other versions is unsupported, and may cause unexpected behavior. A tárolási szolgáltatás által támogatott bármely OData azonban a kérelmeknek az emulátorba való küldésére is használható.However, any version of OData supported by the storage service may be used to send requests to the emulator.

A Storage Emulator működéseHow the storage emulator works

A Storage Emulator egy helyi Microsoft SQL Server 2012 Express LocalDB-példányt használ az Azure Storage-szolgáltatások emulálása érdekében.The Storage Emulator uses a local Microsoft SQL Server 2012 Express LocalDB instance to emulate Azure storage services. Beállíthatja, hogy a Storage Emulator a LocalDB-példány helyett SQL Server helyi példányához férhessen hozzá.You can choose to configure the Storage Emulator to access a local instance of SQL Server instead of the LocalDB instance. További információkért tekintse meg a Storage Emulator elindítása és inicializálása című szakaszt a cikk későbbi részében.See the Start and initialize the Storage Emulator section later in this article to learn more.

A Storage Emulator a Windows-hitelesítés használatával csatlakozik SQL Serverhoz vagy LocalDB.The Storage Emulator connects to SQL Server or LocalDB using Windows authentication.

A Storage Emulator és az Azure Storage szolgáltatás között számos funkció létezik.Some differences in functionality exist between the Storage Emulator and Azure storage services. További információ ezekről a különbségekről: a Storage Emulator és az Azure Storage közötti különbségek a jelen cikk későbbi részében.For more information about these differences, see the Differences between the Storage Emulator and Azure Storage section later in this article.

A Storage Emulator elindítása és inicializálásaStart and initialize the Storage Emulator

Az Azure Storage Emulator elindítása:To start the Azure Storage Emulator:

  1. Kattintson a Start gombra, vagy nyomja le a Windows billentyűt.Select the Start button or press the Windows key.
  2. Kezdjen el gépelni Azure Storage Emulator .Begin typing Azure Storage Emulator.
  3. Válassza ki az emulátort a megjelenített alkalmazások listájából.Select the emulator from the list of displayed applications.

A Storage Emulator indításakor megjelenik egy parancssori ablak.When the Storage Emulator starts, a Command Prompt window will appear. A konzol ablakával elindíthatja és leállíthatja a Storage-emulátort.You can use this console window to start and stop the Storage Emulator. Törölheti is az adatok, az állapot lekérése és az emulátor inicializálását a parancssorból.You can also clear data, get status, and initialize the emulator from the command prompt. További információt a cikk későbbi, a Storage Emulator parancssori eszközének ismertetése című szakaszában talál.For more information, see the Storage Emulator command-line tool reference section later in this article.

Megjegyzés

Előfordulhat, hogy az Azure Storage-emulátor nem indul el megfelelően, ha egy másik tároló-emulátor, például a Azurite fut a rendszeren.The Azure Storage Emulator may not start correctly if another storage emulator, such as Azurite, is running on the system.

Amikor fut az emulátor, egy ikont lát a Windows tálca értesítési területén.When the emulator is running, you'll see an icon in the Windows taskbar notification area.

A Storage Emulator parancssori ablakának bezárását követően a Storage Emulator továbbra is futni fog.When you close the Storage Emulator Command Prompt window, the Storage Emulator will continue to run. A Storage Emulator Console ablak újbóli létrehozásához kövesse az előző lépéseket a Storage Emulator elindítása után.To bring up the Storage Emulator console window again, follow the preceding steps as if starting the Storage Emulator.

Amikor első alkalommal futtatja a Storage Emulatort, a helyi tárolási környezet inicializálva lesz.The first time you run the Storage Emulator, the local storage environment is initialized for you. Az inicializálási folyamat létrehoz egy adatbázist a LocalDB-ben, és minden helyi tárolási szolgáltatáshoz fenntart HTTP-portokat.The initialization process creates a database in LocalDB and reserves HTTP ports for each local storage service.

A Storage Emulator alapértelmezés szerint telepítve van 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.

Tipp

A Microsoft Azure Storage Explorer használatával dolgozhat a helyi tároló-emulátor erőforrásaival.You can use the Microsoft Azure Storage Explorer to work with local Storage Emulator resources. Miután telepítette és elindította a Storage Emulatort, keresse meg a "(Emulator-default ports) (kulcs)" lehetőséget a Storage Explorer erőforrások fájában a "helyi & csatolt" alatt.Look for "(Emulator - Default Ports) (Key)" under "Local & Attached" in the Storage Explorer resources tree after you've installed and started the Storage Emulator.

A Storage Emulator inicializálása másik SQL-adatbázis használatáraInitialize the storage Emulator to use a different SQL database

A Storage Emulator parancssori eszköz használatával inicializálhatja a Storage-emulátort úgy, hogy az az alapértelmezett LocalDB-példánytól eltérő SQL Database-példányra mutasson: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. Nyissa meg a Storage Emulator Console ablakot a Storage Emulator elindítása és inicializálása című szakaszban leírtak szerint.Open the Storage Emulator console window as described in the Start and initialize the Storage Emulator section.

  2. A konzol ablakban írja be a következő parancsot, ahol a a <SQLServerInstance> SQL Server példány neve.In the console window, type the following command, where <SQLServerInstance> is the name of the SQL Server instance. A LocalDB használatához (localdb)\MSSQLLocalDb a SQL Server példányként kell megadnia.To use LocalDB, specify (localdb)\MSSQLLocalDb as the SQL Server instance.

    AzureStorageEmulator.exe init /server <SQLServerInstance>

    A következő parancsot is használhatja, amely az emulátort az alapértelmezett SQL Server példány használatára irányítja:You can also use the following command, which directs the emulator to use the default SQL Server instance:

    AzureStorageEmulator.exe init /server .

    Vagy használhatja a következő parancsot is, amely inicializálja az adatbázist az alapértelmezett LocalDB-példányra:Or, you can use the following command, which initializes the database to the default LocalDB instance:

    AzureStorageEmulator.exe init /forceCreate

További információt ezekről a parancsokról a Storage Emulator parancssori eszköz dokumentációjábantalál.For more information about these commands, see Storage Emulator command-line tool reference.

Tipp

A Microsoft SQL Server Management Studio (SSMS) használatával kezelheti SQL Server példányait, beleértve a LocalDB telepítését is.You can use the Microsoft SQL Server Management Studio (SSMS) to manage your SQL Server instances, including the LocalDB installation. Az SMS- kapcsolat a kiszolgálóhoz párbeszédpanelen adja meg (localdb)\MSSQLLocalDb a kiszolgáló neve: mezőben, hogy csatlakozhasson a LocalDB-példányhoz.In the SMSS Connect to Server dialog, specify (localdb)\MSSQLLocalDb in the Server name: field to connect to the LocalDB instance.

Kérelmek hitelesítése a Storage Emulator használatávalAuthenticating requests against the Storage Emulator

Miután telepítette és elindította a Storage Emulatort, tesztelheti a kódját.Once you've installed and started the Storage Emulator, you can test your code against it. A Storage-emulátoron végzett minden kérést engedélyezni kell, kivéve, ha névtelen kérést használ.Every request you make against the Storage Emulator must be authorized, unless it's an anonymous request. Engedélyezheti a kérelmeket a Storage-emulátoron megosztott kulcsos hitelesítéssel vagy közös hozzáférésű aláírással (SAS).You can authorize requests against the Storage Emulator using Shared Key authentication or with a shared access signature (SAS).

Hitelesítés megosztott kulcsú hitelesítő adatokkalAuthorize with Shared Key credentials

A Azurite egyetlen rögzített fiókot és egy jól ismert hitelesítési kulcsot támogat a megosztott kulcsos hitelesítéshez.Azurite supports a single fixed account and a well-known authentication key for Shared Key authentication. Ez a fiók és a kulcs az egyetlen megosztott kulcs hitelesítő adatai, amelyek használata engedélyezett a Azurite.This account and key are the only Shared Key credentials permitted for use with Azurite. Ezek a következők:They are:

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

Megjegyzés

A Azurite által támogatott hitelesítési kulcs kizárólag az ügyfél-hitelesítési kód működésének tesztelésére szolgál.The authentication key supported by Azurite is intended only for testing the functionality of your client authentication code. Nem szolgál biztonsági céllal.It does not serve any security purpose. Az üzemi Storage-fiók és a kulcs nem használható a Azurite.You cannot use your production storage account and key with Azurite. A fejlesztési fiókot ne használja éles adatszolgáltatással.You should not use the development account with production data.

A Azurite csak HTTP-n keresztül támogatja a kapcsolatokat.Azurite supports connection via HTTP only. Azonban a HTTPS az a javasolt protokoll, amellyel a termelési Azure Storage-fiók erőforrásaihoz férhet hozzá.However, HTTPS is the recommended protocol for accessing resources in a production Azure storage account.

Kapcsolódás az Emulator-fiókhoz parancsikon használatávalConnect to the emulator account using a shortcut

Az alkalmazás Azurite való csatlakoztatásának legegyszerűbb módja egy kapcsolati karakterlánc konfigurálása az alkalmazás konfigurációs fájljában, amely hivatkozik a parancsikonra UseDevelopmentStorage=true .The easiest way to connect to Azurite from your application is to configure a connection string in your application's configuration file that references the shortcut UseDevelopmentStorage=true. Az alábbi példa egy app.config fájlban Azurite kapcsolódási sztringet mutat be:Here's an example of a connection string to Azurite in an app.config file:

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

Kapcsolódjon az Emulator-fiókhoz a jól ismert fiók neve és kulcsa alapjánConnect to the emulator account using the well-known account name and key

Az Emulator-fiók nevére és kulcsára hivatkozó kapcsolódási karakterlánc létrehozásához meg kell adnia a végpontokat minden olyan szolgáltatáshoz, amelyet az emulátorban szeretne használni a kapcsolódási karakterláncban.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. Erre azért van szükség, hogy a kapcsolatok karakterlánca hivatkozzon az emulátor végpontokra, amelyek nem azonosak egy éles tárolóeszköz-fiókkal.This is necessary so that the connection string will reference the emulator endpoints, which are different than those for a production storage account. Például a következőhöz hasonló módon fog kinézni a kapcsolatok karakterláncának értéke: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;
QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;

Ez az érték megegyezik a fent látható parancsikonnal UseDevelopmentStorage=true .This value is identical to the shortcut shown above, UseDevelopmentStorage=true.

További információ a kapcsolatok sztringekről: az Azure Storage-beli kapcsolatok karakterláncának konfigurálása.For more information on connection strings, see Configure Azure Storage connection strings.

Hitelesítés közös hozzáférésű aláírássalAuthorize with a shared access signature

Megjegyzés

A cikk frissítve lett az Azure PowerShell új Az moduljának használatával.This article has been updated to use the new Azure PowerShell Az module. Dönthet úgy is, hogy az AzureRM modult használja, amely továbbra is megkapja a hibajavításokat, legalább 2020 decemberéig.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Ha többet is meg szeretne tudni az új Az modul és az AzureRM kompatibilitásáról, olvassa el az Azure PowerShell új Az moduljának ismertetését.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az Az modul telepítési útmutatását az Azure PowerShell telepítését ismertető cikkben találja.For Az module installation instructions, see Install Azure PowerShell.

Néhány Azure Storage-ügyfél kódtára, például a Xamarin-könyvtár, csak a közös hozzáférésű aláírás (SAS) jogkivonatával történő hitelesítést támogatja.Some Azure storage client libraries, such as the Xamarin library, only support authentication with a shared access signature (SAS) token. Az SAS-tokent Storage Explorer vagy egy másik olyan alkalmazás használatával is létrehozhatja, amely támogatja a megosztott kulcsos hitelesítést.You can create the SAS token using Storage Explorer or another application that supports Shared Key authentication.

A Azure PowerShell használatával is létrehozhat SAS-tokent.You can also generate a SAS token by using Azure PowerShell. Az alábbi példa egy blob-tárolóra vonatkozó teljes körű engedélyekkel rendelkező SAS-tokent hoz létre:The following example generates a SAS token with full permissions to a blob container:

  1. Azure PowerShell telepítése, ha még nem tette meg (az Azure PowerShell-parancsmagok legújabb verziójának használata ajánlott).Install Azure PowerShell if you haven't already (using the latest version of the Azure PowerShell cmdlets is recommended). A telepítési utasításokért lásd: Azure PowerShell telepítése és konfigurálása.For installation instructions, see Install and configure Azure PowerShell.
  2. Nyissa meg Azure PowerShell és futtassa a következő parancsokat, és cserélje CONTAINER_NAME le a nevet a választott névre: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

Az új tárolóhoz tartozó, közös hozzáférésű aláírás URI-azonosítójának a következőhöz hasonlónak kell lennie: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

Az ezzel a példával létrehozott megosztott elérési aláírás egy napig érvényes.The shared access signature created with this example is valid for one day. Az aláírás teljes hozzáférést biztosít (olvasási, írási, törlési, listázási) a tárolóban lévő blobokhoz.The signature grants full access (read, write, delete, list) to blobs within the container.

A közös hozzáférésű aláírásokkal kapcsolatos további információkért lásd: korlátozott hozzáférés engedélyezése az Azure Storage-erőforrásokhoz közös hozzáférésű aláírások (SAS) használatával.For more information on shared access signatures, see Grant limited access to Azure Storage resources using shared access signatures (SAS).

Erőforrások kezelése a Storage EmulatorbanAddressing resources in the Storage Emulator

A Storage Emulator szolgáltatási végpontok eltérnek az Azure Storage-fiókok végpontjaitól.The service endpoints for the Storage Emulator are different from the endpoints for an Azure storage account. A helyi számítógép nem hajtja végre a tartománynevek feloldását, ami megköveteli, hogy a Storage Emulator-végpontok helyi címek legyenek.The local computer doesn't do domain name resolution, requiring the Storage Emulator endpoints to be local addresses.

Amikor egy Azure Storage-fiókban kezel egy erőforrást, a következő sémát kell használnia.When you address a resource in an Azure storage account, you use the following scheme. A fiók neve az URI-állomásnév része, és a címzett erőforrás az URI elérési útja része: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>

A következő URI például egy Azure Storage-fiókban található blob érvényes címe: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

Mivel a helyi számítógép nem hajtja végre a tartománynevek feloldását, a fiók neve az URI elérési útja része az állomásnév helyett.Because the local computer doesn't do domain name resolution, the account name is part of the URI path instead of the host name. Használja a következő URI-formátumot egy erőforráshoz a Storage Emulatorban:Use the following URI format for a resource in the Storage Emulator:

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

Például a következő címről lehet hozzáférni egy blobhoz a Storage Emulatorban: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

A Storage Emulator szolgáltatás-végpontok a következők: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 szolgáltatás: 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>

Másodlagos fiók kezelése RA-GRSAddressing the account secondary with RA-GRS

A 3,1-es verziótól kezdődően a Storage Emulator támogatja az olvasási hozzáférésű geo-redundáns replikálást (RA-GRS).Beginning with version 3.1, the Storage Emulator supports read-access geo-redundant replication (RA-GRS). A másodlagos helyet a fióknév hozzáfűzésével érheti el.You can access the secondary location by appending -secondary to the account name. Például a következő címről lehet hozzáférni egy blobhoz a Storage Emulator írásvédett másodlagos funkciójával: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

Megjegyzés

A másodlagos és a Storage-emulátor programozott eléréséhez használja a Storage ügyféloldali kódtárat a .NET 3,2-es vagy újabb verziójához.For programmatic access to the secondary with the Storage Emulator, use the Storage Client Library for .NET version 3.2 or later. További részletekért tekintse meg a .net-hez készült ügyféloldali kódtár Microsoft Azure Storage .See the Microsoft Azure Storage Client Library for .NET for details.

A Storage Emulator parancssori eszközének dokumentációjaStorage Emulator command-line tool reference

Az 3,0-es verziótól kezdődően a rendszer a Storage Emulator indításakor megjeleníti a konzol ablakát.Starting in version 3.0, a console window is displayed when you start the Storage Emulator. Az emulátor elindításához és leállításához használja a konzol ablakának parancssorát.Use the command line in the console window to start and stop the emulator. Lekérdezheti az állapotot, és egyéb műveleteket is végrehajthat a parancssorból.You can also query for status and do other operations from the command line.

Megjegyzés

Ha telepítve van a Microsoft Azure Compute Emulator, a Storage Emulator indításakor megjelenik egy rendszertálca ikon.If you have the Microsoft Azure compute emulator installed, a system tray icon appears when you launch the Storage Emulator. Kattintson a jobb gombbal az ikonra egy olyan menü megjelenítéséhez, amely grafikus módot biztosít a tároló-emulátor elindításához és leállításához.Right-click on the icon to reveal a menu that provides a graphical way to start and stop the Storage Emulator.

Parancssori szintaxisCommand-line syntax

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

BeállításokOptions

A beállítások listájának megtekintéséhez írja be a /help parancsot a parancssorba.To view the list of options, type /help at the command prompt.

BeállításOption LeírásDescription ParancsCommand ArgumentumokArguments
KezdésStart Elindítja a Storage Emulatort.Starts up the Storage Emulator. AzureStorageEmulator.exe start [-inprocess] -Újrafeldolgozás : indítsa el az emulátort az aktuális folyamatban az új folyamat létrehozása helyett.-Reprocess : Start the emulator in the current process instead of creating a new process.
LeállításStop Leállítja a Storage-emulátort.Stops the Storage Emulator. AzureStorageEmulator.exe stop
ÁllapotStatus A Storage Emulator állapotának kinyomtatása.Prints the status of the Storage Emulator. AzureStorageEmulator.exe status
TörlésClear Törli a parancssorban megadott összes szolgáltatásban lévő összes értéket.Clears the data in all services specified on the command line. AzureStorageEmulator.exe clear [blob] [table] [queue] [all] blob : törli a blob-adatvesztést.blob : Clears blob data.
üzenetsor : a várólista-adathalmazok törlése.queue : Clears queue data.
tábla : a tábla tartalmának törlése.table : Clears table data.
összes : törli az összes szolgáltatás összes adatértékét.all : Clears all data in all services.
InitInit Az emulátor beállításához egyszeri inicializálás szükséges.Does one-time initialization to set up the emulator. AzureStorageEmulator.exe init [-server serverName] [-sqlinstance instanceName] [-forcecreate|-skipcreate] [-reserveports|-unreserveports] [-inprocess] -Server serverName\instanceName : az SQL-példányt üzemeltető kiszolgálót adja meg.-server serverName\instanceName : Specifies the server hosting the SQL instance.
-Sqlinstance példánynév : az alapértelmezett kiszolgálói példányban használandó SQL-példány nevét adja meg.-sqlinstance instanceName : Specifies the name of the SQL instance to be used in the default server instance.
-forcecreate : az SQL-adatbázis létrehozásának kényszerítése, még akkor is, ha már létezik.-forcecreate : Forces creation of the SQL database, even if it already exists.
-skipcreate : kihagyja az SQL-adatbázis létrehozását.-skipcreate : Skips creation of the SQL database. Ez elsőbbséget élvez a forcecreate szemben.This takes precedence over -forcecreate.
-reserveports : megkísérli a szolgáltatásokhoz társított http-portok foglalását.-reserveports : Attempts to reserve the HTTP ports associated with the services.
-unreserveports : megkísérli eltávolítani a szolgáltatásokhoz társított http-portok foglalásait.-unreserveports : Attempts to remove reservations for the HTTP ports associated with the services. Ez elsőbbséget élvez a reserveports szemben.This takes precedence over -reserveports.
-InProcess : az új folyamat létrehozása helyett az aktuális folyamat inicializálását hajtja végre.-inprocess : Performs initialization in the current process instead of spawning a new process. A jelenlegi folyamatot emelt szintű engedélyekkel kell elindítani, ha módosítja a portok foglalását.The current process must be launched with elevated permissions if changing port reservations.

A Storage Emulator és az Azure Storage közötti különbségekDifferences between the Storage Emulator and Azure Storage

Mivel a Storage Emulator egy helyi emulált környezet, az emulátor és a felhőben lévő Azure Storage-fiók használata között különbségek vannak:Because the Storage Emulator is a local emulated environment, there are differences between using the emulator and an Azure storage account in the cloud:

  • A Storage Emulator csak egyetlen rögzített fiókot és egy jól ismert hitelesítési kulcsot támogat.The Storage Emulator supports only a single fixed account and a well-known authentication key.
  • A Storage Emulator nem méretezhető tárolási szolgáltatás, és nem támogatja nagy számú egyidejű ügyfél használatát.The Storage Emulator isn't a scalable storage service and doesn't support a large number of concurrent clients.
  • A Storage Emulator erőforrásainak kezelésecímű témakörben leírtak szerint az erőforrásokat a Storage-emulátorban és egy Azure Storage-fiókban eltérően kezeli a rendszer.As described in Addressing resources in the Storage Emulator, resources are addressed differently in the Storage Emulator versus an Azure storage account. A különbség az, hogy a tartománynév-feloldás a felhőben érhető el, de a helyi számítógépen nem.The difference is because domain name resolution is available in the cloud but not on the local computer.
  • A 3,1-es verziótól kezdődően a Storage Emulator-fiók támogatja az olvasási hozzáférésű geo-redundáns replikálást (RA-GRS).Beginning with version 3.1, the Storage Emulator account supports read-access geo-redundant replication (RA-GRS). Az emulátorban minden fiókhoz engedélyezve van az RA-GRS, és az elsődleges és a másodlagos replikák között soha nem marad késés.In the emulator, all accounts have RA-GRS enabled and there's never any lag between the primary and secondary replicas. A blob szolgáltatás statisztikáinak beolvasása, a várólista-szolgáltatás statisztikáinak beolvasása és a Table szolgáltatás statisztikáinak beolvasása támogatott a másodlagos fiókban, és a válasz elem értékét mindig a LastSyncTime mögöttes SQL-adatbázisnak megfelelő aktuális időpontra fogja visszaadni.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.
  • A file Service és az SMB protokoll szolgáltatási végpontok jelenleg nem támogatottak a Storage Emulatorban.The File service and SMB protocol service endpoints aren't currently supported in the Storage Emulator.
  • Ha az emulátor által nem támogatott tárolási szolgáltatások valamelyik verzióját használja, az emulátor VersionNotSupportedByEmulator-hibát ad vissza (HTTP-állapotkód: 400 – hibás kérés).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).

BLOB Storage-beli különbségekDifferences for Blob storage

Az emulátorban a blob Storage-ra a következő különbségek érvényesek:The following differences apply to Blob storage in the emulator:

  • A Storage Emulator legfeljebb 2 GB méretű blob-méreteket támogat.The Storage Emulator only supports blob sizes up to 2 GB.
  • A Blobok nevének maximális hossza a Storage-emulátorban 256 karakter, míg az Azure Storage-beli blob-nevek maximális hossza 1024 karakter.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.
  • A növekményes másolás lehetővé teszi a felülírt Blobok másolását, így a szolgáltatás hibáját adja vissza.Incremental copy allows snapshots from overwritten blobs to be copied, which returns a failure on the service.
  • Az oldal-tartományok diff beolvasása nem működik a növekményes másolási blob használatával másolt Pillanatképek között.Get Page Ranges Diff doesn't work between snapshots copied using Incremental Copy Blob.
  • Egy Put blob művelet egy olyan blobnál lehet sikeres, amely egy aktív bérlettel rendelkezik a Storage-emulátorban, még akkor is, ha a kérelemben nincs megadva a címbérlet azonosítója.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.
  • Az emulátor nem támogatja a Blobok hozzáfűzését.Append blob operations are not supported by the emulator. Egy hozzáfűző blobon végrehajtott művelet egy FeatureNotSupportedByEmulator-hibát ad vissza (HTTP 400 – hibás kérés).Attempting an operation on an append blob returns a FeatureNotSupportedByEmulator error (HTTP status code 400 - Bad Request).

Táblázatos tárolással kapcsolatos különbségekDifferences for Table storage

A következő eltérések vonatkoznak az emulátorban található Table Storage-ra:The following differences apply to Table storage in the emulator:

  • A Storage Emulator Table servicejában a dátum tulajdonságai csak a SQL Server 2005 által támogatott tartományokat támogatják (a 1753. január 1-től).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). A 1753. január 1. előtti összes dátum erre az értékre módosult.All dates before January 1, 1753 are changed to this value. A dátumok pontossága a SQL Server 2005 pontosságára korlátozódik, ami azt jelenti, hogy a dátumok pontosak egy másodperc 1/300th.The precision of dates is limited to the precision of SQL Server 2005, meaning that dates are precise to 1/300th of a second.
  • A Storage Emulator a partíciós kulcs és a sor kulcsa tulajdonságának értékét kevesebb mint 512 bájtra támogatja.The Storage Emulator supports partition key and row key property values of less than 512 bytes each. A fióknév, a tábla neve és a kulcs tulajdonságainak neve összesen nem haladhatja meg a 900 bájtot.The total size of the account name, table name, and key property names together can't exceed 900 bytes.
  • Egy tábla sorainak teljes mérete a Storage-emulátorban 1 MB-nál kevesebb értékre van korlátozva.The total size of a row in a table in the Storage Emulator is limited to less than 1 MB.
  • A Storage-emulátorban az adattípus tulajdonságai Edm.Guid vagy Edm.Binary csak a Equal (eq) NotEqual (ne) lekérdezési szűrő sztringek és az összehasonlító operátorok támogatása.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.

A várólista-tárolással kapcsolatos különbségekDifferences for Queue storage

Nincsenek eltérések az emulátorban található üzenetsor-tároláshoz.There are no differences specific to Queue storage in the emulator.

A Storage Emulator kibocsátási megjegyzéseiStorage Emulator release notes

5,10-es verzióVersion 5.10

  • A Storage Emulator nem utasítja el a tárolási szolgáltatások 2019-07-07-es verzióját a blob-, üzenetsor-és Table service-végpontokon.The Storage Emulator won't reject version 2019-07-07 of the storage services on Blob, Queue, and Table service endpoints.

5,9-es verzióVersion 5.9

  • A Storage Emulator nem utasítja el a tárolási szolgáltatások 2019-02-02-es verzióját a blob-, üzenetsor-és Table service-végpontokon.The Storage Emulator won't reject version 2019-02-02 of the storage services on Blob, Queue, and Table service endpoints.

5,8-es verzióVersion 5.8

  • A Storage Emulator nem utasítja el a tárolási szolgáltatások 2018-11-09-es verzióját a blob-, üzenetsor-és Table service-végpontokon.The Storage Emulator won't reject version 2018-11-09 of the storage services on Blob, Queue, and Table service endpoints.

5,7-es verzióVersion 5.7

  • Kijavítva egy olyan hibát, amely összeomlást okoz, ha a naplózás engedélyezve volt.Fixed a bug that would cause a crash if logging was enabled.

5,6-es verzióVersion 5.6

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2018-03-28-os verzióját.The Storage Emulator now supports version 2018-03-28 of the storage services on Blob, Queue, and Table service endpoints.

5,5-es verzióVersion 5.5

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2017-11-09-os verzióját.The Storage Emulator now supports version 2017-11-09 of the storage services on Blob, Queue, and Table service endpoints.
  • Támogatás lett hozzáadva a blob által létrehozott tulajdonsághoz, amely a blob létrehozási idejét adja vissza.Support has been added for the blob Created property, which returns the blob's creation time.

5,4-es verzióVersion 5.4

  • A telepítési stabilitás javítása érdekében az emulátor már nem próbálkozik a portok lefoglalására a telepítési időpontban.To improve installation stability, the emulator no longer attempts to reserve ports at install time. Ha a portok foglalását szeretné használni, használja az init parancs -reserveports kapcsolóját a megadásához.If you want port reservations, use the -reserveports option of the init command to specify them.

5,3-es verzióVersion 5.3

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2017-07-29-os verzióját.The Storage Emulator now supports version 2017-07-29 of the storage services on Blob, Queue, and Table service endpoints.

5,2-es verzióVersion 5.2

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2017-04-17-os verzióját.The Storage Emulator now supports version 2017-04-17 of the storage services on Blob, Queue, and Table service endpoints.
  • Kijavítva egy hiba, ahol a Table tulajdonság értékei nem lettek megfelelően kódolva.Fixed a bug where table property values weren't being properly encoded.

5,1-es verzióVersion 5.1

  • Kijavítva egy olyan hibát, amelyben a Storage Emulator a DataServiceVersion fejlécet olyan válaszokban adta vissza, amelyekben a szolgáltatás nem volt elérhető.Fixed a bug where the Storage Emulator was returning the DataServiceVersion header in some responses where the service was not.

5,0-es verzióVersion 5.0

  • A Storage Emulator telepítője már nem ellenőrzi a meglévő MSSQL-és .NET-keretrendszer telepítéseit.The Storage Emulator installer no longer checks for existing MSSQL and .NET Framework installs.
  • A Storage Emulator telepítője már nem hozza létre az adatbázist a telepítés részeként.The Storage Emulator installer no longer creates the database as part of install. A rendszer a rendszerindítás részeként továbbra is létrehozza az adatbázist.Database will still be created if needed as part of startup.
  • Az adatbázis létrehozása már nem igényel jogosultságszint-emelést.Database creation no longer requires elevation.
  • A portok foglalása már nem szükséges az indításhoz.Port reservations are no longer needed for startup.
  • A következő lehetőségeket adja hozzá a következőkhöz init : -reserveports (jogosultságszint emelése szükséges), -unreserveports (jogosultságszint-emelést igényel), -skipcreate .Adds the following options to init: -reserveports (requires elevation), -unreserveports (requires elevation), -skipcreate.
  • A rendszertálca ikonján a Storage Emulator felhasználói felülete lehetőség most elindítja a parancssori felületet.The Storage Emulator UI option on the system tray icon now launches the command-line interface. A régi GUI már nem érhető el.The old GUI is no longer available.
  • Egyes DLL-fájlok el lettek távolítva vagy átnevezve lettek.Some DLLs have been removed or renamed.

4,6-es verzióVersion 4.6

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2016-05-31-os verzióját.The Storage Emulator now supports version 2016-05-31 of the storage services on Blob, Queue, and Table service endpoints.

4,5-es verzióVersion 4.5

  • Kijavítva egy olyan hibát, amely miatt a telepítés és az inicializálás sikertelen volt, ha a háttér-adatbázis át lett nevezve.Fixed a bug that caused installation and initialization to fail when the backing database is renamed.

4,4-es verzióVersion 4.4

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2015-12-11-os verzióját.The Storage Emulator now supports version 2015-12-11 of the storage services on Blob, Queue, and Table service endpoints.
  • A Storage Emulator blob-adatokhoz tartozó Garbage-gyűjteménye hatékonyabban működik, ha nagy mennyiségű blobot kezel.The Storage Emulator's garbage collection of blob data is now more efficient when dealing with large numbers of blobs.
  • Kijavított egy hibát, amely miatt a tároló ACL XML-fájlja némileg másképpen ellenőrizhető, hogy a tárolási szolgáltatás hogyan működik.Fixed a bug that caused container ACL XML to be validated slightly differently from how the storage service does it.
  • Kijavítva egy olyan hibát, amely néha a maximális és a minimális dátum/idő értéket okozta, hogy a rendszer a helytelen időzónában jelentsen.Fixed a bug that sometimes caused max and min DateTime values to be reported in the incorrect time zone.

4,3-es verzióVersion 4.3

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2015-07-08-os verzióját.The Storage Emulator now supports version 2015-07-08 of the storage services on Blob, Queue, and Table service endpoints.

4,2-es verzióVersion 4.2

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2015-04-05-os verzióját.The Storage Emulator now supports version 2015-04-05 of the storage services on Blob, Queue, and Table service endpoints.

4,1-es verzióVersion 4.1

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2015-02-21-os verzióját.The Storage Emulator now supports version 2015-02-21 of the storage services on Blob, Queue, and Table service endpoints. Nem támogatja az új hozzáfűző blob-funkciókat.It doesn't support the new append blob features.
  • Az emulátor most egy értelmes hibaüzenetet ad vissza a tárolási szolgáltatások nem támogatott verzióihoz.The emulator now returns a meaningful error message for unsupported versions of storage services. Javasoljuk, hogy az emulátor legújabb verzióját használja.We recommend using the latest version of the emulator. Ha VersionNotSupportedByEmulator hibaüzenetet kap (HTTP-állapotkód: 400 – hibás kérés), töltse le az emulátor legújabb verzióját.If you get a VersionNotSupportedByEmulator error (HTTP status code 400 - Bad Request), download the latest version of the emulator.
  • Kijavítva egy olyan hibát, amelyben a versenyhelyzet feltétele miatt helytelenek voltak a tábla entitások az egyidejű egyesítési műveletek során.Fixed a bug wherein a race condition caused table entity data to be incorrect during concurrent merge operations.

4,0-es verzióVersion 4.0

  • A Storage Emulator végrehajtható fájljának neve AzureStorageEmulator.exe .The Storage Emulator executable has been renamed to AzureStorageEmulator.exe .

3,2-es verzióVersion 3.2

  • A Storage Emulator mostantól támogatja a blob-, üzenetsor-és Table service-végpontok tárolási szolgáltatásainak 2014-02-14-os verzióját.The Storage Emulator now supports version 2014-02-14 of the storage services on Blob, Queue, and Table service endpoints. A file Service-végpontok jelenleg nem támogatottak a Storage Emulatorban.File service endpoints aren't currently supported in the Storage Emulator. Az 2014-02-14-es verzióval kapcsolatos részletekért tekintse meg Az Azure Storage szolgáltatás verziószámozását .See Versioning for the Azure Storage Services for details about version 2014-02-14.

3,1-es verzióVersion 3.1

  • Az olvasási hozzáférésű geo-redundáns tárolás (RA-GRS) mostantól támogatott a Storage Emulatorban.Read-access geo-redundant storage (RA-GRS) is now supported in the Storage Emulator. A Get Blob Service Stats , a Get Queue Service Stats és az API- Get Table Service Stats k támogatottak a másodlagos fiók esetében, és mindig a LastSyncTime válasz elemének értékét adják vissza, amely az alapul szolgáló SQL-adatbázisnak megfelelően aktuális idő lesz.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. A másodlagos és a Storage-emulátor programozott eléréséhez használja a Storage ügyféloldali kódtárat a .NET 3,2-es vagy újabb verziójához.For programmatic access to the secondary with the Storage Emulator, use the Storage Client Library for .NET version 3.2 or later. A részletekért tekintse meg a .NET-hez készült Microsoft Azure Storage ügyféloldali kódtárat ismertető témakört.See the Microsoft Azure Storage Client Library for .NET Reference for details.

3,0-es verzióVersion 3.0

  • Az Azure Storage-emulátor már nem ugyanarra a csomagba kerül, mint a Compute Emulator.The Azure Storage Emulator is no longer shipped in the same package as the compute emulator.
  • A Storage Emulator grafikus felhasználói felülete elavult.The Storage Emulator graphical user interface is deprecated. Egy parancsfájl-parancssori felület váltotta fel.It has been replaced by a scriptable command-line interface. A parancssori felületen a további tudnivalókat lásd: Storage Emulator Command-Line Tool Reference.For details on the command-line interface, see Storage Emulator Command-Line Tool Reference. A grafikus felület továbbra is megtalálható a 3,0-es verzióban, de csak akkor érhető el, ha a számítási emulátor telepítve van, ha a jobb gombbal a rendszertálca ikonra kattint, és kiválasztja a Storage Emulator felhasználói felületének megjelenítése lehetőséget.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.
  • Az Azure Storage-szolgáltatások 2013-08-15-es verziója már teljes mértékben támogatott.Version 2013-08-15 of the Azure storage services is now fully supported. (Ezt a verziót korábban csak a Storage Emulator 2.2.1 előzetes verziója támogatja.)(Previously this version was only supported by Storage Emulator version 2.2.1 Preview.)

Következő lépésekNext steps

  • Értékelje ki a többplatformos, Közösség által karbantartott nyílt forráskódú Storage Emulator- Azurite.Evaluate the cross-platform, community-maintained open-source Storage Emulator Azurite.
  • A .NET-et használó Azure Storage-minták több, az alkalmazás fejlesztésekor felhasználható kódrészletre mutató hivatkozásokat is tartalmaznak.Azure Storage samples using .NET contains links to several code samples you can use when developing your application.
  • A Microsoft Azure Storage Explorer használatával dolgozhat a felhőalapú Storage-fiókban található erőforrásokkal, és a Storage emulatorban is.You can use the Microsoft Azure Storage Explorer to work with resources in your cloud Storage account, and in the Storage Emulator.

Lásd még:See Also