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

Usługi lub zasoby, które wymagają ustawienia lokalizacji

Kilka usług lub zasobów wymaga ustawienia lokalizacji.

Usługa Domyślna lokalizacja Informacje dodatkowe
Firebase AI Logic
  • W przypadku Gemini Developer API nie można wybrać lokalizacji. Jest ona zawsze globalna.
  • W przypadku Vertex AI Gemini API: jeśli lokalizacja nie jest ustawiona, domyślnym regionem jest us-central1.
Ta lokalizacja to miejsce, w którym uzyskujesz dostęp do modelu.
Google Analytics Brak domyślnej lokalizacji.
Musisz ustawić tę lokalizację. 		Ta lokalizacja to lokalizacja raportowania Analytics 2, która reprezentuje kraj lub region Twojej organizacji. Twoja lokalizacja raportowania Analytics z kolei określa walutę raportowania przychodów.
Firebase App Hosting Brak domyślnej lokalizacji.
Musisz ustawić tę lokalizację dla każdego backendu. 		Ta lokalizacja to miejsce, w którym App Hosting wdrożenie tworzy każdy z Twoich zasobów backendu.
Każdy backend może znajdować się w innej lokalizacji.
Firebase SQL Connect Brak domyślnej lokalizacji.
Musisz ustawić lokalizację dla każdej instancji. 		Każda instancja może znajdować się w innej lokalizacji.
Cloud Firestore 1 Brak domyślnej lokalizacji.
Musisz ustawić lokalizację dla każdej instancji. 		Każda instancja może znajdować się w innej lokalizacji.
Firebase Realtime Database Brak domyślnej lokalizacji.
Musisz ustawić lokalizację dla każdej instancji. 		Każda instancja może znajdować się w innej lokalizacji.
Cloud Storage for Firebase 1 Brak domyślnej lokalizacji.
Musisz ustawić lokalizację dla 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ślnym regionem jest us-central1. Każda funkcja może znajdować się w innej lokalizacji.

1 W zależności od tego, kiedy zaczęto używać tych usług w projekcie, mogą występować zależności lokalizacji między tymi usługami. Tę zależność możesz zobaczyć jako „lokalizację domyślnych Google Cloud zasobów”. Dowiedz się więcej o tej zależności lokalizacji.

2 Twoja lokalizacja raportowania Analytics nie wpływa na to, gdzie Google może przetwarzać i przechowywać dane klientów używane przez Firebase.

Ustawianie lokalizacji usługi lub jej zasobów

W przypadku niektórych usług lokalizację ustawiasz na poziomie usługi. Jednak w przypadku większości usług lokalizację ustawiasz na poziomie zasobu (np. dla każdego Cloud Storage zasobnika lub każdej funkcji).

Usługa Kiedy i jak ustawić lokalizację Dostępne lokalizacje
Firebase AI Logic
  • W przypadku Gemini Developer API nie można wybrać lokalizacji. Jest ona zawsze globalna.
  • W przypadku Vertex AI Gemini API: podczas inicjowania usługi backendu Vertex AI w bazie kodu możesz opcjonalnie określić lokalizację, w której ma być dostępny model.
    Jeśli nie określisz lokalizacji, domyślnym regionem jest us-central1.
Firebase AI Logic lokalizacje
Google Analytics Gdy włączasz Google Analytics w projekcie Firebase w Firebase konsoli, wyświetla się prośba o wybranie lokalizacji raportowania Analytics. Wybierz kraj lub region, który reprezentuje lokalizację Twojej organizacji.

Jeśli jesteś właścicielem lub edytorem 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.

Zobacz listę w Google Analytics ustawieniach > Raportowanie panelu.
Firebase App Hosting Gdy tworzysz backend App Hosting, wyświetla się prośba o wybranie lokalizacji. Do utworzenia backendu możesz użyć konsoli Firebase, interfejsu API typu REST lub interfejsu Firebase CLI. lokalizacjeApp Hosting
Firebase SQL Connect Gdy udostępniasz instancję usługi SQL Connect, ustawiasz jej lokalizacje. Ustawiasz też lokalizację powiązanej instancji Google Cloud SQL.
Do udostępnienia instancji możesz użyć konsoli Firebase lub interfejsu Firebase CLI. 		Lokalizacje usługi SQL Connect i instancji Cloud SQL
Cloud Firestore 1 Gdy udostępniasz instancję bazy danych Cloud Firestore, ustawiasz jej lokalizację. Do udostępnienia instancji możesz użyć konsoli Firebase, interfejsu API typu REST, interfejsu Firebase CLI lub Terraform. Cloud Firestore lokalizacje
Firebase Realtime Database Gdy udostępniasz instancję Realtime Database, ustawiasz jej lokalizację.
Do udostępnienia instancji możesz użyć konsoli Firebase, interfejsu API typu REST, interfejsu Firebase CLI lub Terraform. 		Realtime Database lokalizacje
Cloud Storage for Firebase 1 Gdy udostępniasz zasobnik Cloud Storage, ustawiasz jego lokalizację.
Do udostępnienia zasobnika możesz użyć konsoli Firebase, interfejsu API typu REST lub Terraform. 		Cloud Storage for Firebase lokalizacje
Cloud Functions for Firebase 1 Gdy piszesz funkcję, możesz opcjonalnie ustawić jej region.

Jeśli nie określisz lokalizacji, domyślnym regionem jest us-central1.

Cloud Functions for Firebase lokalizacje

1 W zależności od tego, kiedy zaczęto używać tych usług w projekcie, mogą występować zależności lokalizacji między tymi usługami. Tę zależność możesz zobaczyć jako „lokalizację domyślnych Google Cloud zasobów”. Dowiedz się więcej o tej zależności lokalizacji.

Wyświetlanie ustawień lokalizacji

Usługa Gdzie wyświetlić ustawienie lokalizacji
Firebase AI Logic
  • W przypadku Gemini Developer API nie można wybrać lokalizacji. Jest ona zawsze globalna.
  • W przypadku Vertex AI Gemini API w bazie kodu poszukaj inicjowania usługi backendu Vertex AI. Jeśli lokalizacja nie jest określona, domyślną lokalizacją jest us-central1.
Google Analytics W konsoli Firebase otwórz Ustawienia Ustawienia projektu > Integracje > Google Analytics. Kliknij numer rachunku bankowego, aby otworzyć konto Google Analytics, a następnie otwórz panel Administracja, aby znaleźć informacje o lokalizacji konta.
Firebase App Hosting
  • W konsoli Firebase otwórz stronę App Hosting, aby wyświetlić listę backendów i ich lokalizacji.
  • Aby wyświetlić lokalizację konkretnego backendu, możesz użyć polecenia CLI firebase apphosting:backends:get --project PROJECT_ID BACKEND_IDFirebase
Firebase SQL Connect W konsoli Firebase otwórz stronę SQL Connect, aby wyświetlić listę instancji bazy danych i ich lokalizacji.
Cloud Firestore W konsoli Firebase otwórz kartę Cloud Firestore Dane, aby wyświetlić listę instancji bazy danych i ich lokalizacji.
Firebase Realtime Database W konsoli Firebase otwórz kartę Realtime Database 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 Cloud Scheduler, aby wyświetlić listę tematów dla każdego zadania i funkcji. Lokalizacja to ostatni segment nazwy tematu.
  • Funkcje niezaplanowane: w kodzie źródłowym funkcji poszukaj region parametru. Jeśli region nie jest określony, domyślną lokalizacją jest us-central1.

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

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

  • domyślnej Cloud Firestore instancji bazy danych,
  • domyślnego Cloud Storage dla zasobnika Firebase o formacie nazwy *.appspot.com
  • Google Cloud Scheduler używanego specjalnie z funkcjami zaplanowanymi 1 generacji.

„Lokalizacja domyślnych Google Cloud zasobów” to ustawienie niezmienne. Ponadto, gdy ustawisz lokalizację jednego z powiązanych zasobów, pośrednio ustawisz lokalizację wszystkich z nich ze względu na ich wspólne powiązanie z App Engine.

Jednak w związku z wieloma zmianami w ekosystemie Firebase i Google Cloud na przestrzeni lat powiązania zasobów z App Engine uległy zmianie. Przede wszystkim od 30 października 2024 r. wszystkie nowo udostępnione domyślne Cloud Storage dla zasobników Firebase mają format nazwy *.firebasestorage.app i nie są powiązane z App Engine.

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

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

    • Udostępnienie domyślnej instancji Cloud Firestore ustawia lokalizację każdej przyszłej aplikacji App Engine udostępnionej w projekcie. Nie określa jednak lokalizacji przyszłego domyślnego Cloud Storage zasobnika.

    • Udostępnienie domyślnego zasobnika Cloud Storage nie powoduje już udostępnienia aplikacji App Engine. Lokalizacja domyślnego zasobnika Cloud Storage nie określa więc lokalizacji przyszłej domyślnej instancji Cloud Firestore.

  • Od 30 października 2024 r., jeśli domyślna Cloud Firestore instancja została już udostępniona, ale domyślny Cloud Storage for Firebase _nie_ został udostępniony:

    • Istniejąca domyślna Cloud Firestore instancja nie określa lokalizacji przyszłego domyślnego Cloud Storage zasobnika (*.firebasestorage.app).

  • Od 30 października 2024 r., jeśli domyślny Cloud Storage for Firebase został już udostępniony (konkretnie zasobnik *.appspot.com), ale domyślna Cloud Firestore instancja nie została udostępniona:

    • Gdy udostępniono domyślny zasobnik Cloud Storage(*.appspot.com), udostępniono również aplikację App Engine, a tym samym ustawiono lokalizację przyszłej domyślnej instancji Cloud Firestore. Nawet jeśli usuniesz zasobnik *.appspot.com, nie możesz usunąć aplikacji App Engine, więc ustawienie lokalizacji przyszłej domyślnej instancji Cloud Firestore jest już ustawione.

Jeśli używasz funkcji zaplanowanych 1 generacji, ich lokalizacja jest ustawiona na lokalizację domyślnych Google Cloud zasobów. Wynika to z tego, że Cloud Scheduler i App Engine były wcześniej ze sobą powiązane. Jeśli skonfigurujesz funkcje zaplanowane 1 generacji przed udostępnieniem innych zasobów, które mają to samo ustawienie lokalizacji, ustawisz też ich lokalizację.

Dalsze kroki

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