Redis 데이터 소스 구성
Redis는 오픈 소스 인메모리 데이터 구조 저장 시스템으로, 데이터베이스, 캐시, 메시지 미들웨어로 널리 사용됩니다.
이 문서에서는 Redis 데이터 동기화 기능의 지원 현황을 소개합니다.
지원 버전
redis 3.0+
사용 제한
현재는 다음 구성 방식만 지원합니다.
- AE 사전 설정 스토리지 공간 테이블에서 Redis로 쓰기 지원(오프라인 쓰기)
참고:
- Redis 데이터 소스 읽기는 아직 지원하지 않습니다(오프라인 읽기)
지원 필드 타입
| 필드 타입 | 오프라인 쓰기(Writer) |
|---|---|
| tinyint | 지원 |
| smallint | 지원 |
| integer | 지원 |
| bigint | 지원 |
| varchar | 지원 |
| boolean | 지원 |
| double | 지원 |
| date | 지원 |
| timestamp | 지원 |
array(tinyint) array(smallint) array(integer) array(bigint) array(varchar) array(boolean) array(double) | 지원 |
| array(기타) | 미지원 |
| row | 지원 |
| map | 지원 |
| varchar | 지원 |
Redis 데이터 소스 생성
데이터 개발 플랫폼 - 통합 모듈에서 Redis 데이터 소스 추가를 선택할 수 있습니다.
데이터 소스 설정 파라미터 정보
데이터 소스에 필요한 설정 정보를 입력하고 연결 테스트를 완료하면 Redis 데이터 소스가 생성됩니다.
파라미터 이름 앞에 *가 있는 항목은 필수 파라미터이고, *가 없는 항목은 선택 파라미터입니다.
| 필드 이름 | 설명 |
|---|---|
| 기본 정보 | |
| *데이터 소스 이름 | 데이터 개발 플랫폼 공간 내에서 고유해야 하며, 영문자, 숫자, 밑줄로 구성하고 숫자나 밑줄로 시작할 수 없습니다 |
| 비고 | 선택 사항 |
| 데이터 소스 설정 | |
| 환경 구분 없음 / 독립 환경 설정 | 둘 중 하나 선택: 환경 구분 없음은 운영 환경과 개발 환경이 하나의 설정을 공유하고, 독립 환경 설정은 두 환경을 각각 독립적으로 설정합니다 |
| *배포 모드 |
|
| *서비스 주소/IP | Redis 데이터베이스가 있는 서비스 주소 클러스터 배포 시 여러 노드 정보를 입력하려면 추가를 클릭하십시오 |
| *포트 | Redis에 접근하는 데 사용하는 포트 |
| 사용자 이름 | 데이터베이스에 접근할 권한이 있는 사용자 이름 |
| *비밀번호 | 사용자 이름에 대응하는 비밀번호 |
| 고급 설정 | 데이터베이스 연결에 필요한 기타 고급 파라미터. 직접 입력할 수 있습니다 |
오프라인 동기화 작업 생성
위 단계에 따라 Redis 데이터 소스 생성을 완료하고 연결 테스트에 성공했다면, 실제 시나리오에 맞게 Redis 오프라인 쓰기 작업을 구성할 수 있습니다.
Redis를 데이터 목적지로 사용
데이터 목적지에서 Redis를 선택하고 다음 관련 파라미터를 설정합니다.
| 필드 이름 | 설명 |
|---|---|
| *소스 타입 | 데이터 목적지의 대상 타입으로 Redis 선택 |
| *데이터 소스 이름 | 데이터 소스 관리 화면에 등록된 Redis 데이터 소스이며, 드롭다운에서 선택할 수 있습니다. 해당 데이터 소스를 아직 만들지 않았다면 데이터 소스 관리 버튼을 클릭하여 Redis 데이터 소스를 생성할 수 있습니다. |
| *데이터베이스 선택 | 데이터베이스를 식별하는 Redis db slot 인덱스 *비클러스터 모드 소스에만 이 파라미터가 있습니다 |
*쓰기 데이터 타입 | Redis Value의 데이터 타입 string, set, hash, list 네 가지 타입을 선택할 수 있습니다. |
| *쓰기 모드 |
|
| 일괄 건수 | 일괄 건수: 배치당 제출하는 데이터양. 기본값 1000건 |
| 만료 시간 | Redis에 데이터를 쓸 때 key에 만료 시간을 설정할 수 있으며, 단위는 일/시간/분/초 중에서 선택할 수 있습니다. 스위치는 기본적으로 꺼져 있습니다 |
파라미터 이름 앞에 *가 있는 항목은 필수 파라미터이고, *가 없는 항목은 선택 파라미터입니다.
필드 매핑
데이터 소스와 타겟 설정을 완료한 후 필드를 분석하고 Redis Key의 저장 방식을 설정합니다.
인덱스 키(Key) 조합 전략
Redis는 키-값 저장소이며, 키(Key) 설계는 조회 효율과 유지 보수성에 직접적인 영향을 줍니다.
사용자가 편리하게 사용할 수 있도록 키 조합 및 저장 기능에서 다음을 지원합니다.
- 지정 필드 쓰기 지원(즉, 전체 테이블이 아닌 쓰기)
- 키 접두사 설정 & 접미사 설정 지원
- 파라미터 삽입(공간 파라미터) 지원
- 특수 문자 삽입 지원
- 키 전체가 규칙 검증을 통과해야 합니다
인덱스 키(Key) 설정 설명
| 키 관련 설정 | ||
|---|---|---|
| 필드 이름 | 설명 | 필수 여부 |
| 키 접두사/접미사 | 사용자 지정 접두사와 접미사를 지원합니다 redis key 오염을 방지하기 위해 내용은 [0-9A-Za-z-_]만 지원합니다. 입력 예시: student:tuition:${bd} | 아니요 |
| 필드 값 삽입 | 왼쪽 소스 테이블에서 이미 선택한 필드만 선택할 수 있습니다 | 아니요 |
| 파라미터 삽입 | 사전 설정 공간 파라미터와 커스텀 공간 파라미터를 지원합니다 | 아니요 |
| 특수 문자 삽입 | 예: \u0001 | 아니요 |
| 데이터 미리보기 | 기본적으로 3건 표시 | |
기본 정보 설정
마지막으로 통합 계획의 기본 정보를 설정해야 합니다. 계획 이름, 담당자, 통합 동기화 속도, 비고 등이 포함됩니다.
설정을 완료한 후 저장 버튼을 클릭하면 통합 계획 생성이 완료됩니다.
참고: 계획 이름은 저장 후 수정할 수 없습니다
상세 페이지:
오프라인 동기화 계획을 작업 플로우에 연결
작업 플로우에 연결
1. 연결 시작
- 통합 계획 상세 페이지에서 오른쪽 상단의 작업 플로우에 연결 버튼을 클릭합니다
2. 작업 플로우 선택
-
드롭다운 메뉴에서 대상 작업 플로우를 선택합니다
-
새 작업 플로우를 만들려면:
- 드롭다운 메뉴 아래의 새 작업 플로우 바로가기 버튼을 클릭합니다
- 또는 개발 모듈로 이동하여 생성합니다
-
팁: 대상 작업 플로우가 표시되지 않으면 오른쪽의 ↻ 새로고침 버튼을 클릭합니다
3. 동기화 노드 생성
- 작업 플로우에서 오프라인 동기화 계획 타입의 노드를 새로 만듭니다
- 이 노드는 현재 통합 계획과 연관되며, 노드가 실행되면 해당 통합 계획의 실행이 트리거됩니다
4. 연결 완료
- 노드 생성 및 연결을 클릭하여 설정을 완료합니다
- 연결에 성공하면 작업 플로우로 이동을 클릭하여 연결 결과를 바로 확인할 수 있습니다
참고: 작업 플로우에 연결하여 생성된 작업 노드는 아직 배포되지 않은 상태입니다. 작업 플로우로 이동하여 확인한 후 해당 노드를 배포하여 라이브 상태로 전환하는 것을 권장합니다.
작업 플로우 연결 해제
오프라인 동기화 계획의 작업 플로우 연결을 해제하려면 다음과 같이 진행합니다.
- 작업 플로우가 아직 배포되지 않았다면, 해당 계획이 연결된 작업 플로우로 이동하여 개발 모드에서 해당 오프라인 동기화 계획 작업 노드를 삭제하면 됩니다.
- 작업 플로우가 이미 배포되어 라이브 상태라면, 개발 모드에서 해당 오프라인 동기화 계획 작업 노드를 삭제한 후 작업 플로우를 다시 배포해야 합니다. 이렇게 하면 운영 환경에서도 해당 노드의 연결이 함께 해제됩니다.