사용 방법 App Connect with Redis
Redis (REmote DIctionary Server) 는 메모리에 데이터를 보유하고 데이터베이스, 캐시 및 메시지 브로커로 작동하는 개방형 소스 데이터 저장소입니다.
NoSQL 데이터베이스인 Redis SQL 기반 관계형 데이터베이스에서 사용하는 테이블 및 기타 데이터베이스 객체 대신 문자열, 해시, 리스트와 같은 데이터 구조에 키-값 쌍을 저장합니다. Redis 또한 SQL 기반 문장(예: INSERT 또는 SELECT)과 매우 유사한 방식으로 데이터베이스 관리 시스템( Redis ) 서버에서 작업을 실행하는 데 사용할 수 있는 명령어 집합(예: SET 및 GET )을 제공합니다.
다음 정보는 를 사용하여 App Connect 를 다른 애플리케이션에 Redis 연결하는 방법을 설명합니다.
지원되는 제품 및 API 버전
이 커넥터가 지원하는 제품 및 API 버전을 확인하려면 IBM 지원 페이지의 '상세 시스템 요구 사항'을 참조하십시오.
Redis 에 연결
App Connect 에서 사용할 Redis 계정에 App Connect 를 연결하려면 인스턴스에서 사용 가능해야 하는 다음 연결 세부사항이 필요합니다. 예를 들어, IBM Cloud® Databases for Redis 를 사용하는 경우, IBM Cloud 에서 서비스 인스턴스의 연결 패널 및 서비스 자격 증명 패널에서 연결 값을 확인할 수 있습니다.
- Redis 호스트 이름 또는 IP 주소: Redis 서버의 호스트 이름 또는 IP 주소를 지정하십시오.
- Redis 포트 번호: Redis 서버의 포트 번호를 지정하십시오.
- 사용자 이름: 인증에 필요한 사용자 이름을 지정하십시오.참고: 현재.
admin가 기본값이지만 사용자의 요구사항에 따라 사용자 이름 필드를 채우도록 선택할 수 있습니다. - 비밀번호: 인증에 필요한 비밀번호를 지정하십시오.
- 데이터베이스 번호: 선택적으로 연결할 데이터베이스의 데이터베이스 인덱스를 지정하십시오 (일반적으로
0-15범위). (인덱스는 일반적으로 Redis URL 끝에 표시됩니다.) 기본값은0입니다. - 인증서 유효성 검사 허용 : 데이터베이스가 TLS 인증 및 암호화를 사용하여 보호되는지 여부를 지정하려면
false또는true로 설정하십시오. 이 옵션이 설정된true경우, 인증 기관(CA)의 루트 인증서를 기준으로 유효성을 확인하기 위해 SSL 또는 TSL 인증서를 제공해야 합니다. 기본값은true입니다. - 인증서: 인증서 유효성 검증 허용 이
true로 설정된 경우 인증서가 필수입니다. 데이터베이스를 호스트하는 클러스터에 대한 CA 서명 인증서의 컨텐츠를 Base64 형식으로 지정하십시오. 인스턴스에서 직접 Base64-encoded 컨텐츠를 복사하여 붙여넣을 수 있습니다.
App Connect Designer의 페이지(이전의 '카탈로그' 페이지) 에서 엔드포인트에 처음 연결하려면, 해당 Redis 엔드포인트를 확장한 Redis 후 '연결'을 클릭하십시오. 자세한 내용은 계정 관리하기를 참조하세요.
App Connect 생성된 계정을 플로우에서 사용하기 전에 계정의 이름을 식별하기 쉬운 의미 있는 이름으로 변경하십시오. 애플리케이션과 API 페이지 에서 계정의 이름을 바꾸려면, 계정을 선택하고, 옵션 메뉴(⋮)를 연 다음, 계정 이름 바꾸기 를 클릭하십시오.
우선 무엇을 고려해야 하나요?
Redis와 함께 App Connect Designer를 사용하기 전에 다음 고려사항에 유의하십시오.
- (일반적인 고려 사항) App Connect 애플리케이션 및 API 페이지 에서 사용할 수 있는 트리거 이벤트와 작업 목록을 확인할 수 있습니다.
일부 응용 프로그램의 경우, 이벤트와 작업은 환경과 커넥터가 구성 가능한 이벤트와 동적 작업 검색을 지원하는지 여부에 따라 달라집니다. 애플리케이션이 구성 가능한 이벤트를 지원하는 경우 이벤트 목록 아래에 추가 구성 가능한 이벤트 표시 링크가 표시됩니다. 애플리케이션이 동적 조치 감지를 지원하는 경우 조치 목록 아래에 자세히 표시 링크가 표시됩니다.
- (일반 고려사항) 애플리케이션에 대해 여러 계정을 사용하는 경우 해당 애플리케이션에 대한 조치를 선택할 때 표시되는 필드 세트는 계정마다 다를 수 있습니다. 플로우 편집기에서 일부 애플리케이션은 항상 조치에 대해 큐레이트된 정적 필드 세트를 제공합니다. 다른 애플리케이션은 동적 감지를 사용하여 사용자가 연결된 인스턴스에 구성된 필드 세트를 검색합니다. 예를 들어, 애플리케이션의 두 인스턴스에 대해 두 개의 계정이 있는 경우 첫 번째 계정은 즉시 사용할 수 있는 설정을 사용할 수 있습니다. 그러나 두 번째 계정은 추가 사용자 정의 필드로 구성될 수 있습니다.
- App Connect 는 다음 Redis 배치를 지원합니다.
- IBM® Redis v6.x v7.x:IBM Cloud Databases for Redis 및 IBM Compose for Redis
중요: v6 아래의Redis 버전은 지원되지 않습니다. - App Connect 다음과 같은 Redis 데이터 구조를 지원하며, 이는 객체로 노출됩니다:
- 해시
- 키
- 목록
- SET
- 정렬된 집합
- 문자열
- App Connect 또한 Redis 명령어의 하위 집합을 지원하며, 이는 액션으로 노출됩니다. 애플리케이션 탭에서 오브젝트 목록을 펼쳐서 지원되는 Redis 명령을 볼 수 있습니다. 예를 들어, 해시에 대해 다음 명령이 지원됩니다.
- HSET 키 필드 값 : 해시 필드의 문자열 값 설정
- HEXISTS 키 필드 : 해시 필드가 존재하는지 확인
- HLEN 키 : 해시 내 필드 수 확인
- HGET 키 필드 : 해시 필드의 값을 가져옵니다
그림 1. 해시에 사용 가능한 Redis 조치 
이벤트와 액션
Redis 이벤트
이러한 이벤트는 플로우에서 조치 완료를 시작하도록 플로우를 트리거하는 이 애플리케이션의 변경사항에 대한 것입니다.
Redis 조치
플로우는 이 애플리케이션에서 이러한 조치를 완료합니다.
| 오브젝트 | 조치 | 설명 |
|---|---|---|
| 해시 | 해시 필드 존재 여부 확인 | 해시에 필드가 존재하는지 여부를 판단합니다 |
| 해시 필드 개수 가져오기 | 해시 내의 필드 수를 반환합니다 | |
| 해시 필드 값 가져오기 | 해시 내 필드의 값을 반환합니다 | |
| 해시 업데이트 또는 생성 | 해시가 존재하면 업데이트하고, 존재하지 않으면 생성합니다 | |
| 키 | 키 존재 여부 확인 | 하나 이상의 키가 존재하는지 여부를 판단합니다 |
| 키 삭제 | 키를 삭제합니다 | |
| 키에서 만료 시간 제한 제거 | 키의 만료 시간을 제거하여 영구 키로 전환합니다 | |
| 키 이름 바꾸기 | 키 이름을 변경하고 대상 위치를 덮어씁니다 | |
| 키의 데이터 유형을 가져오기 | 키에 저장된 값의 유형을 결정합니다 | |
| 키의 유효 기간 조회 | 키의 만료 시간을 초 단위로 반환합니다 | |
| 키의 만료 시점 설정 | 키의 만료 시간을 절대 타임스탬프 Unix (1970년 1월 1일 이후 경과한 초 수)를 사용하여 설정합니다. 과거의 타임스탬프는 키를 즉시 삭제합니다. | |
| 키의 만료 시간 초과 설정 (초/밀리초) | 키에 대한 시간 초과를 설정합니다 (초/밀리초). 타임아웃이 만료되면 키가 자동으로 삭제됩니다. | |
| 목록 | 목록 길이 가져오기 | 목록의 길이를 반환합니다 |
| 정리 목록 | 기존 목록을 지정된 범위의 요소만 포함하도록 잘라냅니다 | |
| 업데이트 목록 | 목록 업데이트 | |
| 목록 업데이트 또는 생성 | 목록이 존재하면 업데이트하고, 존재하지 않으면 목록을 생성합니다 | |
| SET | 세트 멤버 존재 여부 확인 | 회원이 그룹에 속하는지 여부를 결정합니다 |
| 설정된 멤버 수 조회 | 집합의 원소 개수를 반환합니다 | |
| 업데이트 또는 세트 생성 | 세트가 존재하면 업데이트하고, 존재하지 않으면 생성합니다 | |
| 정렬된 집합 | 정렬된 집합의 멤버 수 조회 | 정렬된 집합의 멤버 수를 반환합니다 |
| 점수 범위에 따른 정렬된 집합의 멤버 수 조회 | 정렬된 집합에서 지정된 점수 범위에 속하는 멤버의 개수를 반환합니다 | |
| 정렬된 집합 멤버 순위 조회 | 정렬된 집합에서 점수 오름차순으로 정렬된 멤버의 인덱스를 반환합니다 | |
| 정렬된 집합 멤버 점수 조회 | 정렬된 집합에서 멤버의 점수를 반환합니다 | |
| 정렬된 집합 업데이트 또는 생성 | 정렬된 집합이 존재하면 업데이트하고, 존재하지 않으면 생성합니다 | |
| 문자열 | 문자열에 값 추가하기 | 키의 값에 문자열을 추가합니다. 키가 존재하지 않으면 생성합니다. |
| 문자열의 값을 가져오기 | 키의 문자열 값을 반환합니다 | |
| 문자열 업데이트 또는 생성 | 문자열이 존재하면 업데이트하고, 존재하지 않으면 생성합니다 |
예
템플리트를 사용하여 Redis 에 대한 플로우를 빠르게 작성하십시오.
App Connect 템플리트를 사용하여 Redis에서 조치를 완료하는 플로우를 빠르게 작성하는 방법을 학습합니다. 예를 들어, '발견' 페이지로 이동하여 를 검색하세요 Redis.
