Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Elasticsearch Publisher's "type" must always be specified as "application".

Elasticsearch Publisher's "_type" must always be specified as "publisher".

Elasticsearch Publisher's "description" must be a descriptive string without spaces.

Elasticsearch Publisher's "config" must always be specified as "com.accenture.aspire:aspire-elasticsearch-publisher-source".

Elasticsearch Publisher's "appType" must always be specified as "elasticsearch-publisher".

Elasticsearch Publisher's "appName" must always be specified as "Elasticsearch Publisher".

The Azure Search Publisher can be configured using the Rest API. The Properties specific to the Elasticsearch Azure Search Publisher are described below.

Easy Heading Free
navigationTitleOn this Page
navigationExpandOptionexpand-all-by-default

Elesticsearch

Elasticsearch Publisher Properties


FieldRequiredDefaultMultipleNotesExample
properties
typeYes-No
Configuration objectelasticNoUrlYesfalseNoSelects how to enter the Elasticsearch URL. True: server and port are specified. False: full URL is specified.true / falseelasticUrl

The value must be "application".

"application"

_typeYes
No
-No
Enter the URL for the Elasticsearch bulk index endpoint, it must have this format <protocol>://<host>:<port>/_bulk . Required if elasticNoUrl is false."http://myServer:9200"

The value must be "publisher".

"publisher"

appNameYes-NoThe name of the application"Azure_Publisher"
appType
elasticHostNo-NoEnter the Elasticsearch host. Required if elasticNoUrl is true.
"myServer"elasticPortNo9200NoEnter the Elasticsearch port. Required if elasticNoUrl is true."9201"elasticIndex
Yes-No
Enter the index to which the jobs are going to be publish
The value must be "azure-search-publisher"."
test
azure-search-
index
publisher"
authType
config
No
Yes-No
Specify the authentication information. Allowed values are: "none", "basic" and "aws"."none"
The value must be "com.accenture.aspire:aspire-azure-search-publisher-source"."com.accenture.aspire:aspire-azure-search-publisher-source"
descriptionYes-NoThe description

"Azure Search Publisher"

propertiesYes-NoConfiguration object
azureServerYes-NoEnter the name of the service endpoint to use."testdomain.search.windows.net"
azureIndexYes-NoEnter the Azure Search index where the jobs will be stored."index1"
azureApiVersionYes"2021-04-30-Preview"NoEnter the Azure Search API version of the REST API."2021-04-30-Preview"
azureApiKeyYes-NoEnter the Azure Search API Key used to connect to the REST API."PPA3Qt+FqUA5ddSSDRS7w4T6Bya1IWebbcqFmqmI"
transformTypeYes"JSON"
userNo-NoProvide the user for basic authentication. Required if authType is "basic"."john.doe"passwordNo-NoProvide the password for basic authentication. Required if authType is "basic"."myP@ssword11"awsRegionNo-NoSpecify the AWS region to use. Required if authType is "aws"."us-east-2"useCredentialsProviderChainNofalseNoEnable to specify a credentials provider chain.true / falseawsAccessKeyNo-NoProvide the access key for authentication with AWS. Required if authType is "aws" and useCredentialsProviderChain is false."AKIAQYO33L5HIS3N55NN"awsSecretKeyNo-NoProvide the secret key for authentication with AWS. Required if authType is "aws" and useCredentialsProviderChain is false."PPA3Qt+FqUA4Kk07DRS7w4T6Bya1IWebbcqFmqmI"transformTypeYes-
NoType of the transformation file used."JSON"
useTransformFileYestrueNoSelect if a file path or a resource file upload is used in the resources' manager section.true / false
transformFileYes-NoPath to the transform file. The default value is set to "${component.home}/config/groovy/
transform
aspireToAzureSearchBulk.groovy" for the default
JSON
transformation file provided with Aspire. (Required if useTransformFile is true)"C:\transformfiles\groovy\mytransform.groovy"
processClear
transformResourceYes-NoTransformation Resource ID. (Required if useTransformFile is false)"a1f0a708e7965a972cedede5779c656de3574fc88eee983d"
cleanOnFullCrawlYesfalseNoSet to true to clear the index on full crawls.true / false
clearType
useIndexFileYes
if processClear = Yes
-"deleteAllDocuments"uploadMappingsNofalseNoUpload Mappings. Relevant for clearType "deleteIndex"
trueNo

Type of the clear. 2 options here :

  • "deleteAllDocuments" - deletes documents with the index
  • "deleteIndex" - recreates the whole index (with or without requested mapping)

Select if a file path or a resource file upload is used in the resources' manager section. (Required if cleanOnFullCrawl is true)

true / false
uploadMappingsFrom
azureIndexFile
No
Yes
false
-No
Source for the mappings. Required if uploadMappings is true. If uploadsMappingFrom is true the mappings will be used from the parameter below otherwise from the filetrue / falsemappingsTextNo-NoMappings specified directly. Required if uploadMappings is true and uploadMappingsFrom is true."{\"mappings\":{\"properties\":{\"doc._id\":{\"type\":\"text\",\"fields\":{\"keyword\":{\"type\":\"keyword\"}}}}}}"uploadMappingsFileNo-NoMappings file path.  Required if uploadMappings is true and uploadMappingsFrom is false.
Path to the transform file. The default value is set to ".{component.home}/config/json/azureSearchIndex.json" for the default transformation file provided with Aspire. (Required if useIndexFile is true)C:\transformfiles\json\myindex.json"
mappingResourceYes-NoIndex Mappings Resource ID. (Required if useIndexFile is false)"f038945fa320d5f7ee28f835754e9dd699eb36a25ce3439a9"
indexDeleteWaitYes10000NoThe maximum time (in milliseconds) to wait between the deletion/creation of the index and the publishing process.100000
"C:\mappings\myMappings\myMappingsFile.txt"
idleConnectionTimeoutNo-NoMaximum time (in milliseconds) to keep an idle connection open.3600000
maxConnectionsNo-NoMaximum number of connections to be opened.100
maxConnectionsPerRouteNo-NoMaximum number of connections opened for the same target.10
connectionTimeoutNo-NoMaximum time (in milliseconds) to wait for the connection.15000
socketTimeoutNo-NoMaximum time (in milliseconds) to wait for a socket response.15000
useThrottlingNo-NoSet to true to specify Throttling Settings.true / false
throttlingRateNo5000NoTime
period
(in milliseconds) to throttle the connection.6000
throttlingConnectionRateNo500NoMaximum number of connections used during the Throttling Period.600
maxRetriesNo3NoMaximum number of retries for a failed document.5
retryWaitTimeNo5NoTime
period
(in milliseconds) to wait before a retry.6000
batchSizeNo-NoMaximum size of the batches that will be created.50
simultaneousBatchesNo-NoNumber of batches that will be processed simultaneously.5
batchTimeoutNo-NoPeriod (in ms) after which a batch of documents will be closed and executed.5000
debugNo-NoSet to true to enable debug mode to show debug messages from the publisher.true / false

Create example


Code Block
themeRDark
titlePOST /aspire/_api/connectionsworkflows
{
	"type": "application",
	"_type": "publisher",
	"description": "ElasticsearchPublisherTestAzure Search Publisher Test",
	"config": "com.accenture.aspire:aspire-azure-elasticsearchsearch-publisher-source",
	"appType": "elasticsearchazuresearch-publisher",
	"appName": "ElasticsearchAzuresearch Publisher",
	"properties": {
    	"azureServer": "test.search.windows.net",
	    "elasticNoUrlazureIndex": true"index1",
    		"elasticHostazureApiVersion": "myEShost2021-04-30-Preview",
		"elasticPort    "azureApiKey": 9200"encrypted:C4D3B8FE27C26B7D682C8E481D3A53ACEBF7DB23B476F09CB2C0FF866B9E2DCHAFCD08B79B02E51D30E33CB7233CEAD",
    		"elasticIndextransformType": "test-indexJSON",
	    "useTransformFile": false,
	    "authTypetransformResource": "nonea1f0a708e7965a972cede7e4b56ac8e5779c656de3574fc88eee983d",
	    	"transformTypecleanOnFullCrawl": true,
	    "JSONuseIndexFile": false,
		"transformFile    "mappingResource": "${component.home}/config/groovy/transform.groovyf038945fa320d5f7ee28f1d7c1719a9be7a8835b36a25ce3439a9",
    		"processClearindexDeleteWait": false100000,
		    "idleConnectionTimeout": 3600000,
		    "maxConnections": 100,
	    	"maxConnectionsPerRoute": 10,
	    "sharedConnection": false,
    	"connectionTimeout": 15000,
		    "socketTimeout": 15000,
    		"useThrottling": false,
		    "maxRetries": 3,
	    	"retryWaitTime": 5000,
		    "batchSize": 50,
	    	"simultaneousBatches": 5,
		    "batchTimeout": 5000,
	    	"debug": false
	}
}