# 명령 정책 `src/adapter/outbound/redis-sdk/src/main/resources/redis-sdk/redis-command-policy.yml`이 이 SDK가 Redis 명령마다 무엇을 해도 되는지 정하는 유일한 정본이다. 명령이 *무엇인지*는 공식 서버 metadata가 정하고, 무엇을 허락할지는 이 파일이 정한다. 거기에 분류되지 않은 명령은 거부한다. 그래서 명령을 더하는 것은 코드를 쓰는 일이 아니라 그 파일을 고치는 일이고, 위험 판단을 내리고 검토하는 곳이 그 수정이다. ## 필드 | 필드 | 기본값 | 뜻 | | --- | --- | --- | | `risk` | 필수 | `R1` 일상, `R2` 명시적 허가 필요, `R3` 관리, `R4` 절대 허락 안 함 | | `support` | 필수 | `TYPED`, `ADVANCED_TYPED`, `RAW_ONLY`, `ADMIN_ONLY`, `VERSION_GATED`, `BLOCKED` | | `minimum-version` | `7.2` | 그 명령이 있는 가장 낮은 서버 버전 | | `access` | `support`에서 정함 | 어느 ACL 계정이 보낼 수 있는지 | | `blocking` | `false` | 서버가 답할 때까지 connection을 잡는다 | | `optional-block` | `false` | 그 명령에 blocking 아닌 형태도 있다. `XREAD`와 `XREADGROUP`만 가진다 | | `read-only` | `false` | 데이터를 절대 바꾸지 않는다 | | `retry-safe` | `read-only` | 서버에 닿았을 수 있는 실패 뒤에도 재시도해도 된다 | | `may-be-ambiguous` | `!read-only` | 실패가 결과를 모르는 상태로 남길 수 있다 | | `timeout-profile` | 정함 | `FAST`, `COLLECTION`, `ADMIN`, `BLOCKING` | | `key-spec` | `1 1 1` | key가 있는 곳. 또는 `none`, `movable` | | `required-policy` | – | R2 명령이 요구하는 허가 정책 | ## 목록이 강제하는 규칙 - R2 `ADVANCED_TYPED` 명령은 요구하는 허가 정책의 이름을 대야 한다. 발급한 허가 없이 누구나 보낼 수 있는 R2 명령은 없다. - R4 명령은 `BLOCKED`여야 하고, R3 명령은 `ADMIN_ONLY`여야 한다. 그 밖의 조합은 불러올 때 타입 체계가 거부한다. - `BLOCKED` 명령에는 ACL 계정이 없다. 그래서 SDK의 어떤 경로도 그것에 닿을 수 없다. - blocking 명령은 `BLOCKING` timeout profile을 써야 하고, 그 요청은 상한 있는 서버 block을 선언해야 한다. `optional-block`도 선언하면 예외인데, stream 읽기 둘만 그렇다. - 폐기된 명령 이름은 SDK가 그 동작을 제공하더라도 `BLOCKED`로 남는다. 타입 있는 sorted-set 범위 조회는 `ZRANGEBYSCORE`가 아니라 `ZRANGE ... BYSCORE|BYLEX|REV`를 보낸다. 그래서 guard가 들은 명령과 wire에 닿는 명령이 같다. ## 지원 등급마다 닿는 곳 | 지원 | 닿는 곳 | | --- | --- | | `TYPED` | 타입 있는 연산, 허가 없이 | | `ADVANCED_TYPED` | 타입 있는 연산, 이름 댄 허가와 함께 | | `VERSION_GATED` | probe가 그 기능을 찾았을 때만 있는 capability bean | | `RAW_ONLY` | `sdk.raw`, 그리고 배포가 등록한 승인이 있을 때만 | | `ADMIN_ONLY` | `sdk.admin`, 읽기 전용 진단만 | | `BLOCKED` | 어디에도 없음 |