Record 삽입
경로: “Database” > “Insert Record”
레코드를 생성하고 임베딩 벡터와 함께 테이블에 삽입합니다 .
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 가 설정되어 있을 것
동작 :
-
Primary Key 자동 생성
-
입력된 레코드 데이터 수집
-
임베딩 소스 텍스트를 Inference Endpoint 를 통해 벡터로 변환
-
변환된 벡터와 함께 레코드 삽입 API 호출
-
성공 시 입력 필드 초기화 및 성공 메시지 표시
키보드 단축키 : Enter 키 지원 ( 입력 필드에서 Enter 키 입력 시 삽입 실행 )
TIP / 주의
- 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) 문자를 구분자로 사용하여 중복 방지
Endpoint 필수 — TABLE 에 Endpoint 가 설정되어 있지 않으면 레코드 삽입이 불가능합니다. Endpoint 를 설정한 후 다시 시도하세요.
RECORD 목록 조회·수정·삭제 페이지는 제공되지 않으며, ANN 컬럼은 자동 생성됩니다. 자세한 제약·동작은 아래 항목을 참고하세요.
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 로 에러 메시지 표시됩니다 .