Guia de início rápido: criar e se conectar a um banco de dados

Relevante apenas para a edição Enterprise do Cloud Firestore.

Aprenda a criar um banco de dados do Cloud Firestore com compatibilidade com o MongoDB e se conectar a ele com a ferramenta mongosh.

Antes de começar

  1. Crie um projeto do Firebase se você ainda não fez isso: no console do Firebase, clique em Adicionar projeto e siga as instruções na tela para criar um projeto do Firebase ou para adicionar serviços do Firebase a um projeto do Google Cloud.
  2. Instale a ferramenta mongosh

Criar um banco de dados do Cloud Firestore com compatibilidade com o MongoDB e recuperar a string de conexão

No console do Firebase, crie um banco de dados da edição Enterprise do Firestore. O Cloud Firestore com compatibilidade com o MongoDB exige a edição Enterprise do Firestore:

  1. No console do Firebase, acesse a página Banco de dados do Firestore.

    Acesse o banco de dados do Firestore

  2. Clique no banco de dados que você quer autenticar.
  3. No painel Explorer, clique em Ver mais.
  4. Selecione Conectar usando as ferramentas do MongoDB.
  5. Copie a string de conexão.

A string de conexão depende do UID do banco de dados (gerado pelo sistema) e da localização dele:

UID.LOCATION.firestore.goog

Criar um usuário para autenticação SCRAM

No console do Google Cloud, crie um usuário do banco de dados e atribua a ele permissões do Identity and Access Management.

  1. No Console do Google Cloud, acesse a página Bancos de Dados.

    Acessar "Bancos de dados"

  2. Selecione o banco de dados na lista de bancos de dados.
  3. No menu de navegação, clique em Auth.
  4. Clique em Adicionar usuário.
  5. Digite um nome de usuário.
  6. Selecione uma função do Identity and Access Management para o usuário.
  7. Clique em "Criar". O banco de dados cria um usuário e mostra a senha gerada dele. Copie e salve essa senha. Não será possível recuperar essa senha depois..

Conectar usando mongosh

Use a string de conexão, o nome de usuário e a senha para se conectar ao banco de dados e execute mongosh localmente com as seguintes opções de configuração.

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

Substitua:

  • USERNAME: o nome do usuário do banco de dados que você criou.
  • PASSWORD: a senha gerada para o usuário do banco de dados que você criou.
  • CONNECTION_STRING: a string de conexão do banco de dados.
  • DATABASE_ID: um ID do banco de dados.

Depois de conectado, você pode criar e ler dados. Por exemplo:

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

A seguir