Tìm hiểu về vị trí cho các sản phẩm và tài nguyên trong dự án của bạn

Sản phẩm hoặc tài nguyên yêu cầu bạn thiết lập vị trí

Một số sản phẩm hoặc tài nguyên yêu cầu bạn phải thiết lập vị trí.

Sản phẩm Vị trí mặc định Thông tin khác
Firebase AI Logic
  • Đối với Gemini Developer API: Không thể chọn vị trí; luôn là vị trí toàn cầu.
  • Đối với Vertex AI Gemini API: Nếu bạn không đặt vị trí, thì khu vực mặc định là us-central1.
Đây là vị trí bạn truy cập vào mô hình.
Google Analytics Không có vị trí mặc định.
Bạn phải đặt vị trí này.
Vị trí này là Analytics vị trí báo cáo2, cho biết quốc gia hoặc khu vực của tổ chức. Vị trí báo cáo Analytics của bạn sẽ đặt đơn vị tiền tệ cho báo cáo doanh thu.
Firebase App Hosting Không có vị trí mặc định.
Bạn phải đặt vị trí này cho từng phần phụ trợ.
Vị trí này là nơi triển khai App Hosting tạo từng tài nguyên phụ trợ của bạn.
Mỗi phần phụ trợ có thể ở một vị trí khác nhau.
Firebase Data Connect Không có vị trí mặc định.
Bạn phải đặt vị trí cho từng phiên bản.
Mỗi phiên bản có thể ở một vị trí khác nhau.
Cloud Firestore 1 Không có vị trí mặc định.
Bạn phải đặt vị trí cho từng phiên bản.
Mỗi phiên bản có thể ở một vị trí khác nhau.
Firebase Realtime Database Không có vị trí mặc định.
Bạn phải đặt vị trí cho từng phiên bản.
Mỗi phiên bản có thể ở một vị trí khác nhau.
Cloud Storage for Firebase 1 Không có vị trí mặc định.
Bạn phải đặt vị trí cho từng nhóm.
Mỗi nhóm có thể ở một vị trí khác nhau.
Cloud Functions for Firebase 1 Nếu bạn không thiết lập vị trí, khu vực mặc định sẽ là us-central1. Mỗi hàm có thể nằm ở một vị trí khác nhau.

1 Tuỳ thuộc vào thời điểm bạn bắt đầu sử dụng các sản phẩm này trong dự án, có thể có các phần phụ thuộc về vị trí giữa các sản phẩm này. Bạn có thể thấy phần phụ thuộc này được gọi là "vị trí cho tài nguyên Google Cloud mặc định". Tìm hiểu thêm về phụ thuộc vào vị trí này.

2 Vị trí báo cáo Analytics của bạn không ảnh hưởng đến nơi Google có thể xử lý và lưu trữ dữ liệu khách hàng cho Firebase.

Đặt vị trí cho một sản phẩm hoặc tài nguyên của sản phẩm đó

Đối với một số sản phẩm, bạn đặt vị trí ở cấp sản phẩm. Tuy nhiên, đối với hầu hết các sản phẩm, bạn đặt vị trí ở cấp tài nguyên (ví dụ: cho mỗi vùng chứa Cloud Storage hoặc mỗi hàm).

Sản phẩm Thời điểm và cách đặt vị trí Các vị trí có thể sử dụng
Firebase AI Logic
  • Đối với Gemini Developer API: Không thể chọn vị trí; luôn là vị trí toàn cầu.
  • Đối với Vertex AI Gemini API: Khi khởi chạy dịch vụ phụ trợ Vertex AI trong cơ sở mã, bạn có thể tuỳ ý chỉ định vị trí để truy cập vào mô hình.
    Nếu bạn không chỉ định vị trí, khu vực mặc định sẽ là us-central1.
Firebase AI Logic vị trí
Google Analytics Khi bật Google Analytics trong dự án Firebase trên bảng điều khiển Firebase, bạn sẽ được nhắc chọn một vị trí báo cáo Analytics. Bạn nên chọn một quốc gia hoặc khu vực thể hiện vị trí của tổ chức.

Nếu là Chủ sở hữu hoặc Người chỉnh sửa dự án, sau này bạn có thể chỉnh sửa múi giờ và đơn vị tiền tệ cho vị trí báo cáo Analytics; hãy chuyển đến phần Google Analytics cài đặt, sau đó chuyển đến ngăn Báo cáo.

Xem danh sách trong ngăn Google Analytics cài đặt > Báo cáo.
Firebase App Hosting Khi tạo một phần phụ trợ App Hosting, bạn sẽ được nhắc chọn một vị trí. Bạn có thể dùng bảng điều khiển Firebase, REST API hoặc Firebase CLI để tạo một phần phụ trợ. App Hosting vị trí
Firebase Data Connect Khi cung cấp một phiên bản dịch vụ Data Connect, bạn sẽ đặt vị trí cho phiên bản đó. Bạn cũng thiết lập vị trí của phiên bản Google Cloud SQL được liên kết.
Bạn có thể sử dụng bảng điều khiển Firebase hoặc CLI Firebase để cung cấp một phiên bản.
Vị trí của dịch vụ Data Connect và phiên bản Cloud SQL
Cloud Firestore 1 Khi cung cấp một thực thể cơ sở dữ liệu Cloud Firestore, bạn sẽ đặt vị trí của thực thể đó. Bạn có thể dùng bảng điều khiển Firebase, REST API, Firebase CLI hoặc Terraform để cung cấp một phiên bản. Cloud Firestore vị trí
Firebase Realtime Database Khi cung cấp phiên bản Realtime Database, bạn sẽ đặt vị trí cho phiên bản đó.
Bạn có thể sử dụng bảng điều khiển Firebase, REST API, Firebase CLI hoặc Terraform để cung cấp một phiên bản.
Realtime Database vị trí
Cloud Storage for Firebase 1 Khi cung cấp vùng chứa Cloud Storage, bạn sẽ đặt vị trí cho vùng chứa đó.
Bạn có thể sử dụng bảng điều khiển Firebase, REST API hoặc Terraform để cung cấp một vùng lưu trữ.
Cloud Storage for Firebase vị trí
Cloud Functions for Firebase 1 Khi viết một hàm, bạn có thể đặt khu vực cho hàm đó (không bắt buộc).

Nếu bạn không chỉ định vị trí, khu vực mặc định sẽ là us-central1.

Cloud Functions for Firebase vị trí

1 Tuỳ thuộc vào thời điểm bạn bắt đầu sử dụng các sản phẩm này trong dự án, có thể có các phần phụ thuộc về vị trí giữa các sản phẩm này. Bạn có thể thấy phần phụ thuộc này được gọi là "vị trí cho tài nguyên Google Cloud mặc định". Tìm hiểu thêm về phụ thuộc vào vị trí này.

Xem chế độ cài đặt vị trí

Sản phẩm Nơi xem chế độ cài đặt vị trí
Firebase AI Logic
  • Đối với Gemini Developer API: Không thể chọn vị trí; luôn là vị trí toàn cầu.
  • Đối với Vertex AI Gemini API: Trong cơ sở mã của bạn, hãy tìm quá trình khởi chạy dịch vụ phụ trợ Vertex AI. Nếu bạn không chỉ định vị trí, thì vị trí mặc định sẽ là us-central1.
Google Analytics Trong bảng điều khiển Firebase, hãy chuyển đến phần cài đặt Cài đặt dự án > Tích hợp > Google Analytics. Nhấp vào số tài khoản để mở tài khoản Google Analytics của bạn, rồi chuyển đến bảng điều khiển Quản trị để tìm thông tin về vị trí của tài khoản.
Firebase App Hosting
  • Trong bảng điều khiển Firebase, hãy chuyển đến trang App Hosting để xem danh sách các phần phụ trợ và vị trí của chúng.
  • Để xem vị trí của một phần phụ trợ cụ thể, bạn có thể sử dụng lệnh CLI Firebase firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Firebase Data Connect Trong bảng điều khiển Firebase, hãy chuyển đến trang Data Connect để xem danh sách các phiên bản cơ sở dữ liệu và vị trí của chúng.
Cloud Firestore Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Cloud Firestore Data (Dữ liệu) để xem danh sách các phiên bản cơ sở dữ liệu và vị trí của chúng.
Firebase Realtime Database Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Realtime Database Data (Dữ liệu) để xem danh sách các phiên bản cơ sở dữ liệu và vị trí của chúng.
Cloud Storage for Firebase Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Cloud Storage Tệp để xem danh sách các nhóm và vị trí của chúng.
Cloud Functions for Firebase
  • Hàm theo lịch: Trong bảng điều khiển Google Cloud, hãy chuyển đến Cloud Scheduler để xem danh sách các chủ đề cho từng công việc và hàm. Vị trí là phân đoạn cuối cùng trong tên của chủ đề.
  • Hàm không theo lịch: Trong mã nguồn của hàm, hãy tìm tham số region. Nếu bạn không chỉ định một khu vực, thì vị trí mặc định sẽ là us-central1.

Có thể có các thành phần phụ thuộc vào vị trí do "vị trí cho tài nguyên mặc định trên Google Cloud"

"Vị trí cho các tài nguyên Google Cloud mặc định" là chế độ cài đặt vị trí cho mọi tài nguyên dự án được liên kết với App Engine của Google, bao gồm cả những tài nguyên sau:

  • phiên bản cơ sở dữ liệu Cloud Firestore mặc định
  • Cloud Storage mặc định cho vùng chứa Firebase có định dạng tên là *.appspot.com
  • Google Cloud Scheduler được dùng riêng với các hàm theo lịch thế hệ đầu tiên

Đây là chế độ cài đặt bất biến "vị trí cho tài nguyên Google Cloud mặc định". Ngoài ra, khi bạn đặt vị trí cho một trong các tài nguyên được liên kết, bạn sẽ gián tiếp đặt vị trí cho tất cả các tài nguyên đó do mối liên kết chung của chúng với App Engine.

Tuy nhiên, do có nhiều thay đổi đối với hệ sinh thái Firebase và Google Cloud trong những năm qua, các mối liên kết của tài nguyên với App Engine đã thay đổi. Cụ thể, kể từ ngày 30 tháng 10 năm 2024, tất cả Cloud Storage mặc định mới được cung cấp cho các vùng chứa Firebase đều có định dạng tên *.firebasestorage.appkhông được liên kết với App Engine.

Sau đây là thông tin chi tiết về những thay đổi trong các thành phần phụ thuộc vào vị trí có thể có:

  • Kể từ ngày 30 tháng 10 năm 2024, nếu phiên bản Cloud Firestore mặc định và Cloud Storage mặc định cho vùng lưu trữ Firebase chưa được cung cấp:

    • Việc cung cấp phiên bản Cloud Firestore mặc định sẽ đặt vị trí cho mọi ứng dụng App Engine trong tương lai được cung cấp trong dự án. Tuy nhiên, chế độ này không quy định vị trí của vùng chứa Cloud Storage mặc định trong tương lai.

    • Việc cung cấp vùng chứa Cloud Storage mặc định không còn cung cấp ứng dụng App Engine nữa. Do đó, vị trí của vùng chứa Cloud Storage mặc định không quyết định vị trí của phiên bản Cloud Firestore mặc định trong tương lai.

  • Kể từ ngày 30 tháng 10 năm 2024, nếu phiên bản Cloud Firestore mặc định đã được cung cấp, nhưng Cloud Storage mặc định cho vùng lưu trữ Firebase chưa được cung cấp:

    • Phiên bản Cloud Firestore mặc định hiện có không quyết định vị trí của vùng chứa Cloud Storage mặc định trong tương lai (*.firebasestorage.app).
  • Kể từ ngày 30 tháng 10 năm 2024, nếu Cloud Storage mặc định cho vùng lưu trữ Firebase đã được cung cấp (cụ thể là vùng lưu trữ *.appspot.com), nhưng phiên bản Cloud Firestore mặc định chưa được cung cấp:

    • Khi vùng chứa Cloud Storage mặc định (*.appspot.com) được cung cấp, ứng dụng App Engine cũng được cung cấp tương tự. Do đó, vị trí của phiên bản Cloud Firestore mặc định trong tương lai được đặt vào thời điểm đó. Ngay cả khi xoá nhóm *.appspot.com, bạn cũng không thể xoá ứng dụng App Engine, vì vậy, chế độ cài đặt vị trí của phiên bản Cloud Firestore mặc định trong tương lai đã được đặt.

Nếu bạn đã sử dụng các hàm được lên lịch thế hệ thứ nhất, thì vị trí của các hàm này được đặt thành vị trí cho các tài nguyên Google Cloud mặc định. Nguyên nhân là do Cloud SchedulerApp Engine trước đây có mối liên kết với nhau. Ngoài ra, nếu bạn thiết lập các hàm theo lịch thế hệ thứ nhất trước khi cung cấp các tài nguyên khác dùng chung chế độ cài đặt vị trí này, thì bạn cũng sẽ thiết lập vị trí cho các tài nguyên đó.

Các bước tiếp theo

  • Để biết thêm thông tin về cách tạo ứng dụng đáp ứng các yêu cầu về độ trễ, tính sẵn có và độ bền, hãy tham khảo phần Địa lý và khu vực.