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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DataBuilder - 범위, 전역

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

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

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}  

    // 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 객체에 일련의 데이터 요소를 추가합니다. 각 데이터 요소는 타임스탬프이자 값입니다.
시작 매개변수와 보존 정책 수집 기간을 사용하여 배열의 각 값에 대한 타임스탬프를 계산합니다. 첫 번째 값에는 타임스탬프로 start 매개 변수가 있습니다. 이 메서드는 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}  


    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 시작, 숫자 값) {#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}  

    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);