---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DataBuilder - 범위, 전역

# DataBuilder - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

DataBuilder API는 메트릭에 대한 일련의 데이터 요소를 생성하는 메서드를 제공합니다. sn_clotho를 사용합니다 . Client.put() 메서드를 사용하여 값을 저장합니다.

범위가 지정된 전역 서버 스크립트에서 이 클래스를 호출할 수 있습니다. DataBuilder 클래스를 사용하는 경우 `sn_clotho` 네임스페이스 식별자를 사용합니다.

이 클래스는 애플리케이션의 일부입니다 MetricBase .

## DataBuilder - DataBuilder(객체 glideRecord, 문자열 제목, 문자열 메트릭) {#ariaid-title2}

DataBuilder 클래스의 인스턴스를 만듭니다.
{#SDB-DataBuilder_S_S_S__table_yjn_kgf_31b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| glideRecord | 객체 | 도메인을 가져올 GlideRecord입니다. |
| 주제 | 문자열 | 이 계열과 연결된 GlideRecord의 sys_id입니다. |
| 메트릭 | 문자열 | 메트릭의 필드 이름입니다. |
[표 1. 매개변수]

{#SDB-DataBuilder_S_S_S__table_yjn_kgf_31b}  
다음 예제에서는 현재 시간 또는 특정 시간 범위를 나타내는 `now_GR` 매개 변수와 추적 중인 메트릭의 이름인 문자열 매개 변수 `'cpu_percentage'`를 사용하여 `sn_clotho` 네임스페이스에서 `DataBuilder`의 새 인스턴스를 초기화합니다.

    // Where cpu_percentage is the name of the metric
            var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');

## DataBuilder - add(GlideDateTime 시작, 배열 값) {#ariaid-title3}

DataBuilder 객체에 일련의 데이터 요소를 추가합니다. 각 데이터 요소는 타임 스탬프와 값입니다.
시작 매개변수와 보존 정책 수집 기간을 사용하여 배열의 각 값에 대한 타임 스탬프를 계산합니다. 첫 번째 값에는 시작 매개변수가 타임 스탬프로 있습니다. 이 메서드는 MetricBase 데이터베이스에 데이터를 저장하지 않습니다. sn_clotho를 사용합니다 . Client.put() 메서드를 사용하여 값을 저장합니다.
{#SDB-add_GDT_A__table_xy1_c1m_31b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시작 | GlideDateTime | 첫 번째 데이터 요소에 대한 타임 스탬프입니다. 이후 타임 스탬프는 보존 정책 수집 기간을 사용하여 계산됩니다. |
| 값 | 배열 | 숫자의 배열입니다. |
[표 2. 매개변수]

{#SDB-add_GDT_A__table_xy1_c1m_31b} {#SDB-add_GDT_A__table_yy1_c1m_31b__entry__2}

| 유형 | 설명 |
|-|-|
| 데이터 작성기 | 동일한 DataBuilder 객체입니다. |
[표 3. 반환]

{#SDB-add_GDT_A__table_yy1_c1m_31b}  
다음 예제에서는 먼저 지정된 타임스탬프에서 CPU 사용량과 관련된 서로 다른 데이터 요소를 나타내는 7, 0.5 및 273의 세 가지 숫자 값을 포함하는 배열(points)을 초기화합니다. 그런 다음 코드는 새 sn_clotho 초기화합니다`. now_GR 사용하는 DataBuilder` 객체(GlideRecord 객체)는 이 데이터가 저장되는 대상 데이터베이스 기록을 나타냅니다.`'cpu_percentage'`는 CPU 사용량을 추적하는 데 사용되는 메트릭 이름입니다.

객체를 현재 날짜 및 시간으로 설정하는 GlideDateTime을 사용하여 새 시간 변수가 생성됩니다. 마지막으로 이 코드는 `dataBuilder.add(time, points)` 를 사용하여 Data Builder 개체에 여러 데이터 요소를 저장합니다.


    var points = [7,0.5,273];
    var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
    // this creates a GlideDateTime object set to the current date and time
    var time = new GlideDateTime();
    dataBuilder.add(time, points);

## DataBuilder - add(GlideDateTime start, Number value) {#ariaid-title4}

DataBuilder 객체에 데이터 요소를 추가합니다. 각 데이터 요소는 타임 스탬프와 값입니다. 이 방법은 메트릭에 데이터 요소를 저장하지 않습니다. sn_clotho를 사용합니다 . Client.put() 메서드를 사용하여 값을 저장합니다.
{#SDB-add_GDT_N__table_r1w_2vl_31b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시작 | GlideDateTime | 데이터 요소에 대한 타임 스탬프입니다. |
| 값 | 번호 | 데이터 요소의 값입니다. |
[표 4. 매개변수]

{#SDB-add_GDT_N__table_r1w_2vl_31b} {#SDB-add_GDT_N__table_s1w_2vl_31b__entry__2}

| 유형 | 설명 |
|-|-|
| 데이터 작성기 | DataBuilder 객체입니다. |
[표 5. 반환]

{#SDB-add_GDT_N__table_s1w_2vl_31b}  
다음 예에서는 먼저 `now_GR`(대상 기록) 및 `'cpu_percentage'`(추적할 메트릭) 매개변수를 사용하여 `sn_clotho` 네임스페이스에서 `DataBuilder`의 새 인스턴스를 초기화합니다. `GlideDateTime` 은 시간을 현재 날짜 및 시간으로 초기화합니다. 마지막으로 `dataBuilder.add()` 는 현재 타임스탬프에 값 `0.6` (CPU 사용량 60% 값을 나타냄)을 저장합니다.

    var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
    // this creates a GlideDateTime object set to the current date and time
    var time = new GlideDateTime();
    dataBuilder.add(time, 0.6);