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

Nie ma globalnego ustawienia lokalizacji na poziomie projektu ani aplikacji.
Lokalizacje są ustawiane dla poszczególnych usług lub zasobów, a w niektórych przypadkach dla grup usług. Zwykle jednak lokalizację każdego produktu i zasobu ustawia się niezależnie od innych.

Pamiętaj, że niektóre usługi i zasoby Firebase nie obsługują wyboru lokalizacji. Możesz też opcjonalnie ustawić ograniczenie lokalizacji na poziomie organizacji w przypadku usług i zasobów, które obsługują wybór lokalizacji.

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

Niektóre usługi lub zasoby wymagają 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 Agent Platform Gemini API (formerly Vertex AI): jeśli lokalizacja nie jest ustawiona, domyślnym regionem jest us-central1.	W tej lokalizacji uzyskujesz dostęp do modelu.
Google Analytics	Brak domyślnej lokalizacji. Musisz ustawić tę lokalizację.	Ta lokalizacja to Analytics lokalizacja raportowania^2, która reprezentuje kraj lub region Twojej organizacji. Z kolei lokalizacja raportowania Analytics określa walutę w raportach Przychody.
Firebase App Hosting	Brak domyślnej lokalizacji. Musisz ustawić tę lokalizację dla każdego backendu.	W tej lokalizacji wdrożenie App Hosting tworzy każdy z 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ę 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.

¹ W zależności od tego, kiedy po raz pierwszy zaczęto używać tych usług w projekcie, mogą występować między nimi zależności lokalizacyjne. Ta zależność może być określana jako „lokalizacja domyślnych zasobów Google Cloud”. Dowiedz się więcej o zależności od lokalizacji.

² Lokalizacja raportowania Analytics nie wpływa na to, gdzie Google może przetwarzać i przechowywać dane klientów Firebase.

Ustawianie lokalizacji usługi lub jej zasobów

W przypadku kilku produktów lokalizację ustawiasz na poziomie produktu. Jednak w przypadku większości usług lokalizację ustawia się na poziomie zasobu (np. dla każdego zasobnika Cloud Storage 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 Agent Platform Gemini API (formerly Vertex AI): gdy inicjujesz usługę backendu Agent Platform w bazie kodu, możesz opcjonalnie określić lokalizację, w której chcesz uzyskać dostęp do modelu. Jeśli nie określisz lokalizacji, domyślnym regionem będzie us-central1.	Lokalizacje: Firebase AI Logic
Google Analytics	Gdy włączysz Google Analytics w projekcie Firebase w konsoli Firebase, pojawi się prośba o wybranie lokalizacji raportowania Analytics. Wybierz kraj lub region, który odpowiada lokalizacji Twojej organizacji. Jeśli jesteś właścicielem projektu lub edytującym, możesz później zmienić strefę czasową i walutę lokalizacji raportowania Analytics. Aby to zrobić, otwórz ustawienia Google Analytics, a następnie panel Raportowanie.	Listę znajdziesz w panelu Ustawienia Google Analytics > Raportowanie.
Firebase App Hosting	Podczas tworzenia backendu App Hosting pojawi się prośba o wybranie lokalizacji. Aby utworzyć backend, możesz użyć konsoli Firebase, interfejsu API typu REST lub interfejsu wiersza poleceń Firebase.	App Hosting lokalizacje
Firebase SQL Connect	Podczas udostępniania instancji 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 wiersza poleceń Firebase.	Lokalizacje usługi SQL Connect i instancji Cloud SQL
Cloud Firestore ^1	Podczas udostępniania instancji bazy danych Cloud Firestore ustawiasz jej lokalizację. Do udostępnienia instancji możesz użyć konsoli Firebase, interfejsu API typu REST, interfejsu wiersza poleceń Firebase lub Terraform.	Lokalizacje: Cloud Firestore
Firebase Realtime Database	Podczas udostępniania instancji Realtime Database ustawiasz jej lokalizację. Do udostępnienia instancji możesz użyć konsoli Firebase, interfejsu API typu REST, interfejsu wiersza poleceń Firebase lub Terraform.	Lokalizacje: Realtime Database
Cloud Storage for Firebase ^1	Podczas udostępniania zasobnika Cloud Storage ustawiasz jego lokalizację. Do udostępnienia zasobnika możesz użyć konsoli Firebase, interfejsu API typu REST lub Terraform.	Lokalizacje: Cloud Storage for Firebase
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.	Lokalizacje: Cloud Functions for Firebase

¹ W zależności od tego, kiedy po raz pierwszy zaczęto używać tych usług w projekcie, mogą występować między nimi zależności lokalizacyjne. Ta zależność może być określana jako „lokalizacja domyślnych zasobów Google Cloud”. Dowiedz się więcej o 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 Agent Platform Gemini API (formerly Vertex AI): w bazie kodu poszukaj inicjowania usługi backendu Agent Platform. Jeśli nie określisz lokalizacji, zostanie użyta domyślna lokalizacja us-central1.
Google Analytics	W konsoli Firebase 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 stronę App Hosting, aby wyświetlić listę backendów i ich lokalizacji. Aby wyświetlić lokalizację konkretnego backendu, możesz użyć polecenia Firebase interfejsu wiersza poleceń firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID.
Firebase SQL Connect	W konsoli Firebase otwórz stronę SQL Connect, aby wyświetlić listę instancji bazy danych i ich lokalizacje.
Cloud Firestore	W konsoli Firebase otwórz kartę Cloud Firestore Dane, aby wyświetlić listę instancji bazy danych i ich lokalizacje.
Firebase Realtime Database	W konsoli Firebase otwórz kartę Realtime Database Dane, aby wyświetlić listę instancji bazy danych i ich lokalizacje.
Cloud Storage for Firebase	W konsoli Firebase otwórz kartę Cloud Storage Pliki, aby wyświetlić listę zasobników i ich lokalizacje.
Cloud Functions for Firebase	Zaplanowane funkcje: w konsoli Google Cloud otwórz Cloud Scheduler, aby wyświetlić listę tematów dla każdego zadania i funkcji. Lokalizacja to ostatni segment w nazwie tematu. Funkcje niezaplanowane: w kodzie źródłowym funkcji poszukaj parametru region. Jeśli region nie jest określony, domyślną lokalizacją jest us-central1.

Możliwe zależności lokalizacji ze względu na „lokalizację 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 zasobnik Cloud Storage dla Firebase o nazwie w formacie *.appspot.com,
• Google Cloud Scheduler używane specjalnie z funkcjami zaplanowanymi 1 generacji

Uwaga: żadne inne zasoby w projekcie nie mają tej zależności lokalizacji, w tym: instancje Bazy danych czasu rzeczywistego, niestandardowe instancje Cloud Firestore, niestandardowe zasobniki Cloud Storage, domyślne zasobniki Cloud Storage o nazwie w formacie *.firebasestorage.app, funkcje niezaplanowane i zaplanowane funkcje 2 generacji.

To ustawienie „lokalizacji domyślnych zasobów Google Cloud” jest niezmienne. 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 ciągu ostatnich lat w ekosystemie Firebase i Google Cloud zaszło wiele zmian, które wpłynęły na powiązania zasobów z App Engine. Przede wszystkim od 30 października 2024 r. wszystkie nowo udostępnione domyślne zasobniki Cloud Storage dla Firebase mają format nazwy *.firebasestorage.app i nie są powiązane z App Engine.

Kluczowa kwestia: od 30 października 2024 r. udostępnienie domyślnego zasobnika Cloud Storage dla Firebase nie powoduje ustawienia „lokalizacji domyślnych zasobów Google Cloud” (takich jak lokalizacja domyślnej instancji Cloud Firestore projektu). Ponadto udostępnienie domyślnej instancji Cloud Firestore nie powoduje już ustawienia lokalizacji nowego domyślnego zasobnika Cloud Storage dla Firebase (o formacie nazwy *.firebasestorage.app).

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 dla Firebase nie zostały jeszcze udostępnione:

  • Udostępnienie domyślnej instancji Cloud Firestore powoduje ustawienie lokalizacji dla wszystkich przyszłych aplikacji App Engine udostępnionych w projekcie. Nie określa jednak lokalizacji przyszłego domyślnego zasobnika Cloud Storage.

  • Udostępnienie domyślnego zasobnika Cloud Storage nie powoduje już udostępnienia aplikacji App Engine. W związku z tym 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 instancja Cloud Firestore została już udostępniona, ale domyślny zasobnik Cloud Storage dla Firebase nie został udostępniony:

  • Istniejąca 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 zasobnik Cloud Storage dla Firebase został już udostępniony (konkretnie zasobnik *.appspot.com), ale domyślna instancja Cloud Firestore nie została udostępniona:

  • Gdy udostępniono domyślny zasobnik Cloud Storage (*.appspot.com), udostępniono też aplikację App Engine, co oznacza, że lokalizacja przyszłej domyślnej instancji Cloud Firestore została ustawiona w tym momencie. 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ż skonfigurowane.

Jeśli używasz zaplanowanych funkcji 1 generacji, ich lokalizacja jest ustawiona na lokalizację domyślnych zasobów Google Cloud. Dzieje się tak, ponieważ konta Cloud Scheduler i App Engine były wcześniej powiązane. Jeśli skonfigurujesz zaplanowane funkcje 1 generacji przed udostępnieniem innych zasobów, które współdzielą to ustawienie lokalizacji, ustawisz też 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.