값 형식

정상 동작

값을 UTF-8, JSON, 16진수, MessagePack, Base64, Protobuf 또는 압축 해제된 gzip, zstd, LZ4 형식으로 보고, 키별로 선택한 형식이 기억됩니다.

값 뷰어는 감지된 형식만이 아니라 사용자가 선택한 형식으로 값을 표시할 수 있습니다. 값을 열려면, 값 열기 Redis 키를 오른쪽 클릭한 뒤 값 뷰어에서 열기… 또는 16진수로 보기… 그 결과 셀에, 또는 미리보기 페이로드 Pub/Sub 뷰어에서 볼 수 있고, 다음을 사용합니다 형식 메뉴는 뷰어 도구 모음에 있습니다. 메뉴는 묶음으로 구성됩니다: 일반 보기, 그다음 인코딩, 그다음 압축, 그다음 언어 직렬화기 순입니다. 형식은 표시에 불과합니다: 무엇을 고르더라도 키에 저장된 바이트는 절대 변하지 않습니다.

  • 자동 - 감지된 뷰(JSON, XML, 이미지, 지오메트리, 텍스트)입니다. 어느 것에도 맞지 않으면 Auto가 선행 바이트와 값의 구조를 살펴 gzip, zstd, LZ4, zlib, Java 직렬화, PHP serialize, Base64, 그리고 Protobuf; 발견한 형식은 메뉴 옆에 이름으로 표시됩니다 ("자동: gzip → JSON (1,234 → 5,678 바이트)"). 구조 감지는 의도적으로 보수적입니다: 값 전체가 파싱되어야 하고, Base64 추정은 16자 이상이며 디코딩한 바이트를 읽을 수 있는 값에만 시도합니다. 따라서 평범한 단어, 16진수 ID, 다음과 같은 키 이름은 user:42 텍스트로 유지됩니다.
  • UTF-8 - 바이트를 텍스트로 보여 줍니다. 잘못된 UTF-8은 대체 문자로 표시되고 그렇다는 주석도 붙습니다.
  • JSON - 트리 뷰로 예쁘게 출력; 유효한 JSON이 아닌 값은 원본 텍스트를 유지하며 주석이 붙습니다.
  • YAML - 하이라이트되고, JSON 트리가 주는 것과 똑같이 검색 가능한 트리로 보여 줍니다. YAML 매핑이나 리스트가 아닌 값은 원문 그대로 두고 주석을 붙입니다.
  • 마크다운 - Raw 모드에서는 하이라이트가 적용되고, 제목·목록·표·코드 블록·링크로 그려지는 쪽은 미리보기 모드.
  • Hex - 표준 헥스 덤프입니다.
  • MessagePack - 트리와 하이라이터를 위해 JSON으로 디코딩됩니다. 이진 필드는 {"$binary": "<hex>"}, 표준 타임스탬프는 {"$timestamp": "2023-11-14T22:13:20Z"}로 표시되며, 다른 확장 값은 {"$ext": {"type": n, "data": "<hex>"}}, 그리고 키가 JSON 객체 키끼리 충돌하는 맵(정수 1 문자열 옆의 "1", 또는 중복 키)도 다음으로 {"$map": [[key, value], …]} 그래서 항목이 하나도 빠지지 않습니다. 유효한 MessagePack이 아닌 페이로드는 디코더의 사유와 함께 헥스 덤프로 표시됩니다.
  • Base64 - 표준이든 URL-safe든, 패딩이 있든 없든, 줄바꿈은 무시합니다. 디코딩된 바이트는 본모습 그대로 보여 줍니다. JSON이나 XML 트리, 텍스트, 알아본 직렬화 형식, 또는 헥스 덤프입니다.
  • Protobuf - 프로토콜 버퍼 메시지는 스키마 없이도 훑을 수 있어 어떤 메시지든 검사할 수 있습니다. 필드 번호는 키가 되고, varint는 숫자로 보이며, 고정 폭 필드는 정수 값과 부동소수점 값이 둘 다 보입니다({"$fixed64": …, "$double": …}), 길이로 구분되는 필드는 텍스트로 읽히면 텍스트로, 하나의 메시지로 훑히면 중첩 메시지로, 그 외에는 {"$bytes": "<hex>"} 그 외의 경우입니다. 반복 필드는 배열이 됩니다. 필드 이름에는 메시지의 스키마가 필요하니 다음을 등록하세요 .proto 파일로 다음 아래에 저장합니다 설정 › 결과 › Protobuf 스키마 (아래 참조).
  • gzip - zstd, LZ4, deflate, 값을 압축 해제해 그 안에 담긴 내용 그대로 보여줍니다(JSON과 XML은 트리로, PHP, Java, pickle, Protobuf 페이로드는 디코딩 결과로, 텍스트는 텍스트로, 그 외에는 헥스 덤프로), 크기 전후가 적힌 노트가 함께 붙습니다. 한 번에 한 겹만 풀립니다: 압축 스트림 안의 압축 스트림은 다시 풀지 않고 노트에 이름만 적힙니다. LZ4는 프레임 형식과 원본 크기가 앞에 붙은 raw 블록을 모두 받고, deflate는 zlib으로 감싼 스트림과 raw 스트림을 모두 받습니다. zstd는 SQLly 브라우저 에디션에서는 쓸 수 없고 메뉴에도 그렇게 표시됩니다.
  • PHP 직렬화 - serialize() 출력은 JSON으로 디코딩됩니다: 리스트는 배열이 되고, 그 외의 배열은 객체가 되며, 객체는 {"$class": "Name", "$properties": {…}} protected 및 private 속성 이름을 표기하여 protected:name 그리고 private:Class:name, 참조 {"$ref": n}, 그리고 UTF-8이 아닌 문자열 {"$bytes": "<hex>"}.
  • Java 직렬화 - 하나의 ObjectOutputStream 페이로드는 헤더로 식별해 요약합니다. 스트림 버전, 담고 있는 클래스들과 각각의 serialVersionUID, 그리고 그 안의 문자열입니다. 필드 값은 디코딩하지 않습니다; 그러려면 클래스 그 자체가 필요합니다.
  • Python pickle - 프로토콜 2 이상의 피클은 헤더로 인식해 요약합니다: 프로토콜, 오피코드별 개수, 전역 값(module.name)가 참조하는 것, 문자열 샘플, 깔끔하게 끝나는지 여부입니다. 객체는 절대 재구성하지 않습니다 — 그건 피클에 담긴 명령을 실행하는 일이 되니까요.

모든 디코더는 값을 신뢰할 수 없는 입력으로 다룹니다. 압축 해제 출력은 16 MB로 제한되고, gzip 트레일러, zstd 프레임 헤더, LZ4 블록 접두사가 이미 그보다 크다고 선언하면 압축 해제를 시작하기 전에 거부합니다. 잘리거나 깨진 스트림은 부분 출력으로 보여 주지 않고, 디코더의 사유와 함께 디코딩 불가로 보고합니다. Protobuf와 PHP의 중첩은 128단계에서 멈추고, 값 안의 모든 길이는 실제 있는 바이트와 대조하며, 모든 바이트를 설명하지 못하는 워커는 값 전체를 거부합니다.

사용자 정의 스키마를 이용한 Protobuf

아래에 설정 › 결과 › Protobuf 스키마, .proto 파일 추가… 다음을 하나 이상 등록합니다 .proto 파일(각 파일의 폴더는 그 파일의 import이 조회되고, 표준 google/protobuf/* 타입이 내장되어 있습니다), 그리고 디스크립터 세트 추가… 는 다음으로 만든 컴파일된 세트를 등록합니다 protoc --descriptor_set_out. 각 스키마는 메시지 유형과 함께 나열되고, 읽을 수 없을 때는 컴파일러가 알려 주는 이유가 표시됩니다; 다시 불러오기 파일을 변경한 후 다시 읽고, 제거 파일을 건드리지 않고 하나를 등록 해제합니다.

스키마가 등록되어 있으면 Protobuf로 표시되는 값에 메시지 메뉴가 Format 메뉴 옆에 있습니다. 메시지 유형을 고르면 값이 실제 필드 이름으로 디코딩됩니다 - 중첩 메시지, 이름으로 표기한 열거형, 배열로 표기한 반복 필드, 숫자로 표기한 64비트 수 - JSON 트리에 담깁니다. 값이 갖고 있지만 메시지가 정의하지 않은 필드는 노트에 번호로 나열됩니다. 값이 메시지에 전혀 맞지 않거나(필드의 와이어 타입이 틀렸거나 값의 필드 중 어느 것도 메시지에 속하지 않을 때), 스키마가 이미 삭제되었다면 뷰어는 스키마 없는 필드 번호 보기로 돌아가 이유를 알려 줍니다. 메시지 유형은 형식처럼 기억됩니다: 재시작 사이에도 Redis 키별로 유지됩니다( protobuf-schemas.json SQLly 데이터 디렉터리)에 저장하면 세션의 다른 셀에도 적용됩니다. 브라우저 버전은 스키마 파일을 읽을 수 없으므로 Protobuf 값을 항상 필드 번호로 표시합니다.

압축된 값 편집

압축되어 저장된 값 - gzip, zlib, raw deflate, zstd, LZ4(프레임 또는 크기 접두 블록), 또는 MySQL COMPRESS() 출력은 내부의 텍스트처럼 편집할 수 있고, 정확히 같은 방식으로 다시 압축되어 저장되므로 이를 읽는 쪽은 계속 동작합니다:

  • 결과 그리드. 뷰어에서 압축된 바이너리 셀 열기(16진수로 보기… 또는 구조화된 데이터 뷰어 열기). 뷰가 압축 해제된 값일 때, 편집 는 텍스트를 엽니다; gzip으로 스테이징 (또는 읽을 때의 패키징 형식 그대로) 다시 압축하고 해당 셀에 대기 중인 변경으로 스테이징하며, 다른 그리드 편집과 마찬가지로 검토하고 저장합니다.
  • Redis 키 뷰. 압축된 문자열, 해시 필드, 리스트 요소의 편집은 압축을 푼 텍스트에서 시작하며 다음 형식으로 재압축해 저장… 선택되어 있으면 검토용 명령이 재압축한 바이트를 기록합니다. 선택을 해제하면 입력한 텍스트 그대로 저장됩니다.

패키징은 정확히 맞춥니다(zlib 헤더는 zlib 헤더로 남고, MySQL의 4바이트 길이 접두사는 새 길이에 맞게 다시 씁니다). 그리고 무엇을 적용하기 전에 다시 압축한 바이트가 원래 텍스트로 풀리는지 확인합니다. 패키징을 특정할 수 없거나 내용이 텍스트가 아니라 바이너리인 값은 편집 대상으로 제공하지 않습니다.

바이너리 셀에도 셀 세부 정보 패널의 16진수 보기와 열리는 뷰어에서 모두 볼 수 있으므로, 어떤 바이너리 열의 MessagePack 값이든 같은 방식으로 디코딩할 수 있습니다.

MessagePack 디코더는 페이로드를 신뢰할 수 없는 것으로 간주합니다. 데이터에 적힌 길이는 실제 존재하는 바이트와 대조해 검사하므로, 잘렸거나 악의적인 페이로드는 메모리를 소진시키지 않고 디코딩 불가로 보고되며, 128단계를 초과하는 중첩은 거부됩니다.

Redis 키를 읽을 때(GET, HGETALL, LRANGE, JSON.GET…)를 결과 셀에서 열면 그 선택은 해당 연결, 데이터베이스, 키, 열별로 기억되고 SQLly를 다시 시작해도 유지됩니다. 어떤 탭이나 행에서 보더라도 키 값은 선택한 형식으로 표시됩니다. 이 선택 사항은 value-formats.json SQLly 데이터 폴더에 있으며, 최근에 고른 2,000개의 키를 담고 오래된 것부터 잊어 버립니다. 파일에는 버전 번호가 있고, 이 버전이 모르는 형식 이름은 새 SQLly가 적었더라도 파일을 거부하지 않고 Auto로 읽습니다. 파일을 읽을 수 없으면 SQLly는 그 파일을 그대로 두고 뷰어 도구 모음 아래에 그 사실을 알리며, 새로 고른 설정은 이 세션에서만 유지합니다. 다른 결과 셀은 SQLly를 끝낼 때까지 그 쿼리, 행, 열에 대한 선택을 기억합니다. Auto를 고르면 잊어 버립니다. 1MB가 넘는 값은 감지된 보기만 유지합니다.

SQLly
값 뷰어 형식 선택기: MessagePack으로 인코딩된 Redis 값을 JSON 트리로 디코딩합니다.
값 뷰어 형식 선택기: MessagePack으로 인코딩된 Redis 값을 JSON 트리로 디코딩합니다.