---
name: table-sql
description: 리포트 관련 테이블 SQL 작성 가이드. 리포트 테이블 생성 DDL, 메타데이터 등록 시 사용.
---

# 리포트 테이블 SQL 작성 가이드

## 수정 범위 제약

리포트 관련 테이블(report_master, report_details 등)만 대상.
기존 테이블 구조는 수정하지 않는다.

## 핵심 원칙

1. 모든 비즈니스 컬럼은 `VARCHAR(500)`로 통일
2. 날짜/시간 컬럼만 `TIMESTAMP` 사용
3. 기본 컬럼 5개 자동 포함: id, created_date, updated_date, writer, company_code
4. 3개 메타데이터 테이블 등록 필수: `table_labels`, `column_labels`, `table_type_columns`

## 테이블 생성 DDL 템플릿

```sql
CREATE TABLE "테이블명" (
  "id" varchar(500) PRIMARY KEY DEFAULT gen_random_uuid()::text,
  "created_date" timestamp DEFAULT now(),
  "updated_date" timestamp DEFAULT now(),
  "writer" varchar(500) DEFAULT NULL,
  "company_code" varchar(500),
  -- 사용자 정의 컬럼
  "컬럼1" varchar(500),
  "컬럼2" varchar(500)
);
```

## 메타데이터 등록 (3개 필수)

```sql
INSERT INTO table_labels (table_name, display_name, description, company_code)
VALUES ('테이블명', '표시명', '설명', '회사코드');

INSERT INTO column_labels (table_name, column_name, display_name, company_code)
VALUES ('테이블명', '컬럼명', '표시명', '회사코드');

INSERT INTO table_type_columns (table_name, column_name, column_type, display_order, company_code)
VALUES ('테이블명', '컬럼명', 'VARCHAR', 순서, '회사코드');
```