Guida rapida: crea un database e connettiti

Scopri come creare un database Firestore con compatibilità MongoDB e connetterti a quest'ultimo con lo strumento mongosh.

Prima di iniziare

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Verify that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Cloud Datastore Owner

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Vai a IAM
    2. Seleziona il progetto.
    3. Fai clic su Concedi l'accesso.

    4. Nel campo Nuove entità, inserisci il tuo identificatore utente. In genere si tratta dell'indirizzo email di un Account Google.

    5. Nell'elenco Seleziona un ruolo, seleziona un ruolo.
    6. Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo.
    7. Fai clic su Salva.
  5. Installare lo strumento mongosh

    6. Crea un database Firestore con compatibilità MongoDB e recupera la stringa di connessione

    Nella console Google Cloud , crea un nuovo database Firestore Enterprise. Firestore con compatibilità MongoDB richiede Firestore Enterprise:

    1. Nella console Google Cloud , vai alla pagina Database.

      Vai a Database

    2. Fai clic su Crea un database Firestore.
    3. Inserisci un ID database.
    4. Seleziona Enterprise Edition.
    5. Seleziona una posizione per il database.

    6. Fai clic su Crea database.

      Al termine dell'inizializzazione del database, la console apre Firestore Studio per il database.

    7. Nella sezione Connettiti a Firestore utilizzando uno strumento MongoDB esterno, copia la stringa di connessione.

      La stringa di connessione dipende dall'UID del database (generato dal sistema) e dalla posizione del database:

      UID.LOCATION.firestore.goog

    Crea un utente per l'autenticazione SCRAM

    Nella console Google Cloud , crea un nuovo utente del database e assegna le autorizzazioni Identity and Access Management all'utente.

    1. Nella console Google Cloud , vai alla pagina Database.

      Vai a Database

    2. Seleziona il database dall'elenco.
    3. Nel menu di navigazione, fai clic su Autenticazione.
    4. Fai clic su Aggiungi utente.
    5. Inserisci un nome utente.
    6. Seleziona un ruolo Identity and Access Management per l'utente.
    7. Fai clic su Crea. Il database crea un utente e mostra la password generata. Copia e salva questa password. Non potrai recuperare questa password in un secondo momento..

    Connettiti utilizzando mongosh

    Utilizza la stringa di connessione, il nome utente e la password per connetterti al tuo database, esegui mongosh localmente con le seguenti opzioni di configurazione.

    mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'

    Sostituisci quanto segue:

    • USERNAME: il nome dell'utente del database che hai creato.
    • PASSWORD: la password generata per l'utente del database che hai creato.
    • CONNECTION_STRING: la stringa di connessione al database.
    • DATABASE_ID: un ID database

    Una volta connesso, puoi creare e leggere i dati, ad esempio:

    db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

    Esegui la pulizia

    Per eseguire la pulizia delle risorse utilizzate in questa pagina, elimina l'utente del database ed elimina il database.

    Elimina l'utente del database

    Elimina l'utente del database per rimuovere l'utente e le autorizzazioni Identity and Access Management assegnate.

    1. Nella console Google Cloud , vai alla pagina Database.

      Vai a Database

    2. Seleziona il database dall'elenco.
    3. Nel menu di navigazione, fai clic su Autenticazione.
    4. Fai clic su Azioni nella colonna Azioni per l'utente che vuoi eliminare. Fai clic su Elimina utente. Viene visualizzata una finestra di dialogo.
    5. Conferma l'eliminazione e fai clic su Elimina.
    6. Una finestra di dialogo mostra un link alla pagina IAM. Fai clic sul link per eliminare le autorizzazioni assegnate all'utente del database.

    7. Individua la riga contenente l'entità di cui vuoi revocare l'accesso. Poi, fai clic su Modifica entità in quella riga.

      Il principal per l'utente del database che hai creato utilizza il seguente formato di denominazione:

      principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
    8. Fai clic sul pulsante Elimina per il ruolo che vuoi revocare, quindi fai clic su Salva.

    Elimina il database

    Per eliminare il database, completa i seguenti passaggi:

    1. Nella console Google Cloud , vai alla pagina Database.

      Vai a Database

    2. Fai clic su Visualizza altro nella colonna Azioni per il database che vuoi eliminare. Fai clic su Elimina. Viene visualizzata una finestra di dialogo.

    3. Nella finestra di dialogo Eliminare il database?, conferma l'eliminazione digitando l'ID del database nel campo di testo. Fai clic su Elimina. La console ti informa dell'esito positivo o negativo dell'operazione.

      Se l'operazione non riesce, visualizza i dettagli del database e verifica che la protezione dall'eliminazione sia disattivata. Per disattivare la protezione dall'eliminazione, vedi Aggiornare l'impostazione di protezione dall'eliminazione.

    Passaggi successivi