설명
정상 동작테이블, 뷰, 열 설명을 편집하고 주석 DDL로 서버에 다시 기록.
테이블, 뷰, 열에는 설명, 데이터베이스 자체가 객체 옆에 저장하는 주석입니다. SQLly는 스키마를 보여주는 모든 곳(객체 목록의 Comment 열, 스키마 문서 내보내기, AI 컨텍스트)에서 이러한 설명을 읽으며, 엔진의 주석 구문을 수동으로 작성하지 않고도 두 곳에서 작성할 수 있습니다.
편집 위치
- 구조 편집 - 하나의 설명 필드는 열 목록 아래에 있고, 각 열 행에는 자체 설명 상자가 있습니다. 설명 편집은 변경 목록에 다음으로 표시됩니다 설명 설정. 대부분의 엔진에서는 구조 변경 뒤에 스크립트로 작성됩니다. 주석은 열에 속하므로 이름을 바꾸거나 타입을 변경할 때 추가 명령이 필요하지 않습니다. MySQL과 MariaDB에서는 열을 변경하면 전체 정의가 다시 작성되므로, 이름이 바뀌거나, 타입이 바뀌거나, 기본값이 바뀌거나, 추가된 열은 같은 절 안에 설명을 함께 담아 주석을 유지(또는 새로 부여)하며 구조 변경이 취소되지 않습니다.
- 객체 속성 - 그 일반 페이지는 일단 읽히고 나면 편집 가능한 필드에 현재 설명을 보여 줍니다. 바꾸면 페이지가 수정됨으로 표시됩니다; 변경 사항 검토 아무것도 실행되기 전에 정확한 문장을 보여 줍니다.
텍스트를 지우면 설명이 제거됩니다. 두 화면 모두 일반 검토 규칙을 따릅니다. 구조 편집은 스크립트를 편집기 탭으로 보내고, 객체 속성은 검토 시트에서만 실행합니다.
현재 설명을 읽을 수 없는 경우(예: 권한 문제), 두 화면 모두 설명 필드를 숨기고 그 대신 이유를 표시합니다. SQL Server에서는 이미 설명이 존재하는지 여부에 따라 올바른 절차가 달라지기 때문에 추측한 값에 대해 편집 스크립트를 작성하지 않습니다.
엔진별로 SQLly가 실행하는 것
| 엔진 | 테이블 / 뷰 설명 | 열 설명 |
|---|---|---|
| SQL Server / Azure SQL | 그 MS_Description 확장 속성: sp_addextendedproperty 없을 경우, sp_updateextendedproperty 값이 있을 때(빈 텍스트를 가진 값도 포함), sp_dropextendedproperty 지울 수 있습니다. 뷰는 뷰로 지정합니다. | 열 수준에서도 같은 절차가 적용됩니다. |
| PostgreSQL | COMMENT ON TABLE / COMMENT ON VIEW … IS '…'; IS NULL 지워집니다. | COMMENT ON COLUMN … IS '…'. |
| CockroachDB | COMMENT ON TABLE … IS '…'. CockroachDB에는 COMMENT ON VIEW, 그래서 뷰의 설명 필드는 그 이유와 함께 숨겨집니다. | COMMENT ON COLUMN … IS '…'. |
| DuckDB | COMMENT ON TABLE / COMMENT ON VIEW; IS NULL 지워집니다. | COMMENT ON COLUMN. |
| Oracle 데이터베이스 | COMMENT ON TABLE … IS '…' (Oracle은 뷰를 TABLE 키워드로 다룹니다); IS '' 지워집니다. | COMMENT ON COLUMN. |
| MySQL / MariaDB | ALTER TABLE … COMMENT = '…'. 뷰는 설명을 저장할 수 없습니다(서버는 모든 뷰의 주석을 다음과 같이 보고합니다 VIEW), 그래서 뷰의 해당 필드는 그 사유와 함께 숨겨집니다. | MySQL에는 주석만 변경하는 명령문이 없어서 SQLly는 ALTER TABLE … MODIFY COLUMN를 실행합니다. 설명만 바꾸는 변경이라면 열을 다음과 같이 그대로 다시 씁니다 SHOW CREATE TABLE 가 출력하는 그대로 열을 다시 기술하고 오직 COMMENT '…' 절만 바꾸고 나머지는 모두 유지합니다. 주석 뒤에 오는 절도 마찬가지입니다. 예컨대 MariaDB의 CHECK (json_valid(…)); 이 텍스트를 읽을 수 없으면 SQLly는 추측 대신 변경을 거부합니다. 같은 편집에서 열 이름 변경, 타입 변경, 기본값 변경, 열 추가까지 함께 일어나면 다음 COMMENT 는 대신 그 CHANGE/MODIFY/ADD 절에 대신 넣습니다. |
| ClickHouse | ALTER TABLE … MODIFY COMMENT '…'. 뷰는 생성 후에는 주석을 달 수 없으며, SQLly는 다음 절을 넣어 뷰를 다시 만들라고 안내합니다 COMMENT 절입니다. | ALTER TABLE … COMMENT COLUMN … '…'. |
| SQLite / libSQL | 서버 측 주석 저장소 없음. 설명 필드는 숨겨져 있으며 편집기는 대신 이유를 표시합니다. | |
텍스트는 엔진 규칙에 맞게 따옴표로 감싸고, 중간의 따옴표는 어디서든 두 개로 겹쳐 쓰며, SQL Server 값은 유니코드로 전송합니다 N'…' 리터럴에서 처리하며, MySQL과 ClickHouse는 백슬래시도 이스케이프합니다.
MySQL과 MariaDB에서 Edit Structure가 이름을 바꾸거나 유형이나 기본값을 바꾸는 열은 편집기의 필드에서 다시 만들어집니다: 유형, null 허용 여부, 기본값, 자동 증가, ON UPDATE (timestamp와 datetime 열의 경우), 그리고 설명. 문자셋이나 정렬 규칙 재정의, 생성된 표현식, INVISIBLE, 또는 열 수준의 CHECK 은(는) 다시 명시하지 않습니다. 현재 정의에 있는 경우 스크립트가 그 사실을 다음에 밝힙니다 -- WARNING 줄을 보여 주므로 실행하기 전에 타입에 추가할 수 있습니다.

