Więcej informacji o lokalizacjach produktów i zasobów w projekcie

Produkty lub zasoby, które wymagają ustawienia lokalizacji

W przypadku niektórych usług lub zasobów wymagane jest ustawienie lokalizacji.

Product Lokalizacja domyślna Informacje dodatkowe
Firebase AI Logic
  • Gemini Developer API: nie można wybrać lokalizacji; zawsze globalna.
  • W przypadku Vertex AI Gemini API: jeśli lokalizacja nie jest ustawiona, domyślny region to us-central1.
W tym miejscu uzyskasz dostęp do modelu.
Google Analytics Brak domyślnej lokalizacji.
Musisz ustawić tę lokalizację.
Ta lokalizacja to Analyticslokalizacja raportowania2, która reprezentuje kraj lub region Twojej organizacji. Twoja Analyticslokalizacja raportowania z kolei określa walutę raportowania przychodów.
Firebase App Hosting Brak domyślnej lokalizacji.
Musisz ustawić tę lokalizację dla każdego backendu.
W tej lokalizacji App HostingwdrożenieApp Hosting tworzy poszczególne zasoby backendu.
Każdy backend może znajdować się w innej lokalizacji.
Firebase Data Connect Brak domyślnej lokalizacji.
Musisz ustawić lokalizację każdego wystąpienia.
Każde wystąpienie może znajdować się w innej lokalizacji.
Cloud Firestore 1 Brak domyślnej lokalizacji.
Musisz ustawić lokalizację każdego wystąpienia.
Każde wystąpienie może znajdować się w innej lokalizacji.
Firebase Realtime Database Brak domyślnej lokalizacji.
Musisz ustawić lokalizację każdego wystąpienia.
Każde wystąpienie może znajdować się w innej lokalizacji.
Cloud Storage for Firebase 1 Brak domyślnej lokalizacji.
Musisz ustawić lokalizację każdego zasobnika.
Każdy zasobnik może znajdować się w innej lokalizacji.
Cloud Functions for Firebase 1 Jeśli lokalizacja nie jest ustawiona, domyślny region to us-central1. Każda funkcja może znajdować się w innym miejscu.

1 W zależności od tego, kiedy zaczniesz używać tych usług w projekcie, mogą one być od siebie zależne pod względem lokalizacji. Możesz spotkać się z określeniem tej zależności jako „lokalizacja domyślnych zasobów Google Cloud”. Dowiedz się więcej o tej zależności od lokalizacji.

2 Analytics lokalizacja raportowania nie ma wpływu na to, gdzie Google przetwarza i przechowuje dane klientów używane przez Firebase.

Ustawianie lokalizacji produktu lub jego zasobów

W przypadku kilku produktów lokalizację ustawiono na poziomie produktu. W przypadku większości usług lokalizację ustawia się na poziomie zasobu (np. dla każdego Cloud Storage bucketu lub każdej funkcji).

Product Kiedy i jak ustawić lokalizację Dostępne lokalizacje
Firebase AI Logic
  • Gemini Developer API: nie można wybrać lokalizacji; zawsze globalna.
  • W przypadku Vertex AI Gemini API: gdy inicjujesz usługę backendu Vertex AI w bazie kodu, możesz opcjonalnie określić lokalizację, w której model będzie dostępny.
    Jeśli nie określisz lokalizacji, domyślnym regionem będzie us-central1.
Firebase AI Logic lokalizacje
Google Analytics Gdy włączysz Google Analytics w projekcie Firebase w Firebase konsoli, pojawi się prośba o wybranie lokalizacji raportowania Analytics. Wybierz kraj lub region, w którym znajduje się Twoja organizacja.

Jeśli jesteś właścicielem lub edytującym projektu, możesz później edytować strefę czasową i walutę lokalizacji raportowania Analytics. W tym celu otwórz Google Analytics ustawienia, a następnie panel Raportowanie.

Listę znajdziesz w panelu Google Analytics Ustawienia > Raportowanie.
Firebase App Hosting Podczas tworzenia App HostingbackenduApp Hosting pojawi się prośba o wybranie lokalizacji. Aby utworzyć backend, możesz użyć Firebase konsoli, interfejsu API REST lub Firebase interfejsu wiersza poleceń. App Hosting lokalizacje
Firebase Data Connect Podczas udostępniania instancji usługi Data Connect ustawiasz jej lokalizacje. Ustawiasz też lokalizację powiązanej instancji Google Cloud SQL.
Aby aprowizować instancję, możesz użyć Firebase konsoli lub Firebase interfejsu wiersza poleceń.
Lokalizacje usługi Data Connect i instancji Cloud SQL
Cloud Firestore 1 Podczas tworzenia instancji bazy danych Cloud Firestore określasz jej lokalizację. Do udostępnienia instancji możesz użyć Firebasekonsoli, interfejsu API REST, Firebaseinterfejsu wiersza poleceń lub Terraform. Cloud Firestore lokalizacje
Firebase Realtime Database Podczas udostępniania instancji Realtime Database określasz jej lokalizację.
Do udostępnienia instancji możesz użyć Firebase konsoli, interfejsu API REST, Firebase interfejsu wiersza poleceń lub Terraform.
Realtime Database lokalizacje
Cloud Storage for Firebase 1 Podczas udostępniania zasobnika Cloud Storage określasz jego lokalizację.
Zasobnik możesz udostępnić za pomocą Firebase konsoli, interfejsu API typu REST lub Terraform.
Cloud Storage for Firebase lokalizacje
Cloud Functions for Firebase 1 Podczas pisania funkcji możesz opcjonalnie ustawić jej region.

Jeśli nie określisz lokalizacji, domyślnym regionem będzie us-central1.

Cloud Functions for Firebase lokalizacje

1 W zależności od tego, kiedy zaczniesz używać tych usług w projekcie, mogą one być od siebie zależne pod względem lokalizacji. Możesz spotkać się z określeniem tej zależności jako „lokalizacja domyślnych zasobów Google Cloud”. Dowiedz się więcej o tej zależności od lokalizacji.

Wyświetlanie ustawień lokalizacji

Product Gdzie sprawdzić ustawienie lokalizacji
Firebase AI Logic
  • Gemini Developer API: nie można wybrać lokalizacji; zawsze globalna.
  • W przypadku Vertex AI Gemini API: w bazie kodu poszukaj inicjowania usługi backendu Vertex AI. Jeśli lokalizacja nie jest podana, domyślna lokalizacja to us-central1.
Google Analytics Firebase konsoli otwórz ustawienia: Ustawienia projektu > Integracje > Google Analytics. Kliknij numer konta, aby otworzyć konto Google Analytics, a następnie przejdź do panelu Administracja, aby znaleźć informacje o lokalizacji konta.
Firebase App Hosting
  • W konsoli Firebase otwórz App Hosting, aby wyświetlić listę backendów i ich lokalizacji.
  • Aby wyświetlić lokalizację konkretnego backendu, możesz użyć polecenia interfejsu wiersza poleceń Firebase:firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Firebase Data Connect W konsoli Firebase otwórz Data Connect stronę, aby wyświetlić listę instancji bazy danych i ich lokalizacji.
Cloud Firestore W konsoli Firebase otwórz Cloud Firestore kartę Dane, aby wyświetlić listę instancji bazy danych i ich lokalizacji.
Firebase Realtime Database W konsoli Firebase otwórz Realtime Database kartę Dane, aby wyświetlić listę instancji bazy danych i ich lokalizacji.
Cloud Storage for Firebase W konsoli Firebase otwórz kartę Cloud Storage Pliki, aby wyświetlić listę zasobników i ich lokalizacji.
Cloud Functions for Firebase
  • Funkcje zaplanowane: w konsoli Google Cloud otwórz stronę Cloud Scheduler, aby wyświetlić listę tematów dla każdego zadania i funkcji. Lokalizacja to ostatni segment w nazwie tematu.
  • Funkcje nieplanowane: w kodzie źródłowym funkcji poszukaj parametru region. Jeśli region nie jest podany, domyślna lokalizacja to us-central1.

Możliwe zależności lokalizacji wynikające z ustawienia „Lokalizacja domyślnych zasobów Google Cloud”

„Lokalizacja domyślnych zasobów Google Cloud” to ustawienie lokalizacji dla wszystkich zasobów projektu powiązanych z Google App Engine, w tym:

  • domyślna instancja bazy danych Cloud Firestore,
  • domyślny Cloud Storage dla zasobnika Firebase o formacie nazwy *.appspot.com.
  • Google Cloud Scheduler używane w przypadku funkcji zaplanowanych 1 generacji

To ustawienie „Lokalizacja domyślnych zasobów Google Cloud” jest niezmienne. Jeśli ustawisz lokalizację jednego z powiązanych zasobów, pośrednio ustawisz lokalizację wszystkich pozostałych zasobów ze względu na ich wspólne powiązanie z App Engine.

Jednak w ciągu ostatnich lat w ekosystemie Firebase i Google Cloud zaszło wiele zmian, w związku z czym zmieniały się powiązania zasobów z App Engine. Co najważniejsze, od 30 października 2024 r. wszystkie nowo utworzone domyślne Cloud Storage w przypadku zasobników Firebase mają format nazwy *.firebasestorage.appnie są powiązane z App Engine.

Oto szczegóły zmian w możliwych zależnościach od lokalizacji:

  • Od 30 października 2024 r. jeśli instancja domyślna Cloud Firestore i domyślny zasobnik Cloud Storage Firebase nie zostały jeszcze utworzone:

    • Aprowizowanie domyślnej instancji Cloud Firestore określa lokalizację wszystkich przyszłych aplikacji App Engine aprowizowanych w projekcie. Nie określa jednak lokalizacji przyszłego domyślnego kosza Cloud Storage.

    • Provisioning the default Cloud Storage bucket no longer provisions an App Engine app. Thus, the location of the default Cloud Storage bucket does not dictate the location of the future default Cloud Firestore instance.

  • Od 30 października 2024 r. w przypadku, gdy domyślna instancja Cloud Firestore została już utworzona, ale domyślny kosz Cloud Storage na potrzeby Firebase nie został utworzony:

    • Obecna domyślna instancja Cloud Firestore nie określa lokalizacji przyszłego domyślnego zasobnika Cloud Storage (*.firebasestorage.app).
  • Od 30 października 2024 r. jeśli domyślny Cloud Storage w przypadku zasobnika Firebase został już utworzony (a konkretnie zasobnik *.appspot.com), ale domyślna instancja Cloud Firestore nie została utworzona:

    • Gdy został utworzony domyślny kosz Cloud Storage (*.appspot.com), App Engine aplikacja została również utworzona, a tym samym lokalizacja przyszłej domyślnej instancji Cloud Firestore została ustawiona w tym czasie. Nawet jeśli usuniesz kosz *.appspot.com, nie możesz usunąć aplikacji App Engine, więc ustawienie lokalizacji przyszłej domyślnej instancji Cloud Firestore jest już skonfigurowane.

Jeśli używasz funkcji zaplanowanych 1 generacji, ich lokalizacja jest ustawiona na lokalizację domyślnych zasobów Google Cloud. Dzieje się tak, ponieważ konta Cloud SchedulerApp Engine były wcześniej ze sobą powiązane. Jeśli skonfigurujesz funkcje harmonogramu 1 generacji przed udostępnieniem innych zasobów, które korzystają z tego ustawienia lokalizacji, musisz też ustawić ich lokalizację.

Dalsze kroki

  • Więcej informacji o tworzeniu aplikacji spełniających wymagania dotyczące opóźnień, dostępności i trwałości znajdziesz w artykule Położenie geograficzne i regiony.