개요
이 가이드 에서는 Node.js 운전자 사용하여 BSON 문서를 만들고, 파일 에서 BSON 읽고, 파일 에 BSON 쓰기 (write) 방법을 학습 수 있습니다.
BSON 또는 바이너리 JSON 은 MongoDB 데이터를 구성하고 저장 데 사용하는 데이터 형식입니다. BSON 패키지 가져와 JavaScript 애플리케이션 에서 BSON 문서를 사용할 수 있습니다.
이 가이드의 코드 샘플에서는 다음 BSON 문서를 예로 사용합니다.
{ "address" : { "street" : "Pizza St", "zipcode" : "10003" }, "coord" : [-73.982419, 41.579505], "cuisine" : "Pizza", "name" : "Mongo's Pizza" }
참고
Node.js 드라이버의 BSON 패키지 사용
다른 BSON 패키지와의 호환성 문제를 방지하려면 운전자 와 함께 번들로 제공되는 BSON 패키지 를 사용하는 것이 좋습니다. 다음 가져오기 성명서 사용하여 Node.js 드라이버의 BSON 패키지 가져올 수 있습니다.
import { BSON } from 'mongodb';
BSON 데이터 유형
BSON 모든 JSON 데이터 구조 유형을 지원하며 날짜, 다양한 크기의 정수, ObjectId
및 바이너리 데이터를 포함한 유형에 대한 지원 추가합니다. 지원되는 유형의 전체 목록은 MongoDB Server 매뉴얼의 BSON types 페이지를 참조하세요.
범용 고유 ID(UUID)
Node.js 운전자 BSON 바이너리 하위 클래스 UUID
을(를) 사용하여 UUID를 지원합니다. UUID()
생성자를 사용하여 UUID
객체 만들 수 있습니다. 다음 코드 예시 임의의 UUID를 생성합니다.
import { UUID } from 'mongodb'; const myUuid = new UUID();
BSON 문서 만들기
JavaScript 에서 객체 만들 때 사용하는 것과 동일한 표기법을 사용하여 BSON 문서 만들 수 있습니다. Node.js 운전자 JavaScript 객체를 컬렉션 에 삽입할 때 자동으로 BSON 문서로 변환합니다.
다음 예시 앞의 샘플 BSON 문서 나타내는 BSON 문서 만듭니다.
const document = { "address": { "street": "Pizza St", "zipcode": "10003", }, "coord": [-73.982419, 41.579505], "cuisine": "Pizza", "name": "Mongo's Pizza", }
BSON 문서 변경
JavaScript 에서 객체 수정하는 데 사용하는 것과 동일한 표기법을 사용하여 BSON 문서 의 내용을 수정할 수 있습니다. 다음 예시 이전 BSON 문서 를 세 가지 변경합니다.
값이
12345
인 새 필드restaurant_id
을 추가합니다.cuisine
필드 제거name
필드의 값을"Mongo's Pizza Place"
로 설정합니다.
document.restaurant_id = "12345"; delete document.cuisine; document.name = "Mongo's Pizza Place";
파일에 BSON 쓰기
BSON 데이터를 파일 에 쓰기 (write) 려면 파일 시스템 모듈을 가져오고 출력 파일 엽니다. 그런 다음 각 문서 출력 파일 에 쓰기 (write) . BSON.serialize()
메서드를 사용하여 문서가 BSON 형식으로 인코딩되었는지 확인합니다.
다음 예시 샘플 BSON 문서 file.bson
에 씁니다.
import fs from 'fs/promises'; // Import the file system module import { BSON } from 'mongodb'; // Import the BSON package // Create a BSON object const bsonData = BSON.serialize(result); // Write the BSON data to a file await fs.writeFile('file.bson', bsonData); console.log('BSON data written to file.bson');
파일에서 BSON 읽기
파일 에서 BSON 문서를 읽으려면 읽기 모드 에서 파일 엽니다. 그런 다음 BSON.deserialize()
메서드를 사용하여 BSON 형식의 문서를 읽을 때 디코딩합니다.
다음 예시 file.bson
에서 샘플 BSON 문서 읽습니다.
import fs from 'fs/promises'; // Import the file system module import { BSON } from 'mongodb'; // Import the BSON package // Read the BSON data from a file const data = await fs.readFile('file.bson'); const document = BSON.deserialize(data); console.log(document);
{ _id: new ObjectId('67e1823d0d63bfdf87e8928e'), address: { street: 'Pizza St', zipcode: '10003' }, coord: [ -73.982419, 41.579505 ], cuisine: 'Pizza', name: "Mongo's Pizza" }
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.