조직 유형 바이너리 옵션

드라이버에는 BSON 문서를 나타내는 데 사용되는 여러 클래스와 인터페이스가 포함되어 있습니다. 일반적으로 고급 드라이버 API를 사용하지 않아도되지만 BsonDocument 클래스는 문서가 드라이버에서 내부적으로 관리되는 방식의 핵심입니다. BsonDocument 클래스는 동적으로 구조화 된 임의의 복잡성이있는 문서 (형식이 안전한 API 사용) 예를 들어 문서는 다음과 같이 BsonDocument로 생성 될 수 있습니다. 유형 안전성은 Map String, BsonValue를 구현하는 BsonDocument에서 비롯되므로 int String 및 List와 같은 기본 제공 유형도 포함해야합니다. BsonValue의 하위 클래스에서 BsonValue 하위 유형의 전체 목록을 보려면 BsonValue API 문서를 참조하십시오. 대부분의 응용 프로그램은 BsonDocument와 마찬가지로 Document 클래스를 사용하지만 문서 클래스는 복잡성이있는 동적으로 구조화 된 문서를 나타낼 수 있습니다. 문서가 Map String, Object를 구현할 때 훨씬 느슨해 짐 결과로 위와 같은 문서는 D ocument 클래스는 다음과 같이 작성할 수 있습니다. 작성할 코드가 적지 만, 실수로 지원되지 않는 값 유형의 인스턴스를 추가하면 런타임 오류가 발생할 수 있습니다. 가장 일반적으로 사용되는 값 유형은 다음과 같습니다. 실제로 이러한 매핑을 변경하는 메커니즘이 가능합니다 새 응용 프로그램에는 권장되지 않지만 2 x 드라이버 시리즈에서 업그레이드하는 경우 DBObject 인터페이스를 사용하여 BSON 문서를 계속 사용할 수 있습니다. DBObject는 BSON 값을 Object로 나타내지 만 문서와 비슷하지만 그것을 극복하기가 불가능한 몇 가지 결점이있었습니다. 그것은 클래스가 아닌 인터페이스이기 때문에 API는 바이너리 호환성을 손상시키지 않고 확장 될 수 없습니다. 실제로 Map String, Object를 구현하지 않습니다. 인터페이스이기 때문에 별도의 구체적인 클래스 이 인터페이스를 구현하는 BasicDBObject라는 이름이 필요합니다. 이 모든 것을 하나로 묶기 위해 드라이버에는 Bson이라고하는 작지만 강력한 인터페이스 인 Bson Any 클래스가 포함되어 있습니다. 이 클래스는 B 드라이버 자체 또는 제 3 자에 포함 된 SON 문서는이 인터페이스를 구현할 수 있으며 BSON 문서가 필요한 상위 API의 모든 위치에서 사용할 수 있습니다. 위에서 설명한 세 클래스는 모두이 인터페이스를 구현하므로 주어진 응용 프로그램의 필요에 따라 서로 바꿔서 사용할 수 있습니다. 예를 들어. Readers 및 Writers. jsonutil BSON 문서를 사용하여 Python s json 모듈을 사용하는 도구. BSON 문서를 사용하여 Python s json 모듈을 사용하기위한 도구. 이 모듈은 두 가지 도우미 메서드 네이티브 json 메서드를 랩핑하고 json과 명시적인 BSON 변환을 제공합니다. 이렇게하면 BSON 문서를 MongoDB Extended JSON으로 특수 인코딩 및 디코딩 할 수 있습니다. ■ 엄격 모드 이렇게하면 특수 BSON 유형을 사용하는 경우에도 BSON 문서를 JSON으로 디코딩 할 수 있습니다. 사용 serialization. Example 사용 deserialization. Alternatively, 수동으로 기본값을 전달할 수 있습니다 그것은 이진 및 코드 인스턴스를 처리 할 때 그들은 확장됩니다 문자열은 사용자 정의 기본값을 제공 할 수는 없지만 재귀가 적어지면 빠를 것입니다. 응용 프로그램이 JSONOptions에서 제공하는 유연성을 필요로하지 않고 jsonutil 모듈에서 많은 시간을 소비하는 경우 python-bsonjs에서 멋진 성능 개선 python-bsonjs는 MongoDB에 대한 빠른 BSON입니다. libbson 위에 빌드 된 Python 용 JSON 변환기 python-bsonjs는 버전 2에서 RawBSONDocument. Changed를 사용할 때 PyMongo와 가장 잘 작동합니다. 8 Timestamp의 출력 형식이 다음과 같이 변경되었습니다. Timestamp의 인스턴스로 디코드됩니다. 이전 형식은 이전과 같이 파이썬 사전에 계속 디코드됩니다. 이전 형식의 인코딩은 올바르지 않고 형식 정보가 손실되어 더 이상 지원되지 않습니다. numberLong 및 undefined에 대한 지원이 추가되었습니다. - MongoDB 2의 새로운 기능 6 - ISO-8601 형식의 날짜 구문 분석. 버전 2에서 변경됨 7 SON, Timestamp, Code, Binary 및 DBRef 인스턴스를 렌더링 할 때 순서를 유지함. 버전 2에서 변경됨 3 추가 덤프 및 loa ds 헬퍼가 json과의 변환을 자동으로 처리하고 Binary 및 Code. class를 지원합니다. DatetimeRepresentation LEGACY 0.Legacy MongoDB JSON datetime 표현을 확장합니다. 인스턴스는 JSON 형식으로 인코딩됩니다. 여기서 dateAsMilliseconds는 Unix epoch UTC 이후의 밀리 초 수를 제공하는 64 비트 부호있는 정수입니다. PyMongo 버전 3 이전의 기본 인코딩이었습니다. 4. 버전 3의 새로운 기능 4. NumberLong datetime 표현. 인스턴스는 JSON 형식으로 인코딩됩니다. 여기서 dateAsMilliseconds는 버전 3의 4.ISO-8601 datetime 표현에서 Unix epoch UTC. New 이후의 밀리 초 수를 제공하는 64 비트 부호있는 정수의 문자열 표현입니다. Unix 신기원 UTC보다 크거나 같은 인스턴스는 유닉스 신기원 UTC가 datetime 표현이 버전 3의 NUMBERLONG. New 인 것처럼 인코딩되기 전에 형식 인스턴스의 JSON으로 인코딩됩니다. 4.class JSONOptions. 덤프 및 JSON 옵션을 캡슐화하십시오. 만약 SimpleJson이 설치되어 있지 않고 documentclass가 기본 dict. strictnumberlong이 아니면 true Int64 객체가 MongoDB Extended JSON으로 인코딩된다. datetimerepresentation Defaults 인스턴스를 LEGACY. strictuuid로 인코딩 할 때 사용되는 표현 True 오브젝트가 MongoDB Extended JSON으로 인코딩 된 경우 Strict 모드 타입 이진수 그렇지 않으면 False. documentclass로 인코딩됩니다. 로드로 반환 된 BSON 문서가 인스턴스로 디코딩됩니다 이 클래스의 dict. uuidrepresentation에 대한 Defaults의 서브 클래스 여야합니다. 인코딩 및 디코딩 할 때 사용할 BSON 표현 i PYTHONLEGACY. tzaware에 대한 기본값의 설정 True MongoDB Extended JSON 인 경우 엄격한 모드 유형 날짜가 시간대 인식 인스턴스에 디코드됩니다. 그렇지 않으면 순진합니다 True. tzinfo 기본값 datetime 객체를 디코딩해야하는 표준 시간대를 지정하는 서브 클래스 utc. args 버전 3의 CodecOptions. kwargs 인수 4. DEFAULTJSONOPTIONS JSONOptions strictnumberlong False, datetimerpresentation 0, strictuuid False, documentclass dict, tzaware True, uuidrepresentation PYTHONLEGACY, unicodedecodeerrorhandler strict, tzinfo 객체 (0x7feb78b44e50). 기본 JSONOptions for JSON 인코딩 디코딩. 버전 3의 새로운 기능 4. STRICTJSONOPTIONS JSONOptions strictnumberlong True, datetimerpresentation 2, strictuuid True, documentclass dict, tzaware True, uuidrepresentation PYTHONLEGACY, unicodedecodeerrorhandler strict, tzinfo 객체 (0x7feb78b44e50).JSONOptions for MongoDB 확장 JSON s 엄격한 모드 인코딩. 버전 3 4. 도우미 함수입니다. 바이너리 및 코드를 포함한 모든 BSON 유형을 처리하는 재귀 함수입니다. 버전 1 1.BSON은 0 개 이상의 정렬 된 키 값 쌍이 단일 엔터티로 저장되는 이진 형식입니다. 이 엔터티를 문서라고합니다. 다음 문법은 BSON 표준의 버전 1 1을 지정합니다. 의사 - BNF 구문을 사용하여 문법을 작성했습니다. 유효한 BSON 데이터는 문서 non-terminal로 표시됩니다. 기본 유형. 다음 기본 유형은 나머지 문법에서 터미널로 사용됩니다 각 유형은 리틀 엔디안 형식으로 직렬화되어야합니다 .4 바이트 32 비트 부호있는 정수, 2의 s 보수 8 바이트 64 비트 부호있는 정수, 2의 보수 8 바이트 64 비트 부호없는 정수 8 바이트 64 비트 IEEE 754 -2008 2 진 부동 소수점 16 바이트 128 비트 IEEE 754-2008 10 진 부동 소수점. 다음은 나머지 BSON 문법을 지정합니다. 인용 문자열은 터미널을 나타내며 C 의미로 해석되어야합니다. 예를 들어 x01은 0000 0001 바이트를 나타냅니다. 메모 그쪽으로 우리는 연산자를 반복의 축약 형으로 사용합니다. e g x01 2는 x01 x01입니다. 단항 연산자로 사용될 때, 반복은 0 번 이상 발생할 수 있습니다. int32 elist x00. x0B ename cstring cstring 정규식 - 첫 번째 cstring은 정규식 패턴이고 두 번째는 정규식 옵션 문자열입니다. 옵션은 알파벳 순서로 저장해야하는 문자로 식별됩니다. 유효한 옵션은 대소 문자를 구분하지 않는 경우 i, 여러 줄 일치하는 경우 m, x는 상세 모드이고, l은 w, W 등의 로케일에 종속적이며, dotall 모드는 모든 것을 일치시키고, w, W 등은 유니 코드와 일치시킵니다. x0C ename 문자열 바이트 12.DBPointer 사용되지 않습니다. x0D ename 문자열. x0E ename 문자열. x0F는 코드를 입력합니다. JavaScript 코드는 scope입니다. x10 ename int32. x11 ename uint64. x12 ename int64. x13 ename decimal128.String - int32는 후행 x00에 대한 바이트 1의 숫자 바이트입니다. 바이트는 0 개 이상의 UTF-8 인코딩 문자입니다. 0 또는 수정 된 UTF-8 인코딩 문자 뒤에 x00이옵니다. 바이트에는 x00을 포함해서는 안됩니다 따라서 전체 UTF-8.int32 하위 유형 바이트가 아닙니다. 바이트 - int32는 바이트의 바이트 수입니다. 일반 바이너리 subtype. int32 문자열 document. Array - 배열에 대한 문서는 정수 값을 갖는 일반 BSON 문서입니다 예를 들어, 빨강, 파랑은 문서로 인코딩됩니다. 키는 오름차순 숫자 순서 여야합니다. UTC datetime - int64는 Unix 에포크 이후 UTC 밀리 초입니다. Timestamp - 특수 내부 MongoDB 복제 및 샤딩에 사용되는 유형 처음 4 바이트는 증가분이며, 두 번째는 타임 스탬프입니다. Min 키 - 가능한 다른 모든 BSON 요소 값보다 낮은 특수 유형입니다. 최대 키 - 다른 모든 가능한 BSON elem보다 높은 특수 유형 generic 바이너리 하위 유형 - 가장 일반적으로 사용되는 바이너리 하위 유형이며 드라이버 및 도구의 기본값이어야합니다. BSON 바이너리 또는 BinData 데이터 유형은 바이트 배열을 나타내는 데 사용됩니다. 이는 Java의 ByteArray 개념과 비슷합니다. BSON 이진 값에는 부속 유형이 있습니다. 이것은 바이트 배열에있는 데이터의 종류를 나타내는 데 사용됩니다. 0 - 127의 부속 유형은 사전 정의되거나 예약됩니다. 128-255의 부속 유형은 사용자 정의입니다. x02 바이너리 이전 - 이것은 기본 하위 유형 이었지만 이전에는 x00을 사용하도록 권장되지 않았습니다. 드라이버 및 도구는 x02를 적절하게 처리해야합니다. 바이너리 데이터의 구조는 바이너리가 아닌 터미널에서 int32가되어야합니다 a byte int32는 반복되는 바이트 수입니다. x03 UUID Old - 이것은 UUID 하위 유형 이었지만 x04 대신 사용되지 않았습니다. 네이티브 UUID 유형의 언어에 대한 드라이버 및 도구는 x03을 적절하게 처리해야합니다. x80- xFF 사용자 정의 하위 유형 이진 데이터는 아무 것도 될 수 있습니다. 코드 범위 - int32는 전체 코드 값의 길이 (바이트)입니다. 문자열은 JavaScript 코드입니다. 문서는 식별자와 값 사이의 매핑으로, 문자열을 평가해야합니다. 드라이버에는 BSON 문서를 나타내는 데 사용되는 여러 클래스와 인터페이스가 포함되어 있습니다. 일반적으로 BsonDocument 클래스는 드라이버가 내부적으로 문서를 관리하는 방식의 핵심 요소입니다. BsonDocument 클래스는 형식에 안전한 API를 사용하여 복잡성이있는 동적으로 구조화 된 문서를 나타낼 수 있습니다. 예를 들어, document. can은 다음과 같이 BsonDocument로 생성 될 수 있습니다. 형식 안전성은 Map String, BsonValue를 구현하는 BsonDocument에서 비롯되며 int String List는 BsonValue의 하위 클래스로 래핑되어야합니다. BsonValue 하위 유형의 전체 목록은 BsonValue API 문서를 참조하십시오. 대부분의 응용 프로그램 아쉽게도 Document 클래스를 사용하십시오. BsonDocument와 마찬가지로 Document 클래스는 복잡성이있는 동적으로 구조화 된 문서를 나타낼 수 있지만 Document는 Map String, Object를 구현하므로 입력이 훨씬 느립니다. Document 클래스를 사용하여 위와 같은 문서를 작성할 수 있습니다. 작성할 코드가 적지 만, 실수로 지원되지 않는 값 유형의 인스턴스를 추가하면 런타임 오류가 발생할 수 있습니다. 가장 일반적으로 사용되는 값 유형이 있습니다. 실제로 이러한 매핑을 변경하는 것이 가능합니다 새 응용 프로그램에는 권장되지 않지만 2 x 드라이버 시리즈에서 업그레이드하는 경우 DBObject 인터페이스를 계속 사용하여 BSON 문서를 나타낼 수 있습니다. DBObject는 BSON 값을 Object로 나타내지 만 몇 가지 단점이 있습니다 그것을 극복하기가 불가능했다. 그것은 클래스가 아닌 인터페이스이기 때문에 API는 바이너리 호환성을 손상시키지 않고 확장 될 수 없다. 실제로 Map String, Object를 구현하지 않습니다. 인터페이스이기 때문에 인터페이스를 구현하는 BasicDBObject라는 별도의 구체적인 클래스가 필요합니다. 이 모든 것을 하나로 묶기 위해 드라이버에는 작지만 강력한 인터페이스 인 Bson Any 클래스가 포함되어 있습니다. BSON 문서는 드라이버 자체 또는 제 3 자에 포함되어이 인터페이스를 구현할 수 있으며 BSON 문서가 필요한 상위 API의 모든 위치에서 사용할 수 있습니다. 위에서 설명한 세 클래스는 모두이 인터페이스를 구현하므로 주어진 응용 프로그램의 필요에 따라 서로 바꿔서 사용할 수 있습니다. 예를 들어. Readers 및 Writers. BSON serialization 및 deserialiation. new BSON - BSON을 직렬화 및 비 직렬화하는 데 사용할 수있는 새로운 BSON seralizer 디시리얼라이저를 만듭니다. BSON serialize 메서드는 javascript 객체를 사용하고 선택적 옵션 객체이며 Buffer를 반환합니다. param object 직렬화하는 Javascript 객체입니다. param serializer는 키가 유효한지 체크합니다. param은 자바 스크립트 함수를 직렬화합니다. return은 Buffer 인스턴스를 반환합니다. BSON serializeWithBufferAndIndex 메서드는 객체, 대상 버퍼 인스턴스 및 선택적 옵션 객체를 취해 최종 버퍼에 최종 직렬화 인덱스를 반환합니다. 버퍼, 옵션. param object 직렬화하는 Javascript 객체입니다. param buffer 직렬화 된 BSON 객체를 저장하기 위해 미리 할당 한 Buffer. param serializer는 키가 유효한지 체크합니다. param은 자바 스크립트 함수를 직렬화합니다. param은 정의되지 않은 필드를 무시합니다. param 직렬화를 개시하고 싶은 버퍼의 인덱스 return은 버퍼에 마지막으로 기록 된 바이트를 가리키는 인덱스를 반환합니다. BSON calculateObjectSize 메소드는 javascript 객체와 옵션 객체를 취하여 BSON 객체의 크기를 반환합니다. param object 직렬화하는 Javascript 객체입니다. param은 자바 스크립트 함수를 직렬화합니다. return은 Buffer 인스턴스를 반환합니다. BSON deserialize 메서드는 Buffer 및 선택적 옵션 객체를 사용하여 deserialize 된 Javascript 객체를 반환합니다. param은 deserialize 된 객체 범위의 BSON 문서에서 함수를 평가합니다. param 캐시는 재사용을 위해 함수를 평가했습니다. param은 캐싱을 위해 crc32 코드를 사용하고, 그렇지 않으면 함수의 문자열을 사용합니다. long를 직렬화 복원 할 때 param는 53 비트보다 작 으면 Number에 맞 춥니 다. param은 Binary를 비 직렬화 할 때 Buffer 인스턴스로 반환합니다. deserialize 할 때 param은 BSON 값을 가장 비슷한 유형으로 승격시킵니다. param은 직렬화되지 않은 원시 버퍼로 반환하려는 필드가 있는지 여부를 지정할 수 있습니다. param은 BSON 정규 표현식을 BSONRegExp 인스턴스로 반환합니다. 반환 값은 x 개의 문서를 직렬화 해제 한 후 버퍼의 다음 인덱스를 반환합니다. BSON deserializeStream 메소드는 버퍼, startIndex를 사용하고 연결된 BSON 문서가 들어있는 버퍼의 비 직렬화를보다 효과적으로 제어 할 수 있습니다. startIndex, numberOfDocuments, 문서, docStartIndex, 옵션. param 버퍼 직렬화 된 일련의 BSON 문서를 포함하는 버퍼. param startIndex 직렬화 복원을 시작할 데이터 버퍼의 시작 인덱스입니다. param numberOfDocuments 직렬화 복원 할 문서 수입니다. param 문서는, 직렬화 복원 된 문서를 포함하는 배열을 문서화합니다. docStartIndex 문서의 삽입을 개시하는 위치로부터 문서 배열의 인덱스. param은 deserialize 된 객체 범위의 BSON 문서에서 함수를 평가합니다. param 캐시는 재사용을 위해 함수를 평가했습니다. param은 캐싱을 위해 crc32 코드를 사용하고, 그렇지 않으면 함수의 문자열을 사용합니다. long를 직렬화 복원 할 때 param는 53 비트보다 작 으면 Number에 맞 춥니 다. param은 Binary를 비 직렬화 할 때 Buffer 인스턴스로 반환합니다. deserialize 할 때 param을 사용하면 BSON 값을 가장 비슷한 유형으로 승격시킬 수 있습니다. param은 직렬화되지 않은 원시 버퍼로 반환하려는 필드가 있는지 여부를 지정할 수 있습니다. param은 BSON 정규 표현식을 BSONRegExp 인스턴스로 반환합니다. 반환은 직렬화되지 않은 Javascript 객체를 반환합니다. 다양한 권한과 여러 프로젝트로 개발자 팀을 관리하십시오. 개인 패키지 및 조직에 대해 자세히 알아보십시오.