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 i cluster elastici di Amazon DocumentDB
Questa sezione introduttiva illustra come creare e interrogare il primo cluster elastico.
Esistono molti modi per connettersi e iniziare a usare Amazon DocumentDB. La procedura seguente è il modo più rapido, semplice e facile per gli utenti di iniziare a utilizzare il nostro potente database di documenti. Questa guida serve AWS CloudShella connettere e interrogare il cluster Amazon DocumentDB direttamente da. AWS Management Console I nuovi clienti idonei al piano AWS gratuito possono utilizzare Amazon DocumentDB CloudShell gratuitamente. Se il tuo AWS CloudShell ambiente o il cluster elastico di 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 5 minuti.
Argomenti
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 IAM nel menu a discesa.
-
Una volta che sei nella console IAM, seleziona Utenti dal pannello di navigazione.
-
Seleziona il tuo nome utente.
-
Fai clic su Aggiungi autorizzazione.
-
Seleziona Allega direttamente le politiche.
-
Digita
AmazonDocDBElasticFullAccess
nella barra di ricerca e selezionala quando appare nei risultati della ricerca. -
Fai clic su Next (Successivo).
-
Fai clic su Aggiungi autorizzazione.
-
Nota
Il tuo AWS account include un VPC predefinito in ogni regione. Se scegli di utilizzare un Amazon VPC, completa i passaggi nell'argomento Create a Amazon VPC nella Amazon VPC User Guide.
Fase 1: creare un cluster elastico
In questa sezione spieghiamo come creare un cluster elastico nuovo di zecca, utilizzando AWS Management Console o AWS CLI con le seguenti istruzioni.
Fase 2: Connect al cluster elastico
Connettiti al tuo cluster elastico Amazon DocumentDB utilizzando. AWS CloudShell
-
Nella console di gestione Amazon DocumentDB, in Clusters, individua il cluster elastico che hai creato. Scegli il tuo cluster facendo clic sulla casella di controllo accanto ad esso.
-
Fai clic su Connect to cluster (che si trova accanto al menu a discesa Azioni). Questo pulsante è abilitato solo dopo aver fatto clic sulla casella di controllo accanto al cluster e lo stato del cluster viene visualizzato come Disponibile. Viene visualizzata la schermata di comando CloudShell Esegui.
-
Nel campo Nuovo nome dell'ambiente, inserisci un nome univoco, ad esempio «test» e fai clic su Crea ed esegui. I dettagli dell'ambiente VPC vengono configurati automaticamente per il tuo database Amazon DocumentDB.
-
Quando richiesto, inserisci la password che hai creato nel passaggio 1: creazione di un cluster elastico Amazon DocumentDB (fase secondaria 5).
Dopo aver inserito la password e aver ricevuto la richiesta
direct: mongos] <env-name>>
, la connessione al cluster Amazon DocumentDB è avvenuta con successo
Nota
Per informazioni sulla risoluzione dei problemi, consulta Troubleshooting Amazon DocumentDB.
Fase 3: Condividi la tua raccolta, inserisci e interroga i dati
I cluster elastici aggiungono il supporto per lo sharding in Amazon DocumentDB. Ora che sei connesso al cluster, puoi suddividere il cluster, inserire dati ed eseguire alcune query.
-
Per condividere una raccolta, inserisci quanto segue:
sh.shardCollection("db.Employee1" , { "Employeeid" : "hashed" })
-
Per inserire un singolo documento, inserisci quanto segue:
db.Employee1.insertOne({"Employeeid":1, "Name":"Joe", "LastName": "Bruin", "level": 1 })
Viene visualizzato il seguente output:
WriteResult({ "nInserted" : 1 })
-
Per leggere il documento che hai scritto, inserisci il
findOne()
comando (restituisce un singolo documento):db.Employee1.findOne()
Viene visualizzato il seguente output:
{ "_id" : ObjectId("61f344e0594fe1a1685a8151"), "EmployeeID" : 1, "Name" : "Joe", "LastName" : "Bruin", "level" : 1 }
-
Per eseguire qualche altra domanda, considera un caso d'uso di un profilo di gioco. Innanzitutto, inserisci alcune voci in una raccolta intitolata «Employee». Immetti i seguenti dati:
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 } ])
Viene visualizzato il seguente output:
{ acknowledged: true, insertedIds: { '0': ObjectId('679d02cd6b5a0581be78bcbd'), '1': ObjectId('679d02cd6b5a0581be78bcbe'), '2': ObjectId('679d02cd6b5a0581be78bcbf'), '3': ObjectId('679d02cd6b5a0581be78bcc0') } }
-
Per restituire tutti i documenti della raccolta di profili, immettete il comando
find
():db.Employee.find()
Vengono visualizzati i dati inseriti nel passaggio 4.
-
Per interrogare un singolo documento, includi un filtro (ad esempio: «Katie»). Immetti i seguenti dati:
db.Employee.find({name: "Katie"})
Viene visualizzato il seguente output:
[ { _id: ObjectId('679d02cd6b5a0581be78bcc0'), Employeeid: 4, name: 'Katie', lastname: 'Schaper', level: 3 } ]
-
Per trovare un profilo e modificarlo, inserisci il
findAndModify
comando. In questo esempio, al dipendente «Matt» viene assegnato un livello superiore di «14":db.Employee.findAndModify({ query: { "Employeeid" : 1, "name" : "Matt"}, update: { "Employeeid" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 14 } })
Viene visualizzato il seguente output (si noti che il livello non è ancora cambiato):
{ _id: ObjectId('679d02cd6b5a0581be78bcbd'), Employeeid: 1, name: 'Matt', lastname: 'Winkle', level: 12 }
-
Per verificare l'aumento del livello, inserisci la seguente query:
db.Employee.find({name: "Matt"})
Viene visualizzato il seguente output:
[ { _id: ObjectId('679d02cd6b5a0581be78bcbd'), Employeeid: 1, name: 'Matt', lastname: 'Winkle', level: 14 } ]
Fase 4: Esplora
Complimenti! Hai completato con successo la procedura introduttiva per i cluster elastici di Amazon DocumentDB.
Qual è il prossimo passo? Scopri come sfruttare appieno questo database con alcune delle sue funzionalità più popolari:
Nota
Il cluster elastico che hai creato con questa procedura introduttiva continuerà a generare costi a meno che non lo elimini. Per indicazioni, consulta Eliminazione di un cluster elastico.