# 테이블 관리

## Content

데이터 원본 패널을 사용하면 런타임에 데이터 매니저에서 사용하는 테이블을 생성하고 관리할 수 있습니다.

## 데이터 원본 패널 열기

SpreadJS 디자이너에서:

1. 리본 메뉴의 **데이터** 탭으로 이동합니다.
2. **데이터 원본**을 클릭합니다.

![image-20260421.2b6c73.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.2b6c73-20260602.2d0df5.png?width=800)
데이터 원본 패널이 열리며, 왼쪽에는 기존 테이블 목록이 표시되고 오른쪽에는 구성 탭이 표시됩니다.
![image-20260421.b00106.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260421.b00106-20260602.6d15c0.png?width=800)

## 테이블 생성

새 테이블을 생성하려면:

1. Tables 패널에서 **테이블 추가**를 클릭합니다.
2. 새 테이블이 생성되고 자동으로 선택됩니다.
3. **테이블**, **열**, **데이터** 탭에서 설정을 구성합니다.

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

>type=note
> 테이블 생성 시 기본 원격 예제 URL이 자동으로 설정될 수 있습니다. 필요에 따라 사용자 고유의 데이터 원본으로 변경할 수 있습니다.

### 기본 초기화

테이블이 생성되면:

* 데모용 기본 원격 엔드포인트가 미리 구성됩니다.
* 테이블 이름은 `Table1`, `Table2` 등의 형식으로 할당됩니다.
* 테이블 이름은 순차적으로 증가하며, 이전 테이블이 삭제되더라도 재사용되지 않습니다.
* 중복된 이름을 입력하면 고유성을 보장하기 위해 `_1`과 같은 숫자 접미사가 자동으로 추가됩니다.

필요에 따라 기본 데이터 엔드포인트를 변경하거나 제거할 수 있습니다.

## 테이블 이름 변경

테이블 이름을 변경하려면:

1. Tables 패널에서 테이블을 선택합니다.
2. 테이블 이름을 직접 수정합니다.

테이블 이름에는 공백, 특수 문자 및 유니코드 문자를 사용할 수 있습니다.
긴 이름은 레이아웃상 패널 표시에서 잘릴 수 있습니다.
![rename-20260421.052d59.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/rename-20260421.052d59-20260602.8a7532.gif?width=800)

## 테이블 전환

정의된 모든 테이블은 왼쪽 패널에 표시됩니다.
테이블을 전환하려면:

* 목록에서 테이블 이름을 클릭합니다.
* 선택한 테이블의 설정이 표시되도록 구성 영역이 업데이트됩니다.

한 번에 하나의 테이블만 구성할 수 있습니다.

## 테이블 삭제

테이블을 삭제하려면:

1. 왼쪽 패널에서 테이블을 찾습니다.
2. 테이블 이름 옆의 **삭제**(휴지통) 아이콘 ![image-20260409.b4a085.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260409.b4a085-20260602.af95c1.png?width=20)을 클릭합니다.

테이블을 삭제하면 데이터 매니저 모델에서 영구적으로 제거됩니다.
해당 테이블에 바인딩된 모든 컴포넌트는 더 이상 데이터에 접근할 수 없습니다.
이 작업은 실행 취소할 수 없습니다.
![delete-20260421.8b373a.gif](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/delete-20260421.8b373a-20260602.f844de.gif?width=800)

## 테이블 구성 탭

각 테이블에는 세 개의 구성 탭이 있습니다.

| 탭 | 용도 |
| --- | --- |
| **테이블** | 데이터 원본, 원격 엔드포인트, 동기화 및 테이블 수준 동작 구성 |
| **열** | 열 속성, 스키마, 관계 및 계층 구조 정의 |
| **데이터** | 읽기 전용 보기에서 테이블 데이터 미리 보기 |

이 탭들은 데이터 원본 구성, 구조 모델링 및 데이터 검토를 분리하여 제공합니다.

## 기존 시트 테이블 변환

데이터 원본 패널에서 직접 테이블을 생성하는 것 외에도 기존의 바인딩되지 않은 시트 테이블을 데이터 매니저 테이블로 변환할 수 있습니다.
시트 테이블이 변환되면:

* 해당 데이터 매니저 테이블이 생성됩니다.
* 시트 테이블은 새 데이터 매니저 테이블에 바인딩됩니다.
* 원래 셀 데이터는 데이터 매니저 모델을 통해 관리됩니다.

자세한 동작 및 API 사용 방법은 [데이터 테이블로/에서 변환](/spreadjs/docs/features/tablegen/convert-fromto-data-table)을 참조하세요.