Použití Azure Storage Emulator pro vývoj a testování (zastaralé)

The Microsoft Azure Storage Emulator is a tool that emulates the Azure Blob, Queue, and Table services for local development purposes. Aplikaci můžete testovat na službách úložiště místně bez vytvoření předplatného Azure nebo bez jakýchkoli nákladů. Až budete spokojeni s tím, jak vaše aplikace funguje v emulátoru, přepněte na používání účtu úložiště Azure v cloudu.

Získání Storage Emulator

Tento Storage Emulator je k dispozici jako součást sady Microsoft Azure SDK. Můžete také nainstalovat Storage Emulator pomocí samostatného instalačního programu (přímé stažení). Chcete-li Storage Emulator, musíte mít v počítači oprávnění správce.

Tento Storage Emulator aktuálně běží pouze v Windows. Pro emulaci v Linuxu použijte emulátor Azure.

Jak emulátor úložiště funguje

K Storage Emulator služeb úložiště Azure používá místní Microsoft SQL Server 2012 Express LocalDB. Můžete se rozhodnout pro konfiguraci Storage Emulator pro přístup k místní instanci SQL Server místo instance LocalDB. Další informace najdete v části Spuštění Storage Emulator inicializaci souboru v další části tohoto článku.

Tento Storage Emulator se připojí k SQL Server nebo LocalDB pomocí Windows ověřování.

Mezi službami úložiště Azure storage a Storage Emulator existují určité rozdíly ve funkcích. Další informace o těchto rozdílech najdete v části Rozdíly mezi Storage Emulator a Azure Storage dále v tomto článku.

Spuštění a inicializace Storage Emulator

Spuštění Azure Storage Emulator:

1. Vyberte tlačítko Start nebo stiskněte Windows.
2. Začněte psát Azure Storage Emulator .
3. V seznamu zobrazených aplikací vyberte emulátor.

Po Storage Emulator se zobrazí okno příkazového řádku. Toto okno konzoly můžete použít ke spuštění a zastavení Storage Emulator. Můžete také vymazat data, získat stav a inicializovat emulátor z příkazového řádku. Další informace najdete v části Storage Emulator nástroje příkazového řádku dále v tomto článku.

Po spuštění emulátoru se v oznamovací oblasti hlavního panelu Windows zobrazí jeho ikona.

Když zavřete okno Storage Emulator příkazového řádku, bude Storage Emulator nadále spuštěný. Pokud chcete znovu Storage Emulator konzoly, postupujte podle předchozích kroků, jako kdybyste s Storage Emulator.

Při prvním spuštění Storage Emulator se prostředí místního úložiště inicializuje za vás. Proces inicializace vytvoří databázi v LocalDB a rezervuje porty HTTP pro každou službu místního úložiště.

Výchozí Storage Emulator se instaluje na C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator .

Inicializace úložiště Emulator použití jiné SQL databáze

Pomocí nástroje příkazového řádku Emulator úložiště můžete inicializovat Storage Emulator, která bude odkazovat na jinou instanci SQL databáze než na výchozí instanci LocalDB:

1. Otevřete okno Storage Emulator konzoly, jak je popsáno v části Spuštění a inicializace Storage Emulator konzoly.

2. V okně konzoly zadejte následující příkaz, kde je název SQL Server <SQLServerInstance> instance. Pokud chcete použít LocalDB, (localdb)\MSSQLLocalDb zadejte jako SQL Server instanci.

   AzureStorageEmulator.exe init /server <SQLServerInstance>

   Můžete také použít následující příkaz, který emulátor nasměruje na použití výchozí SQL Server instance:

   AzureStorageEmulator.exe init /server .

   Nebo můžete použít následující příkaz, který inicializuje databázi na výchozí instanci LocalDB:

   AzureStorageEmulator.exe init /forceCreate

Další informace o těchto příkazech najdete v Storage Emulator nástroje příkazového řádku.

Ověřování požadavků na Storage Emulator

Po instalaci a spuštění tohoto Storage Emulator můžete proti němu otestovat svůj kód. Každý požadavek, který vůči Storage Emulator musí být autorizován, pokud se jedná o anonymní požadavek. Žádosti proti této žádosti můžete autorizovat Storage Emulator pomocí ověřování pomocí sdíleného klíče nebo pomocí sdíleného přístupového podpisu (SAS).

Autorizace s přihlašovacími údaji sdíleného klíče

Emulátor podporuje jeden pevný účet a známý ověřovací klíč pro ověřování pomocí sdíleného klíče. Tento účet a klíč jsou jedinými přihlašovacími údaji ke sdíleným klíčům povoleným pro použití s emulátorem. Jsou to tyto:

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

Připojení k účtu emulátoru pomocí zástupce

Nejjednodušší způsob, jak se připojit k emulátoru z vaší aplikace, je nakonfigurovat připojovací řetězec v konfiguračním souboru vaší aplikace, který odkazuje na zástupce UseDevelopmentStorage=true . Zástupce je ekvivalentem úplného připojovacího řetězce pro emulátor, který určuje název účtu, klíč účtu a koncové body emulátoru pro každou službu Azure Storage Services:

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

Následující fragment kódu .NET ukazuje, jak lze použít zástupce z metody, která přijímá připojovací řetězec. Například konstruktor BlobContainerClient (String, String) přijímá připojovací řetězec.

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

Ujistěte se, že emulátor běží před voláním kódu ve fragmentu.

Další informace o připojovacích řetězcích najdete v tématu Konfigurace Azure Storage připojovacích řetězců.

Autorizace se sdíleným přístupový podpisem

Některé klientské knihovny úložiště Azure, jako je například knihovna Xamarin, podporují ověřování pouze pomocí tokenu sdíleného přístupového podpisu (SAS). Token SAS můžete vytvořit pomocí tokenu SAS Průzkumník služby Storage jiné aplikace, která podporuje ověřování pomocí sdíleného klíče.

Token SAS můžete také vygenerovat pomocí Azure PowerShell. Následující příklad vygeneruje token SAS s úplnými oprávněními ke kontejneru objektů blob:

1. Nainstalujte Azure PowerShell, pokud jste to ještě neudělali (doporučujeme použít nejnovější verzi Azure PowerShell rutin). Pokyny k instalaci najdete v tématu Instalace a konfigurace Azure PowerShell.
2. Otevřete Azure PowerShell a spusťte následující příkazy a nahraďte názvem CONTAINER_NAME podle svého výběru:

$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

Výsledný identifikátor URI sdíleného přístupového podpisu pro nový kontejner by měl být podobný:

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

Sdílený přístupový podpis vytvořený v tomto příkladu je platný jeden den. Podpis uděluje úplný přístup (čtení, zápis, odstranění, seznam) k objektům blob v rámci kontejneru.

Další informace o sdílených přístupových podpisech najdete v tématu Udělení omezeného přístupu Azure Storage prostředkům pomocí sdílených přístupových podpisů (SAS).

Adresování prostředků v Storage Emulator

Koncové body služby pro Storage Emulator se liší od koncových bodů pro účet úložiště Azure. Místní počítač nepodporuje překlad názvů domén, což vyžaduje, aby Storage Emulator koncové body místní adresy.

Při adresování prostředku v účtu úložiště Azure použijete následující schéma. Název účtu je součástí názvu hostitele URI a adresovaný prostředek je součástí cesty URI:

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

Například následující identifikátor URI je platná adresa objektu blob v účtu úložiště Azure:

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

Vzhledem k tomu, že místní počítač nepodporuje překlad názvů domén, je název účtu součástí cesty URI místo názvu hostitele. Pro prostředek v souboru použijte následující formát Storage Emulator:

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

Pro přístup k objektu blob v úložišti objektů blob se může použít Storage Emulator:

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

Koncové body služby pro Storage Emulator jsou:

• Blob service: http://127.0.0.1:10000/<account-name>/<resource-path>
• Služba front: http://127.0.0.1:10001/<account-name>/<resource-path>
• Table Service: http://127.0.0.1:10002/<account-name>/<resource-path>

Adresování sekundárního účtu pomocí RA-GRS

Počínaje verzí 3.1 Storage Emulator geograficky redundantní replikaci jen pro čtení (RA-GRS). K sekundárnímu umístění se můžete dostat tak, že k názvu účtu připojíte -secondary. Například následující adresa se může použít pro přístup k objektu blob pomocí sekundárního objektu jen pro čtení v Storage Emulator:

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

Storage Emulator nástroje příkazového řádku

Počínaje verzí 3.0 se při spuštění konzoly zobrazí okno Storage Emulator. Pomocí příkazového řádku v okně konzoly spusťte a zastavte emulátor. Můžete také zadat dotaz na stav a provádět další operace z příkazového řádku.

Syntaxe příkazového řádku

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

Možnosti

Pokud chcete zobrazit seznam možností, na příkazovém řádku zadejte /help.

rozdíly mezi Storage Emulator a Azure Storage

vzhledem k tomu, že Storage Emulator je místní emulované prostředí, existují rozdíly mezi použitím emulátoru a účtu úložiště Azure v cloudu:

• Storage Emulator podporuje pouze jeden pevný účet a dobře známý ověřovací klíč.
• Storage Emulator není škálovatelná služba úložiště a nepodporuje velký počet souběžných klientů.
• jak je popsáno v tématu adresování prostředků v Storage Emulator, se prostředky řeší jinak v Storage Emulator a v účtu úložiště Azure. Rozdíl je v tom, že překlad názvů domény je k dispozici v cloudu, ale ne v místním počítači.
• počínaje verzí 3,1 Storage účet Emulator podporuje geograficky redundantní replikaci s přístupem pro čtení (RA-GRS). V emulátoru mají všechny účty povolený RA-GRS a nikdy neexistují žádné prodlevy mezi primárními a sekundárními replikami. na sekundárním účtu se podporují operace získat statistiku služby Blob, získat statistiky služby Queue service a získat statistiku služby Table service a vždycky vrátí hodnotu LastSyncTime elementu response jako aktuální čas podle podkladové databáze SQL.
• koncové body služby souborové služby a protokolu SMB se v Emulator Storage aktuálně nepodporují.
• Pokud používáte verzi služby úložiště, která není podporována emulátorem, emulátor vrátí chybu VersionNotSupportedByEmulator (kód stavu HTTP 400-Chybný požadavek).

Rozdíly pro úložiště objektů BLOB

Pro úložiště objektů BLOB v emulátoru platí následující rozdíly:

• Emulator Storage podporuje jenom velikosti objektů blob až do 2 GB.
• maximální délka názvu objektu blob v Storage Emulator je 256 znaků, zatímco maximální délka názvu objektu blob v Azure Storage je 1024 znaků.
• Přírůstkové kopírování umožňuje zkopírovat snímky z přepsaných objektů blob, což vrátí chybu služby.
• Získat rozdíl mezi snímky zkopírovanými pomocí objektu BLOB přírůstkového kopírování nefunguje rozdíl v rozsahu stránek
• operace Put blob může být úspěšná proti objektu blob, který existuje v Storage Emulator s aktivním zapůjčením i v případě, že v požadavku není zadané ID zapůjčení.
• Emulátor nepodporuje operace připojení objektu BLOB. Pokus o operaci na doplňovacím objektu BLOB vrátí chybu FeatureNotSupportedByEmulator (kód stavu HTTP 400-Chybný požadavek).

Rozdíly pro úložiště tabulek

Následující rozdíly platí pro úložiště tabulek v emulátoru:

• vlastnosti data v Table service v Storage Emulator podporují pouze rozsah podporovaný SQL Server 2005 (musí být pozdější než 1. ledna 1753). Všechna data před 1. ledna 1753 budou změněna na tuto hodnotu. přesnost dat je omezená na přesnost SQL Server 2005, což znamená, že data jsou přesně na 1/300th sekundy.
• Storage Emulator podporuje hodnoty vlastností klíče oddílu a klíče řádku, které mají méně než 512 bajtů. Celková velikost názvu účtu, názvu tabulky a názvů klíčových vlastností dohromady nesmí překročit 900 bajtů.
• celková velikost řádku v tabulce v Storage Emulator je omezena na méně než 1 MB.
• ve Storage Emulator, vlastnosti datového typu Edm.Guid nebo Edm.Binary podporují pouze Equal (eq) NotEqual (ne) operátory porovnání a v řetězcích filtru dotazů.

Rozdíly pro úložiště Queue

V emulátoru nejsou žádné rozdíly specifické pro úložiště Queue.

poznámky k verzi Storage Emulator

Verze 5,10

• Emulator Storage nezpůsobí odmítnutí verze 2019-07-07 služeb úložiště v koncových bodech Blob, Queue a Table service.

Verze 5,9

• Emulator Storage nezpůsobí odmítnutí verze 2019-02-02 služeb úložiště v koncových bodech Blob, Queue a Table service.

Verze 5,8

• Emulator Storage nezpůsobí odmítnutí verze 2018-11-09 služeb úložiště v koncových bodech Blob, Queue a Table service.

Verze 5,7

• Opravili jsme chybu, která by způsobila chybu v případě povolení protokolování.

Verze 5,6

• Storage Emulator nyní podporuje služby úložiště verze 2018-03-28 v koncových bodech Blob, Queue a Table service.

Verze 5,5

• Storage Emulator nyní podporuje služby úložiště verze 2017-11-09 v koncových bodech Blob, Queue a Table service.
• Přidala se podpora pro vlastnost vytvořeného objektu blob, která vrací čas vytvoření objektu BLOB.

Verze 5,4

• Za účelem vylepšení stability při instalaci se emulátor již nepokouší rezervovat porty v době instalace. Pokud chcete rezervace portů, určete je pomocí možnosti -reserveports příkazu init .

Verze 5,3

• Storage Emulator nyní podporuje služby úložiště verze 2017-07-29 v koncových bodech Blob, Queue a Table service.

Verze 5,2

• Storage Emulator nyní podporuje služby úložiště verze 2017-04-17 v koncových bodech Blob, Queue a Table service.
• Byla opravena chyba, kdy hodnoty vlastností tabulky nebyly správně kódovány.

Verze 5,1

• opravili jsme chybu, kdy Storage Emulator vrátil DataServiceVersion hlavičku v některých odpovědích, kde služba nebyla.

Verze 5,0

• instalační program Emulator Storage už nekontroluje stávající instalaci MSSQL a .NET Framework nainstaluje.
• instalační program Emulator Storage již databázi nevytváří jako součást instalace. Databáze bude v případě potřeby vytvořena v rámci spuštění.
• Vytvoření databáze již nevyžaduje zvýšení oprávnění.
• Pro spuštění už nejsou potřeba žádné rezervace portů.
• Přidá následující možnosti init : -reserveports (vyžaduje zvýšení oprávnění), -unreserveports (vyžaduje zvýšení oprávnění) -skipcreate .
• možnost uživatelského rozhraní Storage Emulator v ikoně na hlavním panelu systému teď spouští rozhraní příkazového řádku. Starý GUI již není k dispozici.
• Některé knihovny DLL byly odebrány nebo přejmenovány.

Verze 4,6

• Storage Emulator nyní podporuje služby úložiště verze 2016-05-31 v koncových bodech Blob, Queue a Table service.

Verze 4,5

• Opravili jsme chybu, která způsobila selhání instalace a inicializace při přejmenování záložní databáze.

Verze 4,4

• Storage Emulator nyní podporuje služby úložiště verze 2015-12-11 v koncových bodech Blob, Queue a Table service.
• uvolňování paměti dat objektů blob v Storage Emulator je nyní efektivnější při práci s velkým počtem objektů blob.
• Opravili jsme chybu, která způsobila, že XML seznamu ACL kontejneru se mírně liší od způsobu, jakým služba úložiště dělá.
• Opravili jsme chybu, která někdy způsobila, že se v nesprávném časovém pásmu nahlásí maximální a minimální hodnoty DateTime.

Verze 4,3

• Storage Emulator nyní podporuje služby úložiště verze 2015-07-08 v koncových bodech Blob, Queue a Table service.

Verze 4,2

• Storage Emulator nyní podporuje služby úložiště verze 2015-04-05 v koncových bodech Blob, Queue a Table service.

Verze 4,1

• Storage Emulator nyní podporuje služby úložiště verze 2015-02-21 v koncových bodech Blob, Queue a Table service. Nepodporuje nové funkce přidávání objektů BLOB.
• Emulátor nyní vrátí smysluplnou chybovou zprávu pro nepodporované verze služeb úložiště. Doporučujeme použít nejnovější verzi emulátoru. Pokud se zobrazí chyba VersionNotSupportedByEmulator (kód stavu HTTP 400 – Chybný požadavek), Stáhněte si nejnovější verzi emulátoru.
• Opravili chybu, na kterou konflikt časování způsobil, že data entity tabulky v průběhu souběžných operací sloučení nejsou správná.

Verze 4,0

• spustitelný soubor Emulator Storage byl přejmenován na AzureStorageEmulator.exe.

Verze 3,2

• Storage Emulator nyní podporuje služby úložiště verze 2014-02-14 v koncových bodech Blob, Queue a Table service. v Emulator Storage se aktuálně nepodporují koncové body souborové služby. podrobnosti o verzi 2014-02-14 najdete v tématu správa verzí pro službu Azure Storage Services .

Verze 3,1

• v Emulator Storage se teď podporuje geograficky redundantní úložiště s přístupem pro čtení (RA-GRS). Get Blob Service Stats Get Queue Service Stats rozhraní api, a Get Table Service Stats jsou podporovaná pro sekundární účet a vždycky vrátí hodnotu prvku LastSyncTime response jako aktuální čas podle podkladové databáze SQL. pro programový přístup k sekundárnímu Emulator Storage použijte Storage klientskou knihovnu pro .net verze 3,2 nebo novější. podrobnosti najdete v referenčních informacích k klientské knihovně Microsoft Azure Storage pro .net.

Verze 3,0

• Azure Storage Emulator již není dodávána ve stejném balíčku jako emulátor pro výpočty.
• grafické uživatelské rozhraní Storage Emulator je zastaralé. Byl nahrazen rozhraním skriptového příkazového řádku. podrobnosti o rozhraní příkazového řádku naleznete v tématu Storage Emulator Command-Line Reference k nástroji. grafické rozhraní bude nadále k dispozici ve verzi 3,0, ale je k němu možné přistupovat pouze v případě, že je služba compute Emulator nainstalována kliknutím pravým tlačítkem myši na ikonu na hlavním panelu systému a výběrem možnosti zobrazit Storage Emulator uživatelského rozhraní.
• Služba Azure Storage je teď plně podporovaná ve verzi 2013-08-15. (dřív byla tato verze podporovaná Storage Emulator verze 2.2.1 Preview.)

Další kroky

• vyhodnoťte Storage open source Emulator Azuritepro různé platformy a komunita.
• Azure Storage ukázky používající rozhraní .net obsahují odkazy na několik ukázek kódu, které můžete použít při vývoji aplikace.
• Průzkumník služby Microsoft Azure Storage můžete použít pro práci s prostředky ve vašem cloudovém Storage účtu a v Emulator Storage.

Viz také

• vývoj místních Azure Storage pomocí Azurite, sad Azure sdk a Průzkumník služby Azure Storage