الفهرس
FirestoreAdmin
(واجهة)CreateIndexRequest
(رسالة)DeleteIndexRequest
(رسالة)ExportDocumentsMetadata
(رسالة)ExportDocumentsRequest
(رسالة)ExportDocumentsResponse
(رسالة)Field
(رسالة)Field.IndexConfig
(رسالة)FieldOperationMetadata
(رسالة)FieldOperationMetadata.IndexConfigDelta
(رسالة)FieldOperationMetadata.IndexConfigDelta.ChangeType
(تعداد)GetFieldRequest
(رسالة)GetIndexRequest
(رسالة)ImportDocumentsMetadata
(رسالة)ImportDocumentsRequest
(رسالة)Index
(رسالة)Index.IndexField
(رسالة)Index.IndexField.ArrayConfig
(تعداد)Index.IndexField.Order
(تعداد)Index.QueryScope
(تعداد)Index.State
(تعداد)IndexOperationMetadata
(رسالة)ListFieldsRequest
(رسالة)ListFieldsResponse
(رسالة)ListIndexesRequest
(رسالة)ListIndexesResponse
(رسالة)OperationState
(تعداد)Progress
(رسالة)UpdateFieldRequest
(رسالة)
FirestoreAdmin
يتم إنشاء العمليات من خلال الخدمة FirestoreAdmin
، ولكن يتم الوصول إليها من خلال الخدمة google.longrunning.Operations
.
CreateIndex |
---|
ينشئ فهرسًا مركبًا. يؤدي ذلك إلى عرض رمز الاستجابة
|
DeleteIndex |
---|
حذف فهرس مركب.
|
ExportDocuments |
---|
لتصدير نسخة من كل المستندات أو مجموعة فرعية من المستندات من Google Cloud Firestore إلى نظام تخزين آخر، مثل Google Cloud Storage. قد لا تظهر التعديلات الأخيرة التي تم إجراؤها على المستندات في عملية التصدير. تحدث عملية التصدير في الخلفية ويمكن مراقبة مستوى تقدُّمها وإدارته من خلال مورد "العملية" الذي يتم إنشاؤه. ولا يمكن استخدام ناتج عملية التصدير إلا بعد الانتهاء من العملية المرتبطة. في حال إلغاء عملية تصدير قبل اكتمالها، قد يتم الاحتفاظ ببيانات جزئية في Google Cloud Storage.
|
GetField |
---|
للحصول على البيانات الوصفية وإعدادات أحد الحقول.
|
GetIndex |
---|
الحصول على فهرس مركب.
|
ImportDocuments |
---|
لاستيراد المستندات إلى Google Cloud Firestore. يتم استبدال المستندات الحالية التي تحمل الاسم نفسه. تحدث عملية الاستيراد في الخلفية ويمكن مراقبة مستوى تقدُّمها وإدارته من خلال مورد العملية الذي يتم إنشاؤه. في حال إلغاء عمليةImportDocuments، من المحتمل أن يكون قد تم استيراد مجموعة فرعية من البيانات إلى Cloud Firestore من قبل.
|
ListFields |
---|
يسرد إعدادات الحقل والبيانات الوصفية لقاعدة البيانات هذه. في الوقت الحالي، لا يدعم
|
ListIndexes |
---|
يسرد الفهارس المركّبة.
|
UpdateField |
---|
لتعديل إعدادات حقل في الوقت الحالي، لا تنطبق تعديلات الحقول إلا على إعدادات فهرس حقل واحد. ومع ذلك، يجب أن توفّر المكالمات إلى تعرض هذه المكالمة رمز الاستجابة لضبط إعدادات الحقول التلقائية لقاعدة البيانات، استخدِم
|
CreateIndexRequest
الحقول | |
---|---|
parent |
اسم عنصر رئيسي بالنموذج |
index |
الفهرس المركّب المطلوب إنشاؤه. |
DeleteIndexRequest
الحقول | |
---|---|
name |
اسم النموذج |
ExportDocumentsMetadata
البيانات الوصفية لـ google.longrunning.Operation
نتيجة من FirestoreAdmin.ExportDocuments
الحقول | |
---|---|
start_time |
وقت بدء هذه العملية. |
end_time |
وقت اكتمال هذه العملية. سيتم إلغاء ضبط هذه السياسة إذا كانت العملية لا تزال قيد التنفيذ. |
operation_state |
حالة عملية التصدير. |
progress_documents |
مستوى التقدم في هذه العملية ضمن المستندات |
progress_bytes |
مستوى تقدم هذه العملية، بالبايت. |
collection_ids[] |
معرّفات المجموعات التي يتم تصديرها |
output_uri_prefix |
المكان الذي يتم تصدير الكيانات إليه |
ExportDocumentsRequest
الحقول | |
---|---|
name |
قاعدة البيانات للتصدير. يجب أن يكون التنسيق: |
collection_ids[] |
معرّفات المجموعات المطلوب تصديرها الحالة "غير محدّد" تعني جميع المجموعات. |
output_uri_prefix |
معرِّف الموارد المنتظم (URI) للمخرجات. لا تتوافق حاليًا سوى مع معرِّفات الموارد المنتظمة (URI) لخدمة Google Cloud Storage على النحو التالي: |
ExportDocumentsResponse
تم عرضه في حقل الرد google.longrunning.Operation
.
الحقول | |
---|---|
output_uri_prefix |
موقع ملفات الإخراج يمكن استخدام ذلك لبدء عملية الاستيراد إلى Cloud Firestore (هذا المشروع أو مشروع آخر) بعد اكتمال العملية بنجاح. |
حقل
تمثل حقلاً واحدًا في قاعدة البيانات.
يتم تجميع الحقول حسب "مجموعة المجموعة" التي تمثل كل المجموعات في قاعدة البيانات بالمعرف نفسه.
الحقول | |
---|---|
name |
اسم حقل بالنموذج يمكن أن يكون مسار الحقل اسم حقل بسيطًا، مثل يمكن اقتباس مسارات الحقول باستخدام أمثلة: (ملاحظة: تتم كتابة التعليقات هنا ببنية markdown، وبالتالي تتوفّر طبقة إضافية من الفواصل العليا المائلة لتمثيل كتلة الرموز) يحتوي حقل |
index_config |
إعدادات الفهرس لهذا الحقل. في حال ترك هذه السياسة بدون ضبط، ستتم إعادة فهرسة الحقول إلى الإعدادات التي حدّدتها سياسة |
IndexConfig
إعدادات الفهرس لهذا الحقل.
الحقول | |
---|---|
indexes[] |
الفهارس المتوافقة مع هذا الحقل |
uses_ancestor_config |
النتائج فقط. عندما تكون القيمة "صحيح"، يتم ضبط إعدادات فهرس |
ancestor_field |
النتائج فقط. يحدد اسم مورد |
reverting |
النتائج فقط عندما تكون القيمة "صحيح"، يعني ذلك أنّ إعدادات فهرس |
FieldOperationMetadata
البيانات الوصفية لـ google.longrunning.Operation
نتيجة من FirestoreAdmin.UpdateField
الحقول | |
---|---|
start_time |
وقت بدء هذه العملية. |
end_time |
وقت اكتمال هذه العملية. سيتم إلغاء ضبط هذه السياسة إذا كانت العملية لا تزال قيد التنفيذ. |
field |
تمثّل هذه السمة مورد الحقل الذي تعمل عليه هذه العملية. مثال: |
index_config_deltas[] |
هذه قائمة من |
state |
حالة العملية. |
document_progress |
مستوى التقدم في هذه العملية ضمن المستندات |
bytes_progress |
مستوى تقدم هذه العملية، بالبايت. |
IndexConfigDelta
معلومات حول تغيير في إعدادات الفهرس.
الحقول | |
---|---|
change_type |
تحدد هذه السمة كيفية تغيّر الفهرس. |
index |
الفهرس الذي يتم تغييره. |
ChangeType
تحدد هذه السمة كيفية تغيّر الفهرس.
عمليات التعداد | |
---|---|
CHANGE_TYPE_UNSPECIFIED |
نوع التغيير غير محدّد أو معروف. |
ADD |
تتم إضافة فهرس الحقل الفردي. |
REMOVE |
جارٍ إزالة فهرس الحقل الفردي. |
GetFieldRequest
الحقول | |
---|---|
name |
اسم النموذج |
GetIndexRequest
الحقول | |
---|---|
name |
اسم النموذج |
ImportDocumentsMetadata
البيانات الوصفية لـ google.longrunning.Operation
نتيجة من FirestoreAdmin.ImportDocuments
الحقول | |
---|---|
start_time |
وقت بدء هذه العملية. |
end_time |
وقت اكتمال هذه العملية. سيتم إلغاء ضبط هذه السياسة إذا كانت العملية لا تزال قيد التنفيذ. |
operation_state |
حالة عملية الاستيراد. |
progress_documents |
مستوى التقدم في هذه العملية ضمن المستندات |
progress_bytes |
مستوى تقدم هذه العملية، بالبايت. |
collection_ids[] |
معرّفات المجموعات التي يتم استيرادها. |
input_uri_prefix |
موقع المستندات التي يتم استيرادها. |
ImportDocumentsRequest
الحقول | |
---|---|
name |
قاعدة بيانات ليتم الاستيراد إليها. يجب أن يكون التنسيق: |
collection_ids[] |
معرّفات المجموعات المطلوب استيرادها. الحالة "غير محدّد" تعني جميع المجموعات المضمّنة في عملية الاستيراد. |
input_uri_prefix |
موقع الملفات التي تم تصديرها يجب أن يتطابق هذا الأمر مع out_uri_prefix أمر ExportDocumentsResponse (الاستجابة للطلب) من عملية تصدير اكتملت بنجاح. يُرجى الاطّلاع على: |
الفهرس
تتيح فهارس Cloud Firestore استعلامات بسيطة ومعقدة مقابل المستندات الموجودة في قاعدة البيانات.
الحقول | |
---|---|
name |
النتائج فقط. اسم محدد من قِبل الخادم لهذا الفهرس. سيكون هذا الاسم للفهارس المركّبة كما يلي: |
query_scope |
تسمح الفهارس ذات نطاق طلب بحث المجموعة المحدد بطلبات البحث ضمن مجموعة تابعة لمستند معيّن، والتي تم تحديدها في وقت طلب البحث، وتحتوي على معرّف المجموعة نفسه. إنّ الفهارس ذات نطاق طلبات البحث المحدّدة لمجموعة المجموعات تسمح بطلبات البحث مقابل كل المجموعات الواردة من مستند معيّن، والتي يتم تحديدها في وقت طلب البحث، والتي لها معرّف المجموعة نفسه كهذا الفهرس. |
fields[] |
الحقول التي يتيحها هذا الفهرس. بالنسبة إلى الفهارس المركّبة، يكون هذا دائمًا حقلين أو أكثر. يكون إدخال الحقل الأخير دائمًا لمسار الحقل بالنسبة إلى فهارس الحقل الأحادي، سيكون هذا دائمًا إدخالاً واحدًا فقط مع مسار حقل مساوٍ لمسار الحقل الخاص بالحقل المرتبط. |
state |
النتائج فقط. حالة عرض الفهرس |
IndexField
حقل في فهرس. يصف field_path الحقل الذي تمت فهرسته، ويصف value_mode كيفية فهرسة قيمة الحقل.
الحقول | |
---|---|
field_path |
يمكن أن يكون name. بالنسبة إلى فهارس الحقل الفردي، يجب أن تتطابق مع اسم الحقل أو قد يتم حذفها. |
حقل الاتحاد value_mode كيفية فهرسة قيمة الحقل يمكن أن يكون الحقل "value_mode " واحدًا فقط مما يلي: |
|
order |
تشير إلى أن هذا الحقل يتيح الترتيب حسب الترتيب المحدد أو المقارنة باستخدام = أو < أو <= أو > أو >=. |
array_config |
تشير هذه السمة إلى أنّ هذا الحقل يتيح العمليات على |
ArrayConfig
إعدادات قيم المصفوفة المتوافقة.
عمليات التعداد | |
---|---|
ARRAY_CONFIG_UNSPECIFIED |
لا يتيح الفهرس طلبات صفيف إضافية. |
CONTAINS |
يدعم الفهرس استعلامات احتواء الصفيف. |
طلب
الطلبات المتوافقة.
عمليات التعداد | |
---|---|
ORDER_UNSPECIFIED |
لم يتم تحديد الترتيب. هذا الخيار غير صالح. |
ASCENDING |
يتم ترتيب الحقل حسب قيمة حقل تصاعدية. |
DESCENDING |
يتم ترتيب الحقل حسب قيمة الحقل التنازلي. |
QueryScope
يحدد نطاق طلب البحث النطاق الذي يتم تشغيل طلب البحث فيه. ويتم تحديد ذلك في حقل from
في طلب بحث منظَّم.
عمليات التعداد | |
---|---|
QUERY_SCOPE_UNSPECIFIED |
نطاق طلب البحث غير محدد. هذا الخيار غير صالح. |
COLLECTION |
تسمح الفهارس ذات نطاق طلب بحث المجموعة المحدد بطلبات البحث في مجموعة تابعة لمستند معيّن، والتي تم تحديدها في وقت طلب البحث، وتحتوي على معرّف المجموعة المحدد في الفهرس. |
COLLECTION_GROUP |
إنّ الفهارس ذات نطاق طلبات البحث المحدّدة لمجموعة المجموعات تسمح بإجراء طلبات بحث مقابل كل المجموعات التي تم تحديد معرّف المجموعة لها في الفهرس. |
الحالة
حالة الفهرس. أثناء إنشاء الفهرس، سيكون الفهرس بالحالة CREATING
. في حال إنشاء الفهرس بنجاح، سيتم نقله إلى الحالة READY
. إذا واجهنا مشكلة في إنشاء الفهرس، سينتقل الفهرس إلى حالة NEEDS_REPAIR
.
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
لم يتم تحديد الولاية. |
CREATING |
يتم إنشاء الفهرس. هناك عملية نشطة لفترة طويلة للفهرس. يتم تحديث الفهرس عند كتابة مستند. قد تتوفر بعض بيانات الفهرس. |
READY |
الفهرس جاهز للاستخدام. يتم تحديث الفهرس عند كتابة مستند. تتم تعبئة الفهرس بالكامل من جميع المستندات المخزنة التي ينطبق عليها. |
NEEDS_REPAIR |
تم إنشاء الفهرس، ولكن حدث خطأ. ليست هناك عملية نشطة لفترة طويلة للفهرس، وقد تعذّر إتمام آخر عملية طويلة الأمد تمت معالجتها مؤخرًا. لا يتم تحديث الفهرس عند كتابة مستند. قد تتوفر بعض بيانات الفهرس. استخدِم واجهة برمجة التطبيقات google.long running.Operations لتحديد سبب إخفاق العملية الأخيرة التي حاولت إنشاء هذا الفهرس، ثم أعد إنشاء الفهرس. |
IndexOperationMetadata
البيانات الوصفية لـ google.longrunning.Operation
نتيجة من FirestoreAdmin.CreateIndex
الحقول | |
---|---|
start_time |
وقت بدء هذه العملية. |
end_time |
وقت اكتمال هذه العملية. سيتم إلغاء ضبط هذه السياسة إذا كانت العملية لا تزال قيد التنفيذ. |
index |
مورد الفهرس الذي يتم تنفيذ هذه العملية عليه. مثال: |
state |
حالة العملية. |
progress_documents |
مستوى التقدم في هذه العملية ضمن المستندات |
progress_bytes |
مستوى تقدم هذه العملية، بالبايت. |
ListFieldsRequest
الحقول | |
---|---|
parent |
اسم عنصر رئيسي بالنموذج |
filter |
الفلتر المطلوب تطبيقه على نتائج القائمة. في الوقت الحالي، لا يدعم |
page_size |
عدد النتائج المطلوب عرضها. |
page_token |
رمز مميز للصفحة تم عرضه من خلال مكالمة سابقة إلى |
ListFieldsResponse
الردّ على FirestoreAdmin.ListFields
.
الحقول | |
---|---|
fields[] |
الحقول المطلوبة. |
next_page_token |
هو الرمز المميز للصفحة الذي يمكن استخدامه لطلب صفحة أخرى من النتائج. إذا كان فارغًا، تكون هذه هي الصفحة الأخيرة. |
ListIndexesRequest
الحقول | |
---|---|
parent |
اسم عنصر رئيسي بالنموذج |
filter |
الفلتر المطلوب تطبيقه على نتائج القائمة. |
page_size |
عدد النتائج المطلوب عرضها. |
page_token |
رمز مميز للصفحة تم عرضه من خلال مكالمة سابقة إلى |
ListIndexesResponse
الردّ على FirestoreAdmin.ListIndexes
.
الحقول | |
---|---|
indexes[] |
الفهارس المطلوبة. |
next_page_token |
هو الرمز المميز للصفحة الذي يمكن استخدامه لطلب صفحة أخرى من النتائج. إذا كان فارغًا، تكون هذه هي الصفحة الأخيرة. |
OperationState
لوصف حالة العملية.
عمليات التعداد | |
---|---|
OPERATION_STATE_UNSPECIFIED |
غير محدد |
INITIALIZING |
يتم تجهيز الطلب للمعالجة. |
PROCESSING |
تتم حاليًا معالجة الطلب. |
CANCELLING |
جارٍ إلغاء الطلب بعد أن يُدعى المستخدم google.long running.Operations.CancelOperation on العملية. |
FINALIZING |
تمت معالجة الطلب وهو في المرحلة النهائية. |
SUCCESSFUL |
تم إكمال الطلب بنجاح. |
FAILED |
انتهت معالجة الطلب، ولكن حدث خطأ. |
CANCELLED |
تم إلغاء الطلب بعد أن يُسمّى المستخدم google.long running.Operations.CancelOperation. |
مدى التقدُّم
وصف مستوى تقدم العملية. وحدة العمل عامة ويجب تفسيرها استنادًا إلى مكان استخدام Progress
.
الحقول | |
---|---|
estimated_work |
مقدار العمل المقدر. |
completed_work |
مقدار العمل المنجز. |
UpdateFieldRequest
الحقول | |
---|---|
field |
الحقل الذي سيتم تعديله. |
update_mask |
قناع، مرتبط بالحقل. في حال تحديد هذه السمة، سيتم تعديل الإعدادات التي حدّدها هذا الحقل_mask فقط في الحقل. |