시계열 데이터

개요

이 가이드 에서는 Ruby 운전자 사용하여 Time Series 데이터 저장 하고 상호 작용 방법을 학습 수 있습니다.

시계열 데이터는 다음 구성 요소로 구성됩니다.

• 측정 수량

• 측정 타임스탬프

• 측정값을 설명하는 메타데이터

다음 표에서는 Time Series 데이터 를 저장 수 있는 샘플 상황을 설명합니다.

Time Series 컬렉션 만들기

time series 컬렉션 만들려면 컬렉션 의 사양이 포함된 옵션 해시를 전달해야 합니다. time series 컬렉션 에 대해 다음 사양을 지정할 수 있습니다.

• :timeField: 각 time series 문서 에 타임스탬프를 저장하는 필드 를 지정합니다.

• :metaField: 각 time series 문서 에 메타데이터 를 저장하는 필드 를 지정합니다.

• :granularity: 연속된 타임스탬프 사이의 대략적인 시간을 지정합니다. 가능한 값은 'seconds', 'minutes' 및 'hours' 입니다.

• :bucketMaxSpanSeconds: 동일한 버킷에 있는 타임스탬프 사이의 최대 시간을 설정합니다.

• :bucketRoundingSeconds: MongoDB 가 새 버킷에 대한 최소 타임스탬프를 설정할 때 반내림할 시간(초)을 설정합니다. :bucketMaxSpanSeconds 과 같아야 합니다.

이러한 매개변수에 대해 자세히 학습 명령에 대한 MongoDB Server 매뉴얼 항목의 명령 필드를 참조하세요.create

client = Mongo::Client.new('<connection string>', database: 'weather')
collection_name = 'october2024'
time_series_options = { timeField: 'timestamp' }
database = client.database
database.command(
  create: collection_name,
  timeseries: time_series_options
)

collections = database.list_collections(filter: { name: 'october2024' }).to_a
puts collections

[
  {
    "name": "october2024",
    "type": "timeseries",
    "options": {
      "timeseries": {
        "timeField": "timestamp",
        "granularity": "seconds",
        "bucketMaxSpanSeconds": 3600
   }
   },
    "info": {
      "readOnly": false
    }
   }
 ]

Time Series 데이터 저장

insert_one 또는 insert_many 메서드를 사용하고 삽입된 각 문서 에 측정값, 타임스탬프 및 메타데이터 지정하여 time series 컬렉션 에 데이터를 삽입할 수 있습니다.

문서 삽입에 대해 자세히 학습 문서 삽입 가이드 참조하세요.

client = Mongo::Client.new('<connection string>', database => 'your_db')
collection = client[:october2024]
document_list = [
  { temperature: 77, location: "New York City", timestamp: DateTime.new(2024, 10, 22, 6, 0, 0) },
  { temperature: 74, location: "New York City", timestamp: DateTime.new(2024, 10, 23, 6, 0, 0) }
]
collection.insert_many(document_list)

Time Series 데이터 쿼리

다른 컬렉션에서 읽기 또는 집계 작업을 수행할 때 사용하는 것과 동일한 구문 및 규칙을 사용하여 time series 컬렉션 에 저장된 데이터를 쿼리 수 있습니다. 이러한 작업에 대해 자세히 학습 다음 가이드를 참조하세요.

• MongoDB에서 데이터 읽기

• 애그리게이션을 통한 데이터 변환

추가 정보

이 가이드 의 개념에 학습 보려면 다음 MongoDB Server 매뉴얼 항목을 참조하세요.

• 시계열

• 시계열 컬렉션 만들기 및 쿼리Create and Query a Time Series Collection

• 시계열 데이터의 세분성 설정