Skip to main content

PutGridFS

Description

Writes a file to a GridFS bucket.

Tags

file, gridfs, mongo, put, store

Properties

In the list below required Properties are shown with an asterisk (*). Other properties 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 Service *gridfs-client-serviceController Service:
MongoDBClientService

Implementations:
MongoDBControllerService
The MongoDB client service to use for database connections.
Mongo Database Name *gridfs-database-nameThe name of the database to use

Supports Expression Language, using FlowFile attributes and Environment variables.
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, using FlowFile attributes and Environment variables.
File Name *gridfs-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, using FlowFile attributes and Environment variables.
File Properties Prefixputgridfs-properties-prefixAttributes that have this prefix will be added to the file stored in GridFS as metadata.

Supports Expression Language, using FlowFile attributes and Environment variables.
Enforce Uniqueness *putgridfs-enforce-uniquenessNone
  • None
  • Both
  • Name
  • Hash
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, using Environment variables.
Chunk Size *putgridfs-chunk-size256 KBControls the maximum size of each chunk of a file uploaded into GridFS.

Supports Expression Language, using FlowFile attributes and Environment variables.

Dynamic Properties

This component does not support dynamic properties.

Relationships

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

Reads Attributes

This processor does not read attributes.

Writes Attributes

This processor does not write attributes.

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

This component does not specify system resource considerations.

See Also