데이터 세트는 데이터 포인트의 투영 컨테이너를 나타냅니다. 본인 정보는 갖고 있지 않습니다. 데이터 세트는 특정 데이터 소스의 데이터 포인트 집합을 나타냅니다. 데이터 포인트는 두 개 이상의 데이터 세트에서 찾을 수 있습니다.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
{
"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 |
이 데이터 세트의 지점을 만든 데이터 소스의 데이터 스트림 ID입니다. | |
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 |
데이터 포인트가 파생된 데이터 소스의 데이터 세트에 포함된 경우 이 필드는 원래 데이터 포인트를 만든 데이터 소스 스트림 ID로 채워집니다. 경고: 디버깅 이외의 용도로 이 필드를 사용하지 마세요. 이 필드의 값은 설정된 경우 구현 세부정보이며 일관성을 유지하지 않을 수 있습니다. |
|
point[].rawTimestampNanos |
long |
원래 SensorEvent의 원시 타임스탬프입니다. | |
point[].startTimeNanos |
long |
이 데이터 포인트로 표시되는 간격의 시작 시간(에포크 이후 나노초)입니다. | |
point[].value[] |
list |
데이터 포인트의 각 데이터 유형 필드 값입니다. 데이터 유형 필드에 해당하는 각 값은 필드가 데이터 소스에 지정된 데이터 유형에 나열되는 순서와 동일한 순서로 발생해야 합니다. 데이터 소스 유형 필드의 형식 열거형 값에 따라 정수 및 부동 소수점 필드 중 하나만 채워집니다. |
|
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 |
문자열 값입니다. 이 값을 설정하면 다른 값을 설정하면 안 됩니다. 가능한 한 문자열을 작게 유지해야 합니다. 문자열 값이 크고 데이터 빈도가 높은 데이터 스트림은 다운 샘플링될 수 있습니다. |
메소드
- delete
- 시작 및 종료 시간이 데이터 세트 ID로 지정한 기간과 겹치는 모든 데이터 포인트를 포괄적으로 삭제합니다. 대부분의 데이터 유형에서 전체 데이터 포인트가 삭제됩니다. 기간이 일관된 값 (예:
com.google.activity.segment)을 나타내고 데이터 포인트가 데이터 세트의 어느 한쪽 끝에 걸쳐 있는 데이터 유형의 경우 데이터 포인트의 겹치는 부분만 삭제됩니다. - get
- 시작 시간 및 종료 시간이 데이터 세트의 최소 시작 시간과 최대 종료 시간 범위와 겹친 모든 데이터 포인트가 포함된 데이터 세트를 반환합니다. 특히 시작 시간이 데이터 세트 종료 시간보다 작거나 같고 종료 시간이 데이터 세트 시작 시간보다 크거나 같은 데이터 포인트입니다.
- 패치
- 데이터 포인트를 데이터 세트에 추가합니다. 이전에 데이터 세트를 만들 필요가 없습니다.
이 데이터 세트를 검색하기 위해 지정된 데이터 세트 내의 모든 포인트가 후속 호출로 반환됩니다. 데이터 포인트는 2개 이상의 데이터 세트에 속할 수 있습니다.
이 메서드는 패치 시맨틱스를 사용하지 않습니다. 제공된 데이터 포인트만 삽입되며 기존 데이터는 대체되지 않습니다.