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

Không có chế độ cài đặt vị trí ở cấp dự án hoặc cấp ứng dụng trên toàn cầu.
Vị trí được đặt theo từng sản phẩm hoặc từng tài nguyên, và trong một số trường hợp, theo từng nhóm sản phẩm. Tuy nhiên, thông thường, bạn sẽ đặt vị trí cho từng sản phẩm và từng tài nguyên một cách độc lập với các sản phẩm và tài nguyên khác.

Xin lưu ý rằng một số sản phẩm và tài nguyên của Firebase không hỗ trợ tính năng chọn vị trí. Ngoài ra, bạn có thể tuỳ ý đặt một quy tắc hạn chế vị trí ở cấp tổ chức cho các sản phẩm và tài nguyên hỗ trợ tính năng chọn vị trí.

Sản phẩm hoặc tài nguyên yêu cầu chế độ cài đặt vị trí

Một số sản phẩm hoặc tài nguyên yêu cầu chế độ cài đặt 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.	Vị trí này là nơi 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à vị trí báo cáo Analytics^2, đại diện cho quốc gia hoặc khu vực của tổ chức bạn. Đến lượt vị trí báo cáo Analytics đặ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 quá trình triển khai App Hosting tạo từng tài nguyên phụ trợ. Mỗi phần phụ trợ có thể ở một vị trí khác nhau.
Firebase SQL Connect	Không có vị trí mặc định. Bạn phải đặt vị trí cho từng thực thể.	Mỗi thực thể 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 thực thể.	Mỗi thực thể 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 thực thể.	Mỗi thực thể 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 bộ chứa.	Mỗi bộ chứa có thể ở một vị trí khác nhau.
Cloud Functions for Firebase ^1	Nếu bạn không đặt vị trí, thì khu vực mặc định là us-central1.	Mỗi hàm có thể ở một vị trí khác nhau.

¹ 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 các tài nguyên Google Cloud mặc định". Tìm hiểu thêm về phần phụ thuộc về vị trí này .

² Vị trí báo cáo Analytics của bạn không ảnh hưởng đến vị trí mà 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 sẽ đặ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 sẽ đặt vị trí ở cấp tài nguyên (ví dụ: cho từng Cloud Storage bộ chứa hoặc từng hàm).

Sản phẩm	Thời điểm và cách đặt vị trí	Các vị trí thuộc phạm vi cung cấp
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í, thì khu vực mặc định là us-central1.	Firebase AI Logic vị trí
Google Analytics	Khi bạn bật Google Analytics trong dự án Firebase của mình trong Firebase bảng điều khiển, 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 đại diện cho vị trí của tổ chức bạn. Nếu là Chủ sở hữu hoặc Người chỉnh sửa dự án, 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 sau này; 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 phần cài đặt Google Analytics > Báo cáo ngăn.
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ể sử dụng bảng điều khiển Firebase, API REST hoặc CLI Firebase để tạo một phần phụ trợ.	Vị tríApp Hosting
Firebase SQL Connect	Khi cung cấp một SQL Connect thực thể dịch vụ, bạn sẽ đặt vị trí cho thực thể đó. Bạn cũng đặt vị trí của thực thể Google Cloud SQL được liên kết. Bạn có thể sử dụng bảng điều khiển Firebase hoặc Firebase CLI để cung cấp một thực thể.	Vị trí của dịch vụ SQL Connect và thực thể 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í cho thực thể đó. Bạn có thể sử dụng bảng điều khiển Firebase, API REST, CLI Firebase hoặc Terraform để cung cấp một thực thể.	Cloud Firestore vị trí
Firebase Realtime Database	Khi cung cấp thực thể Realtime Database, bạn sẽ đặt vị trí cho thực thể đó. Bạn có thể sử dụng bảng điều khiển Firebase, API REST, CLI Firebase hoặc Terraform để cung cấp một thực thể.	Realtime Database vị trí
Cloud Storage for Firebase ^1	Khi cung cấp bộ chứa Cloud Storage, bạn sẽ đặt vị trí cho bộ chứa đó. Bạn có thể sử dụng bảng điều khiển Firebase , API REST hoặc Terraform để cung cấp một bộ chứa.	Cloud Storage for Firebase vị trí
Cloud Functions for Firebase ^1	Khi viết một hàm, bạn có thể tuỳ ý đặt khu vực cho hàm đó. Nếu bạn không chỉ định vị trí, thì khu vực mặc định là us-central1.	Cloud Functions for Firebase vị trí

¹ 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 các tài nguyên Google Cloud mặc định". Tìm hiểu thêm về phần phụ thuộc về vị trí này .

Xem 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ã, 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 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, sau đó chuyển đến bảng điều khiển Quản trị để tìm thông tin 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 SQL Connect	Trong bảng điều khiển Firebase, hãy chuyển đến trang SQL Connect để xem danh sách các thực thể 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 Dữ liệu để xem danh sách các thực thể 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 Dữ liệu để xem danh sách các thực thể 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 bộ chứa và vị trí của chúng.
Cloud Functions for Firebase	Hàm theo lịch trình: 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 trình: Trong mã nguồn của hàm, hãy tìm tham số region. Nếu bạn không chỉ định khu vực, thì vị trí mặc định là us-central1.

Các phần phụ thuộc về vị trí có thể xảy ra do "vị trí cho các tài nguyên mặc định của 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 Google App Engine, bao gồm cả những tài nguyên sau:

• thực thể cơ sở dữ liệu Cloud Firestore mặc định
• bộ chứa Cloud Storage cho Firebase mặc định 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 trình thế hệ thứ nhất

Lưu ý: Không có tài nguyên nào khác trong dự án của bạn chia sẻ phần phụ thuộc về vị trí này, bao gồm cả những tài nguyên sau: thực thể Cơ sở dữ liệu theo thời gian thực, thực thể Cloud Firestore không mặc định, bộ chứa Cloud Storage không mặc định, bộ chứa Cloud Storage mặc định có định dạng tên là *.firebasestorage.app, hàm không theo lịch trình, và hàm theo lịch trình thế hệ thứ 2.

"Vị trí cho các tài nguyên mặc định Google Cloud" là một chế độ cài đặt không thể thay đổi. 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 chúng có mối liên kết chung với App Engine.

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

Điểm chính: Kể từ ngày 30 tháng 10 năm 2024, việc cung cấp bộ chứa Cloud Storage mặc định cho Firebase sẽ không đặt "vị trí cho các tài nguyên Google Cloud mặc định" (như vị trí cho thực thể Cloud Firestore mặc định của dự án). Ngoài ra, việc cung cấp thực thể mặc định Cloud Firestore không còn đặt vị trí cho một bộ chứa mặc định Cloud Storage cho Firebase mới (có định dạng tên là *.firebasestorage.app).

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

• Kể từ ngày 30 tháng 10 năm 2024, nếu bạn chưa cung cấp thực thể Cloud Firestore mặc định và bộ chứa Cloud Storage cho Firebase mặc định:

  • Việc cung cấp thực thể 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, việc này không quyết định vị trí của bộ chứa mặc định Cloud Storagetrong tương lai.

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

• Kể từ ngày 30 tháng 10 năm 2024, nếu bạn Cloud Firestore _đã_ cung cấp thực thể mặc định, nhưng bộ chứa mặc định Cloud Storage cho Firebase _chưa_ được cung cấp:

  • Thực thể Cloud Firestore mặc định hiện có không quyết định vị trí của bộ 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 bạn _đã_ cung cấp bộ chứa Cloud Storage cho Firebase mặc định (cụ thể là bộ chứa *.appspot.com), nhưng _chưa_ cung cấp thực thể Cloud Firestore mặc định:

  • Khi bộ chứa Cloud Storage mặc định (*.appspot.com) được cung cấp, một ứng dụng App Engine cũng được cung cấp. Do đó, vị trí của thực thể Cloud Firestore mặc định trong tương lai đã được đặt vào thời điểm đó. Ngay cả khi bạn xoá bộ chứa *.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 thực thể Cloud Firestore mặc định trong tương lai đã được đặt.

Nếu bạn sử dụng các hàm theo lịch trình thế hệ thứ 1, thì vị trí của các hàm đó sẽ được đặt thành vị trí cho các tài nguyên Google Cloud mặc định. Điều này là do Cloud Scheduler và App 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 trình thế hệ thứ nhất trước khi cung cấp các tài nguyên khác chia sẻ chế độ cài đặt vị trí này, thì bạn cũng sẽ đặt vị trí cho các hàm đó.

Các bước tiếp theo

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