Usare il Esplora dati di Azure Cosmos DB per gestire i dati
SI APPLICA A: 
NoSQL MongoDB Cassandra Gremlin Tabella
Azure Cosmos DB Esplora dati è un'interfaccia basata sul Web che consente di visualizzare e gestire i dati archiviati in Azure Cosmos DB.
L'Esplora dati dedicato di Azure Cosmos DB (https://cosmos.azure.com) presenta alcuni vantaggi principali rispetto all'esperienza Esplora dati di portale di Azure, 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 al Esplora dati direttamente usando la sottoscrizione di Azure
È possibile usare l'accesso diretto al Esplora dati e usare le credenziali esistenti per iniziare rapidamente a usare lo strumento.
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 al Esplora dati dalla portale di Azure usando la sottoscrizione di Azure
Se si ha già familiarità con il portale di Azure, è possibile passare direttamente dal Esplora dati nel portale alla Esplora dati autonoma.
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.
Personalizzare le visualizzazioni dati con il selettore colonna personalizzato
Il selettore di colonne personalizzato in Azure Cosmos DB Esplora dati consente di personalizzare le visualizzazioni dati selezionando colonne specifiche più rilevanti per l'analisi quando si usa l'API NoSQL. In precedenza, nella visualizzazione Esplora dati elementi è possibile visualizzare solo la chiave di partizione e le colonne ID. Ora, con questa nuova funzionalità, è possibile selezionare una o più proprietà dal documento e creare colonne aggiuntive per visualizzare facilmente i dati.
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 (Facoltativo).
Nella finestra di dialogo Apri schermo intero selezionare Apri.
Una volta in Esplora dati, aprire la raccolta su cui eseguire la query, selezionare Elementi.
Fare clic sul menu con i puntini di sospensione in alto a destra di qualsiasi colonna, selezionare Modifica colonna
Selezionare le colonne da visualizzare e salvare le impostazioni.
La visualizzazione dati rifletterà ora solo le colonne selezionate, semplificando l'attenzione sui dati pertinenti.
Rimuovere una colonna personalizzata
Una volta in Esplora dati, aprire la raccolta su cui eseguire la query, selezionare Elementi.
Fare clic sul menu con i puntini di sospensione in alto a destra di qualsiasi colonna, selezionare Rimuovi colonna.
Ordinare la visualizzazione colonna crescente o decrescente
Una volta in Esplora dati, aprire la raccolta su cui eseguire la query, selezionare Elementi.
Fare clic sul menu con i puntini di sospensione in alto a destra di qualsiasi colonna, selezionare Rimuovi colonna.
Reimpostare la visualizzazione colonna
Una volta in Esplora dati, aprire la raccolta su cui eseguire la query, selezionare Elementi.
Fare clic sul menu con i puntini di sospensione in alto a destra di qualsiasi colonna, selezionare Modifica colonna.
Selezionare Reimposta per tornare alla visualizzazione predefinita. In alternativa, è possibile cancellare le impostazioni Cronologia filtri, Colonne e Riquadro di visualizzazione selezionando l'icona a forma di ingranaggio in alto a destra Esplora dati menu Globale e selezionare Cancella cronologia.
Uso della cronologia dei filtri
Cronologia filtri consente di rivedere e applicare rapidamente i filtri precedenti. Ciò consente di risparmiare dall'attività ripetitiva di ricostruire manualmente i filtri per le query ricorrenti. Con Cronologia filtri è possibile accedere a un log dei filtri precedenti e riapplicarli con un semplice clic. Questa funzionalità è particolarmente utile per gli utenti che eseguono analisi regolari su set di dati simili.
Applicare un filtro salvato
Una volta in Esplora dati, aprire la raccolta su cui eseguire la query, selezionare Elementi.
Fare clic su Modifica filtro.
Applicare un filtro ai dati come si farebbe normalmente.
Dopo aver applicato il filtro, il filtro verrà salvato automaticamente e aggiunto all'elenco di filtri predefinito nell'elenco a discesa della finestra del filtro.
Per riapplicare un filtro precedente, fare clic sul pulsante Modifica filtro.
Deselezionare qualsiasi filtro dalla finestra del filtro. Questo passaggio è necessario per poter visualizzare i filtri salvati.
Fare clic sull'elenco a discesa nella finestra del filtro e selezionare il filtro desiderato dall'elenco.
Selezionare Applica filtro
Cancellare la cronologia dei filtri
In Esplora dati fare clic sull'icona a forma di ingranaggio nell'angolo superiore destro di Esplora dati per accedere alle impostazioni
Selezionare il pulsante Cancella cronologia
Confermare di voler cancellare la cronologia. Sono incluse le posizioni di divisione colonne di filtro, le colonne personalizzate e il layout della scheda.
Modificare la visualizzazione Finestra query
È stata introdotta una nuova funzionalità nella visualizzazione query che consente di passare da una visualizzazione orizzontale a quella verticale per la query e il pannello dei risultati. È possibile passare facilmente da queste visualizzazioni selezionando l'opzione "Visualizzazioni" nel menu della barra dei comandi.
Salvare le preferenze di visualizzazione finestra query
In Esplora dati fare clic sull'icona a forma di ingranaggio nell'angolo superiore destro di Esplora dati per accedere alle impostazioni.
Selezionare "Visualizzazione risultati query predefinita" dal menu a discesa.
Selezionare orizzontale o verticale come visualizzazione predefinita.
Fare clic su Salva per applicare le impostazioni.
Configurare la soglia per le unità richiesta
Nella Esplora dati è 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.
Iniziare in Esplora risorse per 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.
> [!TIP]La soglia UR viene abilitata automaticamente con un valore predefinito di 5.000 UR.
Usare con l'autenticazione Di Microsoft Entra
È possibile usare l'autenticazione basata su Microsoft Entra all'interno di Explorer abilitandola tramite la configurazione. Per altre informazioni sul controllo degli accessi in base al ruolo, vedere la guida alla sicurezza.
Iniziare in Esplora risorse per l'account Azure Cosmos DB di destinazione.
Selezionare l'opzione di menu Impostazioni.
Nella finestra di dialogo Impostazioni configurare se si vuole
Enable Entra ID (RBAC)usare uno dei tre valori possibili:
| Descrizione | |
|---|---|
| Automatico (impostazione predefinita) | Il controllo degli accessi in base al ruolo viene usato automaticamente se l'autenticazione basata su chiave è disabilitata per l'account. In caso contrario, Esplora dati usa l'autenticazione basata su chiave per le richieste di dati. |
| Vero | Il controllo degli accessi in base al ruolo viene sempre usato per le richieste di dati. Se il controllo degli accessi in base al ruolo non è configurato correttamente per l'account o l'identità, le richieste hanno esito negativo. |
| Falso | L'autenticazione basata su chiave viene sempre usata per le richieste di dati. Se l'autenticazione basata su chiave è disabilitata, le richieste hanno esito negativo. |
Nota
La modifica di questa impostazione su un'opzione che usa l'autenticazione basata su chiave potrebbe attivare una richiesta per recuperare la chiave primaria per conto dell'identità che ha eseguito l'accesso.
Esplora dati accederà automaticamente usando l'account. Potrebbe essere visualizzata una breve finestra popup senza richiedere una voce di credenziale. Se l'accesso automatico ha esito negativo o se i popup sono bloccati nel browser, è necessario usare il pulsante Login for Entra ID RBAC (che si trova sulla barra dei comandi Esplora dati) e consentire i popup per Esplora dati prima di effettuare richieste di dati.
Suggerimento
Il Esplora dati di Azure Cosmos DB supporta anche l'opzione per impostare manualmente il valore di
Enable Entra ID (RBAC)suTrueusando l'URLhttps://cosmos.azure.com?feature.enableAadDataPlane=true.
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. Per usare il Esplora dati, tutti i ruoli personalizzati devono includere l'azione
Microsoft.DocumentDB/databaseAccounts/listKeys/*.