# 테이블 데이터 원본 구성

## Content

## 데이터 원본 모드

**테이블** 탭에서는 테이블이 데이터를 가져오고 동기화하는 방식을 구성할 수 있습니다.
테이블은 다음 두 가지 모드 중 하나로 동작할 수 있습니다.

* **원격 모드** – HTTP 엔드포인트에서 데이터를 로드합니다.
* **로컬 모드** – 데이터가 테이블 구성에 직접 포함됩니다.

한 번에 하나의 모드만 활성화됩니다.

### 원격 모드

원격 모드는 테이블을 하나 이상의 HTTP 엔드포인트에 연결합니다.

#### 읽기 엔드포인트 구성

**읽기** 섹션에서는 테이블이 데이터를 로드하는 방식을 정의합니다.
다음 항목을 구성할 수 있습니다.

* **HTTP 메서드** (GET)
* **URL**
* **요청 헤더**
* **형식**
* **데이터 경로**
* **자동 동기화**

![image-20260421.8f9883.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.8f9883-20260602.79309e.png?width=400)

#### 요청 헤더

요청 헤더를 사용하면 서버로 전송되는 HTTP 요청을 사용자 지정할 수 있습니다.
**헤더** 섹션은 기본적으로 접혀 있습니다. 요청 헤더를 구성하려면 URL 필드 옆의 **설정** 아이콘 ![Local Data Setup-20260421.0d3880.svg](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/Local%20Data%20Setup-20260421.0d3880-20260605.d3f87d.svg)을 클릭하여 헤더 패널을 펼칩니다. 다시 아이콘을 클릭하면 패널이 접힙니다.
헤더를 구성하려면:

1. **추가 (+)** 버튼을 사용하여 새 헤더 행을 추가합니다.
2. **이름** 필드에서 헤더 이름을 선택하거나 입력합니다.
3. **값** 필드에 헤더 값을 입력합니다.
4. 삭제 아이콘 ![image-20260409.861d85.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260409.861d85-20260602.61fc8d.png?width=20)을 사용하여 헤더를 제거합니다.

`Authorization` 또는 `X-API-Key`와 같은 일반적인 헤더 이름은 드롭다운 목록에서 선택할 수 있으며, 필요한 경우 사용자 지정 헤더 이름도 입력할 수 있습니다.
![headers-20260421.a3840a.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/headers-20260421.a3840a-20260602.7a1f79.gif?width=800)

>type=note
> 이름과 값이 모두 입력된 행만 요청에 적용됩니다. 비어 있거나 불완전한 행은 무시됩니다.

#### 자동 동기화

**자동 동기화**를 활성화하면 테이블은 구성된 원격 엔드포인트와 데이터 변경 사항을 자동으로 동기화합니다.
동기화 동작에 대한 자세한 내용은 *기능*의 데이터 매니저 섹션을 참조하세요.

### 로컬 모드

로컬 모드를 사용하면 원격 엔드포인트에서 데이터를 로드하는 대신 데이터를 테이블 구성에 직접 포함할 수 있습니다.
로컬 데이터를 구성하려면:

1. URL 필드 옆의 **로컬 데이터 설정** 버튼 ![Local Data Setup-20260421.f03011.svg](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/Local%20Data%20Setup-20260421.f03011-20260602.bce344.svg)을 클릭합니다.
2. 로컬 데이터 설정 대화 상자에서:
    1. 형식(JSON, CSV, XML 또는 Column JSON)을 선택합니다.
    2. 파일을 업로드하거나 데이터를 편집기에 직접 붙여 넣습니다.
    3. 필요에 따라 **로컬 데이터 서식 지정** 버튼 ![format local data-20260421.66776e.svg](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/format%20local%20data-20260421.66776e-20260602.c13673.svg)을 사용하여 가독성을 높일 수 있습니다.
3. 확인을 클릭하여 데이터를 적용합니다.

![LocalData-20260421.a1152d.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/LocalData-20260421.a1152d-20260602.d189a6.gif?width=800)

>type=note
> 로컬 모드가 활성화되면:
>
> * 원격 엔드포인트 설정이 비활성화됩니다.
> * 행 작업 및 열 작업을 사용할 수 없습니다.
> * 테이블은 데이터를 자체 구성 내에 저장합니다.

원격 모드로 다시 전환하려면 대화 상자에서 Reset local to remote mode를 클릭합니다. 그러면 포함된 데이터가 제거되고 원격 구성이 복원됩니다.
![reset-20260421.d6e751.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/reset-20260421.d6e751-20260602.f4a5ae.gif?width=800)

## 스키마 구성 (모드 공통)

### 데이터 형식

**형식** 옵션은 응답 데이터를 해석하는 방식을 정의합니다.
다음 형식을 지원합니다.

* **JSON**
* **CSV**
* **XML**
* **Column JSON**

서버 응답 구조에 맞는 형식을 선택하세요.

**원격 모드**
![image-20260421.af7938.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.af7938-20260602.672d23.png)
**로컬 모드**
![image-20260421.3866c8.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.3866c8-20260602.bbebf0.png)

### 데이터 경로

**데이터 경로** 옵션은 파싱된 응답 내에서 기본 데이터 컬렉션이 위치한 경로를 지정합니다.

* 데이터 경로가 제공되면 데이터 매니저는 파싱 결과의 지정된 속성에서 데이터 컬렉션을 가져옵니다.
* 데이터 경로가 지정되지 않으면 전체 파싱된 응답 객체가 데이터 원본으로 사용됩니다.

서버 응답이 데이터 배열을 다른 객체 내부에 포함하는 경우 이 옵션을 사용하세요.
![datapath-20260421.1faab3.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/datapath-20260421.1faab3-20260602.8f3031.gif?width=800)

### Window

**Window** 섹션에서는 테이블에서 사용하는 Window 기반 구성을 정의할 수 있습니다.
다음 작업을 수행할 수 있습니다.

* Window 정의 추가
* 이름 지정
* 수식 정의

Window 정의는 테이블 데이터 동작의 일부로 적용됩니다.
![window-20260421.90f41f.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/window-20260421.90f41f-20260602.7b3542.gif?width=800)
Window 정의의 개념에 대한 자세한 내용은 *기능*의 데이터 매니저 문서를 참조하세요.

```auto
CustomerRecent3
=WINDOWDEF(PARTITIONBY([Product]), ORDERBY([Amount]), FRAMERANGE([@-200], [@+200]))

=WINDOWDEF(PARTITIONBY([customId]), ORDERBY([orderDate]), FRAMEROE([@-2], [@]))
```

## 원격 제출 구성 (원격 모드 전용)

테이블이 **원격 모드**로 동작하는 경우 서버에 데이터 변경 사항을 제출하기 위한 엔드포인트를 구성할 수 있습니다.
각 작업은 동일한 구조를 가진 전용 섹션에서 구성됩니다.

* **HTTP 메서드**
* **URL**
* **선택적 요청 헤더**

헤더 패널은 읽기 구성과 동일한 방식으로 동작합니다.

### 행 작업

**행 작업** 섹션에서는 행 수준 변경 사항을 서버에 전송하는 방식을 정의합니다.
다음 작업에 대해 각각 별도의 엔드포인트를 구성할 수 있습니다.

* Update
* Create
* Delete
* Batch

각 작업은 독립적으로 구성됩니다.
이 엔드포인트들은 행 데이터 변경 사항이 제출될 때 호출됩니다.
![image-20260421.0ca800.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.0ca800-20260602.31adc7.png)

### 열 작업

**열 작업** 섹션에서는 열 수준 변경 사항을 서버와 동기화하는 방식을 정의합니다.
다음 작업에 대한 엔드포인트를 구성할 수 있습니다.

* **열 가져오기**
* **열 업데이트**
* **열 생성**
* **열 삭제**

각 작업은 행 작업과 동일한 구성 패턴을 따릅니다.
이 섹션은 원격 모드에서만 사용할 수 있습니다.
![image-20260421.471957.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.471957-20260602.3fb9c5.png)