Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Inizia a usare Amazon DocumentDB
Esistono molti modi per connettersi e iniziare a usare Amazon DocumentDB. Abbiamo creato questa guida perché riteniamo che questo sia il modo più rapido, semplice e facile per gli utenti di iniziare a utilizzare il nostro potente database di documenti. Questa guida utilizza Amazon Elastic Compute Cloud (AmazonEC2) per connettere e interrogare il tuo cluster Amazon DocumentDB direttamente da. AWS Management Console I nuovi clienti idonei al piano AWS gratuito possono utilizzare Amazon DocumentDB e Amazon EC2 gratuitamente. Se il tuo EC2 ambiente Amazon o il tuo cluster Amazon DocumentDB utilizza risorse oltre il livello gratuito, ti vengono addebitate le AWS tariffe normali per tali risorse. Questa guida ti aiuterà a iniziare a usare Amazon DocumentDB in meno di 15 minuti.
Nota
Le istruzioni contenute in questa guida riguardano specificamente la creazione e la connessione a cluster basati su istanze Amazon DocumentDB. Se desideri creare e connetterti a cluster elastici di Amazon DocumentDB, consulta. Inizia a usare i cluster elastici di Amazon DocumentDB
Argomenti
Se preferisci connetterti ad Amazon DocumentDB dal tuo computer locale creando una SSH connessione a un'EC2istanza Amazon, consulta Connect tramite Amazon EC2
Prerequisiti
Prima di creare il tuo primo cluster Amazon DocumentDB, devi effettuare le seguenti operazioni:
- Crea un account Amazon Web Services (AWS)
-
Prima di iniziare a utilizzare Amazon DocumentDB, devi disporre di un account Amazon Web Services (AWS). L' AWS account è gratuito. Paghi solo per i servizi e le risorse che utilizzi.
Se non ne possiedi uno Account AWS, completa i seguenti passaggi per crearne uno.
Per iscriverti a un Account AWS
Apri la https://portal.aws.amazon.com/billing/registrazione.
Segui le istruzioni online.
Nel corso della procedura di registrazione riceverai una telefonata, durante la quale sarà necessario inserire un codice di verifica attraverso la tastiera del telefono.
Quando ti iscrivi a un Account AWS, Utente root dell'account AWSviene creato un. L'utente root dispone dell'accesso a tutte le risorse e tutti i Servizi AWS nell'account. Come best practice di sicurezza, assegna l'accesso amministrativo a un utente e utilizza solo l'utente root per eseguire attività che richiedono l'accesso di un utente root.
- Imposta le autorizzazioni necessarie AWS Identity and Access Management (IAM).
-
L'accesso alla gestione delle risorse di Amazon DocumentDB come cluster, istanze e gruppi di parametri del cluster richiede credenziali che AWS possono essere utilizzate per autenticare le richieste. Per ulteriori informazioni, consulta Identity and Access Management per Amazon DocumentDB.
-
Nella barra di ricerca di AWS Management Console, digita IAM e seleziona nel menu IAMa discesa visualizzato.
-
Una volta nella IAM console, seleziona Utenti dal riquadro di navigazione.
-
Seleziona il tuo nome utente.
-
Fai clic sul pulsante Aggiungi autorizzazioni.
-
Seleziona Attach existing policies directly (Collega direttamente le policy esistenti).
-
Digita
AmazonDocDBFullAccess
nella barra di ricerca e selezionala quando appare nei risultati della ricerca. -
Fai clic sul pulsante blu in basso che dice Avanti: revisione.
-
Fai clic sul pulsante blu in basso che dice Aggiungi autorizzazioni.
-
- Crea un Amazon Virtual Private Cloud (AmazonVPC)
-
Il tuo AWS account include un valore predefinito VPC in ogni regione. Questo passaggio è necessario solo se scegli di utilizzare un Amazon predefinitoVPC. In questo caso, completa i passaggi indicati nell'VPCargomento Create a Amazon nella Amazon VPC User Guide.
- Avvia un'EC2istanza Amazon
-
Completa i passaggi 1 e 2 dell'EC2argomento Guida introduttiva ad Amazon nella Guida per l'utente di Amazon Elastic Compute Cloud.
Fase 1: creare un cluster Amazon DocumentDB
In questa fase creerai un cluster Amazon DocumentDB.
-
Nella console di gestione Amazon DocumentDB, in Clusters, scegli Crea.
-
Nella pagina Crea cluster Amazon DocumentDB, nella sezione Tipo di cluster, scegli Cluster basati su istanze (questa è l'opzione predefinita).
-
Nella sezione Configurazione:
Per l'identificatore del cluster, inserisci un nome univoco, ad esempio
mydocdbcluster
. Tieni presente che la console cambierà tutti i nomi dei cluster in lettere minuscole indipendentemente da come vengono immessi.Per la versione Engine, scegli 5.0.0.
Per la classe Instance, scegli db.t3.medium. Questa opzione è idonea per il piano gratuito. AWS
Per Numero di istanze, scegli 1 istanza. La scelta di un'istanza aiuta a ridurre al minimo i costi. Se si trattasse di un sistema di produzione, consigliamo di effettuare il provisioning di tre istanze per l'elevata disponibilità.
-
Nella sezione Configurazione dello storage del cluster, scegli Amazon DocumentDB Standard (questa è l'opzione predefinita).
-
Nella sezione Connettività:
Seleziona Connetti a una risorsa di EC2 calcolo.
Ad EC2esempio, seleziona l'EC2istanza in Prerequisiti cui hai creato.
-
Nella sezione Autenticazione, inserisci le credenziali di accesso.
-
Lascia tutte le altre opzioni come predefinite e scegli Crea cluster.
Nota
Quando configuri una connessione tra un'EC2istanza e un database Amazon DocumentDB, Amazon DocumentDB configura automaticamente il gruppo di sicurezza per VPC l'istanza e per EC2 il database Amazon DocumentDB. Per ulteriori informazioni, consulta Panoramica della connettività automatica con un'EC2istanza.
Amazon DocumentDB sta ora effettuando il provisioning del cluster, operazione che può richiedere fino a qualche minuto. Puoi connetterti al cluster quando lo stato del cluster e dell'istanza risulta disponibile.
Nota
Per informazioni sui valori dello stato del cluster, consulta il Valori dello stato del cluster capitolo Monitoring Amazon DocumentDB.
Per informazioni sui valori dello stato dell'istanza, consulta il Valori di stato delle istanze capitolo Monitoring Amazon DocumentDB.
Passaggio 2: installa la shell mongo
Installa la shell mongo nella tua EC2 istanza Amazon in Prerequisiti cui hai creato. La mongo shell è un'utilità da riga di comando che puoi utilizzare per connettere e interrogare il tuo cluster Amazon DocumentDB.
Connettiti alla tua EC2 istanza Amazon e al prompt dei comandi, crea il file di repository con il seguente comando:
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
Al termine, installa la shell mongo con il seguente comando:
sudo yum install -y mongodb-org-shell
Fase 3: Connettiti al tuo cluster Amazon DocumentDB
Connettiti al tuo cluster Amazon DocumentDB utilizzando la shell mongo che hai installato nella fase 2.
-
Nella console di gestione di Amazon DocumentDB, in Clusters, individua il cluster. Scegli il cluster che hai creato facendo clic sull'identificatore del cluster.
-
Encryption-in-transit è abilitato per impostazione predefinita su Amazon DocumentDB. Facoltativamente, puoi disabilitare. TLS Per scaricare il certificato corrente richiesto per l'autenticazione nel cluster, nella scheda Connettività e sicurezza, nella sezione Connect, sotto Scarica il certificato Amazon DocumentDB Certificate Authority (CA) necessario per l'autenticazione nel cluster, copia il comando fornito. Torna alla tua EC2 istanza Amazon e incolla il comando.
-
Torna al tuo cluster nella console Amazon DocumentDB, nella scheda Connettività e sicurezza, nella sezione Connect, sotto Connect a questo cluster con la shell mongo, copia la stringa di connessione fornita. Ometti la copia
<insertYourPassword>
in modo che ti venga richiesta la password dalla shell mongo quando ti connetti.Torna alla tua EC2 istanza Amazon e incolla la stringa di connessione.
Quando inserisci la password e il prompt diventars0:PRIMARY>
, sei connesso correttamente al tuo cluster Amazon DocumentDB.
Nota
Per informazioni sulla risoluzione dei problemi, consulta Troubleshooting Amazon DocumentDB.
Fase 4: Inserimento e interrogazione dei dati
Ora che sei connesso al cluster, puoi eseguire alcune query per acquisire familiarità con l'utilizzo di un database di documenti.
-
Per inserire un singolo documento, inserisci quanto segue:
db.collection.insert({"hello":"DocumentDB"})
-
Otterrete il seguente risultato:
WriteResult({ "nInserted" : 1 })
-
Puoi leggere il documento che hai scritto con il
findOne()
comando (perché restituisce solo un singolo documento). Inserisci quanto segue:db.collection.findOne()
-
Si ottiene il seguente risultato:
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }
-
Per eseguire qualche altra domanda, considera un caso d'uso dei profili di gioco. Innanzitutto, inserisci alcune voci in una raccolta intitolata
profiles
. Inserisci quanto segue:db.profiles.insertMany([ { "_id" : 1, "name" : "Matt", "status": "active", "level": 12, "score":202}, { "_id" : 2, "name" : "Frank", "status": "inactive", "level": 2, "score":9}, { "_id" : 3, "name" : "Karen", "status": "active", "level": 7, "score":87}, { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27} ])
-
Si ottiene il seguente risultato:
{ "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }
-
Utilizzate il
find()
comando per restituire tutti i documenti nella raccolta dei profili. Inserisci quanto segue:db.profiles.find()
-
Otterrai un output che corrisponderà ai dati che hai digitato nel passaggio 5.
-
Usa una query per un singolo documento usando un filtro. Inserisci quanto segue:
db.profiles.find({name: "Katie"})
-
Dovresti recuperare questo risultato:
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
-
Ora proviamo a trovare un profilo e modificarlo usando il
findAndModify
comando. Daremo all'utente Matt altri dieci punti con il seguente codice:db.profiles.findAndModify({ query: { name: "Matt", status: "active"}, update: { $inc: { score: 10 } } })
-
Otterrete il seguente risultato (notate che il suo punteggio non è ancora aumentato):
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 202 }
-
Puoi verificare che il suo punteggio sia cambiato con la seguente domanda:
db.profiles.find({name: "Matt"})
-
Si ottiene il seguente risultato:
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
Fase 5: Esplora
Complimenti! Hai completato con successo la Guida introduttiva ad Amazon DocumentDB.
Qual è il prossimo passo? Scopri come sfruttare appieno questo database con alcune delle sue funzionalità più popolari:
Nota
Il cluster creato con questo esercizio introduttivo continuerà a generare costi a meno che non venga eliminato. Per istruzioni, consulta Eliminazione di un cluster Amazon DocumentDB.