Time Series 컬렉션

개요

이 가이드에서는 Rust 드라이버를 사용하여 time-series collection 을 만들고 상호 작용하는 방법을 배울 수 있습니다. time series 컬렉션은 일정 기간 동안 측정값의 연대순 시퀀스를 효율적으로 저장합니다. time series 컬렉션의 각 문서에는 다음과 같은 정보가 포함되어 있습니다.

시간 경과에 따른 측정량
측정값을 설명하는 메타데이터
측정 타임스탬프

다음 표에서는 데이터를 time series 컬렉션에 저장할 수 있는 몇 가지 샘플 상황을 설명합니다. 각 행은 각 문서의 상황, 측정 수량 및 메타데이터를 설명합니다.

상황	측정 수량	Metadata
산업별 월별 매출 기록	USD 기준 수익	회사, 국가
날씨 변화 추적	강수량 수준	위치, 센서 유형
기록적인 주택 가격 변동	월 임대료	위치, 통화

이 가이드에는 다음 섹션이 포함되어 있습니다.

Time Series 컬렉션 만들기에서는 Time Series 컬렉션 을 만드는 구문을 설명하고 예제 코드를 제공합니다.
Time Series 컬렉션 쿼리에서는 Time Series 컬렉션 에서 작업을 수행하는 방법을 설명합니다.
추가 정보에서 이 가이드에 언급된 유형 및 메소드에 대한 리소스 및 API 문서 링크를 찾을 수 있습니다.

Time Series 컬렉션 만들기

중요

Time Series 컬렉션의 서버 버전

time-series 컬렉션을 생성하고 상호 작용하려면 MongoDB 5.0 이상을 실행하는 배포서버에 연결해야 합니다.

time series 컬렉션을 만들려면 다음 작업을 수행하세요.

time series 컬렉션의 속성을 지정하는 TimeseriesOptions 인스턴스를 만듭니다.
CreateCollectionOptions 인스턴스를 만들고 timeseries 필드 값을 TimeseriesOptions 인스턴스로 설정합니다.
CreateCollectionOptions 인스턴스를 create_collection() 메서드에 전달합니다. 또한 컬렉션 이름을 매개 변수로 전달해야 합니다.

예시

이 예에서는 다음 구성을 사용하여 precipitation 데이터베이스에 sept2023 time series 컬렉션을 생성합니다.

time_field 로 설정됩니다. "precipitation_mm"
meta_field 로 설정됩니다. "location"
granularity 분으로 설정

let db = client.database("precipitation");
let ts_opts = TimeseriesOptions::builder()
    .time_field("precipitation_mm".to_string())
    .meta_field(Some("location".to_string()))
    .granularity(Some(TimeseriesGranularity::Minutes))
    .build();
let coll_opts = CreateCollectionOptions::builder()
    .timeseries(ts_opts)
    .build();
db.create_collection("sept2023", coll_opts).await?;

time series 컬렉션이 성공적으로 생성되었는지 확인하려면 데이터베이스에서 list_collections() 메서드를 실행하고 결과를 출력합니다.

let mut coll_list = db.list_collections(None, None).await?;
while let Some(c) = coll_list.try_next().await? {
    println!("{:#?}", c);
}

CollectionSpecification {
    name: "sept2023",
    collection_type: Timeseries,
    options: CreateCollectionOptions {
        ...
        timeseries: Some(
            TimeseriesOptions {
                time_field: "precipitation_mm",
                meta_field: Some(
                    "location",
                ),
                granularity: Some(
                    Minutes,
                ),
            },
        ),
        ...
    },
    ...
}

시계열 컬렉션 쿼리

다른 컬렉션에서 읽기 또는 애그리게이션 작업을 수행할 때 사용하는 것과 동일한 구문과 규칙을 사용하여 Time Series 컬렉션을 쿼리할 수 있습니다. 이러한 작업에 대한 자세한 내용은 추가 정보 섹션을 참조하세요.

추가 정보

이 가이드에 언급된 개념에 대해 자세히 알아보려면 다음 서버 매뉴얼 항목을 참조하세요.

컬렉션 생성에 학습 보려면 데이터베이스 및 컬렉션에 대한 가이드 를 참조하세요.

읽기 작업 수행에 대해 자세히 학습하려면 읽기 작업 섹션의 가이드를 참조하세요.

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.

돌아가기

트랜잭션

추적 & 로깅