기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

JSON 데이터 형식 개요

MemoryDB는 JSON 데이터 유형 작업을 위한 여러 Valkey 및 Redis OSS 명령을 지원합니다. 다음은 JSON 데이터 형식의 개요와 지원되는 명령의 세부 목록입니다.

용어

지원되는 JSON 표준

JSON 형식은 RFC 7159 및 ECMA-404 JSON 데이터 교환 표준을 준수합니다. UTF-8 JSON 텍스트의 유니코드가 지원됩니다.

루트 요소

루트 요소는 모든 JSON 데이터 유형일 수 있습니다. 이전 RFC 4627에서는 객체 또는 배열만 루트 값으로 허용되었습니다. RFC 7159로 업데이트한 이후 JSON 문서의 루트는 모든 JSON 데이터 형식일 수 있습니다.

문서 크기 제한

JSON 문서는 빠른 액세스 및 수정에 최적화된 형식으로 내부적으로 저장됩니다. 이 형식은 일반적으로 동일한 문서의 동등하게 직렬화된 표현보다 어느 정도 더 많은 메모리를 소비하게 됩니다. 단일 JSON 문서의 메모리 사용량은 JSON 문자열이 아닌 인 메모리 데이터 구조의 크기인 64MB 로 제한됩니다. JSON 문서에서 사용하는 메모리의 양은 JSON.DEBUG MEMORY 명령을 사용하여 검사할 수 있습니다.

JSON ACLs

중첩 깊이 제한

JSON 객체 또는 배열에 자체적으로 다른 JSON 객체 또는 배열인 요소가 있는 경우 해당 내부 객체 또는 배열은 외부 객체 또는 배열 내에 “중첩”된다고 합니다. 최대 중첩 깊이 제한은 128입니다. 중첩 깊이가 128보다 큰 문서를 만들려는 시도는 오류와 함께 거부됩니다.

명령 구문

대부분의 명령에는 첫 번째 인수로 Valkey 또는 Redis OSS 키 이름이 필요합니다. 일부 명령에는 path 인수도 있습니다. path 인수가 선택 사항이며 제공되지 않는 경우, 기본 루트로 설정됩니다.

표기법:

경로 구문

JSON for Valkey 및 Redis는 두 가지 종류의 경로 구문을 OSS 지원합니다.

쿼리 경로가 '$'로 시작하는 경우 향상된 구문을 사용합니다. 그렇지 않으면 제한된 구문이 사용됩니다.

향상된 구문

예

아래 예제는 Goessner의 예제 XML 데이터를 기반으로 하며, 추가 필드를 추가하여 수정했습니다.

{ "store": {
    "book": [ 
      { "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "price": 8.95,
        "in-stock": true,
        "sold": true
      },
      { "category": "fiction",
        "author": "Evelyn Waugh",
        "title": "Sword of Honour",
        "price": 12.99,
        "in-stock": false,
        "sold": true
      },
      { "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "isbn": "0-553-21311-3",
        "price": 8.99,
        "in-stock": true,
        "sold": false
      },
      { "category": "fiction",
        "author": "J. R. R. Tolkien",
        "title": "The Lord of the Rings",
        "isbn": "0-395-19395-8",
        "price": 22.99,
        "in-stock": false,
        "sold": false
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95,
      "in-stock": true,
      "sold": false
    }
  }
}

추가 필터 표현식의 예:

127.0.0.1:6379> JSON.SET k1 . '{"books": [{"price":5,"sold":true,"in-stock":true,"title":"foo"}, {"price":15,"sold":false,"title":"abc"}]}'
OK
127.0.0.1:6379> JSON.GET k1 $.books[?(@.price>1&&@.price<20&&@.in-stock)]
"[{\"price\":5,\"sold\":true,\"in-stock\":true,\"title\":\"foo\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?(@.price>1 && @.price<20 && @.in-stock)]'
"[{\"price\":5,\"sold\":true,\"in-stock\":true,\"title\":\"foo\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?((@.price>1 && @.price<20) && (@.sold==false))]'
"[{\"price\":15,\"sold\":false,\"title\":\"abc\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?(@.title == "abc")]'
[{"price":15,"sold":false,"title":"abc"}]

127.0.0.1:6379> JSON.SET k2 . '[1,2,3,4,5]'
127.0.0.1:6379> JSON.GET k2 $.*.[?(@>2)]
"[3,4,5]"
127.0.0.1:6379> JSON.GET k2 '$.*.[?(@ > 2)]'
"[3,4,5]"

127.0.0.1:6379> JSON.SET k3 . '[true,false,true,false,null,1,2,3,4]'
OK
127.0.0.1:6379> JSON.GET k3 $.*.[?(@==true)]
"[true,true]"
127.0.0.1:6379> JSON.GET k3 '$.*.[?(@ == true)]'
"[true,true]"
127.0.0.1:6379> JSON.GET k3 $.*.[?(@>1)]
"[2,3,4]"
127.0.0.1:6379> JSON.GET k3 '$.*.[?(@ > 1)]'
"[2,3,4]"

제한된 구문(Restricted syntax)

예제

일반적인 오류 접두사

각 오류 메시지에는 접두사가 있습니다. 다음은 일반적인 오류 접두사 목록입니다.

JSON 관련 지표

다음 JSON 정보 지표가 제공됩니다.

핵심 지표를 쿼리하려면 다음 명령을 실행합니다.

info json_core_metrics

MemoryDB와 상호 작용하는 방법 JSON

다음은 MemoryDB가 JSON 데이터 유형과 상호 작용하는 방식을 보여줍니다.

연산자 우선순위

필터링에 대한 조건식을 평가하는 경우 &&s가 먼저 평가되고 그 다음 ||s가 평가되는데, 이는 대부분의 언어에서 일반적으로 사용됩니다. 괄호 안의 작업이 먼저 실행됩니다.

최대 경로 중첩 제한 동작

MemoryDB의 최대 경로 중첩 제한은 128입니다. 따라서 $.a.b.c.d...와 같은 값은 128수준까지만 도달할 수 있습니다.

숫자 값 처리

JSON 에는 정수 및 부동 소수점 번호에 대한 별도의 데이터 유형이 없습니다. 모두 숫자라고 부릅니다.

JSON 번호가 수신되면 두 가지 형식 중 하나로 저장됩니다. 숫자가 64비트 부호 있는 정수에 맞으면 해당 형식으로 변환되고 그렇지 않으면 문자열로 저장됩니다. 두 개의 JSON 숫자(예: JSON.NUMINCRBY 및 .JSONNUMMULTBY)에 대한 산술 작업은 가능한 한 정밀도를 유지하려고 시도합니다. 두 피연산자와 결과 값이 부호 있는 64비트 정수에 맞으면 정수 산술이 수행됩니다. 그렇지 않으면 입력 피연산자가 64비트 IEEE 이중 정밀도 부동 소수점 번호로 변환되고 산술 연산이 수행되며 결과가 문자열로 다시 변환됩니다.

산술 명령어 NUMINCRBY과 NUMMULTBY:

사용할 수 있는 명령의 자세한 목록은 지원되는 명령 섹션을 참조하세요.

엄격한 구문 평가

MemoryDB는 경로의 하위 집합에 유효한 JSON 경로가 포함되어 있더라도 잘못된 구문이 있는 경로를 허용하지 않습니다. 이는 고객에게 올바른 행동을 유지하는 것과 같습니다.