---
title: "FieldDto"
slug: "common-apidatatype-cifielddto"
tags: ["Classic"]
updated: 2026-07-23T09:04:18Z
published: 2026-07-23T09:04:18Z
canonical: "api.ncloud-docs.com/common-apidatatype-cifielddto"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FieldDto

Classic/VPC 환경에서 이용 가능합니다.

Schema 생성/수정 시 필요합니다.

## 구문

구문은 다음과 같습니다.

```
private String name;
private DataType dataType;
private Boolean metric = false;
private String metricType;
private Boolean dimension = false;
private Boolean counter = false;
private Boolean isIdDimension = false;
private Map<Interval, Set<Calculation>> aggregations;
private String desc;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `name` | String | Required | Product Schema 이름 |
| `dataType` | DataType | Required | Metric 혹은 Dimension의 데이터 타입 명시 - 해당 필드가 Metric일 경우: `STRING` \| `INTEGER` \| `FLOAT` \| `LONG` - 해당 필드가 Dimension일 경우: `STRING` |
| `metric` | Boolean | Optional | 해당 필드가 Metric임을 명시 - `true` \| `false`(기본값) |
| `metricType` | String | - | Metric 유형 - `BASIC` \| `EXTENDED` \| `CUSTOM` - `BASIC`: 기본 제공하는 성능/운영 지표 - `EXTENDED`: 상세 모니터링을 위한 추가 성능/운영 지표 - `CUSTOM`: 사용자 정의 성능/운영 지표 |
| `dimension` | Boolean | Optional | 해당 필드가 Dimension임을 명시 - `true` \| `false`(기본값) |
| `counter` | Boolean | Optional | - `true` \| `false`(기본값) |
| `isIdDimension` | Boolean | Optional | 해당 필드가 Dimension일 때만 설정 가능하며 사용자가 정의한 상품에 대해 Event Rule 생성 시 해당 Dimension을 기준으로 구분됨 - `default` (기본값) - 반드시 하나의 Dimension은 idDimension으로 설정되어야 함 |
| `aggregations` | Map<Interval, Set<Calculation>> | Optional | 해당 필드가 Metric일 때만 설정 가능하며, 집계 주기와 집계 함수를 설정 - Interval: `Min1` \| `Min5` \| `Min30` \| `Hour2` \| `Day1` - Calculation: `COUNT` \| `SUM` \| `MAX` \| `MIN` \| `AVG` |
| `desc` | String | Optional | Product Schema 설명 |

## 예시

예시는 다음과 같습니다.

          참고

          

aggregations가 설정되어 있지 않으면 default로 아래와 같이 모든 집계 주기에 대해 모든 집계 함수를 수행하도록 설정됩니다.

```
"aggregations": {
    "Min1": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Min5": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Min30": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Hour2": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ],
    "Day1": [
      "AVG",
      "SUM",
      "MIN",
      "MAX",
      "COUNT"
    ]
}
```