Guida rapida: crea un database e connettiti

Scopri come creare un database Firestore con compatibilità MongoDB e connettiti con lo strumentomongosh.

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. Make sure that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: roles/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 accesso.

    4. Nel campo Nuovi principali, 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. Installa lo strumento mongosh

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

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

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

    Vai a Database

  2. Fai clic su Crea un database Firestore.
  3. Inserisci un ID database.
  4. Seleziona la versione Enterprise.
  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

Creare un utente per l'autenticazione SCRAM

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

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

    Vai a Database

  2. Seleziona il database dall'elenco dei database.
  3. Nel menu di navigazione, fai clic su Auth.
  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 database, quindi esegui mongosh localmente con le seguenti opzioni di configurazione.

mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&authMechanismProperties=ENVIRONMENT:gcp,TOKEN_RESOURCE:FIRESTORE&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 collegati, puoi creare e leggere i dati, ad esempio:

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

Esegui la pulizia

Per ripulire le 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 di Identity and Access Management assegnate.

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

    Vai a Database

  2. Seleziona il database dall'elenco dei database.
  3. Nel menu di navigazione, fai clic su Auth.
  4. Fai clic su Azioni nella colonna Azioni relativa all'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. In una finestra di dialogo viene visualizzato 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. quindi fai clic su Modifica entità in quella riga.

    Il principale 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 e poi su Salva.

Elimina il database

Per eliminare il database:

  1. Nella Google Cloud console, 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 Vuoi eliminare il database?, conferma l'eliminazione digitando l'ID del database nel campo di testo. Fai clic su Elimina. La console ti informa sull'esito positivo o negativo dell'operazione.

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

Passaggi successivi