QuerySolr

Description:

Queries Solr and outputs the results as a FlowFile in the format of XML or using a Record Writer

Tags:

Apache, Solr, Get, Query, Records

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 Name	API Name	Default Value	Allowable Values	Description
Solr Type	Solr Type	Standard	Cloud Standard	The type of Solr instance, Cloud or Standard.
Solr Location	Solr Location			The Solr url for a Solr Type of Standard (ex: http://localhost:8984/solr/gettingstarted), or the ZooKeeper hosts for a Solr Type of Cloud (ex: localhost:9983). Supports Expression Language: true (will be evaluated using variable registry only)
Collection	Collection			The Solr collection name, only used with a Solr Type of Cloud Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Return Type	return_type	XML	XML Records	Output format of Solr results. Write Solr documents to FlowFiles as XML or using a Record Writer
Record Writer	Record Writer		Controller Service API: RecordSetWriterFactory Implementations: FreeFormTextRecordSetWriter CSVRecordSetWriter ParquetRecordSetWriter RecordSetWriterLookup ScriptedRecordSetWriter XMLRecordSetWriter JsonRecordSetWriter AvroRecordSetWriter	The Record Writer to use in order to write Solr documents to FlowFiles. Must be set if "Records" is used as return type. Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Solr Query	solr_param_query	:		Solr Query, e. g. field:value Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Request Handler	solr_param_request_handler	/select		Define a request handler here, e. g. /query Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Field List	solr_param_field_list			Comma separated list of fields to be included into results, e. g. field1,field2 Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Sorting of result list	solr_param_sort			Comma separated sort clauses to define the sorting of results, e. g. field1 asc, field2 desc Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Start of results	solr_param_start			Offset of result set Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Rows	solr_param_rows			Number of results to be returned for a single request Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Total amount of returned results	amount_documents_to_return	Only top results	Entire results Only top results	Total amount of Solr documents to be returned. If this property is set to "Only top results", only single requests will be sent to Solr and the results will be written into single FlowFiles. If it is set to "Entire results", all results matching to the query are retrieved via multiple Solr requests and returned in multiple FlowFiles. For both options, the number of Solr documents to be returned in a FlowFile depends on the configuration of the "Rows" property
Kerberos Credentials Service	kerberos-credentials-service		Controller Service API: KerberosCredentialsService Implementation: KeytabCredentialsService	Specifies the Kerberos Credentials Controller Service that should be used for authenticating with Kerberos
Kerberos User Service	kerberos-user-service		Controller Service API: KerberosUserService Implementations: KerberosTicketCacheUserService KerberosKeytabUserService KerberosPasswordUserService	Specifies the Kerberos User Controller Service that should be used for authenticating with Kerberos
Kerberos Principal	kerberos-principal			The principal to use when specifying the principal and password directly in the processor for authenticating to Solr via Kerberos. Supports Expression Language: true (will be evaluated using variable registry only)
Kerberos Password	kerberos-password			The password to use when specifying the principal and password directly in the processor for authenticating to Solr via Kerberos. Sensitive Property: true
Basic Auth Username	Username			The username to use when Solr is configured with basic authentication. Supports Expression Language: true (will be evaluated using variable registry only)
Basic Auth Password	Password			The password to use when Solr is configured with basic authentication. Sensitive Property: true Supports Expression Language: true (will be evaluated using variable registry only)
SSL Context Service	SSL Context Service		Controller Service API: SSLContextService Implementations: StandardSSLContextService StandardRestrictedSSLContextService	The Controller Service to use in order to obtain an SSL Context. This property must be set when communicating with a Solr over https.
Solr Socket Timeout	Solr Socket Timeout	10 seconds		The amount of time to wait for data on a socket connection to Solr. A value of 0 indicates an infinite timeout.
Solr Connection Timeout	Solr Connection Timeout	10 seconds		The amount of time to wait when establishing a connection to Solr. A value of 0 indicates an infinite timeout.
Solr Maximum Connections	Solr Maximum Connections	10		The maximum number of total connections allowed from the Solr client to Solr.
Solr Maximum Connections Per Host	Solr Maximum Connections Per Host	5		The maximum number of connections allowed from the Solr client to a single Solr host.
ZooKeeper Client Timeout	ZooKeeper Client Timeout	10 seconds		The amount of time to wait for data on a connection to ZooKeeper, only used with a Solr Type of Cloud.
ZooKeeper Connection Timeout	ZooKeeper Connection Timeout	10 seconds		The amount of time to wait when establishing a connection to ZooKeeper, only used with a Solr Type of Cloud.

Dynamic Properties:

Supports Sensitive Dynamic Properties: No

Dynamic Properties allow the user to specify both the name and value of a property.

Name	Value	Description
A Solr request parameter name	A Solr request parameter value	These parameters will be passed to Solr on the request Supports Expression Language: false

Relationships:

Name	Description
stats	Stats about Solr index
results	Results of Solr queries
facets	Results of faceted search
failure	Failure relationship
original	Original flowfile

Reads Attributes:

None specified.

Writes Attributes:

Name	Description
solr.connect	Solr connect string
solr.collection	Solr collection
solr.query	Query string sent to Solr
solr.cursor.mark	Cursor mark can be used for scrolling Solr
solr.status.code	Status code of Solr request. A status code of 0 indicates that the request was successfully processed
solr.query.time	The elapsed time to process the query (in ms)
solr.start	Solr start parameter (result offset) for the query
solr.rows	Number of Solr documents to be returned for the query
solr.number.results	Number of Solr documents that match the query
mime.type	The mime type of the data format
querysolr.exeption.class	The Java exception class raised when the processor fails
querysolr.exeption.message	The Java exception message raised when the processor fails

State management:

This component does not store state.

Restricted:

This component is not restricted.

Input requirement:

This component allows an incoming relationship.

System Resource Considerations:

None specified.