본문으로 건너뛰기

Redis 데이터 소스 구성

최근 업데이트 2026. 11. 03.

Redis는 오픈 소스 인메모리 데이터 구조 저장 시스템으로, 데이터베이스, 캐시, 메시지 미들웨어로 널리 사용됩니다.

이 문서에서는 Redis 데이터 동기화 기능의 지원 현황을 소개합니다.

지원 버전​

redis 3.0+

사용 제한​

현재는 다음 구성 방식만 지원합니다.

  • AE 사전 설정 스토리지 공간 테이블에서 Redis로 쓰기 지원(오프라인 쓰기)

참고:

  • Redis 데이터 소스 읽기는 아직 지원하지 않습니다(오프라인 읽기)

지원 필드 타입​

아래 표는 Redis에 쓸 수 있는 소스 필드 타입을 나열합니다. Redis의 쓰기 데이터 구조인 string, hash, list, set은 데이터 목적지에서 별도로 설정하며 아래 표의 필드 타입에는 해당하지 않습니다.

지원 여부소스 필드 타입
지원tinyint, smallint, integer, bigint, varchar, boolean, double, date, timestamp, row, map
지원하는 배열array(tinyint), array(smallint), array(integer), array(bigint), array(varchar), array(boolean), array(double)
추가 확인 필요다른 요소 타입의 배열은 필드 분석 및 작업 검증 결과 확인 필요

필드 분석 및 작업 검증 결과를 기준으로 하십시오. 목록에 없는 필드 타입이 지원된다는 의미는 아닙니다.

Redis 데이터 소스 생성​

데이터 개발 플랫폼 - 통합 모듈에서 Redis 데이터 소스 추가를 선택할 수 있습니다.

데이터 소스 설정 파라미터 정보

데이터 소스에 필요한 설정 정보를 입력하고 연결 테스트를 완료하면 Redis 데이터 소스가 생성됩니다.

파라미터 이름 앞에 *가 있는 항목은 필수 파라미터이고, *가 없는 항목은 선택 파라미터입니다.

필드 이름설명
기본 정보
*데이터 소스 이름데이터 개발 플랫폼 공간 내에서 고유해야 하며, 영문자, 숫자, 밑줄로 구성하고 숫자나 밑줄로 시작할 수 없습니다
비고선택 사항
데이터 소스 설정
환경 구분 없음 / 독립 환경 설정둘 중 하나 선택: 환경 구분 없음은 운영 환경과 개발 환경이 하나의 설정을 공유하고, 독립 환경 설정은 두 환경을 각각 독립적으로 설정합니다
*배포 모드
  • 싱글 노드 모드(single)
  • 클러스터 모드(cluster)
*서비스 주소/IP

Redis 데이터베이스가 있는 서비스 주소

클러스터 배포 시 여러 노드 정보를 입력하려면 추가를 클릭하십시오

*포트Redis에 접근하는 데 사용하는 포트
사용자 이름데이터베이스에 접근할 권한이 있는 사용자 이름
*비밀번호사용자 이름에 대응하는 비밀번호
고급 설정데이터베이스 연결에 필요한 기타 고급 파라미터. 직접 입력할 수 있습니다

오프라인 동기화 작업 생성​

위 단계에 따라 Redis 데이터 소스 생성을 완료하고 연결 테스트에 성공했다면, 실제 시나리오에 맞게 Redis 오프라인 쓰기 작업을 구성할 수 있습니다.

Redis를 데이터 목적지로 사용​

데이터 목적지에서 Redis를 선택하고 다음 관련 파라미터를 설정합니다.

필드 이름설명
*소스 타입데이터 목적지의 대상 타입으로 Redis 선택
*데이터 소스 이름데이터 소스 관리 화면에 등록된 Redis 데이터 소스이며, 드롭다운에서 선택할 수 있습니다.
해당 데이터 소스를 아직 만들지 않았다면 데이터 소스 관리 버튼을 클릭하여 Redis 데이터 소스를 생성할 수 있습니다.
*데이터베이스 선택

데이터베이스를 식별하는 Redis db slot 인덱스

*비클러스터 모드 소스에만 이 파라미터가 있습니다

*쓰기 데이터 타입

Redis Value의 데이터 타입

string, set, hash, list 네 가지 타입을 선택할 수 있습니다.

*쓰기 모드
  • 데이터 타입 = string이면 쓰기 모드 = set
  • 데이터 타입 = hash이면 쓰기 모드 = hset
  • 데이터 타입 = list이면 쓰기 모드 = lpush(기본값) 또는 rpush
  • 데이터 타입 = set이면 쓰기 모드 = sadd
일괄 건수일괄 건수: 배치당 제출하는 데이터양. 기본값 1000건
만료 시간Redis에 데이터를 쓸 때 key에 만료 시간을 설정할 수 있으며, 단위는 일/시간/분/초 중에서 선택할 수 있습니다. 스위치는 기본적으로 꺼져 있습니다

파라미터 이름 앞에 *가 있는 항목은 필수 파라미터이고, *가 없는 항목은 선택 파라미터입니다.

필드 매핑​

데이터 소스와 타겟 설정을 완료한 후 필드를 분석하고 Redis Key의 저장 방식을 설정합니다.

인덱스 키(Key) 조합 전략​

Redis는 키-값 저장소이며, 키(Key) 설계는 조회 효율과 유지 보수성에 직접적인 영향을 줍니다.

노트

사용자가 편리하게 사용할 수 있도록 키 조합 및 저장 기능에서 다음을 지원합니다.

  1. 지정 필드 쓰기 지원(즉, 전체 테이블이 아닌 쓰기)
  2. 키 접두사 설정 & 접미사 설정 지원
  3. 파라미터 삽입(공간 파라미터) 지원
  4. 특수 문자 삽입 지원
  5. 키 전체가 규칙 검증을 통과해야 합니다

인덱스 키(Key) 설정 설명​

키 관련 설정
필드 이름설명필수 여부
키 접두사/접미사

사용자 지정 접두사와 접미사를 지원합니다

redis key 오염을 방지하기 위해 내용은 [0-9A-Za-z-_]만 지원합니다.

입력 예시: student:tuition:${bd}

아니요
필드 값 삽입왼쪽 소스 테이블에서 이미 선택한 필드만 선택할 수 있습니다아니요
파라미터 삽입사전 설정 공간 파라미터와 커스텀 공간 파라미터를 지원합니다아니요
특수 문자 삽입예: \u0001아니요
데이터 미리보기기본적으로 3건 표시

기본 정보 설정​

마지막으로 통합 계획의 기본 정보를 설정해야 합니다. 계획 이름, 담당자, 통합 동기화 속도, 비고 등이 포함됩니다.

설정을 완료한 후 저장 버튼을 클릭하면 통합 계획 생성이 완료됩니다.

참고: 계획 이름은 저장 후 수정할 수 없습니다

상세 페이지:

오프라인 동기화 계획을 작업 플로우에 연결​

작업 플로우에 연결​

1. 연결 시작

  • 통합 계획 상세 페이지에서 오른쪽 상단의 작업 플로우에 연결 버튼을 클릭합니다

2. 작업 플로우 선택

  • 드롭다운 메뉴에서 대상 작업 플로우를 선택합니다

  • 새 작업 플로우를 만들려면:

    • 드롭다운 메뉴 아래의 새 작업 플로우 바로가기 버튼을 클릭합니다
    • 또는 개발 모듈로 이동하여 생성합니다
  • 팁: 대상 작업 플로우가 표시되지 않으면 오른쪽의 ↻ 새로고침 버튼을 클릭합니다

3. 동기화 노드 생성

  • 작업 플로우에서 오프라인 동기화 계획 타입의 노드를 새로 만듭니다
  • 이 노드는 현재 통합 계획과 연관되며, 노드가 실행되면 해당 통합 계획의 실행이 트리거됩니다

4. 연결 완료

  • 노드 생성 및 연결을 클릭하여 설정을 완료합니다
  • 연결에 성공하면 작업 플로우로 이동을 클릭하여 연결 결과를 바로 확인할 수 있습니다
팁

참고: 작업 플로우에 연결하여 생성된 작업 노드는 아직 배포되지 않은 상태입니다. 작업 플로우로 이동하여 확인한 후 해당 노드를 배포하여 라이브 상태로 전환하는 것을 권장합니다.

작업 플로우 연결 해제​

오프라인 동기화 계획의 작업 플로우 연결을 해제하려면 다음과 같이 진행합니다.

  • 작업 플로우가 아직 배포되지 않았다면, 해당 계획이 연결된 작업 플로우로 이동하여 개발 모드에서 해당 오프라인 동기화 계획 작업 노드를 삭제하면 됩니다.
  • 작업 플로우가 이미 배포되어 라이브 상태라면, 개발 모드에서 해당 오프라인 동기화 계획 작업 노드를 삭제한 후 작업 플로우를 다시 배포해야 합니다. 이렇게 하면 운영 환경에서도 해당 노드의 연결이 함께 해제됩니다.
이 문서가 도움이 되었나요?