فهرست مطالب
-
FirestoreAdmin
(رابط) -
Backup
(پیام) -
Backup.State
(enum) -
BackupSchedule
(پیام) -
CreateBackupScheduleRequest
(پیام) -
CreateDatabaseMetadata
(پیام) -
CreateDatabaseRequest
(پیام) -
CreateIndexRequest
(پیام) -
DailyRecurrence
(پیام) -
Database
(پیام) -
Database.AppEngineIntegrationMode
(enum) -
Database.CmekConfig
(پیام) -
Database.ConcurrencyMode
(enum) -
Database.DatabaseType
(enum) -
Database.DeleteProtectionState
(enum) -
Database.PointInTimeRecoveryEnablement
(enum) -
DeleteBackupRequest
(پیام) -
DeleteBackupScheduleRequest
(پیام) -
DeleteDatabaseMetadata
(پیام) -
DeleteDatabaseRequest
(پیام) -
DeleteIndexRequest
(پیام) -
ExportDocumentsMetadata
(پیام) -
ExportDocumentsRequest
(پیام) -
ExportDocumentsResponse
(پیام) -
Field
(پیام) -
Field.IndexConfig
(پیام) -
Field.TtlConfig
(پیام) -
Field.TtlConfig.State
(enum) -
FieldOperationMetadata
(پیام) -
FieldOperationMetadata.IndexConfigDelta
(پیام) -
FieldOperationMetadata.IndexConfigDelta.ChangeType
(enum) -
FieldOperationMetadata.TtlConfigDelta
(پیام) -
FieldOperationMetadata.TtlConfigDelta.ChangeType
(enum) -
GetBackupRequest
(پیام) -
GetBackupScheduleRequest
(پیام) -
GetDatabaseRequest
(پیام) -
GetFieldRequest
(پیام) -
GetIndexRequest
(پیام) -
ImportDocumentsMetadata
(پیام) -
ImportDocumentsRequest
(پیام) -
Index
(پیام) -
Index.ApiScope
(enum) -
Index.IndexField
(پیام) -
Index.IndexField.ArrayConfig
(enum) -
Index.IndexField.Order
(enum) -
Index.IndexField.VectorConfig
(پیام) -
Index.IndexField.VectorConfig.FlatIndex
(پیام) -
Index.QueryScope
(enum) -
Index.State
(تعدادی) -
IndexOperationMetadata
(پیام) -
ListBackupSchedulesRequest
(پیام) -
ListBackupSchedulesResponse
(پیام) -
ListBackupsRequest
(پیام) -
ListBackupsResponse
(پیام) -
ListDatabasesRequest
(پیام) -
ListDatabasesResponse
(پیام) -
ListFieldsRequest
(پیام) -
ListFieldsResponse
(پیام) -
ListIndexesRequest
(پیام) -
ListIndexesResponse
(پیام) -
LocationMetadata
(پیام) -
OperationState
(تعدادی) -
Progress
(پیام) -
RestoreDatabaseMetadata
(پیام) -
RestoreDatabaseRequest
(پیام) -
UpdateBackupScheduleRequest
(پیام) -
UpdateDatabaseMetadata
(پیام) -
UpdateDatabaseRequest
(پیام) -
UpdateFieldRequest
(پیام) -
WeeklyRecurrence
(پیام)
Firestore Admin
Cloud Firestore Admin API.
این API چندین سرویس اداری برای Cloud Firestore ارائه می دهد.
پروژه، پایگاه داده، فضای نام، مجموعه، گروه مجموعه و سند همانطور که در Google Cloud Firestore API تعریف شده است استفاده می شود.
عملیات: یک عملیات نشان دهنده کاری است که در پس زمینه انجام می شود.
سرویس ایندکس فهرستهای Cloud Firestore را مدیریت میکند.
ایجاد ایندکس به صورت ناهمزمان انجام می شود. یک منبع عملیات برای هر عملیات ناهمزمان ایجاد می شود. وضعیت عملیات (شامل هر گونه خطای مواجه شده) ممکن است از طریق منبع عملیات پرس و جو شود.
مجموعه عملیات رکوردی از اقدامات انجام شده برای پروژه مشخص شده (از جمله هر عملیات در حال انجام) را ارائه می دهد. عملیات به طور مستقیم ایجاد نمی شود، بلکه از طریق تماس با مجموعه ها یا منابع دیگر ایجاد می شود.
عملیاتی که انجام می شود ممکن است حذف شود تا دیگر به عنوان بخشی از مجموعه عملیات در لیست قرار نگیرد. عملیات پس از 30 روز زباله جمع آوری می شود. به طور پیش فرض، ListOperations فقط در حال انجام و عملیات ناموفق برمی گردد. برای لیست کردن عملیات تکمیل شده، یک درخواست ListOperations با فیلتر done: true
.
عملیات توسط سرویس FirestoreAdmin
ایجاد می شود، اما از طریق سرویس google.longrunning.Operations
قابل دسترسی است.
CreateBackupSchedule |
---|
یک برنامه پشتیبان در پایگاه داده ایجاد می کند. حداکثر دو زمانبندی پشتیبانگیری را میتوان بر روی یک پایگاه داده پیکربندی کرد، یکی برنامه پشتیبانگیری روزانه با نگهداری تا 7 روز و یک برنامه پشتیبان هفتگی با نگهداری تا 14 هفته.
|
ایجاد پایگاه داده |
---|
یک پایگاه داده ایجاد کنید.
|
CreateIndex |
---|
یک شاخص ترکیبی ایجاد می کند. این یک
|
حذف پشتیبان |
---|
یک نسخه پشتیبان را حذف می کند.
|
DeleteBackupSchedule |
---|
یک برنامه پشتیبان را حذف می کند.
|
حذف پایگاه داده |
---|
پایگاه داده را حذف می کند.
|
حذف ایندکس |
---|
یک شاخص ترکیبی را حذف می کند.
|
صادرات اسناد |
---|
یک کپی از همه یا زیر مجموعه ای از اسناد را از Google Cloud Firestore به سیستم ذخیره سازی دیگری مانند Google Cloud Storage صادر می کند. بهروزرسانیهای اخیر اسناد ممکن است در صادرات منعکس نشود. صادرات در پسزمینه اتفاق میافتد و میتوان پیشرفت آن را از طریق منبع عملیاتی ایجاد شده کنترل و مدیریت کرد. خروجی یک صادرات فقط زمانی می تواند مورد استفاده قرار گیرد که عملیات مربوطه انجام شود. اگر عملیات صادرات قبل از تکمیل لغو شود، ممکن است دادههای جزئی در Google Cloud Storage باقی بماند. برای جزئیات بیشتر در مورد رفتار صادرات و قالب خروجی، مراجعه کنید: https://cloud.google.com/firestore/docs/manage-data/export-import
|
بازگشت تا |
---|
اطلاعاتی در مورد یک نسخه پشتیبان دریافت می کند.
|
GetBackup Schedule |
---|
اطلاعاتی در مورد یک برنامه پشتیبان دریافت می کند.
|
GetDatabase |
---|
اطلاعاتی در مورد پایگاه داده دریافت می کند.
|
GetField |
---|
فراداده و پیکربندی یک فیلد را دریافت می کند.
|
GetIndex |
---|
یک شاخص ترکیبی می گیرد.
|
Import Documents |
---|
اسناد را به Google Cloud Firestore وارد می کند. اسناد موجود با همین نام رونویسی می شوند. واردات در پسزمینه اتفاق میافتد و میتوان پیشرفت آن را از طریق منبع عملیاتی که ایجاد میشود، نظارت و مدیریت کرد. اگر عملیات ImportDocuments لغو شود، ممکن است زیر مجموعه ای از داده ها قبلاً به Cloud Firestore وارد شده باشد.
|
ListBackup Schedules |
---|
فهرست برنامه های پشتیبان گیری
|
پشتیبان گیری از لیست |
---|
همه ی نسخه های پشتیبان را لیست می کند.
|
ListDatabases |
---|
لیست تمام پایگاه های داده در پروژه.
|
ListFields |
---|
پیکربندی فیلد و ابرداده را برای این پایگاه داده فهرست می کند. در حال حاضر،
|
فهرست ایندکس ها |
---|
فهرست های ترکیبی را فهرست می کند.
|
بازیابی پایگاه داده |
---|
یک پایگاه داده جدید با بازیابی از یک نسخه پشتیبان موجود ایجاد می کند. پایگاه داده جدید باید در همان منطقه ابری یا مکان چند منطقه ای پشتیبان موجود باشد. این شبیه به [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] عمل می کند، به جز اینکه به جای ایجاد یک پایگاه داده خالی جدید، یک پایگاه داده جدید با نوع پایگاه داده، پیکربندی فهرست، و اسناد از یک نسخه پشتیبان موجود ایجاد می شود.
|
UpdateBackup Schedule |
---|
یک برنامه پشتیبان را به روز می کند.
|
به روز رسانی پایگاه داده |
---|
پایگاه داده را به روز می کند.
|
UpdateField |
---|
پیکربندی فیلد را به روز می کند. در حال حاضر، بهروزرسانیهای فیلد فقط برای پیکربندی فهرست یک فیلد اعمال میشود. با این حال، فراخوانی به این تماس یک برای پیکربندی تنظیمات فیلد پیشفرض برای پایگاه داده، از
|
پشتیبان گیری
یک نسخه پشتیبان از یک پایگاه داده Cloud Firestore.
نسخه پشتیبان شامل تمام اسناد و تنظیمات فهرست برای پایگاه داده داده شده در یک نقطه زمانی خاص است.
زمینه های | |
---|---|
name | فقط خروجی نام منبع منحصر به فرد پشتیبان گیری. قالب |
database | فقط خروجی نام پایگاه داده Firestore که نسخه پشتیبان از آن تهیه شده است. قالب |
database_uid | فقط خروجی UUID4 تولید شده توسط سیستم برای پایگاه داده Firestore که نسخه پشتیبان از آن تهیه شده است. |
snapshot_time | فقط خروجی نسخه پشتیبان حاوی یک کپی سازگار خارجی از پایگاه داده در این زمان است. |
expire_time | فقط خروجی مهر زمانی که در آن این نسخه پشتیبان منقضی می شود. |
state | فقط خروجی وضعیت فعلی نسخه پشتیبان. |
حالت
وضعیت فعلی پشتیبان را نشان دهید.
Enums | |
---|---|
STATE_UNSPECIFIED | ایالت نامشخص است. |
CREATING | نسخه پشتیبان در انتظار هنوز در حال ایجاد است. عملیات پشتیبان گیری در این حالت رد می شود. |
READY | نسخه پشتیبان کامل و آماده استفاده است. |
NOT_AVAILABLE | نسخه پشتیبان در حال حاضر در دسترس نیست. |
Backup Schedule
یک برنامه پشتیبان برای پایگاه داده Cloud Firestore.
این منبع متعلق به پایگاه داده ای است که از آن نسخه پشتیبان تهیه می کند و به همراه پایگاه داده حذف می شود. پشتیبانگیری واقعی نیست.
زمینه های | |
---|---|
name | فقط خروجی شناسه برنامه پشتیبان منحصر به فرد در تمام مکان ها و پایگاه های داده برای پروژه داده شده. این به طور خودکار اختصاص داده می شود. قالب |
create_time | فقط خروجی مهر زمانی که در آن این برنامه پشتیبان ایجاد شد و از آن زمان مؤثر بود. قبل از این زمان هیچ نسخه پشتیبان برای این زمانبندی ایجاد نخواهد شد. |
update_time | فقط خروجی مهر زمانی که اخیراً در آن این برنامه پشتیبان بهروزرسانی شده است. هنگامی که برای اولین بار یک برنامه پشتیبان ایجاد می شود، این همان create_time است. |
retention | در چه زمان نسبی در آینده، در مقایسه با زمان ایجاد آن، نسخه پشتیبان باید حذف شود، به عنوان مثال بک آپ ها را به مدت 7 روز نگه دارید. |
recurrence میدان اتحادیه . یکی از فیلدها برای نشان دادن زمان تهیه نسخه پشتیبان. recurrence فقط می تواند یکی از موارد زیر باشد: | |
daily_recurrence | برای برنامه ای که روزانه اجرا می شود. |
weekly_recurrence | برای برنامه ای که هر هفته در یک روز خاص اجرا می شود. |
CreateBackupScheduleRequest
درخواست FirestoreAdmin.CreateBackupSchedule
.
زمینه های | |
---|---|
parent | ضروری. پایگاه داده والد. قالببندی |
backup_schedule | ضروری. برنامه پشتیبان برای ایجاد. |
CreateDatabaseMetadata
این نوع هیچ فیلدی ندارد.
ابرداده مربوط به عملیات ایجاد پایگاه داده.
CreateDatabaseRequest
درخواست FirestoreAdmin.CreateDatabase
.
زمینه های | |
---|---|
parent | ضروری. نام والد |
database | ضروری. پایگاه داده برای ایجاد. |
database_id | ضروری. شناسه مورد استفاده برای پایگاه داده، که جزء نهایی نام منبع پایگاه داده خواهد شد. این مقدار باید 4-63 کاراکتر باشد. کاراکترهای معتبر /[az][0-9]-/ هستند که کاراکتر اول یک حرف و آخرین کاراکتر یک حرف یا یک عدد است. نباید شبیه UUID باشد /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. شناسه پایگاه داده "(پیش فرض)" نیز معتبر است. |
CreateIndexRequest
درخواست FirestoreAdmin.CreateIndex
.
زمینه های | |
---|---|
parent | ضروری. نام والد فرم |
index | ضروری. شاخص ترکیبی برای ایجاد. |
عود روزانه
این نوع هیچ فیلدی ندارد.
نشان دهنده یک برنامه تکراری است که هر روز در یک زمان خاص اجرا می شود.
منطقه زمانی UTC است.
پایگاه داده
یک پایگاه داده Cloud Firestore.
زمینه های | |
---|---|
name | نام منبع پایگاه داده قالب: |
uid | فقط خروجی UUID4 تولید شده توسط سیستم برای این پایگاه داده. |
create_time | فقط خروجی مهر زمانی که این پایگاه داده در آن ایجاد شده است. پایگاههای داده ایجاد شده قبل از سال 2016، create_time را پر نمیکنند. |
update_time | فقط خروجی مهر زمانی که این پایگاه داده اخیراً به روز شده است. توجه داشته باشید که این فقط شامل به روز رسانی های منبع پایگاه داده است و نه داده های موجود در پایگاه داده. |
location_id | محل پایگاه داده مکانهای موجود در https://cloud.google.com/firestore/docs/locations فهرست شدهاند. |
type | نوع پایگاه داده برای اطلاعات در مورد نحوه انتخاب به https://cloud.google.com/datastore/docs/firestore-or-datastore مراجعه کنید. |
concurrency_mode | حالت کنترل همزمانی برای استفاده برای این پایگاه داده. |
version_retention_period | فقط خروجی دوره ای که طی آن نسخه های گذشته داده ها در پایگاه داده نگهداری می شوند. هر اگر ویژگی PITR فعال باشد، دوره نگهداری 7 روز است. در غیر این صورت مدت نگهداری 1 ساعت است. |
earliest_version_time | فقط خروجی اولین مهر زمانی که در آن می توان نسخه های قدیمی داده ها را از پایگاه داده خواند. [version_retention_period] را در بالا ببینید. این فیلد با این مقدار به طور مداوم به روز می شود و در لحظه ای که از آن درخواست می شود بیات می شود. اگر از این مقدار برای بازیابی داده ها استفاده می کنید، مطمئن شوید که از لحظه درخواست مقدار تا لحظه شروع بازیابی، زمان را در نظر بگیرید. |
point_in_time_recovery_enablement | فعال کردن ویژگی PITR در این پایگاه داده. |
app_engine_integration_mode | حالت یکپارچه سازی App Engine برای استفاده برای این پایگاه داده. |
key_prefix | فقط خروجی کلید_پیشوند برای این پایگاه داده. این کلید_پیشوند در ترکیب با شناسه پروژه (" این مقدار ممکن است خالی باشد که در این صورت برنامه کاربردی برای استفاده از کلیدهای رمزگذاری شده با URL پروژه_id است (به عنوان مثال: foo به جای v~foo). |
delete_protection_state | وضعیت حفاظت از حذف برای پایگاه داده. |
etag | این چکسوم توسط سرور بر اساس مقدار فیلدهای دیگر محاسبه میشود و ممکن است در درخواستهای بهروزرسانی و حذف ارسال شود تا اطمینان حاصل شود که مشتری قبل از ادامه، مقدار بهروزی دارد. |
AppEngineIntegrationMode
نوع حالت یکپارچه سازی App Engine.
Enums | |
---|---|
APP_ENGINE_INTEGRATION_MODE_UNSPECIFIED | استفاده نشده. |
ENABLED | اگر یک برنامه App Engine در همان منطقه این پایگاه داده وجود داشته باشد، پیکربندی App Engine بر این پایگاه داده تأثیر می گذارد. این شامل غیرفعال کردن برنامه و پایگاه داده و همچنین غیرفعال کردن نوشتن در پایگاه داده است. |
DISABLED | App Engine هیچ تاثیری بر توانایی این پایگاه داده برای ارائه درخواست ها ندارد. این تنظیمات پیشفرض برای پایگاههای داده ایجاد شده با Firestore API است. |
حالت همزمانی
نوع حالت کنترل همزمان برای تراکنش ها.
Enums | |
---|---|
CONCURRENCY_MODE_UNSPECIFIED | استفاده نشده. |
OPTIMISTIC | به طور پیش فرض از کنترل همزمان خوش بینانه استفاده کنید. این حالت برای پایگاه داده های Cloud Firestore در دسترس است. |
PESSIMISTIC | به طور پیش فرض از کنترل همزمان بدبینانه استفاده کنید. این حالت برای پایگاه داده های Cloud Firestore در دسترس است. این تنظیم پیش فرض برای Cloud Firestore است. |
OPTIMISTIC_WITH_ENTITY_GROUPS | به طور پیش فرض از کنترل همزمانی خوش بینانه با گروه های موجود استفاده کنید. این تنها حالت موجود برای Cloud Datastore است. این حالت برای Cloud Firestore با حالت Datastore نیز موجود است اما توصیه نمی شود. |
نوع پایگاه داده
نوع پایگاه داده برای اطلاعات در مورد نحوه انتخاب به https://cloud.google.com/datastore/docs/firestore-or-datastore مراجعه کنید.
تغییر حالت تنها در صورتی مجاز است که پایگاه داده خالی باشد.
Enums | |
---|---|
DATABASE_TYPE_UNSPECIFIED | مقدار پیش فرض اگر نوع پایگاه داده حذف شده باشد از این مقدار استفاده می شود. |
FIRESTORE_NATIVE | حالت بومی Firestore |
DATASTORE_MODE | Firestore در حالت Datastore. |
DeleteProtectionState
وضعیت حفاظتی حذف پایگاه داده
Enums | |
---|---|
DELETE_PROTECTION_STATE_UNSPECIFIED | مقدار پیش فرض نوع حفاظت حذف مشخص نشده است |
DELETE_PROTECTION_DISABLED | حفاظت حذف غیرفعال است |
DELETE_PROTECTION_ENABLED | حفاظت حذف فعال است |
PointInTimeRecoveryEnablement
فعال کردن ویژگی Point In Time Recovery.
Enums | |
---|---|
POINT_IN_TIME_RECOVERY_ENABLEMENT_UNSPECIFIED | استفاده نشده. |
POINT_IN_TIME_RECOVERY_ENABLED | خواندن در نسخههای انتخابی دادهها در ۷ روز گذشته پشتیبانی میشود:
برای تعیین نسخه های پشتیبانی شده می توان |
POINT_IN_TIME_RECOVERY_DISABLED | خواندن در هر نسخه از داده ها در 1 ساعت گذشته پشتیبانی می شود. |
DeleteBackupRequest
درخواست FirestoreAdmin.DeleteBackup
.
زمینه های | |
---|---|
name | ضروری. نام نسخه پشتیبان برای حذف. قالب |
DeleteBackupScheduleRequest
درخواست برای [FirestoreAdmin.DeleteBackupSchedules][].
زمینه های | |
---|---|
name | ضروری. نام برنامه پشتیبان. قالببندی |
DeleteDatabaseMetadata
این نوع هیچ فیلدی ندارد.
ابرداده مربوط به عملیات حذف پایگاه داده.
DeleteDatabaseRequest
درخواست FirestoreAdmin.DeleteDatabase
.
زمینه های | |
---|---|
name | ضروری. نام |
etag | تگ فعلی پایگاه داده. اگر تگ ارائه شود و با تگ فعلی پایگاه داده مطابقت نداشته باشد، حذف مسدود می شود و خطای FAILED_PRECONDITION برگردانده می شود. |
DeleteIndexRequest
درخواست FirestoreAdmin.DeleteIndex
.
زمینه های | |
---|---|
name | ضروری. نامی از |
ExportDocumentsMetadata
فراداده برای google.longrunning.Operation
نتایج عملیات از FirestoreAdmin.ExportDocuments
.
زمینه های | |
---|---|
start_time | زمانی که این عملیات شروع شد. |
end_time | زمان تکمیل این عملیات اگر عملیات هنوز در حال انجام باشد، تنظیم نخواهد شد. |
operation_state | وضعیت عملیات صادرات. |
progress_documents | پیشرفت، در اسناد، این عملیات. |
progress_bytes | پیشرفت این عملیات بر حسب بایت. |
collection_ids[] | کدام شناسه های مجموعه در حال صادرات هستند. |
output_uri_prefix | جایی که اسناد صادر می شود. |
namespace_ids[] | کدام شناسههای فضای نام صادر میشوند. |
snapshot_time | مهر زمانی که مربوط به نسخه پایگاه داده ای است که صادر می شود. در صورت نامشخص بودن، هیچ تضمینی در مورد سازگاری اسناد صادر شده وجود ندارد. |
ExportDocumentsRequest
درخواست FirestoreAdmin.ExportDocuments
.
زمینه های | |
---|---|
name | ضروری. پایگاه داده برای صادرات باید به این شکل باشد: |
collection_ids[] | کدام شناسه مجموعه را صادر کنیم. نامشخص یعنی همه مجموعه ها. |
output_uri_prefix | URI خروجی در حال حاضر فقط از URIهای Google Cloud Storage به شکل: |
namespace_ids[] | یک لیست خالی همه فضاهای نام را نشان می دهد. این استفاده ارجح برای پایگاه داده هایی است که از فضای نام استفاده نمی کنند. یک عنصر رشته خالی نشان دهنده فضای نام پیش فرض است. اگر پایگاه داده دارای دادههایی در فضای نام غیر پیشفرض است، اما نمیخواهد آنها را شامل شود، باید از این مورد استفاده شود. هر فضای نام در این لیست باید منحصر به فرد باشد. |
snapshot_time | مهر زمانی که مربوط به نسخه پایگاه داده ای است که باید صادر شود. مهر زمان باید در گذشته باشد، به دقیقه گرد شده و از |
ExportDocumentsResponse
در فیلد پاسخ google.longrunning.Operation
بازگردانده شد.
زمینه های | |
---|---|
output_uri_prefix | محل قرارگیری فایل های خروجی این می تواند برای شروع وارد کردن به Cloud Firestore (این پروژه یا پروژه دیگر) پس از تکمیل موفقیت آمیز عملیات استفاده شود. |
رشته
نشان دهنده یک فیلد واحد در پایگاه داده است.
فیلدها توسط "گروه مجموعه" خود گروه بندی می شوند، که همه مجموعه های موجود در پایگاه داده را با شناسه یکسان نشان می دهد.
زمینه های | |
---|---|
name | ضروری. نام فیلد یک مسیر فیلد ممکن است یک نام فیلد ساده، به عنوان مثال مسیرهای فیلد ممکن است با استفاده از مثالها: (توجه: نظرات در اینجا با نحو علامتگذاری نوشته میشوند، بنابراین یک لایه بکتیک اضافی برای نمایش یک بلوک کد وجود دارد) یک |
index_config | پیکربندی شاخص برای این فیلد. اگر تنظیم نشود، نمایه سازی فیلد به پیکربندی تعریف شده توسط |
ttl_config | پیکربندی TTL برای این |
IndexConfig
پیکربندی شاخص برای این فیلد.
زمینه های | |
---|---|
indexes[] | شاخص های پشتیبانی شده برای این زمینه |
uses_ancestor_config | فقط خروجی وقتی درست است، پیکربندی نمایه |
ancestor_field | فقط خروجی نام منبع |
reverting | فقط خروجی وقتی درست است، پیکربندی نمایه |
TtlConfig
پیکربندی TTL (زمان تا زندگی) برای اسنادی که دارای این مجموعه Field
هستند.
ذخیره یک مقدار مهر زمانی در یک فیلد فعال با TTL به عنوان زمان انقضای مطلق سند تلقی می شود. مقادیر مهر زمانی در گذشته نشان می دهد که سند برای انقضای فوری واجد شرایط است. استفاده از هر نوع داده دیگری یا عدم وجود فیلد، انقضا را برای سند جداگانه غیرفعال می کند.
زمینه های | |
---|---|
state | فقط خروجی وضعیت پیکربندی TTL. |
حالت
وضعیت اعمال پیکربندی TTL برای همه اسناد.
Enums | |
---|---|
STATE_UNSPECIFIED | وضعیت نامشخص یا ناشناخته است. |
CREATING | TTL در حال اعمال است. یک عملیات طولانی مدت فعال برای ردیابی تغییر وجود دارد. اسناد جدید نوشته شده دارای TTLهای درخواستی خواهند بود. TTLهای درخواستی در اسناد موجود هنوز در حال پردازش هستند. هنگامی که TTLها در تمام اسناد موجود پردازش شدند، وضعیت به "ACTIVE" منتقل می شود. |
ACTIVE | TTL برای همه اسناد فعال است. |
NEEDS_REPAIR | پیکربندی TTL را نمی توان برای همه اسناد موجود فعال کرد. اسناد جدید نوشته شده به اعمال TTL خود ادامه خواهند داد. LRO زمانی برگشت که آخرین تلاش برای فعال کردن TTL برای این Field ناموفق بود و ممکن است جزئیات بیشتری داشته باشد. |
FieldOperationMetadata
فراداده برای نتایج google.longrunning.Operation
از FirestoreAdmin.UpdateField
.
زمینه های | |
---|---|
start_time | زمانی که این عملیات شروع شد. |
end_time | زمان تکمیل این عملیات اگر عملیات هنوز در حال انجام باشد، تنظیم نخواهد شد. |
field | منبع میدانی که این عملیات روی آن عمل می کند. برای مثال: |
index_config_deltas[] | فهرستی از |
state | وضعیت عملیات. |
progress_documents | پیشرفت، در اسناد، این عملیات. |
progress_bytes | پیشرفت این عملیات بر حسب بایت. |
ttl_config_delta | دلتاهای پیکربندی TTL را توصیف می کند. |
IndexConfigDelta
اطلاعات مربوط به تغییر پیکربندی شاخص
زمینه های | |
---|---|
change_type | نحوه تغییر شاخص را مشخص می کند. |
index | شاخص در حال تغییر است. |
تغییر نوع
نحوه تغییر شاخص را مشخص می کند.
Enums | |
---|---|
CHANGE_TYPE_UNSPECIFIED | نوع تغییر مشخص یا مشخص نیست. |
ADD | فهرست تک فیلد در حال اضافه شدن است. |
REMOVE | فهرست تک فیلد در حال حذف شدن است. |
TtlConfigDelta
اطلاعات مربوط به تغییر پیکربندی TTL.
زمینه های | |
---|---|
change_type | نحوه تغییر پیکربندی TTL را مشخص می کند. |
تغییر نوع
نحوه تغییر پیکربندی TTL را مشخص می کند.
Enums | |
---|---|
CHANGE_TYPE_UNSPECIFIED | نوع تغییر مشخص یا مشخص نیست. |
ADD | پیکربندی TTL در حال اضافه شدن است. |
REMOVE | پیکربندی TTL در حال حذف است. |
GetBackupRequest
درخواست FirestoreAdmin.GetBackup
.
زمینه های | |
---|---|
name | ضروری. نام پشتیبان برای واکشی. قالب |
GetBackupScheduleRequest
درخواست FirestoreAdmin.GetBackupSchedule
.
زمینه های | |
---|---|
name | ضروری. نام برنامه پشتیبان. قالببندی |
GetDatabaseRequest
درخواست FirestoreAdmin.GetDatabase
.
زمینه های | |
---|---|
name | ضروری. نام |
GetFieldRequest
درخواست FirestoreAdmin.GetField
.
زمینه های | |
---|---|
name | ضروری. نام |
GetIndexRequest
درخواست FirestoreAdmin.GetIndex
.
زمینه های | |
---|---|
name | ضروری. نامی از |
ImportDocumentsMetadata
فراداده برای google.longrunning.Operation
نتایج عملیات از FirestoreAdmin.ImportDocuments
.
زمینه های | |
---|---|
start_time | زمانی که این عملیات شروع شد. |
end_time | زمان تکمیل این عملیات اگر عملیات هنوز در حال انجام باشد، تنظیم نخواهد شد. |
operation_state | وضعیت عملیات واردات. |
progress_documents | پیشرفت، در اسناد، این عملیات. |
progress_bytes | پیشرفت این عملیات بر حسب بایت. |
collection_ids[] | کدام شناسه های مجموعه در حال وارد شدن هستند. |
input_uri_prefix | محل اسناد وارد شده |
namespace_ids[] | کدام شناسههای فضای نام وارد میشوند. |
ImportDocumentsRequest
درخواست FirestoreAdmin.ImportDocuments
.
زمینه های | |
---|---|
name | ضروری. پایگاه داده برای وارد کردن باید به این شکل باشد: |
collection_ids[] | کدام شناسه مجموعه را وارد کنید. نامشخص به معنای تمام مجموعه های موجود در واردات است. |
input_uri_prefix | محل فایل های صادر شده این باید با output_uri_prefix یک ExportDocumentsResponse از صادراتی که با موفقیت انجام شده است مطابقت داشته باشد. به: |
namespace_ids[] | یک لیست خالی همه فضاهای نام را نشان می دهد. این استفاده ارجح برای پایگاه داده هایی است که از فضای نام استفاده نمی کنند. یک عنصر رشته خالی نشان دهنده فضای نام پیش فرض است. اگر پایگاه داده دارای دادههایی در فضای نام غیر پیشفرض است، اما نمیخواهد آنها را شامل شود، باید از این مورد استفاده شود. هر فضای نام در این لیست باید منحصر به فرد باشد. |
فهرست مطالب
نمایه های Cloud Firestore پرس و جوهای ساده و پیچیده را در برابر اسناد موجود در پایگاه داده فعال می کنند.
زمینه های | |
---|---|
name | فقط خروجی یک نام سرور برای این فهرست تعریف شده است. شکل این نام برای نمایه های ترکیبی به این صورت خواهد بود: |
query_scope | نمایههایی با محدوده جستجوی مجموعه مشخص شده، درخواستهایی را در برابر مجموعهای که فرزند یک سند خاص است، مشخص شده در زمان پرس و جو، و دارای همان شناسه مجموعه است، اجازه میدهند. نمایههایی با محدوده پرس و جوی گروه مجموعه مشخص شده، درخواستهایی را در برابر همه مجموعههایی که از یک سند خاص، مشخص شده در زمان پرسوجو مشخص شدهاند، اجازه میدهند که همان شناسه مجموعه را با این فهرست دارند. |
api_scope | دامنه API که توسط این شاخص پشتیبانی می شود. |
fields[] | فیلدهای پشتیبانی شده توسط این شاخص برای ایندکس های ترکیبی، حداقل 2 و حداکثر 100 فیلد لازم است. آخرین ورودی فیلد همیشه برای مسیر فیلد برای فهرست های تک فیلد، این همیشه دقیقاً یک ورودی با مسیر فیلد برابر با مسیر فیلد مربوطه خواهد بود. |
state | فقط خروجی وضعیت خدمات شاخص. |
ApiScope
API Scope APIهایی (Firestore Native یا Firestore در حالت Datastore) را تعریف می کند که برای پرس و جوها پشتیبانی می شوند.
Enums | |
---|---|
ANY_API | این فهرست را فقط میتوان توسط Firestore Native query API استفاده کرد. این پیش فرض است. |
DATASTORE_MODE_API | این فهرست فقط توسط Firestore در حالت Datastore Query API قابل استفاده است. |
IndexField
یک فیلد در یک شاخص field_path توضیح می دهد که کدام فیلد ایندکس شده است، value_mode نحوه نمایه شدن مقدار فیلد را توضیح می دهد.
زمینه های | |
---|---|
field_path | می تواند نام باشد. برای فهرست های تک فیلد، این باید با نام فیلد مطابقت داشته باشد یا ممکن است حذف شود. |
فیلد اتحادیه value_mode . چگونه مقدار فیلد ایندکس می شود. value_mode فقط می تواند یکی از موارد زیر باشد: | |
order | نشان می دهد که این فیلد از ترتیب با ترتیب مشخص شده یا مقایسه با استفاده از =، !=، <، <=، >، >= پشتیبانی می کند. |
array_config | نشان می دهد که این فیلد از عملیات روی |
vector_config | نشان می دهد که این فیلد از عملیات نزدیکترین همسایه و فاصله بر روی بردار پشتیبانی می کند. |
ArrayConfig
تنظیمات ارزش آرایه پشتیبانی شده
Enums | |
---|---|
ARRAY_CONFIG_UNSPECIFIED | این فهرست از پرس و جوهای آرایه اضافی پشتیبانی نمی کند. |
CONTAINS | ایندکس از پرس و جوهای مربوط به آرایه پشتیبانی می کند. |
سفارش
سفارشات پشتیبانی شده
Enums | |
---|---|
ORDER_UNSPECIFIED | سفارش مشخص نیست گزینه معتبری نیست |
ASCENDING | فیلد بر اساس مقدار فیلد صعودی مرتب می شود. |
DESCENDING | فیلد بر اساس مقدار فیلد نزولی مرتب می شود. |
VectorConfig
پیکربندی نمایه برای پشتیبانی از عملیات جستجوی برداری
زمینه های | |
---|---|
dimension | ضروری. بعد برداری که این پیکربندی برای آن اعمال می شود. شاخص به دست آمده فقط شامل بردارهای این بعد است و می تواند برای جستجوی برداری با همان بعد استفاده شود. |
type فیلد اتحادیه نوع شاخص مورد استفاده type می تواند تنها یکی از موارد زیر باشد: | |
flat | نشان می دهد که شاخص برداری یک شاخص مسطح است. |
FlatIndex
این نوع هیچ فیلدی ندارد.
شاخصی که بردارها را در یک ساختار داده مسطح ذخیره می کند و از جستجوی جامع پشتیبانی می کند.
QueryScope
Query Scope محدوده ای را که یک پرس و جو در آن اجرا می شود را تعریف می کند. این در یک فیلد StructuredQuery from
مشخص شده است.
Enums | |
---|---|
QUERY_SCOPE_UNSPECIFIED | محدوده پرس و جو مشخص نشده است. گزینه معتبری نیست |
COLLECTION | نمایههایی با محدوده جستجوی مجموعه مشخص شده، درخواستهایی را در برابر مجموعهای که فرزند یک سند خاص است، مشخص شده در زمان پرس و جو، و دارای شناسه مجموعه مشخص شده توسط ایندکس است، اجازه میدهند. |
COLLECTION_GROUP | نمایههایی با محدوده پرس و جوی گروه مجموعه مشخص شده، درخواستهایی را در برابر همه مجموعههایی که دارای شناسه مجموعه مشخص شده توسط ایندکس هستند، اجازه میدهند. |
COLLECTION_RECURSIVE | تمام اجداد مجموعه ها را در فهرست قرار دهید. فقط برای پایگاه های داده Datastore Mode موجود است. |
حالت
وضعیت یک شاخص در طول ایجاد ایندکس، یک نمایه در حالت CREATING
خواهد بود. اگر نمایه با موفقیت ایجاد شود، به حالت READY
منتقل می شود. اگر ایجاد ایندکس با مشکل مواجه شود، ایندکس به حالت NEEDS_REPAIR
منتقل میشود.
Enums | |
---|---|
STATE_UNSPECIFIED | ایالت نامشخص است. |
CREATING | شاخص در حال ایجاد است. یک عملیات طولانی مدت فعال برای شاخص وجود دارد. نمایه هنگام نوشتن یک سند به روز می شود. برخی از داده های شاخص ممکن است وجود داشته باشد. |
READY | شاخص آماده استفاده است. نمایه هنگام نوشتن یک سند به روز می شود. فهرست به طور کامل از تمام اسناد ذخیره شده ای که برای آنها اعمال می شود پر شده است. |
NEEDS_REPAIR | شاخص در حال ایجاد بود، اما مشکلی پیش آمد. هیچ عملیاتی طولانی مدت فعال برای این شاخص وجود ندارد و اخیراً به پایان رسیده است که عملیات طولانی مدت انجام نشد. این فهرست هنگام نوشتن یک سند به روز نمی شود. برخی از داده های فهرست ممکن است وجود داشته باشد. از API Google.Longrunning.Operations استفاده کنید تا مشخص کنید که چرا عملیاتی که آخرین بار برای ایجاد این شاخص تلاش کرده است شکست خورد ، سپس دوباره شاخص را ایجاد کنید. |
indexoperationmetadata
ابرداده برای google.longrunning.Operation
از FirestoreAdmin.CreateIndex
.
زمینه های | |
---|---|
start_time | زمان شروع این عملیات. |
end_time | زمان اتمام این عملیات. اگر عملکرد هنوز در حال انجام باشد ، باز خواهد شد. |
index | منبع شاخصی که این عملیات در آن انجام می شود. به عنوان مثال: |
state | وضعیت عملیات. |
progress_documents | پیشرفت ، در اسناد ، این عملیات. |
progress_bytes | پیشرفت ، در بایت ، این عملیات. |
listbackupschedulesrequest
درخواست FirestoreAdmin.ListBackupSchedules
.
زمینه های | |
---|---|
parent | ضروری. پایگاه داده والدین. قالب |
پاسخ ListBackupSchedulesResponse
پاسخ برای FirestoreAdmin.ListBackupSchedules
.
زمینه های | |
---|---|
backup_schedules[] | لیست کلیه برنامه های پشتیبان گیری. |
listbackupsrequest
درخواست FirestoreAdmin.ListBackups
.
زمینه های | |
---|---|
parent | ضروری. موقعیت مکانی برای لیست پشتیبان گیری از. قالب |
پاسخ لیست
پاسخ برای FirestoreAdmin.ListBackups
.
زمینه های | |
---|---|
backups[] | لیست کلیه پشتیبان گیری برای این پروژه. |
unreachable[] | لیست مکانهایی که پشتیبان گیری های موجود از آن قادر به برداشتن نیستند. این پاسخ به جای عدم موفقیت در کل درخواست ها در صورت عدم دسترسی یک مکان واحد ، یک مجموعه نتیجه جزئی و لیستی از مکانهایی را که قادر به دستیابی به اینجا نیستند ، برمی گرداند. این درخواست را می توان در برابر یک مکان واحد دوباره امتحان کرد تا خطای مشخصی داشته باشد. |
listDatabasesRequest
درخواست لیست پایگاه داده های Firestore در همه مکان ها برای یک پروژه.
زمینه های | |
---|---|
parent | ضروری. نام والدین |
پاسخ لیست
لیست بانکهای اطلاعاتی برای یک پروژه.
زمینه های | |
---|---|
databases[] | بانکهای اطلاعاتی در پروژه. |
unreachable[] | در صورتی که داده های مربوط به بانکهای اطلاعاتی فردی را نمی توان ذکر کرد ، آنها در اینجا ضبط می شوند. به عنوان مثال ممکن است: پروژه ها/some_project/مکان/some_location این اتفاق می افتد اگر منطقه ابری که پایگاه داده در آن ساکن است در حال حاضر در دسترس نیست. در این حالت ما نمی توانیم تمام جزئیات مربوط به پایگاه داده را واگذار کنیم. ممکن است با ارسال درخواست "دریافت" برای منبع یا درخواست "لیست" برای مکان خاص ، بتوانید یک پیام خطای دقیق تر (یا احتمالاً منبع را واکشی کنید) دریافت کنید. |
ListfieldSrequest
درخواست FirestoreAdmin.ListFields
.
زمینه های | |
---|---|
parent | ضروری. نام والدین |
filter | فیلتر برای اعمال در لیست نتایج. در حال حاضر ، |
page_size | تعداد نتایج برای بازگشت. |
page_token | یک صفحه صفحه ، از تماس قبلی به |
لیست
پاسخ برای FirestoreAdmin.ListFields
.
زمینه های | |
---|---|
fields[] | زمینه های درخواست شده |
next_page_token | نشانه ای که ممکن است برای درخواست صفحه دیگری از نتایج استفاده شود. اگر خالی باشد ، این آخرین صفحه است. |
ListIndexesRequest
درخواست FirestoreAdmin.ListIndexes
.
زمینه های | |
---|---|
parent | ضروری. نام والدین |
filter | فیلتر برای اعمال در لیست نتایج. |
page_size | تعداد نتایج برای بازگشت. |
page_token | یک صفحه صفحه ، که از یک تماس قبلی به |
listIndexesResponse
پاسخ برای FirestoreAdmin.ListIndexes
.
زمینه های | |
---|---|
indexes[] | شاخص های درخواست شده. |
next_page_token | نشانه ای که ممکن است برای درخواست صفحه دیگری از نتایج استفاده شود. اگر خالی باشد ، این آخرین صفحه است. |
مکان metadata
این نوع فیلدهایی ندارد.
پیام ابرداده برای google.cloud.location.Location.metadata
.
عملیات
وضعیت عملیات را توصیف می کند.
Enums | |
---|---|
OPERATION_STATE_UNSPECIFIED | نامشخص |
INITIALIZING | درخواست برای پردازش آماده می شود. |
PROCESSING | درخواست به طور فعال پردازش می شود. |
CANCELLING | درخواست در حال لغو شدن پس از کاربر به نام Google.Longrunning.Operations.CanceLoperation در این عملیات است. |
FINALIZING | درخواست پردازش شده و در مرحله نهایی خود قرار دارد. |
SUCCESSFUL | درخواست با موفقیت به پایان رسیده است. |
FAILED | درخواست پردازش به پایان رسیده است ، اما با خطایی روبرو شده است. |
CANCELLED | درخواست پس از آنکه کاربر به نام google.longrunning.operations.canceloperation لغو شد ، لغو شد. |
پیش رفتن
پیشرفت عملیات را توصیف می کند. واحد کار عمومی است و باید بر اساس جایی که Progress
استفاده می شود ، تفسیر شود.
زمینه های | |
---|---|
estimated_work | میزان کار تخمین زده می شود. |
completed_work | میزان کار به پایان رسید. |
restoredatabasemetadata
ابرداده برای long-running operation
از درخواست [RestoredAtabase] [Google.firestore.admin.v1.RestoredAtabase].
زمینه های | |
---|---|
start_time | زمان شروع بازیابی. |
end_time | زمان بازیابی ، برای بازگرداندن مداوم ، غیرقانونی است. |
operation_state | حالت عملیات بازیابی. |
database | نام پایگاه داده در حال بازگرداندن است. |
backup | نام بازیابی پشتیبان از. |
progress_percentage | تا چه حد در طول بازیابی به عنوان درصد تخمینی از زمان باقی مانده است. |
restoredatabaserequest
پیام درخواست برای [firestoreadmin.restedatabase] [google.firestore.admin.v1.restoredatabase].
زمینه های | |
---|---|
parent | ضروری. پروژه برای بازگرداندن پایگاه داده در قالب |
database_id | ضروری. شناسه مورد استفاده برای پایگاه داده ، که به مؤلفه نهایی نام منبع پایگاه داده تبدیل می شود. این شناسه پایگاه داده نباید با یک پایگاه داده موجود همراه باشد. این مقدار باید 4-63 کاراکتر باشد. شخصیت های معتبر / [AZ] [0-9]- / با شخصیت اول نامه و آخرین نامه یا یک شماره هستند. نباید مانند uuid /[0-9a-f] {8} (-[0-9a-f] {4}) {3}-[0-9a-f] {12} /. "(پیش فرض)" شناسه پایگاه داده نیز معتبر است. |
| |
backup | پشتیبان گیری برای بازیابی از. باید از همان پروژه والدین باشد. قالب است: |
UpdatebackUpschedulerequest
درخواست FirestoreAdmin.UpdateBackupSchedule
.
زمینه های | |
---|---|
backup_schedule | ضروری. برنامه پشتیبان گیری برای به روزرسانی. |
update_mask | لیست زمینه هایی که باید به روز شوند. |
به روز شده atatabasemetadata
این نوع فیلدهایی ندارد.
ابرداده مربوط به عملکرد پایگاه داده به روزرسانی.
به روز شده
درخواست FirestoreAdmin.UpdateDatabase
.
زمینه های | |
---|---|
database | ضروری. پایگاه داده برای به روزرسانی. |
update_mask | لیست زمینه هایی که باید به روز شوند. |
UpdatefieldRequest
درخواست FirestoreAdmin.UpdateField
.
زمینه های | |
---|---|
field | ضروری. زمینه ای که باید به روز شود. |
update_mask | ماسک ، نسبت به میدان. در صورت مشخص شدن ، فقط پیکربندی مشخص شده توسط این field_mask در قسمت به روز می شود. |
گردش هفتگی
یک برنامه مکرر را نشان می دهد که در یک روز مشخص هفته اجرا می شود.
منطقه زمانی UTC است.
زمینه های | |
---|---|
day | روز هفته اجرا. day_of_week_unspecified مجاز نیست. |