Một tập dữ liệu đại diện cho một vùng chứa phép chiếu cho các điểm dữ liệu. Chúng không mang theo bất kỳ thông tin nào của chính mình. Tập dữ liệu đại diện cho một tập hợp các điểm dữ liệu từ một nguồn dữ liệu cụ thể. Bạn có thể tìm thấy một điểm dữ liệu trong nhiều tập dữ liệu.
Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.
Biểu diễn tài nguyên
{
"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
}| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
dataSourceId |
string |
Mã luồng dữ liệu của nguồn dữ liệu đã tạo điểm trong tập dữ liệu này. | |
maxEndTimeNs |
long |
Thời gian kết thúc lớn nhất của tất cả điểm dữ liệu trong bản trình bày một phần của tập dữ liệu này. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Mã này cũng phải khớp với phần thứ hai của giá trị nhận dạng tập dữ liệu. | |
minStartTimeNs |
long |
Thời gian bắt đầu nhỏ nhất của tất cả các điểm dữ liệu trong cách biểu diễn một phần tập dữ liệu này có thể là. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Mã này cũng phải khớp với phần đầu tiên của giá trị nhận dạng tập dữ liệu. | |
nextPageToken |
string |
Mã thông báo này sẽ được đặt khi nhận được tập dữ liệu theo yêu cầu GET và tập dữ liệu quá lớn nên không thể đưa vào một phản hồi. Cung cấp giá trị này trong yêu cầu GET tiếp theo để trả về trang tiếp theo của các điểm dữ liệu trong tập dữ liệu này. | |
point[] |
list |
Danh sách một phần các điểm dữ liệu có trong tập dữ liệu, được sắp xếp theo endTimeNanos. Danh sách này được coi là hoàn chỉnh khi truy xuất một tập dữ liệu nhỏ và truy xuất một phần tập dữ liệu trong trường hợp vá một tập dữ liệu hoặc truy xuất một tập dữ liệu quá lớn để đưa vào một phản hồi. | |
point[].computationTimeMillis |
long |
ĐỪNG SỬ DỤNG TRƯỜNG NÀY. Thông tin này sẽ bị bỏ qua và không được lưu trữ. | |
point[].dataTypeName |
string |
Loại dữ liệu xác định định dạng của các giá trị trong điểm dữ liệu này. | |
point[].endTimeNanos |
long |
Thời gian kết thúc của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. | |
point[].modifiedTimeMillis |
long |
Cho biết lần gần nhất điểm dữ liệu này được sửa đổi. Chỉ hữu ích trong những ngữ cảnh mà chúng ta liệt kê các thay đổi về dữ liệu thay vì biểu thị trạng thái hiện tại của dữ liệu. | |
point[].originDataSourceId |
string |
Nếu điểm dữ liệu nằm trong tập dữ liệu cho một nguồn dữ liệu phái sinh, thì trường này sẽ được điền sẵn mã luồng của nguồn dữ liệu đã tạo điểm dữ liệu ban đầu. CẢNH BÁO: đừng dựa vào trường này để tìm bất cứ thông tin nào khác ngoài tính năng gỡ lỗi. Giá trị của trường này, nếu có, là chi tiết triển khai và không được đảm bảo để duy trì nhất quán. |
|
point[].rawTimestampNanos |
long |
Dấu thời gian thô từ SensorEvent ban đầu. | |
point[].startTimeNanos |
long |
Thời gian bắt đầu của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. | |
point[].value[] |
list |
Giá trị của mỗi trường loại dữ liệu cho điểm dữ liệu. Theo dự kiến, mỗi giá trị tương ứng với một trường loại dữ liệu sẽ xuất hiện theo cùng thứ tự mà trường được liệt kê trong loại dữ liệu được chỉ định trong nguồn dữ liệu. Chỉ một trong các trường số nguyên và dấu phẩy động sẽ được điền sẵn, tuỳ thuộc vào giá trị enum của định dạng trong trường loại của nguồn dữ liệu. |
|
point[].value[].fpVal |
double |
Giá trị dấu phẩy động. Khi đặt giá trị này, bạn không được đặt các giá trị khác. | |
point[].value[].intVal |
integer |
Giá trị số nguyên. Khi đặt giá trị này, bạn không được đặt các giá trị khác. | |
point[].value[].mapVal[] |
list |
Giá trị bản đồ. Không gian khoá và đơn vị khoá hợp lệ cho giá trị tương ứng của mỗi mục nhập phải được ghi lại trong quá trình định nghĩa kiểu dữ liệu. Bạn nên giữ các khoá nhỏ bất cứ khi nào có thể. Việc lấy mẫu những luồng dữ liệu có kích thước lớn và tần suất dữ liệu cao có thể được giảm xuống. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
Giá trị dấu phẩy động. | |
point[].value[].stringVal |
string |
Giá trị chuỗi. Khi đặt giá trị này, bạn không được đặt các giá trị khác. Bạn nên giữ kích thước chuỗi nhỏ bất cứ khi nào có thể. Những luồng dữ liệu có giá trị chuỗi lớn và tần suất dữ liệu cao có thể bị giảm tần suất lấy mẫu. |
Phương thức
- xóa
- Xoá toàn bộ tất cả các điểm dữ liệu có thời gian bắt đầu và kết thúc
có trùng lặp với phạm vi thời gian mà mã tập dữ liệu chỉ định hay không. Đối với hầu hết
thì toàn bộ điểm dữ liệu sẽ bị xoá. Đối với loại dữ liệu mà
khoảng thời gian biểu thị một giá trị nhất quán (chẳng hạn như
com.google.activity.segment) và các điểm dữ liệu điểm cuối của tập dữ liệu, chỉ phần chồng chéo của dữ liệu điểm sẽ bị xoá. - nhận
- Trả về một tập dữ liệu chứa tất cả các điểm dữ liệu có thời gian bắt đầu và thời gian kết thúc trùng với phạm vi đã chỉ định của thời gian bắt đầu tập dữ liệu tối thiểu và thời gian kết thúc tối đa. Cụ thể, bất kỳ điểm dữ liệu nào có thời gian bắt đầu ít hơn lớn hơn hoặc bằng thời gian kết thúc của tập dữ liệu và thời gian kết thúc của tập dữ liệu đó lớn hơn hoặc bằng thời gian bắt đầu tập dữ liệu.
- bản vá
- Thêm các điểm dữ liệu vào một tập dữ liệu. Tập dữ liệu không cần được tạo trước đó.
Tất cả điểm trong tập dữ liệu nhất định sẽ được trả về cùng với các lệnh gọi tương ứng
để truy xuất tập dữ liệu này. Các điểm dữ liệu có thể thuộc về nhiều tập dữ liệu.
Phương thức này không sử dụng ngữ nghĩa của bản vá: các điểm dữ liệu được cung cấp là chỉ được chèn mà không có dữ liệu hiện có nào bị thay thế.