Redis 데이터 저장소에서 키 이름 변경하기 – RENAME, RENAMENX 명령어 사용법

이번 튜토리얼에서는 Redis 데이터 저장소에 저장된 키의 이름을 변경하는 방법을 알아봅니다. 이를 위해 Redis에서 제공하는 RENAME 명령어와 RENAMENX 명령어를 사용합니다.

RENAME 명령어란?

RENAME 명령어는 기존 키(old name)를 새로운 이름(new name)으로 변경하는 명령어입니다. 동작 방식은 다음과 같습니다.

• 새 이름을 가진 키가 이미 존재하는 경우: 기존 키가 암시적 DEL 명령에 의해 삭제되고 덮어써집니다.
• 새 이름을 가진 키가 존재하지 않는 경우: 기존 키의 이름이 새 이름으로 그대로 변경됩니다.

RENAME 명령어의 기본 문법은 다음과 같습니다.

문법(Syntax)

redis host:port> RENAME <기존 키 이름> <새 키 이름>

실행 결과(Output)

- 키가 성공적으로 변경된 경우: string 응답 반환
- 기존 키가 존재하지 않는 경우: 에러 반환

예제(Example)

RENAMENX 명령어란?

RENAMENX 명령어는 새 이름을 가진 키가 존재하지 않을 때만 기존 키의 이름을 새 이름으로 변경합니다. 즉, 실수로 다른 키를 덮어쓰는 것을 방지하고 싶을 때 유용하게 사용할 수 있습니다. 동작 결과는 다음과 같습니다.

• 새 이름의 키가 이미 존재하면: 0을 반환하며 이름 변경은 수행되지 않습니다.
• 새 이름의 키가 없으면: 키 이름이 정상적으로 변경됩니다.

RENAMENX 명령어의 기본 문법은 다음과 같습니다.

문법(Syntax)

redis host:port> RENAMENX <기존 키 이름> <새 키 이름>

실행 결과(Output)

- 1: 키 이름이 성공적으로 변경된 경우
- 0: 새 이름을 가진 키가 이미 존재하는 경우
- 에러: 기존 키가 존재하지 않는 경우

예제(Example)

참고 자료(References)

1. RENAME 명령어 공식 문서
2. RENAMENX 명령어 공식 문서

마무리

지금까지 Redis 데이터 저장소에 저장된 키의 이름을 변경하는 두 가지 방법, RENAME과 RENAMENX 명령어에 대해 살펴보았습니다. 두 명령어의 가장 큰 차이점은 덮어쓰기 여부라는 점을 기억해 두시면 좋습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!