Usare Azure Cosmos DB Explorer per gestire i dati
SI APPLICA A: NoSQL MongoDB Cassandra Gremlin Tabella
Azure Cosmos DB Explorer è un'interfaccia autonoma basata sul Web che consente di visualizzare e gestire i dati archiviati in Azure Cosmos DB. Azure Cosmos DB Explorer è equivalente alla sezione Esplora dati disponibile nel portale di Azure per gli account Azure Cosmos DB.
Azure Cosmos DB Explorer offre alcuni vantaggi significativi rispetto a Esplora dati, tra cui:
- Area a schermo intero per esplorare i dati, eseguire query e osservare i risultati delle query
- Possibilità di fornire agli utenti senza accesso al portale di Azure o a una sottoscrizione di Azure funzionalità di lettura o di lettura/scrittura sui dati nei contenitori
- Possibilità di condividere i risultati delle query con gli utenti che non hanno una sottoscrizione di Azure o l'accesso al portale di Azure
Prerequisiti
- Un account Azure Cosmos DB esistente.
- Se non si ha una sottoscrizione di Azure, provare gratuitamente Azure Cosmos DB.
Accedere direttamente a Explorer usando la sottoscrizione di Azure
È possibile usare direttamente Explorer e usare le credenziali esistenti per iniziare a usare lo strumento rapidamente.
Accedere a https://cosmos.azure.com.
Selezionare Accedi. Accedere usando le credenziali esistenti che hanno accesso all'account Azure Cosmos DB.
Selezionare quindi la sottoscrizione di Azure e l'account di destinazione dal menu Selezionare un account di database.
Accedere a Explorer dal portale di Azure usando la sottoscrizione di Azure
Se si ha già familiarità con il portale di Azure, è possibile passare direttamente da Esplora dati nel portale a Explorer autonomo.
Accedi al portale di Azure.
Passare all'account Azure Cosmos DB esistente.
Nel menu della risorsa selezionare Esplora dati.
Selezionare quindi l'opzione di menu Apri schermo intero.
Nella finestra di dialogo Apri schermo intero selezionare Apri.
Concedere a un altro utente l'accesso a Explorer usando una stringa di connessione
Usare la chiave lettura/scrittura o sola lettura per concedere a un altro utente l'accesso all'account Azure Cosmos DB. Questo metodo funziona anche se l'utente non ha accesso a una sottoscrizione di Azure o al portale di Azure.
Accedi al portale di Azure.
Passare all'account Azure Cosmos DB esistente.
Nel menu della risorsa selezionare Chiavi.
Nella pagina Chiavi selezionare l'opzione Chiavi di lettura/scrittura o Chiavi di sola lettura. Copiare quindi il valore del campo Stringa di connessione primaria. Questo valore verrà usato in un passaggio successivo.
Descrizione Chiave di lettura/scrittura Fornisce l'accesso per visualizzare e modificare database, contenitori, query e altre risorse associate a tale account specifico Chiave di sola lettura Fornisce l'accesso per visualizzare database, contenitori, query e altre risorse associate a tale account specifico Suggerimento
Se asi vogliono condividere i risultati di una query con i colleghi del team che non dispongono dell'accesso a una sottoscrizione di Azure o al portale di Azure è possibile concedere loro l'accesso di sola lettura.
A questo punto, l'altro utente deve passare a https://cosmos.azure.com.
Selezionare Connettersi all'account con la stringa di connessione. Quindi, chiedere all'utente di immettere la stringa di connessione copiata in precedenza e selezionare Connetti.
Configurare la soglia per le unità richiesta
In Explorer è possibile configurare un limite per le unità richiesta al secondo (UR/sec) usate dalle query. Usare questa funzionalità per controllare i costi e le prestazioni delle unità richiesta (UR) delle query. Questa funzionalità può anche annullare automaticamente le query con costi elevati.
In Explorer selezionare l'account Azure Cosmos DB di destinazione.
Selezionare l'opzione di menu Impostazioni.
Nella finestra di dialogo Impostazioni selezionare Abilitare soglia UR e il valore Soglia UR effettivo.
Suggerimento
La soglia UR viene abilitata automaticamente con un valore predefinito di 5.000 UR.
Problemi noti
Di seguito sono riportati alcuni problemi noti:
L'esplorazione di elementi che contengono un UUID non è supportata in Esplora dati. Questa limitazione non influisce sul caricamento dei contenitori, solo sulla visualizzazione di singoli elementi o query che includono questi elementi. Per visualizzare e gestire questi elementi, gli utenti devono continuare a usare gli stessi strumenti/SDK usati in origine per crearli.
Possono verificarsi errori HTTP 401 a causa di autorizzazioni di controllo degli accessi in base al ruolo insufficienti per l'account Microsoft Entra ID. Questa condizione può verificarsi in particolare quando all'account è assegnato un ruolo personalizzato. In tutti i ruoli personalizzati deve essere inclusa l'azione
Microsoft.DocumentDB/databaseAccounts/listKeys/*
per usare Explorer.