PutGridFS

Description:

Writes a file to a GridFS bucket.

Additional Details...

Tags:

mongo, gridfs, put, file, store

Properties:

In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

NameDefault ValueAllowable ValuesDescription
Client ServiceController Service API:
MongoDBClientService
Implementation: MongoDBControllerService		The MongoDB client service to use for database connections.
Mongo Database NameThe name of the database to use
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Bucket NameThe GridFS bucket where the files will be stored. If left blank, it will use the default value 'fs' that the MongoDB client driver uses.
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
File NameThe name of the file in the bucket that is the target of this processor. GridFS file names do not include path information because GridFS does not sort files into folders within a bucket.
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
File Properties PrefixAttributes that have this prefix will be added to the file stored in GridFS as metadata.
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Enforce Uniquenessnone
  • None No uniqueness will be enforced.
  • Both Both the filename and hash must be unique.
  • Name Only the filename must be unique.
  • Hash Only the file hash must be unique.
When enabled, this option will ensure that uniqueness is enforced on the bucket. It will do so by creating a MongoDB index that matches your selection. It should ideally be configured once when the bucket is created for the first time because it could take a long time to build on an existing bucket wit a lot of data.
Hash Attributehash.valueIf uniquness enforcement is enabled and the file hash is part of the constraint, this must be set to an attribute that exists on all incoming flowfiles.
Supports Expression Language: true (will be evaluated using variable registry only)
Chunk Size256 KBControls the maximum size of each chunk of a file uploaded into GridFS.
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)

Relationships:

NameDescription
successWhen the operation succeeds, the flowfile is sent to this relationship.
duplicateFlowfiles that fail the duplicate check are sent to this relationship.
failureWhen there is a failure processing the flowfile, it goes to this relationship.

Reads Attributes:

None specified.

Writes Attributes:

None specified.

State management:

This component does not store state.

Restricted:

This component is not restricted.

Input requirement:

This component requires an incoming relationship.

System Resource Considerations:

None specified.