现已推出具有 MongoDB 兼容性的 Firestore 企业版!
了解详情。
Быстрый старт: создание базы данных и подключение к ней
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Относится только к версии Cloud Firestore Enterprise. |
Узнайте, как создать облачное хранилище Firestore с совместимой базой данных MongoDB и подключиться к нему с помощью инструмента mongosh
.
Прежде чем начать
- Если вы еще этого не сделали, создайте проект Firebase: в консоли Firebase нажмите « Добавить проект» , затем следуйте инструкциям на экране, чтобы создать проект Firebase или добавить службы Firebase в существующий проект Google Cloud .
- Установить инструмент
mongosh
Создайте облачный Firestore с базой данных, совместимой с MongoDB, и получите строку подключения.
В консоли
Firebase создайте новую базу данных Firestore Enterprise Edition. Для совместимости с Cloud Firestore и MongoDB требуется версия Firestore Enterprise Edition:
В консоли Firebase перейдите на страницу базы данных Firestore .
Перейти к базе данных Firestore
- Щелкните базу данных, которую вы хотите аутентифицировать.
- На панели проводника нажмите more_vert Просмотреть больше .
- Выберите Подключиться с помощью инструментов MongoDB .
- Скопируйте строку подключения.
Строка подключения зависит от UID базы данных (генерируется системой) и расположения базы данных:
UID.LOCATION.firestore.goog
Создайте пользователя для аутентификации SCRAM
В консоли Google Cloud создайте нового пользователя базы данных и назначьте ему разрешения на управление удостоверениями и доступом.
В консоли Google Cloud перейдите на страницу Базы данных .
Перейти к базам данных
- Выберите базу данных из списка баз данных.
- В навигационном меню нажмите кнопку «Аутентификация» .
- Нажмите Добавить пользователя .
- Введите имя пользователя.
- Выберите роль управления идентификацией и доступом для пользователя.
- Нажмите «Создать». База данных создаст пользователя и покажет вам сгенерированный им пароль. Скопируйте и сохраните этот пароль. Вы не сможете восстановить его позже.
Подключиться с помощью mongosh
Используйте строку подключения, имя пользователя и пароль для подключения к базе данных, запустите mongosh
локально со следующими параметрами конфигурации.
mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'
Заменить следующее:
- USERNAME : имя созданного вами пользователя базы данных.
- PASSWORD : сгенерированный пароль для созданного вами пользователя базы данных.
- CONNECTION_STRING : строка подключения к базе данных.
- DATABASE_ID : идентификатор базы данных
После подключения вы можете создавать и считывать данные, например:
db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit
Что дальше?
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 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)"]]