PostgreSQL에서 컬럼 이름을 변경하는 방법

2024년 7월 23일 작성자: Matthew Rathbone

ALTER TABLE 문은 기존 테이블 구조를 수정할 때 사용해요. 컬럼 이름을 변경하려면 RENAME COLUMN 절을 사용하면 돼요.

계속 읽기 전에 저희의 모던한 PostgreSQL 클라이언트인 Beekeeper Studio를 소개할게요. 테이블 구조 편집기에서 이름만 바꾸면 컬럼 이름을 변경할 수 있고, PostgreSQL에서는 무료로 사용할 수 있어요. 여기에서 다운로드하세요.

문법:

ALTER TABLE table_name RENAME COLUMN old_column_name TO new_column_name;

예시:

다음과 같은 구조의 employees 테이블이 있다고 가정해 볼게요:

CREATE TABLE employees (
    id SERIAL PRIMARY KEY,
    firstname VARCHAR(50),
    lastname VARCHAR(50),
    dob DATE
);

dob 컬럼의 이름을 birthdate로 변경하려면 다음 명령을 사용하세요:

ALTER TABLE employees RENAME COLUMN dob TO birthdate;

단계별 가이드

1. 기존 테이블 구조 확인

먼저 테이블의 현재 구조를 확인하세요. psql의 \d 명령이나 pgAdmin을 사용해 테이블 정보를 볼 수 있어요.

\d employees

출력:

 Column    |         Type          | Collation | Nullable |               Default
-----------+-----------------------+-----------+----------+--------------------------------------
 id        | integer               |           | not null | nextval('employees_id_seq'::regclass)
 firstname | character varying(50) |           |          |
 lastname  | character varying(50) |           |          |
 dob       | date                  |           |          |

2. 컬럼 이름 변경

ALTER TABLE 명령을 실행해 컬럼 이름을 변경하세요.

ALTER TABLE employees RENAME COLUMN dob TO birthdate;

3. 변경 사항 확인

테이블 정보를 다시 조회해 컬럼 이름이 변경되었는지 확인하세요.

\d employees

출력:

 Column    |         Type          | Collation | Nullable |               Default
-----------+-----------------------+-----------+----------+--------------------------------------
 id        | integer               |           | not null | nextval('employees_id_seq'::regclass)
 firstname | character varying(50) |           |          |
 lastname  | character varying(50) |           |          |
 birthdate | date                  |           |          |

고려 사항

의존성: 컬럼 이름을 변경해도 뷰, 함수, 트리거 등 다른 데이터베이스 객체에서 해당 컬럼을 참조하는 부분은 자동으로 업데이트되지 않아요. 이런 객체는 직접 수정해야 해요.
권한: 테이블 구조를 변경할 수 있는 권한이 있는지 확인하세요.
백업: 스키마를 변경하기 전에는 항상 데이터베이스를 백업하세요.

Beekeeper Studio로 컬럼 이름 변경하기

Beekeeper Studio를 사용하면 SQL 문을 직접 작성하지 않고 GUI로 작업할 수 있어요. 오픈 소스 SQL 에디터이자 데이터베이스 관리 도구인 Beekeeper Studio로 PostgreSQL의 컬럼 이름을 쉽고 빠르게 변경할 수 있어요.

Beekeeper Studio로 컬럼 이름을 변경하는 방법:

PostgreSQL 데이터베이스에 연결하세요.
원하는 테이블로 이동하세요.
모든 컬럼이 목록으로 표시되면, 이름을 변경할 컬럼을 클릭하세요.
새 이름을 입력하고 Enter 키를 누르세요.

SQL 명령은 Beekeeper Studio가 모두 알아서 처리해 줘요. 게다가 다양한 SQL 방언을 지원하기 때문에 다른 SQL 환경으로도 매끄럽게 옮겨 갈 수 있어요.

결론

PostgreSQL에서 컬럼 이름을 변경하면 데이터베이스 스키마의 가독성과 유지보수성을 높일 수 있어요. ALTER TABLE … RENAME COLUMN 명령을 사용하거나 Beekeeper Studio 같은 SQL 에디터를 사용하면 간단하게 처리할 수 있어요. 런타임 오류를 방지하려면 컬럼 이름을 변경하기 전에 의존성을 확인하고 업데이트하세요.

함께 보면 좋은 글: