Redis Cluster

정상 동작

Redis 클러스터, ElastiCache 클러스터 모드, MemoryDB: 슬롯 라우팅, 접근할 수 없는 노드 주소용 노드 맵, 노드별 SSH 포워딩, 그리고 토폴로지.

SQLLY는 Redis Cluster, 자체 호스팅 클러스터, 클러스터 모드의 Amazon ElastiCache, Amazon MemoryDB에 연결하며, 모든 명령을 키의 해시 슬롯을 소유한 노드로 라우팅합니다. 클러스터가 슬롯을 옮길 때(페일오버 또는 리샤딩) 클라이언트는 다음을 따라갑니다 MOVED 또는 ASK 응답하고, 슬롯 맵을 업데이트하며, 스크립트가 본 리디렉션 수를 알려줍니다. 키 브라우저, 메모리 분석기, 대량 작업, 프로파일러 및 Pub/Sub 뷰어는 모두 모든 마스터에서 작동합니다.

연결 중

평소처럼 Redis 연결을 만드세요. 다음에서 서버 여러 시드 노드를 쉼표로 구분하여 나열할 수 있습니다 (10.0.0.1:7000, 10.0.0.2:7001); 포트가 없는 항목은 다음을 사용합니다 포트 필드. 다음과 같은 URL을 붙여넣으면 redis://user:[email protected]:7000,10.0.0.2:7001 모든 호스트가 그대로 유지됩니다. 다음의 클러스터 모드 선택:

  • 자동으로 감지 (기본값) - 첫 번째 연결에서 서버에 묻습니다 INFO cluster 그리고 앱을 끝낼 때까지 그 답을 기억하니, 서버 하나는 세션당 한 번의 추가 확인만 감당하면 되고 그 외에는 아무것도 바뀌지 않습니다.
  • 단일 서버 - 서버가 클러스터 노드여도 슬롯 기준으로 라우팅하지 않습니다.
  • Redis Cluster - 항상 슬롯으로 라우팅합니다.

클러스터에는 하나의 논리적 데이터베이스가 있으므로 데이터베이스 비워 두거나 0으로 설정하세요. ElastiCache의 경우 클러스터의 구성 엔드포인트를 가리키도록 연결을 설정하고, MemoryDB는 항상 클러스터입니다.

노드 맵: 노드가 알리는 주소로 접속할 수 없을 때

클러스터 노드는 자신이 알리도록 구성된 주소를 이용해 클라이언트에게 다른 노드의 위치를 알려 줍니다. NAT, Docker 포트 매핑 또는 SSH 배스천 뒤에서는 이 주소가 이 머신이 닿을 수 없는 사설 주소인 경우가 많습니다. 클러스터 노드 맵 필드가 이를 다시 매핑합니다. 한 줄에 advertised host:port => dial host:port 예를 들어 한 줄에 하나씩 10.0.0.5:7001 => 127.0.0.1:17001. 광고된 주소는 노드를 계속 지정합니다(슬롯 맵, 리디렉션 및 TLS 서버 이름에서); 소켓만 다이얼 주소로 이동합니다.

SSH 터널과 프록시는 모든 노드에 도달합니다. SSH 홉이나 SOCKS/HTTP 프록시가 있는 연결에서는 SQLLY가 클러스터가 알려주는 각 노드에 대해 같은 홉을 거치는 별도의 로컬 포워드를 열므로, 배스천을 통해서만 도달할 수 있는 노드 주소도 여전히 작동합니다. 노드 맵이 먼저 적용되므로 배스천이 접속하는 대상도 재작성할 수 있습니다. Kubernetes 포트 포워드는 서비스 포트 하나만 전달하므로 시드 노드에만 도달할 수 있고, 릴레이 브리지를 통한 연결은 아직 클러스터 모드를 지원하지 않습니다.

클러스터에서 에디터가 허용하지 않는 것

각 명령은 전송되기 전에 거부되며, 어떤 규칙 위반인지 알려 주는 메시지가 함께 표시됩니다:

  • 슬롯 간 다중 키 명령 - MGET, MSET, DEL 여러 키와 함께, SUNION, RENAME, EVAL 여러 키를 다루는 작업 등은 모든 키가 같은 슬롯에 매핑될 때만 실행됩니다. 관련된 키에는 공통 해시 태그를 붙여 주세요: user:{42}:profile 그리고 user:{42}:cart 슬롯을 공유합니다.
  • SELECT 에 0이 아닌 값을 넘기기 - 클러스터에는 논리 데이터베이스가 하나입니다.
  • KEYS 그리고 SCAN - KEYS 모든 마스터를 차단하며, 그리고 SCAN 커서는 하나의 노드에 속합니다. 키 브라우저를 사용하거나, SQLLY.KEYS pattern [limit [cursor]], 모든 마스터를 페이지 단위로 훑으면서 페이지를 넘어 이어지는 커서를 반환합니다.
  • MULTI / EXEC - 각 명령은 독립적으로 라우팅되기 때문에 트랜잭션은 에디터에서 하나의 노드에 머물 수 없습니다.

선택한 노드에서 명령 실행

줄 앞에 SQLLY.ON 키를 소유한 노드 대신 선택한 노드로 보내는 대상입니다. 대상은 masters, replicas, all, 노드의 host:port 클러스터 토폴로지 뷰에 표시되는 형태이거나, 그런 값을 쉼표로 구분해 여러 개 쓴 것입니다:

  • SQLLY.ON masters DBSIZE - 마스터마다 한 행씩, 키 개수와 함께.
  • SQLLY.ON masters FLUSHALL - 모든 마스터를 비웁니다(복제본이 뒤따릅니다).
  • SQLLY.ON 10.0.0.4:7003 INFO replication - 복제본 하나의 자체 응답입니다.
  • SQLLY.ON replicas DBSIZE - 모든 복제본이 마스터와 같은 수의 키를 갖고 있는지 확인합니다.

이 줄은 각 노드에서 입력한 그대로 실행되며, 이는 redis-cli 가 다음 옵션 없이 -c: 리디렉션을 따르지 않으므로, 키를 소유하지 않은 노드가 다음과 같이 답합니다 MOVED, 그리고 위에서 거부된 명령(KEYS, SCAN) 선택한 노드에서 실행됩니다. 복제본은 다음으로 전환됩니다 READONLY 먼저 읽어 키 읽기를 맡깁니다. 여러 노드가 하나의 그리드에서 함께 답하며 노드 그리고 역할 열로 답하고, 오류로 답한 노드는 자기 행이 하나 생깁니다; 명령이 어디에서도 실행되기 전에 모든 노드에 연결하므로, 접근할 수 없는 노드가 있으면 어떤 노드도 실행하기 전에 줄이 멈춥니다. 이 접두사는 안전성을 바꾸지 않습니다: 읽기 전용 연결은 여전히 SQLLY.ON masters FLUSHALL, 그리고 쓰기와 파괴적인 명령은 여전히 확인을 요구합니다. 클러스터 토폴로지 뷰에서 노드를 선택하고 노드에서 쿼리 를 눌러 해당 노드의 라인으로 시작하는 쿼리 탭을 엽니다.

클라이언트가 스크립트가 도는 동안 리디렉션을 따라갔다면 메시지 창에 그 횟수를 표시합니다(예: 장애 조치 직후). 클러스터가 슬롯을 옮긴 직후라면 정상입니다. 리디렉션이 계속 이어지면 리샤딩이 진행 중이라는 뜻입니다.

클러스터 전체 도구

  • Key browser - 평소 예산 안에서 각 마스터의 키를 차례로 훑습니다. 일찍 멈추면 노트 행에 몇 개의 마스터에서 얼마나 스캔했는지 표시되고 더 스캔하기 중단했던 노드에서 이어서 실행됩니다.
  • 메모리 분석기 - 샘플은 각 마스터의 키 수에 비례하여 나뉘며, 총합은 모든 마스터에서 합산됩니다.
  • 일괄 삭제 - 일치하는 키는 해시 슬롯별로 그룹화되어 각 UNLINK 배치가 하나의 슬롯 안에 유지됩니다.
  • 프로파일러 - 모든 마스터에서 동시에 MONITOR 을 모든 마스터에서 동시에 실행하고 스트림을 하나의 테이블로 합치며, 이때 노드 열.
  • Pub/Sub 뷰어 - 키스페이스 알림은 모든 마스터에서 구독하고(노드 단위 성격이라), 일반 채널과 패턴은 한 마스터에서 구독합니다(클러스터가 PUBLISH 전체에 전달됨), 그리고 샤드 채널 - 입력할 때 접두사 #, 예를 들면 다음과 같습니다 #orders - 채널을 소유한 마스터에서 구독합니다. 행에는 노드 열이 표시됩니다. 샤딩된 채널은 독립 실행형 Redis 7 서버에서도 작동합니다.

클러스터 토폴로지

Redis 데이터베이스를 마우스 오른쪽 버튼으로 클릭하고 도구 › 클러스터 토폴로지…, 다음을 실행하거나 Redis 클러스터 토폴로지… 명령 팔레트에서 하거나, 클러스터 연결의 서버 대시보드에 있는 링크로 열 수 있습니다. 창에는 다음에서 온 모든 노드가 나열됩니다 CLUSTER SHARDS (또는 CLUSTER NODES 7.0 이전 서버에서는) 다음 항목들이 포함됩니다: ID, 역할, 광고하는 주소, SQLLY가 해당 노드에 연결할 주소, 공지된 호스트명과 클라이언트가 보내는 TLS 서버 이름, 슬롯, 상태, 복제 오프셋 및 링크 상태. 하단에서는 마스터와 복제본 수를 계산하고, 모든 16,384 슬롯이 포함되었는지 확인하며, 건강하지 않거나 광고하는 주소와 다른 주소로 연결된 노드를 표시합니다.

트레이스 각 노드에 대해 Test Connection과 같은 단계별 검사를 실행합니다 - 이름 조회, (노드 맵을 쓰는) 터널 또는 프록시, TCP, TLS(노드가 알린 주소 기준으로 검사), 로그인, 프로토콜과 핑, 데이터베이스, 그리고 CLUSTER INFO - 단계마다 한 행씩 기록되므로, 처음 실패한 행이 무엇을 고쳐야 하는지 알려 줍니다. 잘못된 노드 맵 항목, 막힌 포트, TLS 이름 불일치, ACL 문제, 건강한 클러스터를 보고하지 않는 노드 중 하나입니다. 두 보고서 모두 다음으로도 제공됩니다: SQLLY.TOPOLOGY 그리고 SQLLY.TRACE 쿼리 탭에서 실행할 수 있고, 읽기만 합니다.