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

Produkty lub zasoby, które wymagają ustawienia lokalizacji

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

Product Domyślna lokalizacja Informacje dodatkowe
Firebase AI Logic
  • W przypadku 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 Hosting wdrażanie 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 po raz pierwszy zaczęto 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 „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 Storagezasobnika lub każdej funkcji).

Product Kiedy i jak ustawić lokalizację Dostępne lokalizacje
Firebase AI Logic
  • W przypadku Gemini Developer API: nie można wybrać lokalizacji; zawsze globalna.
  • W przypadku Vertex AI Gemini API: gdy zainicjujesz Vertex AI usługę backendu w bazie kodu, możesz opcjonalnie określić lokalizację, z której będzie można uzyskać dostęp do modelu.
    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 Hostingbackendu pojawi się prośba o wybranie lokalizacji. Do utworzenia backendu możesz użyć Firebasekonsoli, interfejsu API REST lub Firebaseinterfejsu wiersza poleceń. App Hosting lokalizacje
Firebase Data Connect Podczas udostępniania instancji usługi Data Connect określasz jej lokalizacje. Możesz też ustawić lokalizację powiązanej instancji Google Cloud SQL.
Aby aprowizować instancję, możesz użyć Firebase konsoli lub Firebase interfejsu wiersza poleceń.
Lokalizacje Data Connect usługi i Cloud SQL instancji
Cloud Firestore 1 Podczas udostępniania instancji bazy danych Cloud Firestore określasz jej lokalizację. Aby udostępnić instancję, 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ę.
Aby udostępnić instancję, 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 po raz pierwszy zaczęto 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 „lokalizacja domyślnych zasobów Google Cloud”. Dowiedz się więcej o tej zależności od lokalizacji.

Wyświetlanie ustawień lokalizacji

Product Gdzie można wyświetlić ustawienie lokalizacji
Firebase AI Logic
  • W przypadku 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ślną lokalizacją jest us-central1.
Google Analytics Firebase konsoli otwórz ustawienia: Ustawienia projektu > Integracje > Google Analytics. Kliknij numer rachunku bankowego, 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ć Firebasepolecenia interfejsu wiersza poleceń: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 Cloud Storage kartę 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 od lokalizacji wynikające z ustawienia „Lokalizacja 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ś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

„Lokalizacja domyślnych zasobów Google Cloud” to ustawienie, którego nie można zmienić. Jeśli ustawisz lokalizację jednego z powiązanych zasobów, pośrednio ustawisz lokalizację wszystkich pozostałych zasobów, ponieważ są one powiązane 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 zasobniki Cloud Storage w Firebase będą miały nazwę w formacie *.firebasestorage.appnie będą 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 kosz Cloud Storage Firebase nie zostały jeszcze udostępnione:

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

    • Podczas udostępniania domyślnego zasobnika Cloud Storage nie jest już udostępniana aplikacja App Engine. Dlatego lokalizacja domyślnego zasobnika Cloud Storage nie określa lokalizacji przyszłej domyślnej instancji Cloud Firestore.

  • Od 30 października 2024 r. jeśli domyślna instancjaCloud Firestore została już utworzona, ale domyślny zasobnik Cloud Storage w Firebase nie został utworzony:

    • Obecne domyślne wystąpienie Cloud Firestore nie określa lokalizacji przyszłego domyślnego zasobnika Cloud Storage (*.firebasestorage.app).
  • Od 30 października 2024 r. jeśli Cloud Storagedomyślny zasobnik 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 zaplanowane 1 generacji przed udostępnieniem innych zasobów, które współużytkują to ustawienie 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.