Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

Inizia a usare i cluster elastici di Amazon DocumentDB

Modalità Focus
Inizia a usare i cluster elastici di Amazon DocumentDB - Amazon DocumentDB

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à.

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à.

Questa sezione introduttiva illustra come creare e interrogare il primo cluster elastico. Esistono molti modi per connettersi e iniziare a utilizzare i cluster elastici. Questa guida utilizza Amazon Elastic Compute Cloud (AmazonEC2) per connettere e interrogare il tuo cluster elastico Amazon DocumentDB direttamente da. AWS Management Console

Configurazione

Se preferisci connetterti ad Amazon DocumentDB dal tuo computer locale creando una SSH connessione a un'EC2istanza Amazon, consulta Connecting with 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
  1. Apri la https://portal.aws.amazon.com/billing/registrazione.

  2. 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.

  1. Nella barra di ricerca di AWS Management Console, digita IAM e seleziona nel menu IAMa discesa.

  2. Una volta nella IAM console, seleziona Utenti dal riquadro di navigazione.

  3. Seleziona il tuo nome utente.

  4. Fai clic sul pulsante Aggiungi autorizzazioni.

  5. Seleziona Allega direttamente le politiche.

  6. Digita AmazonDocDBFullAccess nella barra di ricerca e selezionala quando appare nei risultati della ricerca.

  7. Fai clic sul pulsante Avanti.

  8. Fai clic sul pulsante 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 Amazon Elastic Compute Cloud User Guide.

Nota

Registra il nome e l'ID del gruppo di sicurezza creato per la tua EC2 istanza Amazon.

Passaggio 1: crea 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.

Using the AWS Management Console

Per creare una configurazione di cluster elastico utilizzando AWS Management Console:

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. Nella Console di gestione Amazon DocumentDB, in Clusters, scegli Crea.

    Diagramma: creazione di cluster elastici
  3. Nella pagina Crea cluster Amazon DocumentDB, nella sezione Tipo di cluster, scegli Elastic Cluster.

    Diagramma: tipo di cluster elastico
  4. Nella pagina Crea cluster Amazon DocumentDB, nella sezione Configurazione, inserisci un identificatore univoco del cluster (seguendo i requisiti di denominazione sotto il campo).

    Diagramma: identificatore elastico del cluster
  5. Per i campi di configurazione dello shard:

    1. Nel campo Shard count, inserisci il numero di shard che desideri inserire nel cluster. Il numero massimo di shard per cluster è 32.

      Nota

      Verranno distribuiti due nodi per ogni shard. Entrambi i nodi avranno la stessa capacità di shard.

    2. Nel campo Shard instance count, scegli il numero di istanze di replica che desideri associare a ogni shard. Il numero massimo di istanze shard è 16, in incrementi di 1. Tutte le istanze di replica hanno la stessa capacità di shard definita nel campo seguente.

      Nota

      Il numero di istanze di replica si applica a tutti gli shard del cluster elastico. Un valore di conteggio delle istanze shard pari a 1 indica che esiste un'istanza di writer e tutte le istanze aggiuntive sono repliche che possono essere utilizzate per le letture e per migliorare la disponibilità.

    3. Nel campo Capacità dello shard, scegli il numero di virtual CPUs (vCPUs) che desideri associare a ciascuna istanza dello shard. Il numero massimo di istanze vCPUs per shard è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.

    Diagramma: numero e capacità dello shard del cluster elastico
  6. Nel campo Virtual Private Cloud (VPC), sceglietene uno VPC dall'elenco a discesa.

    Per le sottoreti e i gruppi VPC di sicurezza, puoi utilizzare le impostazioni predefinite o selezionare tre sottoreti a tua scelta e fino a tre gruppi di sicurezza (almeno uno). VPC

    Diagramma: cluster elastico e sottoreti VPC
  7. Nella sezione Autenticazione, inserisci una stringa che identifica il nome di accesso dell'utente principale nel campo Nome utente.

    Nel campo Password, inserisci una password univoca conforme alle istruzioni.

    Diagramma: nome utente e password del cluster elastico
  8. Nella sezione Crittografia, mantieni le impostazioni predefinite.

    Facoltativamente, puoi inserire un file AWS KMS key ARN che hai creato. Per ulteriori informazioni, consulta Critografia dei dati inattivi per i cluster elastici Amazon DocumentDB.

    Importante

    La crittografia deve essere abilitata per i cluster elastici.

  9. Nella sezione Backup, modifica i campi in base ai requisiti di backup.

    Screenshot del riquadro Backup che mostra le fasi per la configurazione della finestra di backup del cluster.
    1. Periodo di conservazione dei backup: nell'elenco, scegli il numero di giorni in cui conservare i backup automatici di questo cluster prima di eliminarli.

    2. Finestra di backup: imposta l'ora e la durata giornaliere durante le quali Amazon DocumentDB deve effettuare i backup di questo cluster.

      1. Scegli Seleziona finestra se desideri configurare l'ora e la durata di creazione dei backup.

        Ora di inizio: nel primo elenco, scegli l'ora di inizio (UTC) per avviare i backup automatici. Dal secondo elenco scegli il minuto dell'ora in cui desideri inizino i backup automatici.

        Durata: nell'elenco, scegli il numero di ore da assegnare alla creazione di backup automatici.

      2. Scegli Nessuna preferenza se desideri che Amazon DocumentDB scelga l'ora e la durata di creazione dei backup.

  10. Nella sezione Manutenzione, scegli il giorno, l'ora e la durata in cui le modifiche o le patch vengono applicate al cluster.

    Diagramma: nome utente e password del cluster elastico
  11. Scegli Create cluster (Crea cluster).

Il cluster elastico è ora in fase di provisioning. Il completamento di questa operazione può richiedere fino a qualche minuto. È possibile connettersi al cluster quando lo stato del cluster elastico viene visualizzato, come active nell'elenco Cluster.

Using the AWS CLI

Per creare un cluster elastico utilizzando il AWS CLI, utilizza l'create-clusteroperazione con i seguenti parametri:

  • --cluster-name: obbligatorio. Il nome corrente del cluster in scala elastica immesso durante la creazione o l'ultima modifica.

  • --shard-capacity: obbligatorio. Il numero vCPUs assegnato a ogni shard. Il massimo è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.

  • --shard-count: obbligatorio. Il numero di shard assegnati al cluster. Il massimo è 32.

  • --shard-instance-count—Facoltativo. Il numero di istanze di replica applicabili a tutti gli shard di questo cluster. Il massimo è 16.

  • --admin-user-name: obbligatorio. Il nome utente associato all'utente amministratore.

  • --admin-user-password: obbligatorio. La password associata all'utente amministratore.

  • --auth-type: obbligatorio. Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono PLAIN_TEXT oSECRET_ARN.

  • --vpc-security-group-ids—Facoltativo. Configura un elenco di gruppi di EC2 VPC sicurezza da associare a questo cluster.

  • --preferred-maintenance-window—Facoltativo. Configura l'intervallo di tempo settimanale durante il quale può avvenire la manutenzione del sistema, in Universal Coordinated Time (UTC).

    Il formato è:ddd:hh24:mi-ddd:hh24:mi. Giorni validi (gdd): lun, mar, mer, gio, ven, sab, dom

    L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un periodo di 8 ore per ogni regione di Amazon Web Services, che si verifica in un giorno casuale della settimana.

    Finestra minima di 30 minuti.

  • --kms-key-id—Facoltativo. Configurare l'identificatore di KMS chiave per un cluster crittografato.

    L'identificatore della KMS chiave è Amazon Resource Name (ARN) per la chiave di AWS KMS crittografia. Se stai creando un cluster utilizzando lo stesso account Amazon Web Services che possiede la chiave di KMS crittografia utilizzata per crittografare il nuovo cluster, puoi utilizzare l'alias della KMS chiave anziché quello ARN per la chiave di KMS crittografia.

    Se non è specificata una chiave di crittografia KmsKeyId e se il StorageEncrypted parametro è vero, Amazon DocumentDB utilizza la chiave di crittografia predefinita.

  • --preferred-backup-window—Facoltativo. L'intervallo di tempo giornaliero preferito durante il quale vengono creati i backup automatici. L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un periodo di 8 ore per ciascuna. Regione AWS

  • --backup-retention-period—Facoltativo. Il numero di giorni durante i quali vengono conservati i backup automatici. Il valore predefinito è 1.

  • --storage-encrypted—Facoltativo. Configura se il cluster è crittografato o meno.

    --no-storage-encryptedspecifica che il cluster non è crittografato.

  • --subnet-ids—Facoltativo. Configura gli ID delle sottoreti di rete.

Nell'esempio seguente, sostituisci ogni user input placeholder con le tue informazioni.

Nota

I seguenti esempi includono la creazione di una KMS chiave specifica. Per utilizzare la KMS chiave predefinita, non includete il --kms-key-id parametro.

Per Linux, macOS o Unix:

aws docdb-elastic create-cluster \ --cluster-name sample-cluster-123 \ --shard-capacity 8 \ --shard-count 4 \ --shard-instance-count 3 \ --auth-type PLAIN_TEXT \ --admin-user-name testadmin \ --admin-user-password testPassword \ --vpc-security-group-ids ec-65f40350 \ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7

Per Windows:

aws docdb-elastic create-cluster ^ --cluster-name sample-cluster-123 ^ --shard-capacity 8 ^ --shard-count 4 ^ --shard-instance-count 3 ^ --auth-type PLAIN_TEXT ^ --admin-user-name testadmin ^ --admin-user-password testPassword ^ --vpc-security-group-ids ec-65f40350 ^ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7

Per creare una configurazione di cluster elastico utilizzando AWS Management Console:

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. Nella Console di gestione Amazon DocumentDB, in Clusters, scegli Crea.

    Diagramma: creazione di cluster elastici
  3. Nella pagina Crea cluster Amazon DocumentDB, nella sezione Tipo di cluster, scegli Elastic Cluster.

    Diagramma: tipo di cluster elastico
  4. Nella pagina Crea cluster Amazon DocumentDB, nella sezione Configurazione, inserisci un identificatore univoco del cluster (seguendo i requisiti di denominazione sotto il campo).

    Diagramma: identificatore elastico del cluster
  5. Per i campi di configurazione dello shard:

    1. Nel campo Shard count, inserisci il numero di shard che desideri inserire nel cluster. Il numero massimo di shard per cluster è 32.

      Nota

      Verranno distribuiti due nodi per ogni shard. Entrambi i nodi avranno la stessa capacità di shard.

    2. Nel campo Shard instance count, scegli il numero di istanze di replica che desideri associare a ogni shard. Il numero massimo di istanze shard è 16, in incrementi di 1. Tutte le istanze di replica hanno la stessa capacità di shard definita nel campo seguente.

      Nota

      Il numero di istanze di replica si applica a tutti gli shard del cluster elastico. Un valore di conteggio delle istanze shard pari a 1 indica che esiste un'istanza di writer e tutte le istanze aggiuntive sono repliche che possono essere utilizzate per le letture e per migliorare la disponibilità.

    3. Nel campo Capacità dello shard, scegli il numero di virtual CPUs (vCPUs) che desideri associare a ciascuna istanza dello shard. Il numero massimo di istanze vCPUs per shard è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.

    Diagramma: numero e capacità dello shard del cluster elastico
  6. Nel campo Virtual Private Cloud (VPC), sceglietene uno VPC dall'elenco a discesa.

    Per le sottoreti e i gruppi VPC di sicurezza, puoi utilizzare le impostazioni predefinite o selezionare tre sottoreti a tua scelta e fino a tre gruppi di sicurezza (almeno uno). VPC

    Diagramma: cluster elastico e sottoreti VPC
  7. Nella sezione Autenticazione, inserisci una stringa che identifica il nome di accesso dell'utente principale nel campo Nome utente.

    Nel campo Password, inserisci una password univoca conforme alle istruzioni.

    Diagramma: nome utente e password del cluster elastico
  8. Nella sezione Crittografia, mantieni le impostazioni predefinite.

    Facoltativamente, puoi inserire un file AWS KMS key ARN che hai creato. Per ulteriori informazioni, consulta Critografia dei dati inattivi per i cluster elastici Amazon DocumentDB.

    Importante

    La crittografia deve essere abilitata per i cluster elastici.

  9. Nella sezione Backup, modifica i campi in base ai requisiti di backup.

    Screenshot del riquadro Backup che mostra le fasi per la configurazione della finestra di backup del cluster.
    1. Periodo di conservazione dei backup: nell'elenco, scegli il numero di giorni in cui conservare i backup automatici di questo cluster prima di eliminarli.

    2. Finestra di backup: imposta l'ora e la durata giornaliere durante le quali Amazon DocumentDB deve effettuare i backup di questo cluster.

      1. Scegli Seleziona finestra se desideri configurare l'ora e la durata di creazione dei backup.

        Ora di inizio: nel primo elenco, scegli l'ora di inizio (UTC) per avviare i backup automatici. Dal secondo elenco scegli il minuto dell'ora in cui desideri inizino i backup automatici.

        Durata: nell'elenco, scegli il numero di ore da assegnare alla creazione di backup automatici.

      2. Scegli Nessuna preferenza se desideri che Amazon DocumentDB scelga l'ora e la durata di creazione dei backup.

  10. Nella sezione Manutenzione, scegli il giorno, l'ora e la durata in cui le modifiche o le patch vengono applicate al cluster.

    Diagramma: nome utente e password del cluster elastico
  11. Scegli Create cluster (Crea cluster).

Il cluster elastico è ora in fase di provisioning. Il completamento di questa operazione può richiedere fino a qualche minuto. È possibile connettersi al cluster quando lo stato del cluster elastico viene visualizzato, come active nell'elenco Cluster.

Fase 2: Abilitare le connessioni in entrata

L'accesso a un cluster Amazon DocumentDB è controllato dal gruppo di sicurezza associato. In questo passaggio modificherai il gruppo di sicurezza Amazon DocumentDB per consentire la comunicazione dall'EC2istanza Amazon attraverso la porta configurata con il cluster elastico (impostazione predefinita 27017).

  1. Nella console di gestione di Amazon DocumentDB, in Clusters, individua il cluster.

    1. Scegli il cluster che hai creato facendo clic sull'identificatore del cluster.

    2. Nella scheda Connettività e sicurezza, nella sezione Sicurezza, scegli Gruppi VPC di sicurezza.

      Si apre l'elenco dei gruppi di sicurezza della console di EC2 gestione Amazon. In alternativa, puoi accedere alla console di EC2 gestione di Amazon, selezionare Gruppi di sicurezza nella sezione Rete e sicurezza.

    3. Scegli il gruppo di sicurezza Amazon DocumentDB (predefinito).

    Immagine: elenco dei gruppi di sicurezza di Amazon DocumentDB
  2. Scegli la scheda Regole in entrata (potrebbe essere necessario scorrere fino alla fine della finestra), quindi scegli Modifica regole in entrata.

    Immagine: finestra di dialogo sulle regole EC2 in entrata di Amazon
  3. Nella finestra di dialogo Modifica regole in entrata, seleziona Aggiungi regola.

    1. Per Intervallo di porte, immettere27017.

    2. Lascia Source as Custom e cerca il valore del gruppo di sicurezza che hai registrato dall'EC2istanza in cui hai creatoPrerequisiti.

    3. Scegliere Salva regole.

    Immagine: finestra di dialogo per la EC2 modifica delle regole in entrata di Amazon

Passaggio 3: installa la shell mongo

Installa la shell mongo nella tua EC2 istanza Amazon in Prerequisiti cui hai creato. La mongo shell è un'utilità a riga di comando che usi per connettere e interrogare il tuo cluster elastico.

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 4: Connect al nuovo cluster elastico

Connettiti al tuo cluster usando la shell mongo che hai installato nel passaggio 2.

  1. Nella Console di gestione Amazon DocumentDB, in Clusters, individua il cluster. Ordina per ruolo per visualizzare tutti i cluster con il ruolo Elastic Cluster.

    Diagramma: schermata dell'elenco dei cluster elastici
  2. Scegli il cluster che hai creato selezionando l'identificatore del cluster. Da Connettività e sicurezza, copia il tuo endpoint e incollalo nella tua EC2 istanza Amazon.

    Diagramma: schermata di connessione elastica del cluster
  3. Una volta connesso, dovresti vedere qualcosa di simile al seguente output:

    Diagramma: schermata finale di connessione del cluster elastico

Fase 5: 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.

  1. Per condividere una raccolta, inserisci quanto segue:

    sh.shardCollection("db.Employee1" , { "Employeeid" : "hashed" })

  2. Per inserire un singolo documento, inserisci quanto segue:

    db.Employee1.insert({"Employeeid":1, "Name":"Joe", "LastName": "Bruin", "level": 1 })

    Viene visualizzato il seguente output:

    WriteResult({ "nInserted" : 1 })

  3. 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 }
  4. 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.Employee1.insertMany([ { "Employeeid" : 1, "name" : "Matt", "lastname": "Winkle", "level": 12}, { "Employeeid" : 2, "name" : "Frank", "lastname": "Chen", "level": 2}, { "Employeeid" : 3, "name" : "Karen", "lastname": "William", "level": 7}, { "Employeeid" : 4, "name" : "Katie", "lastname": "Schaper", "level": 3} ])

    Viene visualizzato il seguente output:

    { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

  5. Per restituire tutti i documenti della raccolta di profili, immettete il comando find ():

    db.Employee1.find()

    Vengono visualizzati i dati inseriti nel passaggio 4.

  6. Per interrogare un singolo documento, includi un filtro (ad esempio: «Katie»). Immetti i seguenti dati:

    db.Employee1.find({name: "Katie"})

    Viene visualizzato il seguente output:

    { "_id" : 4, "name" : "Katie", "lastname": "Schaper", "level": 3}

  7. Per trovare un profilo e modificarlo, inserisci il findAndModify comando. In questo esempio, al dipendente «Matt» viene assegnato un livello superiore di «14":

    db.Employee1.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" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 12, }
  8. Per verificare l'aumento del livello, inserisci la seguente query:

    db.Employee1.find({name: "Matt"})

    Viene visualizzato il seguente output:

    { "_id" : 1, "name" : "Matt", "lastname" : "winkle", "level" : 14 }

Argomento successivo:

Best practice

Argomento precedente:

Come funziona
PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.