در مورد مکان های محصولات و منابع پروژه خود بیاموزید

محصولات یا منابعی که نیاز به تنظیم موقعیت مکانی دارند

چندین محصول یا منبع نیاز به تنظیم موقعیت مکانی دارند.

محصول مکان پیش‌فرض اطلاعات تکمیلی
منطق هوش مصنوعی فایربیس
  • برای رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Gemini : انتخاب مکان امکان‌پذیر نیست؛ همیشه سراسری است.
  • برای Vertex AI Gemini API : اگر مکان تنظیم نشده باشد، منطقه پیش‌فرض ... است. us-central1 .
 این مکان جایی است که شما به مدل دسترسی پیدا می‌کنید.
Google Analytics مکان پیش‌فرض وجود ندارد.
شما باید این مکان را تنظیم کنید.		 این مکان، مکان گزارش‌دهی Analytics ۲ است که نشان‌دهنده کشور یا منطقه سازمان شما می‌باشد. مکان گزارش‌دهی Analytics شما، به نوبه خود، واحد پول گزارش‌دهی درآمد را تعیین می‌کند.
Firebase App Hosting مکان پیش‌فرض وجود ندارد.
شما باید این مکان را برای هر backend تنظیم کنید.		 این مکان جایی است که استقرار App Hosting هر یک از منابع backend شما را ایجاد می‌کند.
هر backend می‌تواند در مکان متفاوتی باشد.
Firebase Data Connect مکان پیش‌فرض وجود ندارد.
شما باید برای هر نمونه، مکان را تعیین کنید.		 هر نمونه می‌تواند در مکان متفاوتی باشد.
Cloud Firestore ۱ مکان پیش‌فرض وجود ندارد.
شما باید برای هر نمونه، مکان را تعیین کنید.		 هر نمونه می‌تواند در مکان متفاوتی باشد.
Firebase Realtime Database مکان پیش‌فرض وجود ندارد.
شما باید برای هر نمونه، مکان را تعیین کنید.		 هر نمونه می‌تواند در مکان متفاوتی باشد.
Cloud Storage for Firebase ۱ مکان پیش‌فرض وجود ندارد.
شما باید برای هر سطل، مکان مشخصی تعیین کنید.		 هر سطل می‌تواند در مکان متفاوتی باشد.
Cloud Functions for Firebase ۱ اگر مکان تنظیم نشده باشد، منطقه پیش‌فرض ... است. us-central1 . هر تابع می‌تواند در مکان متفاوتی باشد.

۱ بسته به اینکه چه زمانی برای اولین بار از این محصولات در پروژه خود استفاده کرده‌اید، ممکن است وابستگی‌های مکانی بین این محصولات وجود داشته باشد. ممکن است این وابستگی را به عنوان «مکان منابع پیش‌فرض Google Cloud » ببینید. درباره این وابستگی مکانی بیشتر بدانید.

۲- محل گزارش‌دهی Analytics شما تاثیری بر محل پردازش و ذخیره داده‌های مشتری توسط گوگل برای فایربیس ندارد .

تعیین مکان برای یک محصول یا منابع آن

برای تعداد کمی از محصولات، مکان را در سطح محصول تنظیم می‌کنید. با این حال، برای اکثر محصولات، مکان را در سطح منابع تنظیم می‌کنید (به عنوان مثال، برای هر سطل Cloud Storage یا هر عملکرد).

محصول چه زمانی و چگونه مکان را تعیین کنیم مکان‌های موجود
منطق هوش مصنوعی فایربیس
  • برای رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Gemini : انتخاب مکان امکان‌پذیر نیست؛ همیشه سراسری است.
  • برای Vertex AI Gemini API : وقتی سرویس backend Vertex AI را در پایگاه کد خود مقداردهی اولیه می‌کنید، می‌توانید به صورت اختیاری مکانی را برای دسترسی به مدل مشخص کنید.
    اگر مکانی را مشخص نکنید، منطقه پیش‌فرض ... است. us-central1 .
 مکان‌های منطق هوش مصنوعی فایربیس
Google Analytics وقتی Google Analytics در پروژه فایربیس خود در کنسول Firebase فعال می‌کنید، از شما خواسته می‌شود که یک مکان گزارش‌دهی آنالیتیکس را انتخاب کنید. شما باید یک کشور یا منطقه‌ای را انتخاب کنید که نشان دهنده موقعیت مکانی سازمان شما باشد.

اگر مالک یا ویرایشگر پروژه هستید، می‌توانید بعداً منطقه زمانی و واحد پول را برای محل گزارش‌دهی آنالیتیکس خود ویرایش کنید؛ به تنظیمات Google Analytics خود بروید، سپس به پنل گزارش‌دهی بروید.

 فهرست را در تنظیمات Google Analytics > بخش گزارش‌دهی مشاهده کنید.
Firebase App Hosting وقتی یک بک‌اند App Hosting backend) ایجاد می‌کنید، از شما خواسته می‌شود که یک مکان را انتخاب کنید. می‌توانید از کنسول Firebase ، REST API یا Firebase CLI برای ایجاد بک‌اند استفاده کنید. مکان‌های App Hosting
Firebase Data Connect وقتی یک نمونه سرویس Data Connect را فراهم می‌کنید، مکان‌های آن را تنظیم می‌کنید. همچنین مکان نمونه Google Cloud SQL مرتبط را نیز تعیین می‌کنید.
می‌توانید از کنسول Firebase یا Firebase CLI برای تهیه یک نمونه استفاده کنید.		 سرویس Data Connect و مکان‌های نمونه Cloud SQL
Cloud Firestore ۱ وقتی یک نمونه پایگاه داده Cloud Firestore را تهیه می‌کنید، مکان آن را تعیین می‌کنید. می‌توانید از کنسول Firebase ، REST API، Firebase CLI یا Terraform برای تهیه یک نمونه استفاده کنید. مکان‌های Cloud Firestore
Firebase Realtime Database وقتی نمونه Realtime Database را تهیه می‌کنید، مکان آن را تنظیم می‌کنید.
شما می‌توانید از کنسول Firebase ، REST API، Firebase CLI یا Terraform برای تهیه یک نمونه استفاده کنید.		 مکان‌های Realtime Database
Cloud Storage for Firebase ۱ وقتی سطل Cloud Storage را تهیه می‌کنید، مکان آن را تعیین می‌کنید.
شما می‌توانید از کنسول Firebase ، REST API یا Terraform برای تهیه یک Bucket استفاده کنید.		 Cloud Storage for Firebase
Cloud Functions for Firebase ۱ وقتی یک تابع می‌نویسید، می‌توانید به صورت اختیاری ناحیه‌ی آن را تنظیم کنید.

اگر مکانی را مشخص نکنید، منطقه پیش‌فرض ... است. us-central1 .

 Cloud Functions for Firebase

۱ بسته به اینکه چه زمانی برای اولین بار از این محصولات در پروژه خود استفاده کرده‌اید، ممکن است وابستگی‌های مکانی بین این محصولات وجود داشته باشد. ممکن است این وابستگی را به عنوان «مکان منابع پیش‌فرض Google Cloud » ببینید. درباره این وابستگی مکانی بیشتر بدانید.

مشاهده تنظیمات مکان

محصول تنظیمات مکان را از کجا می‌توان مشاهده کرد
منطق هوش مصنوعی فایربیس
  • برای رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Gemini : انتخاب مکان امکان‌پذیر نیست؛ همیشه سراسری است.
  • برای Vertex AI Gemini API : در کدبیس خود، به دنبال مقداردهی اولیه سرویس backend Vertex AI باشید. اگر مکانی مشخص نشده باشد، مکان پیش‌فرض ... است. us-central1 .
Google Analytics در کنسول Firebase ، به بروید تنظیمات پروژه > ادغام‌ها > Google Analytics . برای باز کردن حساب Google Analytics خود، روی شماره حساب کلیک کنید و سپس به پنل مدیریت بروید تا اطلاعات موقعیت مکانی حساب خود را پیدا کنید.
Firebase App Hosting
  • در کنسول Firebase ، به صفحه App Hosting بروید تا لیست backend های خود و مکان‌های آنها را مشاهده کنید.
  • برای مشاهده موقعیت مکانی یک backend خاص، می‌توانید از دستور Firebase CLI استفاده کنید. firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Firebase Data Connect در کنسول Firebase ، به صفحه Data Connect بروید تا لیست نمونه‌های پایگاه داده و مکان‌های آنها را مشاهده کنید.
Cloud Firestore در کنسول Firebase ، به تب Cloud Firestore Data بروید تا لیست نمونه‌های پایگاه داده و مکان‌های آنها را مشاهده کنید.
Firebase Realtime Database در کنسول Firebase ، به تب Realtime Database Data بروید تا لیست نمونه‌های پایگاه داده و مکان‌های آنها را مشاهده کنید.
Cloud Storage for Firebase در کنسول Firebase ، به تب Cloud Storage Files بروید تا لیست باکت‌ها و مکان‌های آنها را مشاهده کنید.
Cloud Functions for Firebase
  • توابع زمان‌بندی‌شده: در کنسول Google Cloud ، برای مشاهده لیست موضوعات مربوط به هر کار و تابع، به Cloud Scheduler بروید. مکان، آخرین بخش در نام موضوع است.
  • توابع زمان‌بندی نشده: در کد منبع تابع خود، به دنبال پارامتر region بگردید. اگر منطقه مشخص نشده باشد، مکان پیش‌فرض ... است. us-central1 .

وابستگی‌های مکانی احتمالی به دلیل «مکان برای منابع پیش‌فرض Google Cloud»

«مکان منابع پیش‌فرض Google Cloud » تنظیم مکان برای هرگونه منبع پروژه مرتبط با Google App Engine است، از جمله موارد زیر:

  • نمونه پایگاه داده پیش‌فرض Cloud Firestore
  • Cloud Storage پیش‌فرض برای باکت فایربیس با فرمت نام *.appspot.com
  • Cloud Scheduler به طور خاص با توابع زمان‌بندی‌شده نسل اول استفاده می‌شود.

این «مکان منابع پیش‌فرض Google Cloud » یک تنظیم تغییرناپذیر است. همچنین، وقتی مکان یکی از منابع مرتبط را تعیین می‌کنید، به دلیل ارتباط مشترک آنها با App Engine ، به طور غیرمستقیم مکان همه آنها را تعیین می‌کنید.

با این حال، با تغییرات زیادی که در اکوسیستم Firebase و Google Cloud در طول این سال‌ها رخ داده است، نحوه‌ی ارتباط منابع با App Engine نیز در حال تغییر بوده است. از همه مهم‌تر، از 30 اکتبر 2024 ، تمام Cloud Storage پیش‌فرض جدید برای باکت‌های Firebase دارای قالب نام هستند. *.firebasestorage.app هستند و با App Engine مرتبط نیستند .

در اینجا جزئیاتی از آنچه در وابستگی‌های مکانی احتمالی تغییر کرده است، آورده شده است:

  • از 30 اکتبر 2024 ، اگر نمونه پیش‌فرض Cloud Firestore و Cloud Storage پیش‌فرض برای باکت Firebase هنوز فراهم نشده باشند:

    • تأمین نمونه پیش‌فرض Cloud Firestore مکان هر برنامه App Engine که در آینده در پروژه تأمین شود را تعیین می‌کند. با این حال، مکان سطل Cloud Storage پیش‌فرض آینده را تعیین نمی‌کند .

    • تأمین باکت پیش‌فرض Cloud Storage دیگر یک برنامه App Engine را تأمین نمی‌کند. بنابراین، مکان باکت پیش‌فرض Cloud Storage مکان نمونه پیش‌فرض Cloud Firestore در آینده را تعیین نمی‌کند .

  • از 30 اکتبر 2024 ، اگر نمونه پیش‌فرض Cloud Firestore قبلاً ارائه شده باشد، اما Cloud Storage پیش‌فرض برای باکت Firebase ارائه نشده باشد:

    • نمونه پیش‌فرض فعلی Cloud Firestore مکان باکت پیش‌فرض Cloud Storage آینده را تعیین نمی‌کند ( *.firebasestorage.app ).

  • از 30 اکتبر 2024 ، اگر Cloud Storage پیش‌فرض برای باکت فایربیس از قبل فراهم شده باشد (به‌طور خاص، *.appspot.com bucket) ، اما نمونه پیش‌فرض Cloud Firestore فراهم نشده است:

    • زمانی که سطل Cloud Storage پیش‌فرض ( *.appspot.com ) فراهم شد، یک برنامه App Engine نیز فراهم شد و بنابراین مکان نمونه پیش‌فرض Cloud Firestore در آینده در آن زمان تعیین شد. حتی اگر آن را حذف کنید باکت *.appspot.com ، شما نمی‌توانید برنامه App Engine را حذف کنید، بنابراین تنظیمات مکان نمونه پیش‌فرض Cloud Firestore آینده از قبل تنظیم شده است.

اگر از توابع زمان‌بندی‌شده نسل اول استفاده کرده‌اید، مکان آنها روی مکان منابع پیش‌فرض Google Cloud تنظیم می‌شود. دلیل این امر این است که Cloud Scheduler و App Engine قبلاً با یکدیگر ارتباط داشته‌اند. همچنین، اگر توابع زمان‌بندی‌شده نسل اول را قبل از تأمین منابع دیگری که این تنظیم مکان را به اشتراک گذاشته‌اند، تنظیم کنید، مکان آنها را نیز تنظیم می‌کنید.

مراحل بعدی

  • برای اطلاعات بیشتر در مورد ساخت برنامه‌های کاربردی برای برآورده کردن الزامات تأخیر، در دسترس بودن و دوام، به جغرافیا و مناطق مراجعه کنید.