یک مجموعه داده نشان دهنده یک محفظه طرح ریزی برای نقاط داده است. آنها هیچ اطلاعاتی از خودشان ندارند. مجموعه داده ها مجموعه ای از نقاط داده را از یک منبع داده خاص نشان می دهد. یک نقطه داده را می توان در بیش از یک مجموعه داده یافت.
برای لیست روش های این منبع، انتهای این صفحه را ببینید.
بازنمایی منابع
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
نام ملک | ارزش | توضیحات | یادداشت ها |
---|---|---|---|
dataSourceId | string | شناسه جریان داده منبع داده که نقاط این مجموعه داده را ایجاد کرده است. | |
maxEndTimeNs | long | بزرگترین زمان پایان تمام نقاط داده در این نمایش احتمالاً جزئی از مجموعه داده. زمان بر حسب نانوثانیه از دوران است. این همچنین باید با قسمت دوم شناسه مجموعه داده مطابقت داشته باشد. | |
minStartTimeNs | long | کوچکترین زمان شروع تمام نقاط داده در این نمایش احتمالاً جزئی از مجموعه داده. زمان بر حسب نانوثانیه از دوران است. این همچنین باید با قسمت اول شناسه مجموعه داده مطابقت داشته باشد. | |
nextPageToken | string | این نشانه زمانی تنظیم می شود که یک مجموعه داده در پاسخ به یک درخواست GET دریافت شود و مجموعه داده بیش از حد بزرگ باشد که در یک پاسخ واحد گنجانده شود. این مقدار را در یک درخواست GET بعدی برای بازگرداندن صفحه بعدی نقاط داده در این مجموعه داده ارائه کنید. | |
point[] | list | فهرستی جزئی از نقاط داده موجود در مجموعه داده، به ترتیب توسط endTimeNanos. این لیست هنگام بازیابی یک مجموعه داده کوچک کامل و در هنگام اصلاح یک مجموعه داده یا بازیابی مجموعه داده ای که برای گنجاندن در یک پاسخ بسیار بزرگ است جزئی در نظر گرفته می شود. | |
point[]. computationTimeMillis | long | از این فیلد استفاده نکنید. نادیده گرفته می شود و ذخیره نمی شود. | |
point[]. dataTypeName | string | نوع داده ای که فرمت مقادیر را در این نقطه داده تعیین می کند. | |
point[]. endTimeNanos | long | زمان پایان بازه نشان داده شده توسط این نقطه داده، در نانوثانیه از دوران. | |
point[]. modifiedTimeMillis | long | آخرین باری را که این نقطه داده اصلاح شده را نشان می دهد. فقط در زمینه هایی که تغییرات داده ها را فهرست می کنیم، به جای نمایش وضعیت فعلی داده ها مفید است. | |
point[]. originDataSourceId | string | اگر نقطه داده در یک مجموعه داده برای منبع داده مشتق شده وجود داشته باشد، این فیلد با شناسه جریان منبع داده که نقطه داده را در ابتدا ایجاد کرده است پر می شود. اخطار: برای هیچ چیز به جز اشکال زدایی به این فیلد اعتماد نکنید. ارزش این فیلد، اگر اصلاً تنظیم شود، جزییات اجرایی است و تضمینی برای ثابت ماندن آن وجود ندارد. | |
point[]. rawTimestampNanos | long | مهر زمانی خام از SensorEvent اصلی. | |
point[]. startTimeNanos | long | زمان شروع بازه نشان داده شده توسط این نقطه داده، در نانوثانیه از دوران. | |
point[]. value[] | list | مقادیر هر فیلد نوع داده برای نقطه داده. انتظار می رود که هر مقدار مربوط به یک فیلد نوع داده به همان ترتیبی رخ دهد که فیلد در نوع داده مشخص شده در منبع داده فهرست شده است. فقط یکی از فیلدهای عدد صحیح و ممیز شناور، بسته به مقدار فرمت enum در فیلد نوع منبع داده، پر می شود. | |
point[].value[]. fpVal | double | مقدار ممیز شناور وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند. | |
point[].value[]. intVal | integer | مقدار صحیح وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند. | |
point[].value[]. mapVal[] | list | ارزش نقشه فضای کلید و واحدهای معتبر برای مقدار متناظر هر ورودی باید به عنوان بخشی از تعریف نوع داده مستند شود. کلیدها باید تا حد امکان کوچک نگه داشته شوند. جریانهای داده با کلیدهای بزرگ و فرکانس داده بالا ممکن است نمونه برداری شوند. | |
point[].value[].mapVal[]. key | string | ||
point[].value[].mapVal[]. value | nested object | ||
point[].value[].mapVal[].value. fpVal | double | مقدار ممیز شناور | |
point[].value[]. stringVal | string | مقدار رشته وقتی این تنظیم شد، مقادیر دیگر نباید تنظیم شوند. رشته ها باید تا حد امکان کوچک نگه داشته شوند. جریانهای داده با مقادیر رشته ای بزرگ و فرکانس داده بالا ممکن است نمونه برداری شوند. |
روش ها
- حذف کنید
- تمام نقاط دادهای را که زمان شروع و پایان آنها با محدوده زمانی مشخصشده توسط شناسه مجموعه دادهها همپوشانی دارند، بهطور جامع حذف میکند. برای اکثر انواع داده، کل نقطه داده حذف خواهد شد. برای انواع داده که بازه زمانی یک مقدار ثابت را نشان میدهد (مانند
com.google.activity.segment
)، و یک نقطه داده در هر یک از نقاط پایانی مجموعه داده قرار دارد، فقط قسمت همپوشانی نقطه داده حذف خواهد شد. - دریافت کنید
- مجموعه داده ای حاوی تمام نقاط داده را برمی گرداند که زمان شروع و پایان آنها با محدوده مشخص شده حداقل زمان شروع و حداکثر زمان پایان مجموعه داده همپوشانی دارند. به طور خاص، هر نقطه داده ای که زمان شروع آن کمتر یا مساوی با زمان پایان مجموعه داده باشد و زمان پایان آن بزرگتر یا مساوی با زمان شروع مجموعه داده باشد.
- پچ
- نقاط داده را به یک مجموعه داده اضافه می کند. لازم نیست مجموعه داده قبلا ایجاد شده باشد. تمام نقاط در مجموعه داده داده شده با فراخوانی های بعدی برای بازیابی این مجموعه داده بازگردانده می شود. نقاط داده می توانند به بیش از یک مجموعه داده تعلق داشته باشند.
این روش از معنیشناسی وصله استفاده نمیکند: نقاط داده ارائه شده صرفاً درج میشوند، بدون اینکه دادههای موجود جایگزین شوند.