diff --git a/쿼리/README.md b/쿼리/README.md index 3577359..e8db044 100644 --- a/쿼리/README.md +++ b/쿼리/README.md @@ -1 +1,54 @@ -월별 유지보수 쿼리문을 저장하는 곳입니다. \ No newline at end of file +# 쿼리 관리 및 저장 방식 안내 + +월별 유지보수 쿼리문을 체계적으로 관리하기 위한 저장소입니다. 협업과 명확한 이력 관리를 위해 아래 규칙을 준수하여 쿼리를 저장해 주세요. + +--- + +## 1. 폴더 구조 (Directory Structure) + +쿼리는 연도 및 월별로 디렉토리를 나누어 관리합니다. + +```text +hallasanup/ +└── 쿼리/ + ├── README.md (현재 파일) + ├── 2026/ + │ ├── 05_May/ + │ └── 06_June/ + │ ├── 20260618_UPDATE_고객_데이터_정정.sql + │ └── 20260620_SELECT_월간_통계_집계.sql + └── 2025/ + └── 12_December/ +--- + +## 2. 파일 명명 규칙 (Naming Convention) + +파일 이름만 보고도 실행 날짜와 목적을 직관적으로 알 수 있도록 작성합니다. + +> **`[YYYYMMDD]_[SQL타입]_[작업_내용].sql`** + +* **데이터 수정 (UPDATE/DELETE):** `20260618_UPDATE_회원탈퇴처리.sql` +* **데이터 조회 (SELECT):** `20260630_SELECT_매출통계조회.sql` +* **테이블 구조 변경 (ALTER/CREATE):** `20260615_ALTER_상품테이블_인덱스추가.sql` + +--- + +## 3. 쿼리 파일 내부 작성 표준 (SQL Template) + +사후 검증 및 히스토리 추적을 위해 SQL 파일 상단에 반드시 아래 메타데이터 주석을 포함해 주세요. + +```sql +-- ========================================== +-- 작업일자: YYYY-MM-DD +-- 작 성 자: [작성자 이름] +-- 작업목적: [쿼리 작성 및 실행 목적 설명] +-- 요청자/티켓번호: [요청 부서 또는 이슈 번호] +-- ========================================== + +-- [1] 대상 데이터 검증 (조회) +SELECT COUNT(*) +FROM 테이블명 +WHERE 조건; + +-- [2] 본 작업 (수정/삭제 시 주석 처리 후 공유 권장) +-- UPDATE 테이블명 SET 컬럼 = 값 WHERE 조건; \ No newline at end of file