Guida introduttiva: Creare un cluster Di Azure DocumentDB usando il portale di Azure

In questa guida rapida si crea un nuovo cluster di Azure DocumentDB. Questo cluster contiene tutte le risorse tipiche di MongoDB: database, raccolte e documenti. Il cluster fornisce un endpoint univoco per vari strumenti e driver per connettersi ad Azure DocumentDB ed eseguire operazioni quotidiane.

Prerequisiti

• Una sottoscrizione di Azure

  • Se non hai un abbonamento Azure, crea un account gratuito

Creare un cluster

Per iniziare, è prima necessario creare un cluster Di Azure DocumentDB, che funge da base per l'archiviazione e la gestione dei dati NoSQL.

1. Accedere al portale di Azure (https://portal.azure.com).

2. Nel menu del portale di Azure o dalla pagina Home selezionare Crea una risorsa.

3. Nella pagina Nuovo cercare e selezionare Azure DocumentDB.

   

4. Nella pagina Crea cluster Azure DocumentDB e nella sezione Informazioni di base, nella sezione selezionare l'opzione Configura nella sezione Livello cluster.

   

5. Nella pagina Scalabilità configurare queste opzioni e quindi selezionare Salva per rendere persistenti le modifiche apportate al livello cluster.

   	Value
   Livello cluster	M30 tier, 2 vCore, 8-GiB RAM
   Spazio di archiviazione per partizione	128 GiB

   

6. Nella sezione Informazioni di base configurare le opzioni seguenti:

   	Value
   Subscription	Selezionare la sottoscrizione di Azure
   Gruppo di risorse	Creare un nuovo gruppo di risorse o selezionare un gruppo di risorse esistente
   Nome del cluster	Specificare un nome univoco globale
   Ubicazione	Selezionare un'area di Azure supportata per la sottoscrizione
   Versione di MongoDB	Selezionare 8.0
   Nome utente amministratore	Creare un nome utente per accedere al cluster come amministratore utente
   Parola d’ordine	Usare una password univoca associata al nome utente

   

   Suggerimento

   Registrare i valori usati per nome utente e password. Questi valori vengono usati più avanti in questa guida. Per altre informazioni sui valori validi, vedere Limitazioni del cluster.

7. Selezionare Avanti: Rete.

8. Nella sezione Regole del firewall della scheda Rete configurare queste opzioni:

   	Value
   Metodo di connettività	Public access
   Consentire l'accesso pubblico da servizi e risorse di Azure in Azure a questo cluster	abilitato

9. Aggiungere una regola del firewall per il dispositivo client corrente per concedere l'accesso al cluster selezionando + Aggiungi indirizzo IP client corrente.

   

   Suggerimento

   In molti ambienti aziendali, gli indirizzi IP del computer per sviluppatori sono nascosti a causa di una VPN o di altre impostazioni di rete aziendale. In questi casi, è possibile consentire temporaneamente l'accesso a tutti gli indirizzi IP aggiungendo l'intervallo 0.0.0.0 - 255.255.255.255 di indirizzi IP come regola del firewall. Usare questa regola del firewall solo temporaneamente come parte del test e dello sviluppo delle connessioni.

10. Selezionare Rivedi e crea.

11. Rivedere le impostazioni specificate e quindi selezionare Crea. La creazione del cluster richiede alcuni minuti. Attendere il completamento della distribuzione delle risorse.

12. Infine, selezionare Vai alla risorsa per passare al cluster Azure DocumentDB nel portale.

Ottenere le credenziali del cluster

Ottenere le credenziali usate per connettersi al cluster.

1. Nella pagina del cluster selezionare l'opzione Stringhe di connessione nel menu della risorsa.

2. Nella sezione Stringhe di connessione copiare o registrare il valore dal campo Stringa di connessione .

Importante

La stringa di connessione nel portale non include il valore della password. È necessario sostituire il <password> segnaposto con le credenziali immesse al momento della creazione del cluster o immettere la password in modo interattivo.

Connettersi usando la shell MongoDB dell'avvio rapido.

Per connettersi direttamente ad Azure DocumentDB usando MongoDB Shell, usare l'esperienza di avvio rapido disponibile nella pagina della risorsa nel portale di Azure.

1. Nella pagina della risorsa cluster, selezionare Avvio rapido (anteprima) dal menu di navigazione.

2. Selezionare quindi Open MongoDB shell (Apri shell MongoDB).

3. Attendere l'avvio dell'ambiente shell mongoDB.

4. Quando l'ambiente è pronto, immettere Y per accettare l'avviso.

   Annotazioni

   Se si verifica un problema durante la connessione tramite MongoDB Shell dopo aver accettato l'avviso, assicurarsi che Azure Cloud Shell abbia accesso al cluster.

5. Immettere ora la password per connettere il cluster a Cloud Shell.

Eseguire query di test

Verificare di essere connessi correttamente al cluster eseguendo una serie di comandi e query di test.

1. Controllare lo stato della connessione eseguendo il connectionStatus comando .

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. Elencare i database nel cluster.

   show dbs
   

3. Passare a un database specifico. Sostituire il <database-name> segnaposto con il nome di qualsiasi database nel cluster.

   use <database-name>
   

   Suggerimento

   Ad esempio, se il nome del database è inventory, il comando sarà use inventory.

4. Elencare le raccolte all'interno del database.

   show collections
   

5. Trovare i primi cinque elementi all'interno di una raccolta specifica. Sostituire il segnaposto <collection-name> con il nome di una raccolta nel cluster.

   db.<collection-name>.find().limit(5)
   

   Suggerimento

   Ad esempio, se il nome della raccolta è equipment, il comando sarà db.equipment.find().limit(5).

Pulire le risorse

Al termine dell'operazione con il cluster Azure DocumentDB, è possibile eliminare le risorse di Azure create in modo da non comportare costi aggiuntivi.

1. Nella barra di ricerca del portale di Azure cercare e selezionare Gruppi di risorse.

   

2. Nell'elenco, selezionare il gruppo di risorse utilizzato in questa guida introduttiva.

   

3. Nella pagina del gruppo di risorse selezionare Elimina gruppo di risorse.

4. Nella finestra di dialogo di conferma dell'eliminazione, immettere il nome del gruppo di risorse per confermarne l'eliminazione. Infine, selezionare Elimina per eliminare definitivamente il gruppo di risorse.

   

Contenuti correlati

• Connettersi alla shell di MongoDB
• Connettersi da Azure Cloud Shell
• Eseguire la migrazione dei dati ad Azure DocumentDB