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.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Client Servicegridfs-client-serviceController Service API:
MongoDBClientService
Implementation: MongoDBControllerService
The MongoDB client service to use for database connections.
Mongo Database Namegridfs-database-nameThe name of the database to use
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Bucket Namegridfs-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 Namegridfs-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 Prefixputgridfs-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 Uniquenessputgridfs-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 Attributeputgridfs-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 Sizeputgridfs-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.