자체 관리 배포를 위한 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 문서의 기본 유형은 BSONObjectId입니다.

files.length

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

files.chunkSize

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

files.uploadDate

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

files.md5

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

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

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

files.filename

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

files.contentType

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

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

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

files.aliases

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

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

GridFS 파일의 MIME 유형과 관련된 정보를 저장하려면 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를 실행하는 경우 해시된 샤딩을 사용할 수 없습니다. 자세한 내용은 SERVER-9888을 참조하세요.

files 컬렉션

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

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