> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> 레코드를 생성하고 임베딩 벡터와 함께 테이블에 삽입합니다

# Insert record

# Record 삽입

**경로**: Console → **Database** → **Insert Data**

레코드를 생성하고 임베딩 벡터와 함께 테이블에 삽입합니다 .

<img src="https://mintcdn.com/dnotitia-328335e7/nH6QAwwQZ-jsIFdi/.gitbook/assets/admin__Recordinsert1.png?fit=max&auto=format&n=nH6QAwwQZ-jsIFdi&q=85&s=a6c2e0ff1974071aab97e95add2d3912" alt="Record 삽입" width="982" height="804" data-path=".gitbook/assets/admin__Recordinsert1.png" />

## Table ( 테이블 선택 )

드롭다운으로 레코드를 삽입할 테이블 선택

| 필드명   | 설명              | 타입                | 표시 형식                                             | 표시 조건 | 필수 | 예시             |
| ----- | --------------- | ----------------- | ------------------------------------------------- | ----- | -- | -------------- |
| TABLE | 레코드를 삽입할 테이블 선택 | DROPDOWN (SELECT) | MUI Select, fullWidth , 테이블 이름 ( table\_name ) 표시 | 항상 표시 | ○  | my\_table\_001 |

**동작** :

* 페이지 로드 시 모든 테이블 목록 자동 조회

* 테이블 선택 시 자동으로 해당 테이블의 컬럼 정보 로드

* 첫 번째 테이블이 자동 선택됨

* 테이블 변경 시 모든 입력 필드 초기화

## Inference Endpoint 정보

| 필드명                | 설명                            | 타입   | 표시 형식                                          | 표시 조건                                       | 필수 | 예시                                      |
| ------------------ | ----------------------------- | ---- | ---------------------------------------------- | ------------------------------------------- | -- | --------------------------------------- |
| INFERENCE ENDPOINT | 사용 중인 Inference Endpoint UUID | CHIP | MUI Chip, color="primary", size="small", 읽기 전용 | 테이블에 dense\_emb\_endpoint\_uuid 가 설정되어 있을 때 | -  | ep-123e4567-e89b-12d3-a456-426614174000 |

## 레코드 데이터 입력 필드

데이터 입력

| 필드명                    | 설명                           | 타입         | 표시 형식                                                                        | 표시 조건                                  | 필수 | 예시                                       |
| ---------------------- | ---------------------------- | ---------- | ---------------------------------------------------------------------------- | -------------------------------------- | -- | ---------------------------------------- |
| Primary Key 컬럼         | Primary Key 값 ( 미입력시 자동 생성 ) | TEXT FIELD | TextField , fullWidth , placeholder="Auto-generated with ASCII 30 separator" | Primary Key 컬럼 ( is\_primary === true) | O  | a1b2c3d4 ␞ 1234                          |
| 일반 컬럼 (String)         | 문자열 데이터 입력                   | TEXT FIELD | TextField , fullWidth , 단일 행                                                 | String 타입 컬럼                           | -  | sample metadata                          |
| 임베딩 소스 컬럼              | 벡터로 변환될 텍스트 입력               | TEXTAREA   | TextField , fullWidth , multiline, rows=4                                    | 임베딩 소스로 선택된 컬럼                         | ○  | This is a sample text…                   |
| Vector 컬럼 (ANN Column) | 자동 생성 벡터 ( 입력 불가 )           | INFO TEXT  | 회색 텍스트 , 입력 필드 없음                                                            | Vector 타입 컬럼 (ANN Column)              | -  | ( 벡터는 Inference Endpoint 를 통해 자동 생성됩니다 ) |

**Primary Key 자동 생성 규칙** :

* String 타입 PK: `{UUID 8 자 }` | `{ 랜덤 숫자 }` (ASCII 30 Record Separator 사용)

* Int64 타입 PK: 랜덤 정수

* Double 타입 PK: 랜덤 실수

* Boolean 타입 PK: 랜덤 true/false

**임베딩 소 스컬럼 표시** :

* 임베딩 소스로 선택된 컬럼은 \[ 임베딩 소스 ] 라벨 표시

* Multiline 입력 필드 (4 행 ) 로 표시

* 필수 입력 항목

## INSERT 버튼

| 필드명           | 설명           | 타입     | 표시 형식                                                       | 활성화 조건                               | 예시     |
| ------------- | ------------ | ------ | ----------------------------------------------------------- | ------------------------------------ | ------ |
| INSERT Button | 레코드 삽입 실행 버튼 | BUTTON | MUI Button, variant="contained", color="primary", fullWidth | 테이블 선택 AND 임베딩 소스 선택 AND 필수 필드 입력 완료 | INSERT |

**활성화** **조건** **상세** :

* 테이블이 선택되어 있을 것

* 임베딩 소스가 선택되어 있을 것

* 임베딩 소스 컬럼에 텍스트가 입력되어 있을 것

* 테이블에 Inference Endpoint 가 설정되어 있을 것

**동작** :

1. Primary Key 자동 생성

2. 입력된 레코드 데이터 수집

3. 임베딩 소스 텍스트를 Inference Endpoint 를 통해 벡터로 변환

4. 변환된 벡터와 함께 레코드 삽입 API 호출

5. 성공 시 입력 필드 초기화 및 성공 메시지 표시

**키보드** **단축키** : Enter 키 지원 ( 입력 필드에서 Enter 키 입력 시 삽입 실행 )

<img src="https://mintcdn.com/dnotitia-328335e7/nH6QAwwQZ-jsIFdi/.gitbook/assets/admin__Recordinsertsu.png?fit=max&auto=format&n=nH6QAwwQZ-jsIFdi&q=85&s=8ab686d47d711e7374c37dc3efc9e524" alt="INSERT 버튼" width="982" height="804" data-path=".gitbook/assets/admin__Recordinsertsu.png" />

## TIP / 주의

<Info>
  * **PK 자동 생성** — Primary Key 필드는 데이터 타입에 따라 자동 생성되므로 입력할 필요 없음
  * **첫 번째 테이블 자동 선택** — 페이지 로드 시 첫 번째 테이블이 자동 선택되어 빠르게 작업 시작 가능
  * **text 컬럼 우선 선택** — `text` 컬럼이 있으면 Embedding Source 로 자동 선택됨
  * **멀티라인 입력** — Embedding Source 필드는 multiline (3 줄) 으로 표시되어 긴 텍스트 입력 가능
  * **Shift + Enter 로 줄바꿈** — Embedding Source 필드에서 Shift+Enter 로 줄바꿈, Enter 로 제출
  * **필드 자동 포커스** — Embedding Source 선택 시 해당 필드에 자동 포커스
  * **ASCII 30 사용** — PK 생성 시 ASCII 30 (Record Separator) 문자를 구분자로 사용하여 중복 방지
</Info>

<Warning>
  **Endpoint 필수** — TABLE 에 Endpoint 가 설정되어 있지 않으면 레코드 삽입이 불가능합니다. Endpoint 를 설정한 후 다시 시도하세요.
</Warning>

<Info>
  RECORD 목록 조회·수정·삭제 페이지는 제공되지 않으며, ANN 컬럼은 자동 생성됩니다. 자세한 제약·동작은 아래 항목을 참고하세요.
</Info>

**1. RECORD 목록 조회 불가**

RECORD 목록을 조회하는 별도 페이지는 없습니다 . 삽입한 레코드를 확인하려면 :

* **DATABASE > Tables** 메뉴로 이동
* 해당 TABLE 클릭하여 상세 페이지로 이동
* **SEARCH RECORD** 섹션에서 레코드 검색 및 조회

**2. RECORD 수정 삭제 불가**

현재 버전에서는 RECORD 수정 및 삭제 기능이 제공되지 않습니다 . 레코드를 수정하거나 삭제하려면 직접 TABLE 을 조작해야 합니다 .

**3. ANN 컬럼 제외**

ANN 컬럼 ( 벡터 컬럼 ) 은 입력 필드에 표시되지 않으며 , Endpoint 를 통해 자동으로 생성됩니다 .

**4. Primary Key 자동 생성 규칙**

* **string 타입** : ASCII 30 (RS) 문자 포함
* **비출력 문자** : ASCII 30 은 화면에 보이지 않지만 실제 데이터에 포함됨
* **중복 방지** : UUID + 랜덤 숫자 조합으로 중복 가능성 최소화

**5. 업로드 성공 후 초기화**

업로드 성공 후 Embedding Source 필드만 비워지고 , 자동 생성된 PK 등 다른 필드는 유지됩니다 ( 연속 입력 편의성 ).

**6. 에러 Alert 표시**

API 호출 실패 시 하단에 빨간색 Alert 로 에러 메시지 표시됩니다 .