Package google.firestore.v1

map<string, Value >

نتیجه توابع تجمع، به عنوان مثال: COUNT(*) AS total_docs .

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

Value

مقادیر موجود در آرایه

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} .

string

نام مدارکی که باید بازیابی شود. در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} . اگر هر یک از اسناد منبع فرزند database داده شده نباشد، درخواست ناموفق خواهد بود. نام های تکراری حذف خواهند شد.

DocumentMask

زمینه هایی برای بازگشت. اگر تنظیم نشود، همه فیلدها را برمی گرداند.

اگر سندی دارای فیلدی باشد که در این ماسک وجود ندارد، آن فیلد در پاسخ بازگردانده نخواهد شد.

bytes

اسناد را در یک معامله می خواند.

TransactionOptions

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

Timestamp

اسناد را همانطور که در زمان معین بودند می خواند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

bytes

معامله ای که به عنوان بخشی از این درخواست آغاز شد. فقط در اولین پاسخ تنظیم می شود و فقط در صورتی که BatchGetDocumentsRequest.new_transaction در درخواست تنظیم شده باشد.

Timestamp

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

Document

سندی که درخواست شد.

string

نام سندی که درخواست شده است اما وجود ندارد. در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} .

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} .

Write

می نویسد برای اعمال.

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

map<string, string>

برچسب های مرتبط با این دسته می نویسند.

WriteResult

نتیجه اعمال نوشته ها.

این نتیجه نوشتن i-ام با نوشتن i-ام در درخواست مطابقت دارد.

Status

وضعیت اعمال نوشته ها.

این وضعیت نوشتن i-ام با نوشتن i-ام در درخواست مطابقت دارد.

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} .

TransactionOptions

گزینه های معامله پیش‌فرض تراکنش خواندن و نوشتن.

bytes

معامله ای که شروع شد.

bytes

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

int32

تعداد بیت های آخرین بایت در bitmap که به عنوان "padding" نادیده گرفته می شود. اگر طول bitmap صفر باشد، این مقدار باید 0 باشد. در غیر این صورت، این مقدار باید بین 0 تا 7 باشد.

BitSequence

داده های فیلتر شکوفه

int32

تعداد هش های استفاده شده توسط الگوریتم.

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} .

Write

می نویسد برای اعمال.

همیشه به صورت اتمی و به ترتیب اجرا می شود.

bytes

در صورت تنظیم، تمام نوشته های این تراکنش را اعمال می کند و آن را انجام می دهد.

WriteResult

نتیجه اعمال نوشته ها.

این نتیجه نوشتن i-ام با نوشتن i-ام در درخواست مطابقت دارد.

Timestamp

زمانی که ارتکاب در آن اتفاق افتاد. هر خواندنی با read_time مساوی یا بیشتر تضمین می شود که اثرات commit را مشاهده کند.

string

ضروری. منبع والد برای مثال: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}

string

ضروری. شناسه مجموعه، نسبت به parent ، به فهرست. به عنوان مثال: chatrooms .

string

شناسه سند اختصاص داده شده توسط مشتری برای استفاده برای این سند.

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

Document

ضروری. سند برای ایجاد name نباید تنظیم شود

DocumentMask

زمینه هایی برای بازگشت. اگر تنظیم نشود، همه فیلدها را برمی گرداند.

اگر سند دارای فیلدی باشد که در این ماسک وجود ندارد، آن فیلد در پاسخ بازگردانده نمی شود.

Value

مقادیری که یک موقعیت را نشان می‌دهند، به ترتیبی که به ترتیب بند یک پرس و جو ظاهر می‌شوند.

می‌تواند حاوی مقادیر کمتری از مقدار مشخص‌شده در ترتیب با بند باشد.

bool

اگر موقعیت درست قبل یا بعد از مقادیر داده شده باشد، نسبت به ترتیب مرتب سازی تعریف شده توسط پرس و جو.

string

ضروری. نام منبع سندی که باید حذف شود. در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} .

Precondition

یک پیش شرط اختیاری در سند. اگر این درخواست تنظیم شده باشد و توسط سند مورد نظر برآورده نشود، این درخواست با شکست مواجه خواهد شد.

string

نام منبع سند، برای مثال projects/{project_id}/databases/{database_id}/documents/{document_path} .

map<string, Value >

Timestamp

فقط خروجی زمانی که سند ایجاد شد.

این مقدار زمانی که یک سند حذف می شود و دوباره ایجاد می شود به طور یکنواخت افزایش می یابد. همچنین می توان آن را با مقادیر سایر اسناد و read_time یک پرس و جو مقایسه کرد.

Timestamp

فقط خروجی زمانی که سند آخرین بار تغییر کرده است.

این مقدار در ابتدا روی create_time تنظیم می شود و سپس با هر تغییر در سند به طور یکنواخت افزایش می یابد. همچنین می توان آن را با مقادیر سایر اسناد و read_time یک پرس و جو مقایسه کرد.

Document

وضعیت جدید Document .

اگر mask تنظیم شده باشد، فقط شامل فیلدهایی است که به‌روزرسانی یا اضافه شده‌اند.

int32

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

int32

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

string

نام منبع Document که حذف شد.

int32

مجموعه ای از شناسه های هدف برای اهدافی که قبلاً با این نهاد مطابقت داشتند.

Timestamp

مهر زمانی خوانده شده که در آن حذف مشاهده شد.

بزرگتر یا برابر با commit_time حذف.

string

لیست مسیرهای فیلد در ماسک. برای مرجع نحو مسیر فیلد به Document.fields مراجعه کنید.

string

نام منبع Document که از دید خارج شده است.

int32

مجموعه ای از شناسه های هدف برای اهدافی که قبلاً با این سند مطابقت داشتند.

Timestamp

مهر زمانی خواندن که در آن حذف مشاهده شد.

بزرگتر یا برابر با commit_time تغییر/حذف/حذف.

string

نام سند برای تبدیل.

FieldTransform

فهرست تغییراتی که باید به ترتیب در فیلدهای سند اعمال شود. این نباید خالی باشد.

string

مسیر میدان. برای مرجع نحو مسیر فیلد به Document.fields مراجعه کنید.

ServerValue

فیلد را روی مقدار سرور داده شده تنظیم می کند.

Value

مقدار داده شده را به مقدار فعلی فیلد اضافه می کند.

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

Value

فیلد را به حداکثر مقدار فعلی و مقدار داده شده تنظیم می کند.

این باید یک عدد صحیح یا یک مقدار دوگانه باشد. اگر فیلد یک عدد صحیح یا دوگانه نباشد، یا اگر فیلد هنوز وجود نداشته باشد، تبدیل فیلد را روی مقدار داده شده تنظیم می کند. اگر یک عملیات حداکثر در جایی اعمال شود که فیلد و مقدار ورودی از انواع مختلط هستند (یعنی - یکی عدد صحیح و یکی دوتایی است) فیلد نوع عملوند بزرگتر را می گیرد. اگر عملوندها معادل باشند (مثلاً 3 و 3.0)، فیلد تغییر نمی کند. 0، 0.0 و -0.0 همگی صفر هستند. حداکثر مقدار ذخیره شده صفر و مقدار ورودی صفر همیشه مقدار ذخیره شده است. حداکثر هر مقدار عددی x و NaN NaN است.

Value

فیلد را روی حداقل مقدار فعلی و مقدار داده شده تنظیم می کند.

این باید یک عدد صحیح یا یک مقدار دوگانه باشد. اگر فیلد یک عدد صحیح یا دوگانه نباشد، یا اگر فیلد هنوز وجود نداشته باشد، تبدیل فیلد را روی مقدار ورودی تنظیم می‌کند. اگر یک عملیات حداقل در جایی اعمال شود که فیلد و مقدار ورودی از انواع مختلط هستند (یعنی - یک عدد صحیح و یکی دو برابر است) فیلد نوع عملوند کوچکتر را می گیرد. اگر عملوندها معادل باشند (مثلاً 3 و 3.0)، فیلد تغییر نمی کند. 0، 0.0 و -0.0 همگی صفر هستند. حداقل مقدار ذخیره شده صفر و مقدار ورودی صفر همیشه مقدار ذخیره شده است. حداقل هر مقدار عددی x و NaN NaN است.

ArrayValue

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

اعداد معادل از انواع مختلف (به عنوان مثال 3L و 3.0) هنگام بررسی عدم وجود یک مقدار برابر در نظر گرفته می شوند. NaN برابر با NaN و Null برابر با Null است. اگر ورودی حاوی چندین مقدار معادل باشد، تنها مقدار اول در نظر گرفته می شود.

transform_result مربوطه مقدار تهی خواهد بود.

ArrayValue

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

اعداد معادل انواع مختلف (مانند 3L و 3.0) هنگام تصمیم گیری در مورد حذف یک عنصر برابر در نظر گرفته می شوند. NaN برابر با NaN و Null برابر با Null است. اگر موارد تکراری وجود داشته باشد، تمام مقادیر معادل حذف می شود.

transform_result مربوطه مقدار تهی خواهد بود.

int64

تعداد کل نتایج بازگردانده شده، از جمله اسناد، پیش بینی ها، نتایج تجمیع، کلیدها.

Duration

کل زمان برای اجرای پرس و جو در باطن.

int64

کل عملیات خواندن قابل پرداخت

Struct

اشکال زدایی آمار از اجرای پرس و جو. توجه داشته باشید که با تکامل Firestore، آمار اشکال زدایی در معرض تغییر است. ممکن است شامل موارد زیر باشد: { "index_entries_scanned": "1000"، "documents_scanned": "20"، "billing_details" : { "documents_billable": "20", "index_entries_billable": "1000", "min_query_cost": "0" } }

int32

شناسه هدفی که این فیلتر برای آن اعمال می شود.

int32

تعداد کل اسنادی که با target_id مطابقت دارند.

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

کلاینت می‌تواند از فیلتر شکوفایی unchanged_names برای کمک به این تعیین با آزمایش همه نام‌های سند در برابر فیلتر استفاده کند. اگر نام سند در فیلتر نباشد، به این معنی است که سند دیگر با هدف مطابقت ندارد.

BloomFilter

فیلتر شکوفه‌ای که علی‌رغم نامش حاوی رمزگذاری‌های UTF-8 بایتی نام منابع همه اسنادی است که با target_id مطابقت دارند، به شکل projects/{project_id}/databases/{database_id}/documents/{document_path} .

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

PlanSummary

اطلاعات مرحله برنامه ریزی برای پرس و جو

ExecutionStats

آمار جمع آوری شده از اجرای پرس و جو. فقط زمانی ارائه می شود که ExplainOptions.analyze روی true تنظیم شده باشد.

bool

اختیاری. آیا این کوئری را اجرا کنیم.

در صورت false (پیش‌فرض)، پرس‌وجو برنامه‌ریزی می‌شود و تنها معیارهای مربوط به مراحل برنامه‌ریزی را برمی‌گرداند.

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

string

ضروری. نام منبع سند برای دریافت. در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} .

DocumentMask

زمینه هایی برای بازگشت. اگر تنظیم نشود، همه فیلدها را برمی گرداند.

اگر سند دارای فیلدی باشد که در این ماسک وجود ندارد، آن فیلد در پاسخ بازگردانده نمی شود.

bytes

سند را در یک معامله می خواند.

Timestamp

نسخه سند را در زمان معین می خواند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

string

ضروری. سند مادر. در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} . به عنوان مثال: projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

int32

حداکثر تعداد نتایج برای بازگشت.

string

یک نشانه صفحه. باید مقداری از ListCollectionIdsResponse باشد.

Timestamp

اسناد را همانطور که در زمان معین بودند می خواند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

string

شناسه های مجموعه

string

نشانه صفحه ای که ممکن است برای ادامه لیست استفاده شود.

string

ضروری. نام منبع والد در قالب: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/{document_path} .

به عنوان مثال: projects/my-project/databases/my-database/documents یا projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

string

اختیاری. شناسه مجموعه، نسبت به parent ، به فهرست.

به عنوان مثال: chatrooms یا messages .

این اختیاری است و هنگامی که ارائه نشده باشد، Firestore اسناد همه مجموعه‌ها را تحت parent ارائه شده فهرست می‌کند.

int32

اختیاری. حداکثر تعداد اسناد برای بازگشت در یک پاسخ.

Firestore ممکن است کمتر از این مقدار را بازگرداند.

string

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

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

string

اختیاری. سفارش اختیاری اسناد برای بازگشت.

به عنوان مثال: priority desc, __name__ desc .

این منعکس کننده ORDER BY مورد استفاده در جستارهای Firestore اما در نمایش رشته ای است. در صورت غیبت، اسناد بر اساس __name__ ASC مرتب می شوند.

DocumentMask

اختیاری. زمینه هایی برای بازگشت. اگر تنظیم نشود، همه فیلدها را برمی گرداند.

اگر سندی دارای فیلدی باشد که در این ماسک وجود ندارد، آن فیلد در پاسخ بازگردانده نخواهد شد.

bool

اگر لیست باید اسناد گم شده را نشان دهد.

اگر سندی وجود نداشته باشد، وجود ندارد، اما اسناد فرعی در زیر آن وجود دارد. در صورت درست بودن، چنین اسناد گمشده با یک کلید بازگردانده می‌شوند، اما فیلدها، create_time ، یا update_time set ندارند.

درخواست‌های دارای show_missing ممکن است where یا order_by را مشخص نکنند.

bytes

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

Timestamp

خواندن را در زمان مقرر انجام دهید.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

Document

اسناد یافت شده

string

نشانه ای برای بازیابی صفحه بعدی اسناد.

اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} .

map<string, string>

برچسب های مرتبط با این هدف تغییر می کنند.

Target

هدفی برای افزودن به این جریان.

int32

شناسه هدفی که باید از این جریان حذف شود.

TargetChange

اهداف تغییر کرده است.

DocumentChange

یک Document تغییر کرده است

DocumentDelete

یک Document حذف شده است.

DocumentRemove

یک Document از یک هدف حذف شده است (زیرا دیگر مربوط به آن هدف نیست).

ExistenceFilter

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

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

map<string, Value >

فیلدهای نقشه

کلیدهای نقشه نشان دهنده نام فیلدها هستند. نام فیلدهای مطابق با عبارت منظم __.*__ رزرو شده است. نام فیلدهای رزرو شده به جز در زمینه های مستند خاص ممنوع است. کلیدهای نقشه که به صورت UTF-8 نشان داده می شوند، نباید بیش از 1500 بایت باشند و نمی توانند خالی باشند.

string

ضروری. نام منبع والد در قالب: projects/{project_id}/databases/{database_id}/documents . نام منابع سند پشتیبانی نمی شود. فقط نام منابع پایگاه داده را می توان مشخص کرد.

int64

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

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

string

مقدار next_page_token از فراخوانی قبلی به PartitionQuery برگردانده شد که ممکن است برای دریافت مجموعه‌ای از نتایج استفاده شود. هیچ تضمینی برای سفارش بین مجموعه نتایج وجود ندارد. بنابراین، استفاده از چندین مجموعه از نتایج مستلزم ادغام مجموعه های مختلف نتایج است.

به عنوان مثال، دو تماس بعدی با استفاده از page_token ممکن است برگردد:

• مکان نما B، مکان نما M، مکان نما Q
• مکان نما A، مکان نما U، مکان نما W

برای به دست آوردن یک مجموعه کامل از نتایج مرتب شده با توجه به نتایج جستجوی ارائه شده به PartitionQuery، مجموعه نتایج باید ادغام شوند: مکان نما A، مکان نما B، مکان نما M، مکان نما Q، مکان نما U، مکان نما W.

int32

حداکثر تعداد پارتیشن‌هایی که باید در این تماس بازگردانده شوند، مشروط به partition_count .

برای مثال، اگر partition_count = 10 و page_size = 8، اولین فراخوانی به PartitionQuery تا 8 پارتیشن و در صورت وجود نتایج بیشتر، یک next_page_token برمی‌گرداند. یک فراخوان دوم به PartitionQuery حداکثر 2 پارتیشن را برمی گرداند تا مجموع 10 پارتیشن مشخص شده در partition_count را تکمیل کند.

StructuredQuery

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

Timestamp

اسناد را همانطور که در زمان معین بودند می خواند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

Cursor

نتایج پارتیشن هر پارتیشن یک نقطه تقسیم است که می تواند توسط RunQuery به عنوان نقطه شروع یا پایان برای نتایج پرس و جو استفاده شود. درخواست های RunQuery باید با همان پرس و جوی ارائه شده به این درخواست PartitionQuery انجام شود. نشانگرهای پارتیشن مطابق با همان ترتیبی که نتایج پرس و جو ارائه شده به PartitionQuery ترتیب داده می شود.

به عنوان مثال، اگر یک درخواست PartitionQuery نشانگرهای پارتیشن A و B را برمی گرداند، اجرای سه پرس و جو زیر کل مجموعه نتایج پرس و جو اصلی را برمی گرداند:

• query، end_at A
• پرس و جو، start_at A، end_at B
• پرس و جو، start_at B

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

string

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

Struct

شاخص های انتخاب شده برای پرس و جو. برای مثال: [ {"query_scope": "Collection", "properties": "(foo ASC, name ASC)"}, {"query_scope": "Collection"، "properties": "(bar ASC, name ASC)" } ]

bool

وقتی روی true تنظیم شود، سند هدف باید وجود داشته باشد. وقتی روی false تنظیم می شود، سند هدف نباید وجود داشته باشد.

Timestamp

هنگام تنظیم، سند هدف باید وجود داشته باشد و آخرین بار در آن زمان به روز شده باشد. مُهر زمان باید تراز میکروثانیه باشد.

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} .

bytes

ضروری. معامله به عقب برگرداند.

string

ضروری. نام منبع والد در قالب: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/{document_path} . به عنوان مثال: projects/my-project/databases/my-database/documents یا projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

ExplainOptions

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

StructuredAggregationQuery

یک پرس و جو تجمع

bytes

تجمیع را در یک تراکنش فعال از قبل اجرا کنید.

مقدار در اینجا شناسه تراکنش مات برای اجرای پرس و جو در آن است.

TransactionOptions

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

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

Timestamp

پرس و جو را در مهر زمانی داده شده اجرا می کند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

AggregationResult

یک نتیجه تجمع واحد.

هنگام گزارش پیشرفت جزئی وجود ندارد.

bytes

معامله ای که به عنوان بخشی از این درخواست آغاز شد.

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

Timestamp

زمانی که نتیجه کل محاسبه شد. این همیشه به طور یکنواخت در حال افزایش است. در این صورت، نتایج قبلی AggregationResult در جریان نتیجه تضمین می‌شود که بین read_time و این یکی تغییر نکرده باشند.

اگر پرس و جو هیچ نتیجه ای برگرداند، پاسخی با read_time و بدون result ارسال می شود و این نشان دهنده زمانی است که پرس و جو اجرا شده است.

ExplainMetrics

پرس و جو برای توضیح معیارها این تنها زمانی وجود دارد که RunAggregationQueryRequest.explain_options ارائه شده باشد، و تنها یک بار با آخرین پاسخ در جریان ارسال می شود.

string

ضروری. نام منبع والد در قالب: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/{document_path} . به عنوان مثال: projects/my-project/databases/my-database/documents یا projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

ExplainOptions

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

StructuredQuery

یک پرس و جو ساختار یافته

bytes

پرس و جو را در یک تراکنش فعال از قبل اجرا کنید.

مقدار در اینجا شناسه تراکنش مات برای اجرای پرس و جو در آن است.

TransactionOptions

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

Timestamp

اسناد را همانطور که در زمان معین بودند می خواند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

bytes

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

Document

نتیجه پرس و جو، هنگام گزارش پیشرفت جزئی تنظیم نشده است.

Timestamp

زمانی که سند خوانده شد. این ممکن است به طور یکنواخت در حال افزایش باشد. در این صورت، اسناد قبلی در جریان نتیجه تضمین می‌شود که بین read_time و این یکی تغییر نکرده باشند.

اگر پرس و جو هیچ نتیجه ای نداشته باشد، پاسخی با read_time و بدون document ارسال می شود و این نشان دهنده زمانی است که پرس و جو اجرا شده است.

int32

تعداد نتایجی که به دلیل جابجایی بین آخرین پاسخ و پاسخ فعلی نادیده گرفته شده اند.

ExplainMetrics

پرس و جو برای توضیح معیارها این تنها زمانی وجود دارد که RunQueryRequest.explain_options ارائه شده باشد و تنها یک بار با آخرین پاسخ در جریان ارسال می شود.

bool

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

Aggregation

اختیاری. مجموعه‌ای از تجمیع‌ها برای اعمال بر روی نتایج structured_query .

نیاز دارد:

• حداقل یک و حداکثر پنج تجمیع در هر پرس و جو.

StructuredQuery

پرس و جوی ساختاریافته تو در تو.

string

اختیاری. نام اختیاری فیلد برای ذخیره نتیجه تجمیع در.

اگر ارائه نشده باشد، Firestore یک نام پیش‌فرض را به دنبال field_<incremental_id++> . مثلا:

AGGREGATE
  COUNT_UP_TO(1) AS count_up_to_1,
  COUNT_UP_TO(2),
  COUNT_UP_TO(3) AS count_up_to_3,
  COUNT(*)
OVER (
  ...
);

تبدیل می شود:

AGGREGATE
  COUNT_UP_TO(1) AS count_up_to_1,
  COUNT_UP_TO(2) AS field_1,
  COUNT_UP_TO(3) AS count_up_to_3,
  COUNT(*) AS field_2
OVER (
  ...
);

نیاز دارد:

• باید در همه نام های مستعار انباشته منحصر به فرد باشد.
• مطابق با محدودیت های document field name .

Count

جمع کننده شمارش.

Sum

جمع کننده جمع.

Avg

جمع کننده متوسط.

FieldReference

میدانی برای تجمیع

Int64Value

اختیاری. محدودیت اختیاری در حداکثر تعداد اسناد برای شمارش.

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

Unspecified به عنوان بدون محدودیت تفسیر می شود.

مثال سطح بالا:

AGGREGATE COUNT_UP_TO(1000) OVER ( SELECT * FROM k );

نیاز دارد:

• در صورت وجود باید بزرگتر از صفر باشد.

FieldReference

میدانی برای تجمیع

Projection

زیر مجموعه اختیاری از فیلدها برای بازگشت.

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

CollectionSelector

مجموعه هایی برای پرس و جو

Filter

فیلتری که باید اعمال شود.

Order

ترتیب اعمال به نتایج پرس و جو.

Firestore به تماس‌گیرندگان اجازه می‌دهد تا سفارش کامل، سفارش جزئی یا اصلاً سفارشی را نداشته باشند. در همه موارد، Firestor یک سفارش پایدار را از طریق قوانین زیر تضمین می کند:

• order_by برای ارجاع به تمام فیلدهای استفاده شده با فیلتر نابرابری لازم است.
• تمام فیلدهایی که باید به order_by باشند اما قبلاً وجود ندارند به ترتیب واژگانی نام فیلد اضافه می شوند.
• اگر سفارشی در __name__ مشخص نشده باشد، به طور پیش‌فرض اضافه می‌شود.

فیلدها با همان جهت مرتب‌سازی آخرین مرتبه مشخص شده، یا اگر ترتیبی مشخص نشده باشد، "صعودی" اضافه می‌شوند. مثلا:

• ORDER BY a تبدیل به ORDER BY a ASC, __name__ ASC می شود
• ORDER BY a DESC به ORDER BY a DESC, __name__ DESC
• WHERE a > 1 تبدیل می شود WHERE a > 1 ORDER BY a ASC, __name__ ASC
• WHERE __name__ > ... AND a > 1 می شود WHERE __name__ > ... AND a > 1 ORDER BY a ASC, __name__ ASC

Cursor

پیشوند بالقوه یک موقعیت در نتیجه مجموعه برای شروع پرس و جو در.

ترتیب مجموعه نتایج بر اساس بند ORDER BY درخواست اصلی است.

SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, __name__ ASC;

نتایج این پرس و جو بر اساس (b ASC, __name__ ASC) مرتب شده اند.

مکان‌نماها می‌توانند به ترتیب کامل یا پیشوند مکان اشاره کنند، اگرچه نمی‌توانند به فیلدهای بیشتری از آنچه در ORDER BY ارائه شده ارجاع دهند.

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

• START BEFORE (2, /k/123) : پرس و جو را درست قبل از a = 1 AND b > 2 AND __name__ > /k/123 شروع کنید.
• START AFTER (10) : پرس و جو را درست بعد از a = 1 AND b > 10 شروع کنید.

برخلاف OFFSET که برای رد شدن به اسکن بر روی اولین N نتیجه نیاز دارد، مکان نما شروع به درخواست اجازه می دهد تا از یک موقعیت منطقی شروع شود. این موقعیت برای مطابقت با یک نتیجه واقعی لازم نیست، از این موقعیت به جلو اسکن می شود تا سند بعدی را پیدا کند.

نیاز دارد:

• تعداد مقادیر نمی تواند بیشتر از تعداد فیلدهای مشخص شده در عبارت ORDER BY باشد.

Cursor

پیشوند بالقوه یک موقعیت در نتیجه مجموعه ای برای پایان دادن به پرس و جو در.

این شبیه به START_AT است اما به جای موقعیت شروع، موقعیت پایان را کنترل می کند.

نیاز دارد:

• تعداد مقادیر نمی تواند بیشتر از تعداد فیلدهای مشخص شده در عبارت ORDER BY باشد.

int32

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

این پس از محدودیت های مشخص شده توسط WHERE ، START AT و END AT اما قبل از بند LIMIT اعمال می شود.

نیاز دارد:

• در صورت مشخص شدن مقدار باید بزرگتر یا مساوی صفر باشد.

Int32Value

حداکثر تعداد نتایج برای بازگشت.

بعد از تمام محدودیت های دیگر اعمال می شود.

نیاز دارد:

• در صورت مشخص شدن مقدار باید بزرگتر یا مساوی صفر باشد.

FindNearest

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

بعد از تمام فیلترهای دیگر و سفارش اعمال می شود.

نزدیکترین جاسازی های برداری را به بردار پرس و جو داده شده پیدا می کند.

string

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

bool

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

Operator

عملگر برای ترکیب چند فیلتر.

Filter

لیست فیلترهایی که باید ترکیب شوند.

نیاز دارد:

• حداقل یک فیلتر وجود دارد.

FieldReference

فیلدی برای فیلتر کردن.

Operator

اپراتور برای فیلتر کردن.

Value

ارزشی که باید با آن مقایسه کرد.

string

ارجاع به یک فیلد در یک سند.

نیاز دارد:

• باید رشته‌ای از بخش‌ها با نقطه مشخص ( . ) باشد که در آن هر بخش با محدودیت‌های document field name مطابقت دارد.

CompositeFilter

یک فیلتر کامپوزیت

FieldFilter

فیلتر در فیلد سند

UnaryFilter

فیلتری که دقیقاً یک آرگومان می گیرد.

FieldReference

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

Value

ضروری. بردار پرس و جو که ما در آن جستجو می کنیم. باید بردار با ابعاد بیش از 2048 باشد.

DistanceMeasure

ضروری. اندازه گیری فاصله برای استفاده، مورد نیاز است.

Int32Value

ضروری. تعداد نزدیکترین همسایگان برای بازگشت. باید یک عدد صحیح مثبت بیش از 1000 نباشد.

FieldReference

زمینه برای سفارش.

Direction

جهت سفارش توسط. پیش‌فرض ASCENDING است.

FieldReference

زمینه هایی برای بازگشت.

اگر خالی باشد، همه فیلدها برگردانده می شوند. فقط برای برگرداندن نام سند، از ['__name__'] استفاده کنید.

Operator

اپراتور unary برای درخواست.

FieldReference

فیلدی که اپراتور برای آن اعمال می شود.

int32

شناسه هدف که هدف را در جریان مشخص می کند. باید عددی مثبت و غیر صفر باشد.

اگر target_id 0 باشد (یا نامشخص)، سرور یک شناسه برای این هدف اختصاص می‌دهد و آن را در رویداد TargetChange::ADD برمی‌گرداند. هنگامی که یک هدف با target_id=0 اضافه شد، همه اهداف بعدی نیز باید target_id=0 داشته باشند. اگر یک درخواست AddTarget با target_id != 0 پس از افزودن یک هدف با target_id=0 به سرور ارسال شود، سرور بلافاصله یک پاسخ با یک رویداد TargetChange::Remove ارسال می کند.

توجه داشته باشید که اگر مشتری چندین درخواست AddTarget را بدون شناسه ارسال کند، ترتیب شناسه‌های بازگشتی در TargetChage.target_ids تعریف نشده است. بنابراین، مشتریان باید به جای تکیه بر سرور برای اختصاص یک شناسه هدف، یک شناسه هدف ارائه دهند.

اگر target_id غیر صفر باشد، نباید هدف فعال موجود در این جریان با همان شناسه وجود داشته باشد.

bool

اگر هدف باید یک بار حذف شود که فعلی و سازگار باشد.

Int32Value

تعداد اسنادی که آخرین بار در زمان نشانه رزومه یا زمان خواندن با درخواست مطابقت داشتند.

این مقدار فقط زمانی مرتبط است که resume_type ارائه شده باشد. وجود این مقدار و بزرگتر از صفر نشان می دهد که مشتری می خواهد ExistenceFilter.unchanged_names در پاسخ گنجانده شود.

QueryTarget

هدفی که توسط یک پرس و جو مشخص شده است.

DocumentsTarget

هدفی که توسط مجموعه ای از نام های سند مشخص شده است.

bytes

یک توکن رزومه از یک TargetChange قبلی برای یک هدف یکسان.

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

Timestamp

بعد از یک read_time مشخص شروع به گوش دادن کنید.

مشتری باید در این زمان از وضعیت تطبیق اسناد مطلع باشد.

string

نام مدارکی که باید بازیابی شود. در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} . اگر هر یک از اسناد منبع فرزند database داده شده نباشد، درخواست ناموفق خواهد بود. نام های تکراری حذف خواهند شد.

string

نام منبع والد در قالب: projects/{project_id}/databases/{database_id}/documents or projects/{project_id}/databases/{database_id}/documents/{document_path} . به عنوان مثال: projects/my-project/databases/my-database/documents یا projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

StructuredQuery

یک پرس و جو ساختار یافته

TargetChangeType

نوع تغییری که رخ داده است.

int32

شناسه های هدف اهدافی که تغییر کرده اند.

اگر خالی باشد، این تغییر برای همه اهداف اعمال می شود.

ترتیب شناسه های هدف تعریف نشده است.

Status

خطایی که منجر به این تغییر شد، در صورت وجود.

bytes

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

در هر تغییر هدف تنظیم نشده است.

Timestamp

read_time ثابت برای target_ids داده شده (در صورتی که target_idها در یک عکس فوری ثابت نباشند حذف می شود).

هر زمان که کل جریان به یک عکس فوری ثابت جدید رسید، جریان تضمین می‌شود که یک read_time با target_ids خالی ارسال کند. پیام‌های ADD، CURRENT و RESET تضمین می‌شوند که (در نهایت) منجر به یک عکس فوری جدید می‌شوند (در حالی که پیام‌های NO_CHANGE و REMOVE چنین نیستند).

برای یک جریان معین، read_time به طور یکنواخت تضمین شده است.

ReadOnly

تراکنش فقط برای عملیات خواندن قابل استفاده است.

ReadWrite

این تراکنش می تواند هم برای عملیات خواندن و هم برای نوشتن استفاده شود.

Timestamp

اسناد را در زمان معین می خواند.

این باید یک مهر زمانی دقیق میکروثانیه در یک ساعت گذشته باشد، یا اگر بازیابی نقطه در زمان فعال باشد، می‌تواند یک مهر زمانی کامل در 7 روز گذشته باشد.

bytes

یک تراکنش اختیاری برای امتحان مجدد.

Document

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

DocumentMask

فیلدهایی که باید به روز شوند. هیچ یک از مسیرهای فیلد در ماسک ممکن است حاوی نام رزرو شده نباشد.

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

DocumentMask

زمینه هایی برای بازگشت. اگر تنظیم نشود، همه فیلدها را برمی گرداند.

اگر سند دارای فیلدی باشد که در این ماسک وجود ندارد، آن فیلد در پاسخ بازگردانده نمی شود.

Precondition

یک پیش شرط اختیاری در سند. اگر این درخواست تنظیم شده باشد و توسط سند مورد نظر برآورده نشود، این درخواست با شکست مواجه خواهد شد.

NullValue

یک مقدار صفر

bool

یک مقدار بولی

int64

یک مقدار صحیح

double

یک مقدار دو برابر

Timestamp

یک مقدار مهر زمانی

دقیق فقط به میکروثانیه. هنگامی که ذخیره می شود، هرگونه دقت اضافی به سمت پایین گرد می شود.

string

یک مقدار رشته

رشته ای که به صورت UTF-8 نشان داده می شود، نباید از 1 مگابایت تا 89 بایت تجاوز کند. فقط 1500 بایت اول نمایش UTF-8 توسط پرس و جوها در نظر گرفته می شود.

bytes

مقدار یک بایت

نباید بیش از 1 مگابایت - 89 بایت باشد. فقط 1500 بایت اول توسط پرس و جو در نظر گرفته می شود.

string

ارجاع به یک سند برای مثال: projects/{project_id}/databases/{database_id}/documents/{document_path} .

LatLng

یک مقدار نقطه جغرافیایی که نشان دهنده یک نقطه در سطح زمین است.

ArrayValue

یک مقدار آرایه

نمی تواند مستقیماً حاوی مقدار آرایه دیگری باشد، اگرچه می تواند حاوی نقشه ای باشد که حاوی آرایه دیگری است.

MapValue

یک مقدار نقشه

DocumentMask

فیلدهایی برای به روز رسانی در این نوشته می شود.

این فیلد را فقط زمانی می توان تنظیم کرد که عملیات update شود. اگر ماسک برای update تنظیم نشده باشد و سند وجود داشته باشد، همه داده‌های موجود بازنویسی می‌شوند. اگر ماسک تنظیم شده باشد و سند روی سرور دارای فیلدهایی باشد که توسط ماسک پوشانده نشده است، آنها بدون تغییر باقی می مانند. فیلدهایی که در ماسک ارجاع داده شده اند، اما در سند ورودی وجود ندارند، از سند روی سرور حذف می شوند. مسیرهای فیلد در این ماسک نباید حاوی نام فیلد رزرو شده باشد.

FieldTransform

تبدیل ها برای انجام پس از به روز رسانی.

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

Precondition

یک پیش شرط اختیاری در سند.

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

Document

سندی برای نوشتن

string

نام سند برای حذف در قالب: projects/{project_id}/databases/{database_id}/documents/{document_path} .

DocumentTransform

یک تبدیل را در یک سند اعمال می کند.

string

ضروری. نام پایگاه داده در قالب: projects/{project_id}/databases/{database_id} . این فقط در پیام اول مورد نیاز است.

string

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

Write

می نویسد برای اعمال.

همیشه به صورت اتمی و به ترتیب اجرا می شود. در اولین درخواست باید خالی باشد. ممکن است در آخرین درخواست خالی باشد. این نباید در تمام درخواست‌های دیگر خالی باشد.

bytes

توکن جریانی که قبلاً توسط سرور ارسال شده بود.

مشتری باید این فیلد را روی توکنی از آخرین WriteResponse که دریافت کرده است تنظیم کند. این تأیید می کند که مشتری تا این توکن پاسخ هایی دریافت کرده است. پس از ارسال این توکن، دیگر از توکن های قبلی استفاده نمی شود.

سرور ممکن است جریان را ببندد اگر پاسخ‌های تأیید نشده زیاد باشد.

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

هنگام ایجاد یک جریان جدید، این قسمت را تنظیم نشده بگذارید.

map<string, string>

برچسب‌های مرتبط با این درخواست نوشتن.

string

شناسه جریان. فقط روی اولین پیام تنظیم شود، زمانی که یک جریان جدید ایجاد شد.

bytes

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

این فیلد همیشه تنظیم شده است.

WriteResult

نتیجه اعمال نوشته ها.

این نتیجه نوشتن i-ام با نوشتن i-ام در درخواست مطابقت دارد.

Timestamp

زمانی که ارتکاب در آن اتفاق افتاد. هر خواندنی با read_time برابر یا بیشتر تضمین می شود که اثرات نوشتن را مشاهده کند.

Timestamp

آخرین زمان به روز رسانی سند پس از اعمال نوشتن. پس از delete تنظیم نشده است.

اگر رایت در واقع سند را تغییر نداد، این همان update_time قبلی خواهد بود.

Value

نتایج اعمال هر DocumentTransform.FieldTransform به همان ترتیب.