انواع فهرست در Firestore ابر

مجموعه های خود را بهینه کنید و محتوا را مطابق با تنظیمات خود طبقه بندی کنید.

شاخص ها عامل مهمی در عملکرد بانک اطلاعاتی هستند. مانند شاخص کتابی که مباحث موجود در یک کتاب را با صفحات مقایسه می کند ، شاخص پایگاه داده عناصر موجود در پایگاه داده را با موقعیت مکانی خود در پایگاه داده مقایسه می کند. هنگامی که یک پایگاه داده پرس و جو را ارسال می کنید ، بانک اطلاعاتی می تواند از این فهرست برای جستجوی سریع مکان عناصر مورد نظر خود استفاده کند.

در این صفحه دو نوع شاخص که Firestore Cloud از آن استفاده می کند: شاخص هایی با یک زمینه و شاخص های کامپوزیت.

فهرست پشت هر درخواست

اگر شاخصی برای درخواست وجود نداشته باشد ، بیشتر پایگاه داده ها عنصر محتوای آنها را مشاهده می کنند ، که یک فرآیند آهسته است که با رشد پایگاه داده حتی بیشتر کاهش می یابد. Firestore Cloud با استفاده از شاخص ها برای کلیه درخواست ها ، عملکرد پرس و جو بالا را تضمین می کند. در نتیجه ، عملکرد درخواست به اندازه مجموعه نتایج بستگی دارد و نه به تعداد عناصر موجود در پایگاه داده.

مدیریت کمتر شاخص ها ، توسعه برنامه های بیشتر

Firestore Cloud شامل کارکردهایی است که زمان مورد نیاز برای کنترل شاخص ها را کاهش می دهد. شاخص های لازم برای ساده ترین نمایش داده ها به صورت خودکار ایجاد می شوند. هنگام استفاده و آزمایش برنامه خود ، Cloud Firestore به شما کمک می کند تا شاخص های اضافی لازم را برای برنامه خود تعریف و ایجاد کنید.

انواع فهرست ها

Firestore Cloud از دو نوع شاخص استفاده می کند: تک و کامپوزیت. علاوه بر تعداد زمینه های فهرست بندی شده ، شاخص های تک طبقه و کامپوزیت در نحوه کنترل آنها متفاوت است.

ایندکس ها با یک زمینه

این شاخص با یک زمینه ، مقایسه مرتب شده ای از کلیه اسناد موجود در مجموعه حاوی یک زمینه خاص را ذخیره می کند. هر ورودی در فهرست با یک قسمت ، مقدار سند را برای یک قسمت خاص و مکان سند در پایگاه داده ثبت می کند. Firestore Cloud از این شاخص ها برای انجام بسیاری از نمایش داده های اساسی استفاده می کند. شما با تنظیم پارامترهای فهرست بندی خودکار پایگاه داده و محرومیت از شاخص ها ، شاخص ها را با یک قسمت کنترل می کنید.

نمایه سازی خودکار

به طور پیش فرض ، Firestore Cloud به طور خودکار از زمینه های جداگانه برای هر قسمت در سند و هر زیرزمینی روی نقشه پشتیبانی می کند. Firestore Cloud از تنظیمات پیش فرض زیر برای ایندکس ها با یک قسمت استفاده می کند:

برای هر زمینه ای که آرایه ای نیست و به نقشه مربوط نمی شود ، Cloud Firestore دو شاخص را با یک زمینه از منطقه جمع آوری ، یکی در حالت صعودی و دیگری در رو به پایین تعریف می کند.

برای هر زمینه ، کارت Firestore Cloud یک شاخص صعودی از منطقه جمع آوری و یک شاخص نزولی برای هر زیرزمینی از کارت ایجاد می کند که یک آرایه نیست و به نقشه مربوط نمی شود.

برای هر زمینه ، آرایه موجود در Document Cloud Firestore شاخص MASSIF را در زمینه مجموعه ایجاد و پشتیبانی می کند.

شاخص هایی با یک زمینه و منطقه گروه مجموعه به طور پیش فرض پشتیبانی نمی شوند.

استثنائات برای فهرست با یک قسمت

می توانید با ایجاد محرومیت از شاخص برای یک قسمت ، زمینه را از تنظیمات فهرست بندی خودکار حذف کنید. محرومیت از نمایه سازی ، پارامترهای نمایه سازی اتوماتیک را برای کل بانک اطلاعاتی کاهش می دهد. یک استثنا می تواند شاخص را با یک قسمت روشن کند ، که در غیر این صورت توسط تنظیمات نمایه سازی خودکار شما غیرفعال می شود یا شاخص را با یک قسمت جدا می کند ، که در غیر این صورت در فهرست بندی اتوماتیک روشن می شود. مواردی که استثنائات می توانند مفید باشند ، به توصیه های فهرست بندی مراجعه کنید.

اگر محرومیت از شاخص را برای یک قسمت از زمینه ایجاد می کنید ، زیرزمین کارت این تنظیمات را به ارث می برد. با این حال ، می توانید استثنائات شاخص را برای زمینه های فردی برای یارانه های خاص تعیین کنید. اگر استثناء را برای زیرزمین حذف کنید ، این زیرزمین تنظیمات را برای محرومیت والدین شما ، در صورت وجود یا تنظیمات کل بانک اطلاعاتی ، به ارث می برد ، اگر استثنائات والدین در آنجا نباشد.

برای ایجاد استثنائات در فهرست با یک زمینه و مدیریت آنها ، به بخش مدیریت فهرست در Firestore Cloud مراجعه کنید.

شاخص های مرکب

یک شاخص انتگرال نمایشگر مرتب شده ای از کلیه اسناد موجود در مجموعه را بر اساس لیست سفارش داده شده از زمینه های فهرست بندی ذخیره می کند.

Cloud Firestore از شاخص های کامپوزیت برای پشتیبانی از درخواست هایی که هنوز توسط شاخص ها با یک زمینه پشتیبانی نمی شوند ، استفاده می کند.

Cloud Firestore به دلیل تعداد زیادی از ترکیبات ممکن از زمینه ها ، به طور خودکار شاخص های کامپوزیتی را ایجاد نمی کند ، همانطور که برای شاخص ها با یک زمینه انجام می شود. در عوض ، Firestore Cloud به تعیین و ایجاد شاخص های کامپوزیت لازم هنگام ایجاد یک برنامه کمک می کند.

اگر سعی می کنید بدون ایجاد اولیه شاخص لازم ، درخواست فوق را برآورده کنید ، Cloud Firestore پیام خطای حاوی پیوندی را که می توانید برای ایجاد یک فهرست غایب بروید ، برمی گرداند. این اتفاق می افتد هر زمان که می خواهید درخواستی را که توسط فهرست پشتیبانی نمی شود ، انجام دهید. همچنین می توانید شاخص های کامپوزیت را تعیین کرده و با استفاده از کنسول یا خط فرمان Firebase به صورت دستی آنها را کنترل کنید. اطلاعات بیشتر در مورد ایجاد شاخص های کامپوزیت و مدیریت آنها ، به مدیریت شاخص مراجعه کنید.

فهرست و درخواست رژیم

شما شاخص ها را با یک قسمت و شاخص های کامپوزیت به روش های مختلف تنظیم کرده اید ، اما هر دو نیاز به تنظیم حالت های شاخص و درخواست برای شاخص های خود دارند.

حالت های شاخص

هنگامی که شاخص را تعیین می کنید ، برای هر قسمت فهرست بندی شده حالت فهرست را انتخاب می کنید. شاخص هر قسمت جملات درخواست خاصی را برای این زمینه حفظ می کند. می توانید یکی از حالت های شاخص زیر را انتخاب کنید:

مناطقی را درخواست کنید

هر شاخص یا برای مجموعه یا گروه مجموعه ها اعمال می شود. این به عنوان منطقه درخواست شاخص شناخته می شود:

مجموعه پیش فرض Cloud Firestore شاخص هایی را با منطقه مجموعه ایجاد می کند. این شاخص ها از درخواست هایی پشتیبانی می کنند که نتایج را از یک مجموعه باز می گرداند.

دامنه گروه گروه مجموعه شامل کلیه مجموعه هایی با شناسه مجموعه یکسان است. به منظور رعایت یک گروه مجموعه که نتایج فیلتر شده یا سفارش داده شده را از گروه جمع آوری باز می گرداند ، لازم است یک شاخص مناسب با منطقه گروه جمع آوری ایجاد شود.

نمونه ای از نمایه سازی

Cloud Firestore به طور خودکار ایجاد شاخص ها برای شما با یک زمینه ، به برنامه شما اجازه می دهد تا به سرعت ساده ترین درخواست های پایگاه داده را حفظ کند. شاخص ها با یک زمینه به شما امکان می دهند بر اساس مقادیر زمینه ها و مقایسه ها ، درخواست های ساده را انجام دهید<, = ,>و دربرای مزارع Massif ، آنها به شما امکان می دهند درخواست هایی از قبیل آرایه های آرایه و آرایه را انجام دهید.

برای نشان دادن ، نمونه های زیر را از نقطه نظر ایجاد شاخص در نظر بگیرید. قطعه بعدی کد چندین سند شهری را در مجموعه سیتس ایجاد می کند و مجموعه ای را برای هر سند نام ، ایالت ، کشور ، سرمایه ، جمعیت و برچسب ها ایجاد می کند:

اینترنت

با فرض تنظیمات برای نمایه سازی پیش فرض خودکار ، Firestore Cloud یک شاخص صعودی را با یک قسمت برای هر قسمت که یک آرایه نیست ، به روز می کند ، یک شاخص نزولی با یک قسمت برای هر زمینه ای که یک آرایه نیست ، و یک فهرست با یک قسمت حاوی یک Massif برای آرایه میدانهر خط در جدول زیر یک ورود در فهرست با یک قسمت را نشان می دهد:

درخواست های پشتیبانی شده توسط ایندکس ها با یک قسمت

با استفاده از این شاخص های ایجاد شده به صورت خودکار با یک قسمت ، می توانید درخواست های ساده ای شبیه به موارد زیر انجام دهید:

اینترنت

همچنین می توانید در برابری (==) درخواست ایجاد و ایجاد کنید:

اینترنت

درخواست های پشتیبانی شده توسط شاخص های کامپوزیت

Cloud Firestore از شاخص های کامپوزیت برای پشتیبانی از درخواست های کامپوزیت که هنوز توسط شاخص ها با یک زمینه پشتیبانی نمی شوند ، استفاده می کند. به عنوان مثال ، برای درخواست های زیر به یک شاخص کامپوزیت نیاز خواهید داشت:

اینترنت

این درخواست ها در زیر به یک شاخص انتگرال نیاز دارند. از آنجا که درخواست از برابری (== یا In) برای قسمت کشور استفاده می کند ، برای این زمینه می توانید با افزایش یا کاهش از حالت شاخص استفاده کنید. به طور پیش فرض ، پیشنهادات نابرابری روش برای مرتب سازی با افزایش بر اساس یک زمینه در پیشنهادی برای نابرابری اعمال می شود.

برای تحقق همان درخواست ها ، اما با مرتب سازی در نزولی ، به یک شاخص کامپوزیت اضافی در جهت نزولی برای جمعیت نیاز دارید:

اینترنت

همچنین برای ترکیب آرایه های آرایه آرایه ای با هر یک از پیشنهادات اضافی ، باید یک شاخص کامپوزیت ایجاد کنید.

اینترنت

با استفاده از فهرست بعدی با یک زمینه و منطقه مجموعه ، می توانید یک مجموعه نشانه های یک شهر را بر اساس قسمت دسته بندی درخواست کنید:

اینترنت

حال تصور کنید که می خواهید در همه شهرها از نقاط دیدنی درخواست کنید. برای تحقق این درخواست در گروهی از مجموعه های متشکل از همه مجموعه های نقاط دیدنی ، لازم است که شاخص نقاط دیدنی را با گروه مجموعه ها فعال کنید:

اگر این شاخص گنجانده شده باشد ، می توانید گروه جمع آوری نقاط دیدنی را درخواست کنید:

اینترنت

به منظور رعایت یک گروه جمع آوری که نتایج فیلتر شده یا سفارش داده شده را برمی گرداند ، لازم است شاخص مربوطه را با یک زمینه یا یک شاخص انتگرال با منطقه گروه جمع آوری درج کنید. با این حال ، درخواست های گروه مجموعه که فیلتر نمی شوند و نتایج را ساده نمی کنند ، نیازی به تعاریف اضافی از شاخص ندارند.

به عنوان مثال ، می توانید بدون روشن کردن یک فهرست اضافی ، درخواست بعدی گروه مجموعه را انجام دهید:

اینترنت

پست های امضاء

شاخص های پیکربندی شده پروژه شما و ساختار سند تعداد سوابق فهرست را برای سند تعیین می کند. عناصر نشانگر مطابق با محدودیت تعداد عناصر نشانگر در نظر گرفته می شوند.

مثال بعدی عناصر نشانگر سند را نشان می دهد.

مدرک

City_name: "سانفرانسیسکو" درجه حرارت: محله ها: ["ماموریت" ، "مرکز شهر" ، "مارینا"]

شاخص های دلهره

• name_gorod acc
• name_gorod desc
• دما. ASC
• دما
• دما. ASC زمستانی
• دما. نزول زمستان
• آرایه اطراف شامل (ASC و DESC) است

شاخص های مرکب

• City_name ASC ، مناطق آرایه
• name_gorod desc ، مناطق آرایه

پست های امضاء

این پیکربندی نمایه سازی منجر به 18 عنصر زیر از فهرست برای سند می شود:

فهرست و قیمت ها

Index اعداد را برای هزینه نقشه Vashota خود مستقر کنید. اطلاعات بیشتر در مورد تام ، به عنوان اندازه آشفتگی برای شاخص ها ، cm. در بخش بخش اندازه اندازه.

استفاده از شاخص های Sliyania

Hotspor Cloud Fiestore از درخواست ارزان استفاده می کند ، ذکر نشده است. برای درخواست ها Ravenstva (==) من را برمی گرداند ، به Firtsto Firestore Orderby Cloud ارائه دهید. Cloud Firestore United Clasty Filtyrov Ravenstva ، برای پیشبرد داخلی در ترکیب ، باعث می شود که سوراخ بیش از بقیه باشد.

شما همچنین می توانید یک Snigess ایجاد کنید ، تعریف وضعیت. عزیز ، مجموعه رستوران های پاسخ داده شده برای رتبه بندی رستوران ها:

نام: "Burger Thyme" دسته: "همبرگر" شهر: "سان فرانسیسکو" ویرایشگران_PICK: True Star_rating: 4

نمونه دیگری انتظار می رود که برای آن آسان تر باشد ، مشابه سمت راست. لطفاً توجه داشته باشید که ترکیبی از ترکیب بقیه گزارش های گروه ، شهر و ویراستاران_PICK ، ما همیشه در این بخش هستیم:

اینترنت

همچنین می توانید برای هر درخواست شاخص ایجاد کنید:

در پایان وجوه می توانید شما را برای کشتن شاخص ها بکشید ، از Cloud Cloud Fiestore Unified برای Firestall Four Nechs استفاده کنید:

این مجموعه از شاخص ها نه تنها کمتر است ، بلکه از یک درخواست اضافی نیز پشتیبانی می کند:

اینترنت

محدودیت های نمایه سازی

محدودیت های زیر در شاخص ها اعمال می شود. برای همه سهمیه ها و محدودیت ها ، به سهمیه ها و محدودیت ها مراجعه کنید.

برای درخواست افزایش در این حد می توانید با سرویس پشتیبانی تماس بگیرید.

در کل ، 200 تنظیم سطح فیلد مجاز است. یک پیکربندی میدانی ممکن است حاوی چندین تنظیم برای همان قسمت باشد. به عنوان مثال ، محرومیت از فهرست بندی یک زمینه و خط مشی TTL برای همان زمینه به عنوان یک پیکربندی قسمت برای محدودیت در نظر گرفته می شود.

حداکثر تعداد سوابق امضا برای هر سند

تعداد عناصر نشانگر مقدار مقادیر زیر برای سند است:

• تعداد ضبط های فهرست با یک قسمت
• تعداد سوابق شاخص کامپوزیت

برای دیدن اینکه چگونه Cloud Firestore یک سند و مجموعه ای از شاخص ها را در ضبط شاخص تبدیل می کند ، به این نمونه از محاسبه ضبط های شاخص مراجعه کنید.

برای اینکه دریابید که چگونه Firestore Cloud اندازه عنصر شاخص را محاسبه می کند ، به اندازه عنصر شاخص مراجعه کنید.

اندازه کل مقدار مقادیر زیر برای سند است:

مقادیر میدانی بیش از 1500 بایت بریده شده است. درخواست های موجود در مقادیر کوتاه شده در زمینه ها می توانند نتایج متناقض را برگردانند.

بهترین روشهای نمایه سازی

برای اکثر برنامه ها ، می توانید به فهرست بندی خودکار و پیوندها به پیام های خطا برای مدیریت شاخص های خود اعتماد کنید. با این حال ، می توانید استثنائاتی را برای یک زمینه در موارد زیر اضافه کنید:

اگر یک رشته رشته ای دارید که اغلب حاوی مقادیر رشته ای طولانی است که از آنها برای درخواست استفاده نمی کنید ، می توانید با حذف این قسمت از فهرست بندی ، هزینه های ذخیره سازی را کاهش دهید.

اگر زمینه ای را که به طور مداوم بین اسناد موجود در مجموعه افزایش یا کاهش می یابد ، به عنوان مثال ، برچسب زمان ، فهرست بندی کنید ، حداکثر سرعت ضبط در مجموعه 500 عملیات ضبط در ثانیه است. اگر با یک درخواست مبتنی بر فیلد با مقادیر ثابت مطابقت ندارید ، می توانید این زمینه را از فهرست بندی خارج کنید تا این محدودیت را بدست آورید.

به عنوان مثال ، در مورد استفاده از اینترنت اشیاء با سرعت ضبط بالا ، مجموعه ای حاوی اسناد با یک زمینه برچسب زدن ممکن است به حد 500 عملیات ضبط در ثانیه نزدیک شود.

اگر از خط مشی های TTL (طول عمر) استفاده می کنید ، توجه داشته باشید که قسمت TTL باید یک علامت زمانی داشته باشد. نمایه سازی میدان TTL به طور پیش فرض و می تواند بر عملکرد با سرعت بالاتر ترافیک تأثیر بگذارد. توصیه می شود استثنائاتی را برای زمینه های جداگانه برای زمینه های TTL اضافه کنید.

زمینه هایی از توده ها یا کارت های بزرگ می توانند به حد 40،000 مدخل امضا در سند نزدیک شوند. اگر درخواستی را بر اساس یک آرایه بزرگ یا قسمت کارت دنبال نکنید ، باید آن را از فهرست بندی خارج کنید.

به استثنای آنچه در غیر این صورت ذکر نشده است ، محتوای این صفحه تحت مجوز Creative Commons Attribution 4. 0 مجوز دارد و نمونه های کد دارای مجوز Licidense Apache 2. 0 هستند. برای جزئیات بیشتر ، به سیاست های سایت Google Developers مراجعه کنید. جاوا یک علامت تجاری ثبت شده اوراکل و/یا شرکت های وابسته به آن است.< an> اگر از خط مشی TTL (Lifetime) استفاده می کنید ، توجه داشته باشید که قسمت TTL باید یک علامت زمانی داشته باشد. نمایه سازی میدان TTL به طور پیش فرض و می تواند بر عملکرد با سرعت بالاتر ترافیک تأثیر بگذارد. توصیه می شود استثنائاتی را برای زمینه های جداگانه برای زمینه های TTL اضافه کنید.