자체 관리 배포를 위한 GridFS

chunks 컬렉션

chunks [1] 컬렉션의 각 문서는 GridFS에서 표현되는 별개의 파일 청크를 나타냅니다. 이 컬렉션의 문서 양식은 다음과 같습니다. 이 컬렉션의 문서 양식은 다음과 같습니다.

{
  "_id" : <ObjectId>,
  "files_id" : <ObjectId>,
  "n" : <num>,
  "data" : <binary>
}

컬렉션 chunks 문서에는 다음 필드가 포함되어 있습니다.

chunks._id

청크의 고유 ObjectId입니다.

chunks.files_id

_id 컬렉션에 명시된 '상위' 문서의 files입니다.

chunks.n

청크의 시퀀스 번호입니다. GridFS는 0부터 시작하여 모든 청크에 번호를 매깁니다.

chunks.data

청크의 페이로드는 BSON Binary 유형입니다.

files 컬렉션

files collection 컬렉션의 각 문서는 GridFS의 파일을 나타냅니다.

{
  "_id" : <ObjectId>,
  "length" : <num>,
  "chunkSize" : <num>,
  "uploadDate" : <timestamp>,
  "md5" : <hash>,
  "filename" : <string>,
  "contentType" : <string>,
  "aliases" : <string array>,
  "metadata" : <any>,
}

files 컬렉션 내의 문서에는 다음 필드 중 일부 또는 전부가 포함되어 있습니다.

files._id

이 문서의 고유 식별자입니다. _id는 원본 문서에 대해 선택한 데이터 유형입니다. MongoDB 문서의 기본 유형은 BSON ObjectId입니다.

files.length

문서의 크기(바이트)입니다.

files.chunkSize

각 청크의 크기(바이트)입니다. GridFS는 마지막 청크를 제외하고 문서를 필요한 크기의 청크 chunkSize로 나눕니다. 기본값 크기는 255KiB입니다.

files.uploadDate

문서가 GridFS에 처음 저장된 날짜입니다. 이 값은 Date 유형입니다.

files.md5

더 이상 사용되지 않습니다.

MD5 알고리즘은 FIPS 140-2에 의해 금지되어 있습니다. MongoDB 드라이버는 MD5 지원을 중단하고 향후 릴리스에서 MD5 생성을 제거할 예정입니다. 파일 다이제스트가 필요한 애플리케이션은 이를 GridFS 외부에서 구현하고 files.metadata에 저장해야 합니다.

명령에 의해 반환된 전체 파일 filemd5 의 MD 해시입니다. 이 값의5 String 유형은 입니다.

files.filename

선택 사항. 사람이 읽을 수 있는 GridFS 파일의 이름입니다.

files.contentType

더 이상 사용되지 않습니다.

선택 사항GridFS 파일에 유효한 MIME 유형입니다. 애플리케이션 전용입니다.

GridFS 파일의 MIME 유형과 관련된 정보를 저장하려면 files.metadata를 사용하세요.

files.aliases

더 이상 사용되지 않습니다.

선택 사항. 별칭 문자열의 배열입니다. 애플리케이션 전용입니다.

별칭 정보를 저장하려면 files.metadata 를 사용합니다.

files.metadata

선택 사항. 메타데이터 필드 모든 데이터 유형 수 있으며 저장 하려는 추가 정보를 보유할 수 있습니다. files 컬렉션 의 문서에 임의의 필드를 추가하려면 메타데이터 필드 의 객체 에 추가합니다.

chunks 인덱스

GridFS는 files_id 및 n 필드를 사용하여 chunks 컬렉션에서 고유한 복합 인덱스를 사용합니다. 이렇게 하면 다음 예시와 같이 청크를 효율적으로 조회할 수 있습니다.

db.fs.chunks.find( { files_id: myFileID } ).sort( { n: 1 } )

GridFS 사양을 준수하는 드라이버는 읽기 및 쓰기 (write) 작업 전에 이 인덱스 존재하는지 자동으로 확인합니다. GridFS 애플리케이션 의 특정 동작에 대해서는 관련 운전자 설명서를 참조하세요.

이 인덱스가 없는 경우 mongosh:를 사용하여 다음 작업을 실행하고 인덱스를 만들 수 있습니다:

db.fs.chunks.createIndex( { files_id: 1, n: 1 }, { unique: true } );

files 인덱스

GridFS는 filename 및 uploadDate 필드로 files 컬렉션의 인덱스를 사용합니다. 이 인덱스를 사용하면 다음 예시와 같이 파일을 효율적으로 조회할 수 있습니다.

db.fs.files.find( { filename: myFileName } ).sort( { uploadDate: 1 } )

GridFS 사양을 준수하는 드라이버는 읽기 및 쓰기 (write) 작업 전에 이 인덱스 존재하는지 자동으로 확인합니다. GridFS 애플리케이션 의 특정 동작에 대해서는 관련 운전자 설명서를 참조하세요.

이 인덱스가 없는 경우 mongosh:를 사용하여 다음 작업을 실행하고 인덱스를 만들 수 있습니다:

db.fs.files.createIndex( { filename: 1, uploadDate: 1 } );

chunks 컬렉션

chunks 컬렉션을 샤딩하려면 { files_id : 1, n : 1 } 또는 { files_id : 1 }을(를) 샤드 키 인덱스로 사용합니다. files_id는 ObjectId이며 단조롭게 변경됩니다.

업로드 성공적인 를 확인하기 위해 를 실행 하지 filemd5 않는 MongoDB 드라이버의 경우 컬렉션 chunks 에 해시 샤딩 사용할 수 있습니다.

MongoDB 운전자 를 실행하는 경우 해시 filemd5 샤딩 사용할 수 없습니다. 자세한 내용은 서버-9888 를 참조하세요.

files 컬렉션

files 컬렉션은 크기가 작고 메타데이터만 포함되어 있습니다. GridFS에 필요한 키 중 어느 것도 샤드된 환경에서 균등하게 배포되는 데 적합하지 않습니다. files를 샤딩되지 않은 상태로 두면 모든 파일 메타데이터 문서를 하나의 샤드에 보관할 수 있습니다.

files 컬렉션을 반드시 샤딩해야 하는 경우 가능하면 애플리케이션 필드와 함께 _id 필드를 사용합니다.