데이터 세트는 데이터 포인트의 프로젝션 컨테이너를 나타냅니다. 자체적인 정보는 가지고 있지 않습니다. 데이터 세트는 특정 데이터 소스의 데이터 포인트 집합을 나타냅니다. 데이터 포인트는 두 개 이상의 데이터 세트에서 찾을 수 있습니다.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
{ "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 }
속성 이름 | 값 | 설명 | Notes |
---|---|---|---|
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 |
데이터 포인트에 대한 각 데이터 유형 필드 값입니다. 데이터 유형 필드에 해당하는 각 값은 데이터 소스에 지정된 데이터 유형에 필드가 나열되는 순서와 동일한 순서로 발생합니다. 데이터 소스의 유형 필드 내에 있는 형식 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 |
문자열 값입니다. 이 속성을 설정할 때는 다른 값을 설정하면 안 됩니다. 문자열은 가능하면 작게 유지해야 합니다. 문자열 값이 크고 데이터 빈도가 높은 데이터 스트림이 다운 샘플링될 수 있습니다. |
방법
- 삭제
- 시작 및 종료 시간이 데이터 세트 ID로 지정된 시간 범위와 겹치는 모든 데이터 포인트를 포괄 삭제를 수행합니다. 대부분의 데이터 유형에서 전체 데이터 포인트가 삭제됩니다. 기간이 일관된 값을 나타내고 (예:
com.google.activity.segment
) 데이터 포인트가 데이터 세트의 끝점에 걸쳐 있는 데이터 유형의 경우 데이터 포인트에서 겹치는 부분만 삭제됩니다. - get
- 시작 시간과 종료 시간이 데이터 세트의 최소 시작 시간 및 최대 종료 시간의 지정된 범위와 겹치는 모든 데이터 포인트를 포함하는 데이터 세트를 반환합니다. 특히 시작 시간이 데이터 세트 종료 시간보다 작거나 같고 종료 시간이 데이터 세트 시작 시간보다 크거나 같은 데이터 포인트입니다.
- patch
- 데이터 세트에 데이터 포인트를 추가합니다. 데이터 세트는 이전에 만들 필요가 없습니다.
지정된 데이터 세트 내의 모든 포인트는 이 데이터 세트를 검색하기 위한 후속 호출로 반환됩니다. 데이터 포인트는 둘 이상의 데이터 세트에 속할 수 있습니다.
이 메서드는 패치 시맨틱스를 사용하지 않습니다. 제공된 데이터 포인트는 기존 데이터가 대체되지 않고 단순히 삽입됩니다.