现已推出具有 MongoDB 兼容性的 Firestore 企业版!
了解详情。
Krótkie wprowadzenie: tworzenie bazy danych i łączenie się z nią
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Dotyczy tylko wersji Cloud Firestore Enterprise.
|
Dowiedz się, jak utworzyć bazę danych Cloud Firestore w trybie zgodności z MongoDB i połączyć się z nią za pomocą narzędzia mongosh
.
Zanim zaczniesz
-
Jeśli nie masz jeszcze projektu Firebase, utwórz go: w Firebasekonsoli kliknij Dodaj projekt, a potem postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby utworzyć projekt Firebase lub dodać usługi Firebase do istniejącego projektu Google Cloud.
- Zainstaluj narzędzie
mongosh
Tworzenie bazy danych Cloud Firestore w trybie zgodności z MongoDB i pobieranie ciągu znaków połączenia
W konsoli
Firebase utwórz nową bazę danych Firestore w wersji Enterprise.
Cloud Firestore w trybie zgodności z MongoDB wymaga wersji Enterprise Firestore:
-
W konsoli Firebase otwórz stronę Baza danych Firestore.
Otwórz bazę danych Firestore
- Kliknij bazę danych, którą chcesz uwierzytelnić.
- W panelu Eksplorator kliknij more_vert Wyświetl więcej.
- Kliknij Połącz za pomocą narzędzi MongoDB.
- Skopiuj ciąg połączenia.
Ciąg połączenia zależy od identyfikatora UID bazy danych (generowanego przez system) i lokalizacji bazy danych:
UID.LOCATION.firestore.goog
Tworzenie użytkownika na potrzeby uwierzytelniania SCRAM
W konsoli Google Cloud utwórz nowego użytkownika bazy danych i przypisz mu uprawnienia Identity and Access Management.
-
W konsoli Google Cloud otwórz stronę Bazy danych.
Otwórz Bazy danych
- Wybierz bazę danych z listy baz danych.
- W menu nawigacyjnym kliknij Uwierzytelnianie.
- Kliknij Dodaj użytkownika.
- Wpisz nazwę użytkownika.
- Wybierz rolę Identity and Access Management dla użytkownika.
- Kliknij Utwórz. Baza danych utworzy użytkownika i wyświetli wygenerowane hasło. Skopiuj to hasło i zapisz je. Nie będzie można go później odzyskać.
Połącz przy użyciu mongosh
Użyj ciągu połączenia, nazwy użytkownika i hasła, aby połączyć się z bazą danych i uruchomić mongosh
lokalnie z tymi opcjami konfiguracji:
mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'
Zastąp następujące elementy:
- USERNAME: nazwa utworzonego użytkownika bazy danych.
- PASSWORD: wygenerowane hasło użytkownika bazy danych, którego utworzono.
- CONNECTION_STRING: ciąg połączenia z bazą danych.
- DATABASE_ID: identyfikator bazy danych
Po połączeniu możesz tworzyć i odczytywać dane, np.:
db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit
Co dalej?
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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)"]]