Users.dataSources.datasets

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

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

بازنمایی منابع

{
  "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 )، و یک نقطه داده در هر یک از نقاط پایانی مجموعه داده قرار دارد، فقط قسمت همپوشانی نقطه داده حذف خواهد شد.

گرفتن

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

پچ

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

این روش از معناشناسی وصله استفاده نمی کند: نقاط داده ارائه شده صرفاً درج می شوند و هیچ داده موجود جایگزین نمی شود.