A edição Enterprise do Firestore com compatibilidade com o MongoDB já está disponível.
Saiba mais.
Guia de início rápido: criar e se conectar a um banco de dados
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
|
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
-
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.
- 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:
-
No console do Firebase, acesse a página Banco de dados do Firestore.
Acesse o banco de dados do Firestore
- Clique no banco de dados que você quer autenticar.
- No painel Explorer, clique em more_vert Ver mais.
- Selecione Conectar usando as ferramentas do MongoDB.
- 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.
-
No Console do Google Cloud, acesse a página Bancos de Dados.
Acessar "Bancos de dados"
- Selecione o banco de dados na lista.
- No menu de navegação, clique em Auth.
- Clique em Adicionar usuário.
- Digite um nome de usuário.
- Selecione uma função do Identity and Access Management para o usuário.
- 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
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[],[],null,["\u003cbr /\u003e\n\n\n|--------------------------------------------------------|\n| *Relevant to Cloud Firestore Enterprise edition only.* |\n\n\u003cbr /\u003e\n\nLearn how to create a Cloud Firestore with MongoDB compatibility database and connect to it with the\n`mongosh` tool.\n\nBefore you begin\n\n1. If you haven't already, create a Firebase project: In the [Firebase console](//console.firebase.google.com/), click **Add project** , then follow the on-screen instructions to create a Firebase project or to add Firebase services to an existing Google Cloud project.\n2. [Install the `mongosh` tool](https://www.mongodb.com/docs/mongodb-shell/install/)\n\n\u003cbr /\u003e\n\nCreate a Cloud Firestore with MongoDB compatibility database and retrieve the connection string In the Firebase console, create a new Firestore Enterprise edition database. Cloud Firestore with MongoDB compatibility requires Firestore Enterprise edition:\n1. In the Firebase console, go to the **Firestore Database** page.\n\n [Go to Firestore Database](//console.firebase.google.com/project/_/firestore/databases/-default-/data/)\n2. Click the database that you want to authenticate.\n3. In the **Explorer** panel, click more_vert **View more**.\n4. Select **Connect using MongoDB tools**.\n5. Copy the connection string.\n\n\u003cbr /\u003e\n\nThe connection string depends on the UID of the database (system-generated)\nand the location of database: \n\n```text\nUID.LOCATION.firestore.goog\n```\n\nCreate a user for SCRAM authentication\n\nIn the Google Cloud console, create a new database user and assign\nthe user Identity and Access Management permissions.\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the database from the list of databases.\n3. In the navigation menu, click **Auth**.\n4. Click **Add User**.\n5. Enter a username.\n6. Select an Identity and Access Management role for the user.\n7. Click create. The database creates a user and shows you the user's generated password. **Copy and save this password. You will not be able to retrieve\n this password later.**.\n\nConnect using `mongosh`\n\nUse the connection string, username, and password to connect to your\ndatabase, run `mongosh` locally with the following configuration options. \n\n```gdscript\nmongosh 'mongodb://\u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e:\u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e@\u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e:443/\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e: the name of the database user you created.\n- \u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e: the generated password for the database user you created.\n- \u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e: the database connection string.\n- \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e: a database ID\n\nOnce connected, you can create and read data, for example: \n\n```text\ndb.pages.insertOne({ message: \"Hello World!\"})\ndb.pages.find({})\nexit\n```\n\nWhat's next\n\n- [See a list of supported features](/docs/firestore/enterprise/supported-data-types-drivers)\n- [Learn about behavior differences in Cloud Firestore with MongoDB compatibility](/docs/firestore/enterprise/behavior-differences)\n- [Learn about additional authentication methods](/docs/firestore/enterprise/connect)"]]
