Usare l'emulatore di archiviazione di Azure per lo sviluppo e il test (deprecato)

L'Emulatore di archiviazione Microsoft Azure è uno strumento che emula i servizi Azure Blob, Queue e Table per lo sviluppo locale. È possibile testare l'applicazione sui servizi di archiviazione in locale senza creare una sottoscrizione di Azure o sostenere costi. Quando si è soddisfatti del funzionamento dell'applicazione nell'emulatore, passare all'uso di un account di archiviazione di Azure nel cloud.

Ottenere l'emulatore di archiviazione

L'emulatore di archiviazione è disponibile come parte dell'SDK Microsoft Azure. È anche possibile installare l'emulatore di archiviazione usando il programma di installazione autonomo (download diretto). Per installare l'emulatore di archiviazione, è necessario disporre di privilegi amministrativi nel computer.

L'emulatore di archiviazione attualmente viene eseguito solo in Windows. Per l'emulazione in Linux, usare l'emulatore Azurite.

Come funziona l'emulatore di storage

L'emulatore di archiviazione usa un'istanza locale di Microsoft SQL Server 2012 Express Local DB per emulare i servizi di archiviazione di Azure. È possibile scegliere di configurare l'emulatore di archiviazione per accedere a un'istanza locale di SQL Server anziché l'istanza Local DB. Per altre informazioni, vedere la sezione Avviare e inizializzare l'emulatore di archiviazione più avanti in questo articolo.

L'emulatore di storage si collega a SQL Server o LocalDB utilizzando autenticazione di Windows.

Esistono alcune differenze a livello di funzionalità tra l'emulatore di archiviazione e i servizi di archiviazione di Azure. Per altre informazioni su queste differenze, vedere la sezione Differenze tra l'emulatore di archiviazione e Archiviazione di Azure più avanti in questo articolo.

Avviare e inizializzare l'emulatore di archiviazione

Per avviare l'emulatore di archiviazione di Azure:

1. Fare clic sul pulsante Start oppure premere il tasto WINDOWS.
2. Iniziare a digitare Archiviazione di Azure Emulator.
3. Selezionare l'emulatore nell'elenco delle applicazioni visualizzate.

Quando Storage Emulator si avvia, viene visualizzata una finestra del prompt dei comandi. Usa questa finestra della console per avviare e fermare l'Emulatore di Storage. È anche possibile cancellare i dati, ottenere lo stato e inizializzare l'emulatore dal prompt dei comandi. Per altre informazioni, vedere la sezione Informazioni di riferimento sullo strumento da riga di comando dell'emulatore di archiviazione più avanti in questo articolo.

Quando l'emulatore è in esecuzione, vedi un'icona nell'area notifica della barra delle applicazioni di Windows.

Quando chiudi la finestra del prompt dei comandi dell'emulatore di archiviazione, l'emulatore di archiviazione continua a funzionare. Per visualizzare di nuovo la finestra della console dell'emulatore di archiviazione, eseguire la procedura precedente come per avviare l'emulatore di archiviazione.

La prima volta che esegui l'Emulatore di Storage, inizializza l'ambiente di archiviazione locale. Il processo di inizializzazione crea un database in LocalDB e riserva le porte HTTP per ogni servizio di archiviazione locale.

Il percorso di installazione predefinito per l'emulatore di archiviazione è C:\Program Files (x86)\Microsoft SDKs\Azure\Storage Emulator.

Inizializza l'emulatore di storage per usare un database SQL diverso

Usa lo strumento a riga di comando Storage Emulator per inizializzare l'emulatore di storage e puntare a un'istanza di database SQL diversa dall'istanza predefinita del LocalDB:

1. Aprire la finestra della console dell'emulatore di archiviazione come descritto nella sezione Avviare e inizializzare l'emulatore di archiviazione.

2. Nella finestra della console digitare il comando seguente, dove <SQLServerInstance> è il nome dell'istanza di SQL Server. Per usare LocalDB, specificare (localdb)\MSSQLLocalDb come istanza di SQL Server.

   AzureStorageEmulator.exe init /server <SQLServerInstance>

   Per indicare all'emulatore di usare l'istanza di SQL Server predefinita, digitare il comando seguente:

   AzureStorageEmulator.exe init /server .

   In alternativa, è possibile usare il comando seguente, che consente di inizializzare nuovamente l'istanza predefinita Local DB:

   AzureStorageEmulator.exe init /forceCreate

Per altre informazioni su questi comandi, vedere Informazioni di riferimento sullo strumento da riga di comando dell'emulatore di archiviazione.

Autenticazione delle richieste nell'emulatore di archiviazione

Dopo aver installato e avviato l'emulatore di storage, puoi testare il tuo codice contro di esso. Ogni richiesta eseguita per l'emulatore di archiviazione deve essere autorizzata, a meno che non si tratti di una richiesta anonima. Autorizzare le richieste contro l'Emulatore di Memoria utilizzando l'autenticazione con chiave condivisa o una firma di accesso condiviso (SAS).

Autorizzazione con credenziali con chiave condivisa

L'emulatore supporta un singolo account fisso e una chiave di autenticazione nota per l'autenticazione con chiave condivisa. Questo account e la chiave sono le uniche credenziali di chiave condivisa consentite per l'uso con l'emulatore. Sono:

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

Connettiti all'account dell'emulatore usando la scorciatoia

Il modo più semplice per eseguire la connessione all'emulatore dall'applicazione consiste nel configurare una stringa di connessione nel file di configurazione dell'applicazione che fa riferimento al collegamento UseDevelopmentStorage=true. Il collegamento rapido corrisponde alla stringa di connessione completa per l'emulatore, che specifica il nome dell'account, la chiave dell'account e gli endpoint dell'emulatore per ciascuno dei servizi di Archiviazione di Azure:

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;

Il frammento di codice .NET seguente mostra come utilizzare la scorciatoia in un metodo che accetta una stringa di connessione. Ad esempio, il costruttore blobContainerClient(String, String) accetta una stringa di connessione.

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

Assicurarsi che l'emulatore sia in esecuzione prima di chiamare il codice nel frammento di codice.

Per altre informazioni sulle stringhe di connessione, vedere Configurare le stringhe di connessione di Archiviazione di Azure.

Autorizzazione con una firma di accesso condiviso

Puoi creare un token SAS usando Storage Explorer o un'altra applicazione che supporta l'autenticazione con chiave condivisa.

È anche possibile generare un token di firma di accesso condiviso usando Azure PowerShell. L'esempio seguente genera un token di firma di accesso condiviso dotato di autorizzazioni complete per un contenitore BLOB:

1. Installare Azure PowerShell se non è già stato fatto. È consigliabile usare la versione più recente dei cmdlet di PowerShell. Per le istruzioni di installazione, vedere Installare e configurare Azure PowerShell.
2. Aprire Azure PowerShell ed eseguire i comandi seguenti, sostituendo CONTAINER_NAME con il nome scelto:

$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

L'URI della firma di accesso condiviso risultante per il nuovo contenitore sarà simile a:

http://127.0.0.1:10000/devstoreaccount1/sascontainer?sv=2012-02-12&se=2015-07-08T00%3A12%3A08Z&sr=c&sp=rwdl&sig=t%2BbzU9%2B7ry4okULN9S0wst/8MCUhTjrHyV9rDNLSe8g%3D

La firma di accesso condiviso creata con questo esempio è valida per un giorno. La firma concede l'accesso completo (lettura, scrittura, eliminazione ed elenco) ai BLOB all'interno del contenitore.

Per altre informazioni sulle firme di accesso condiviso, vedere Concedere accesso limitato alle risorse di archiviazione di Azure tramite firme di accesso condiviso.

Indirizzamento delle risorse nell'emulatore di archiviazione

Gli endpoint di servizio per l'emulatore di archiviazione sono diversi da quelle di un account di archiviazione di Azure. Il computer locale non gestisce la risoluzione dei nomi di dominio, quindi gli endpoint dell'emulatore di storage sono indirizzi locali.

Quando si indirizza una risorsa in un account di archiviazione di Azure, usare lo schema seguente. Il nome dell'account fa parte del nome host dell'URI e la risorsa indirizzata fa parte del percorso URI:

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

Ad esempio, l'URI seguente è un indirizzo valido per un BLOB in un account di archiviazione di Azure:

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

Poiché il computer locale non esegue la risoluzione dei nomi di dominio, il nome dell'account fa parte del percorso URI anziché del nome host. Usare il formato URI seguente per una risorsa nell'emulatore di archiviazione:

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

Ad esempio, l'indirizzo seguente può essere usato per accedere a un BLOB nell'emulatore di archiviazione:

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

Gli endpoint di servizio per l'emulatore di archiviazione sono:

• Servizio BLOB: http://127.0.0.1:10000/<account-name>/<resource-path>
• Servizio di coda: http://127.0.0.1:10001/<account-name>/<resource-path>
• Servizio tabelle: http://127.0.0.1:10002/<account-name>/<resource-path>

Indirizzamento dell'account secondario con RA-GRS

A partire dalla versione 3.1, l'Emulatore di archiviazione supporta l'archiviazione con ridondanza geografica e accesso in lettura (RA-GRS). Puoi accedere alla posizione secondaria aggiungendo -secondary al nome dell'account. Ad esempio, usa il seguente indirizzo per accedere a un blob tramite il secondario di sola lettura nell'emulatore di memoria:

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

Informazioni di riferimento sullo strumento da riga di comando dell'emulatore di archiviazione

A partire dalla versione 3.0, una finestra della console viene visualizzata quando si avvia l'emulatore di storage. Usare la riga di comando nella finestra della console per avviare e arrestare l'emulatore. Puoi anche interrogare lo stato ed eseguire altre operazioni dalla riga di comando.

Sintassi della riga di comando

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

Opzioni

Per visualizzare l'elenco di opzioni, digitare /help al prompt dei comandi.

Differenze tra Storage Emulator e Archiviazione di Azure

Poiché l'emulatore di archiviazione è un ambiente emulato locale, esistono differenze tra l'uso dell'emulatore e un account di archiviazione di Azure nel cloud:

• L'emulatore di archiviazione supporta solo un singolo account fisso e una chiave di autenticazione nota.
• L'emulatore di archiviazione non è un servizio di archiviazione scalabile e non supporta un numero elevato di client simultanei.
• Come descritto in Indirizzamento delle risorse nell'emulatore di archiviazione, le risorse sono indirizzate diversamente nell'emulatore di archiviazione rispetto a un account di archiviazione di Azure. La differenza esiste perché la risoluzione dei nomi di dominio è disponibile nel cloud ma non sul computer locale.
• A partire dalla versione 3.1, l'account dell'emulatore di archiviazione supporta l'archiviazione con ridondanza geografica e accesso in lettura (RA-GRS). Nell'emulatore, RA-GRS è abilitato per tutti gli account e non c'è mai alcuna latenza tra le repliche primaria e secondaria. Le operazioni Get Blob Service Stats, Get Queue Service Statistics e Get Table Service Stats sono supportate sul account secondario e restituiscono sempre il valore dell'elemento LastSyncTime di risposta come tempo corrente secondo il database SQL sottostante.
• Gli endpoint del servizio file e del servizio protocollo SMB non sono attualmente supportati nell'emulatore di archiviazione.
• Se usi una versione dei servizi di storage che l'emulatore non supporta, l'emulatore restituisce un errore VersionNotSupportedByEmulator (codice stato HTTP 400 - Richiesta Mala).

Differenze nell'archiviazione BLOB

All'archiviazione BLOB nell'emulatore si applicano le seguenti differenze:

• L'emulatore di archiviazione supporta solo dimensioni BLOB fino a 2 GB.
• La lunghezza massima di un nome BLOB nell'emulatore di archiviazione è 256 caratteri, mentre la lunghezza massima di un nome BLOB in Archiviazione di Azure è di 1024 caratteri.
• La copia incrementale consente di copiare gli snapshot da blob sovrascritti, operazione per cui il servizio restituisce un errore.
• Get Page Ranges Diff non funziona tra snapshot copiati tramite Incremental Copy Blob.
• Un'operazione Put Blob potrebbe avere esito positivo su un BLOB esistente nell'emulatore di archiviazione con un lease attivo, anche se l'ID del lease non è stato specificato nella richiesta.
• Le operazioni sui BLOB di aggiunta non sono supportate dall'emulatore. Il tentativo di eseguire un'operazione su un blob di accodamento restituisce l'errore FeatureNotSupportedByEmulator (codice di stato HTTP 400 - Richiesta non valida).

Differenze per l'archiviazione tabelle

All'archiviazione tabelle nell'emulatore si applicano le seguenti differenze:

• Le proprietà di data nel servizio tabelle nell'emulatore di archiviazione supportano solo l'intervallo supportato da SQL Server 2005 (le date devono essere successive al 1° gennaio 1753). Tutte le date precedenti a 1 gennaio 1753 vengono modificate in questo valore. La precisione delle date è limitata alla precisione di SQL Server 2005, ovvero le date sono precise a 1/300 di secondo.
• L'Emulatore di archiviazione supporta valori delle proprietà chiave di partizione e chiave di riga inferiori a 512 byte ciascuno. Le dimensioni totali del nome dell'account, del nome di tabella e dei nomi delle proprietà di chiave non possono superare 900 byte.
• Le dimensioni totali di una riga in una tabella nell'emulatore di archiviazione sono limitate a meno di 1 MB.
• Nell'emulatore di archiviazione le proprietà con tipo di dati Edm.Guid o Edm.Binary supportano solo gli operatori di confronto Equal (eq) e NotEqual (ne) nelle stringhe di filtro delle query.

Differenze per l'archiviazione di accodamento

Non vi sono differenze specifiche per Queue storage nell'emulatore.

Note sulla versione dell'emulatore di archiviazione

Versione 5.10

• L'emulatore di archiviazione non respingerà la versione 2019-07-07 dei servizi di archiviazione negli endpoint del servizio BLOB, Coda e Tabella.

Versione 5.9

• L'emulatore di storage non rifiuta la versione 2019-02-02 dei servizi di storage sugli endpoint dei servizi Blob, Queue e Table.

Versione 5.8

• L'emulatore di archiviazione non rifiuta la versione 2018-11-09 dei servizi di storage sugli endpoint dei servizi Blob, Coda e Tabella.

Versione 5.7

• Corretto un bug che causa un crash se il login è abilitato.

Versione 5.6

• L'Emulatore di archiviazione supporta la versione 2018-03-28 dei servizi di archiviazione negli endpoint di servizio Blob, Queue e Table.

Versione 5.5

• L'Emulatore di Storage supporta la versione 2017-11-09 dei servizi di storage sugli endpoint dei servizi Blob, Queue e Table.
• Aggiunta la funzionalità Created del blob, che restituisce il tempo di creazione del blob.

Versione 5.4

• Per migliorare la stabilità dell'installazione, l'emulatore non tenta più di riservare le porte in fase di installazione. Se vuoi prenotazioni di port, usa l'opzione -reserveports del comando init per specificarle.

Versione 5.3

• L'emulatore di storage supporta la versione 2017-07-29 dei servizi di storage sugli endpoint dei servizi Blob, Queue e Table.

Versione 5.2

• L'emulatore di archiviazione supporta ora la versione 2017-04-17 dei servizi di archiviazione negli endpoint di servizio Blob, Queue e Table.
• È stato risolto un bug per cui i valori delle proprietà di tabella non venivano codificati correttamente.

Versione 5.1

• È stato risolto un bug per cui l'emulatore di archiviazione restituiva l'intestazione DataServiceVersion in risposte in cui il servizio non era presente.

Versione 5.0

• Il programma di installazione dell'emulatore di archiviazione non verifica l'eventuale presenza di installazioni MSSQL e .NET Framework esistenti.
• Il programma di installazione dell'emulatore di archiviazione non crea più il database come parte del processo di installazione. L'installatore crea comunque il database se necessario durante l'avvio.
• La creazione del database non richiede più privilegi elevati.
• Per l'avvio non sono più necessarie prenotazioni di porte.
• Aggiunge a init le opzioni seguenti: -reserveports (è richiesta l'elevazione), -unreserveports(è richiesta l'elevazione) e -skipcreate.
• L'opzione Storage Emulator UI sull'icona nell'area di notifica del sistema apre ora l'interfaccia a riga di comando. L'interfaccia utente grafica precedente non è più disponibile.
• Alcune DLL sono state rimosse o rinominate.

Versione 4.6

• Storage Emulator supporta ora la versione 2016-05-31 dei servizi di archiviazione negli endpoint di servizio Blob, Queue e Table.

Versione 4.5

• Correzione di un bug che causava l'esito negativo dell'installazione e dell'inizializzazione quando il database di backup viene rinominato.

Versione 4.4

• L'emulatore di archiviazione supporta ora la versione 2015-12-11 dei servizi di archiviazione per gli endpoint BLOB, della coda e del servizio tabelle.
• La raccolta automatica dei dati blob dell'emulatore di archiviazione è ora più efficiente quando gestisce un numero elevato di blob.
• Risolto un bug che causava la convalida dell'XML ACL del contenitore in modo leggermente diverso da come fa il servizio di archiviazione.
• Risolto un bug che a volte ha causato la segnalazione di valori DateTime max e min nel fuso orario non corretto.

Versione 4.3

• L'emulatore di archiviazione supporta ora la versione 2015-07-08 dei servizi di archiviazione per gli endpoint BLOB, della coda e del servizio tabelle.

Versione 4.2

• L'Emulatore di archiviazione supporta ora la versione 2015-04-05 dei servizi di archiviazione negli endpoint dei servizi BLOB, Queue e Table.

Versione 4.1

• Storage Emulator supporta ora la versione 2015-02-21 dei servizi di archiviazione negli endpoint del servizio Blob, Queue e Table. Non supporta le nuove funzionalità degli Append Blob.
• L'emulatore restituisce ora un messaggio di errore significativo per le versioni non supportate dei servizi di archiviazione. Usa l'ultima versione dell'emulatore. Se viene visualizzato un errore VersionNotSupportedByEmulator (codice di stato HTTP 400 - Richiesta non valida), scaricare la versione più recente dell'emulatore.
• Corretto un bug in cui una condizione di gara causava errati i dati delle entità della tabella durante operazioni di fusione concorrenti.

Versione 4.0

• L'emulatore di archiviazione eseguibile è stato rinominato in AzureStorageEmulator.exe.

Versione 3.2

• L'emulatore di archiviazione supporta ora la versione 2014-02-14 dei servizi di archiviazione negli endpoint del servizio BLOB, Coda e Tabella. Gli endpoint del servizio file non sono attualmente supportati nell'emulatore di archiviazione. Vedere Controllo delle versioni per i servizi di archiviazione Azure per informazioni dettagliate sulla versione 2014-02-14.

Versione 3.1

• L'Emulatore di archiviazione ora supporta l'archiviazione con ridondanza geografica e accesso in lettura (RA-GRS). Supporta le API Get Blob Service Stats, Get Table Service Stats e LastSyncTime per l'account secondario e restituisce sempre il valore dell'elemento di risposta Get Queue Service Stats come ora corrente in base al database SQL sottostante. Per l'accesso programmatico all'endpoint secondario con l'Emulatore di archiviazione, utilizzare la libreria client di archiviazione per .NET versione 3.2 o successiva. Per ulteriori informazioni, consulta le librerie client di Archiviazione di Azure per .NET.

Versione 3.0

• L'emulatore Archiviazione di Azure non è più incluso nello stesso pacchetto dell'emulatore di calcolo.
• L'interfaccia utente grafica dell'emulatore di archiviazione è deprecata. Microsoft lo sostituì con un'interfaccia a riga di comando scriptabile. Per dettagli sull'interfaccia a riga di comando, vedi Storage Emulator Command-Line Tool Reference. L'interfaccia grafica rimane nella versione 3.0, ma puoi accedervi solo quando l'emulatore di calcolo è installato. Per accedervi, clicca con il tasto destro sull'icona della barra di sistema e seleziona Mostra interfaccia dell'emulatore di archiviazione.
• L'emulatore di archiviazione ora supporta completamente la versione 2013-08-15 dei servizi di archiviazione Azure. (In precedenza, questa versione era supportata solo dalla versione 2.2.1 Preview dell'Emulatore di Storage.)

Passaggi successivi

• Valutare l'emulatore di archiviazione open source multipiattaforma gestito dalla community Azurite.
• L'articolo Esempi di Archiviazione di Azure che usano .NET contiene collegamenti a diversi esempi di codice che è possibile usare durante lo sviluppo dell'applicazione.
• Usa Microsoft Azure Storage Explorer per lavorare con le risorse nel tuo account cloud Storage e nell'emulatore di storage.

Vedi anche

• Sviluppo locale di Archiviazione di Azure con Azurite, Azure SDK e Azure Storage Explorer