Controls certain runtime behaviors of the streaming job.
'1.0'
dataLocale
The data locale of the stream analytics job. Value should be the name of a supported .NET Culture from the set https://msdn.microsoft.com/library/system.globalization.culturetypes(v=vs.110).aspx. Defaults to 'en-US' if none specified.
string
eventsLateArrivalMaxDelayInSeconds
The maximum tolerable delay in seconds where events arriving late could be included. Supported range is -1 to 1814399 (20.23:59:59 days) and -1 is used to specify wait indefinitely. If the property is absent, it is interpreted to have a value of -1.
int
eventsOutOfOrderMaxDelayInSeconds
The maximum tolerable delay in seconds where out-of-order events can be adjusted to be back in order.
int
eventsOutOfOrderPolicy
Indicates the policy to apply to events that arrive out of order in the input event stream.
'Adjust' 'Drop'
functions
A list of one or more functions for the streaming job. The name property for each function is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual transformation.
A list of one or more inputs to the streaming job. The name property for each input is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual input.
Indicates the policy to apply to events that arrive at the output and cannot be written to the external storage due to being malformed (missing column values, column values of wrong type or size).
'Drop' 'Stop'
outputs
A list of one or more outputs for the streaming job. The name property for each output is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual output.
This property should only be utilized when it is desired that the job be started immediately upon creation. Value may be JobStartTime, CustomTime, or LastOutputEventTime to indicate whether the starting point of the output event stream should start whenever the job is started, start at a custom user time stamp specified via the outputStartTime property, or start from the last event output time.
'CustomTime' 'JobStartTime' 'LastOutputEventTime'
outputStartTime
Value is either an ISO-8601 formatted time stamp that indicates the starting point of the output event stream, or null to indicate that the output event stream will start whenever the streaming job is started. This property must have a value if outputStartMode is set to CustomTime.
string
sku
Describes the SKU of the streaming job. Required on PUT (CreateOrReplace) requests.
Indicates the query and the number of streaming units to use for the streaming job. The name property of the transformation is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual transformation.
The API key used to authenticate with Request-Response endpoint.
string
batchSize
Number between 1 and 10000 describing maximum number of rows for every Azure ML RRS execute request. Default is 1000.
int
endpoint
The Request-Response execute endpoint of the Azure Machine Learning web service. Find out more here: https://docs.microsoft.com/azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs
string
inputs
The inputs for the Azure Machine Learning web service endpoint.
The name of the input. This is the name provided while authoring the endpoint.
string
AzureMachineLearningWebServiceInputColumn
Name
Description
Value
dataType
The (Azure Machine Learning supported) data type of the input column. A list of valid Azure Machine Learning data types are described at https://msdn.microsoft.com/library/azure/dn905923.aspx .
string
mapTo
The zero based index of the function parameter this input maps to.
int
name
The name of the input column.
string
AzureMachineLearningWebServiceOutputColumn
Name
Description
Value
dataType
The (Azure Machine Learning supported) data type of the output column. A list of valid Azure Machine Learning data types are described at https://msdn.microsoft.com/library/azure/dn905923.aspx .
The JavaScript code containing a single function definition. For example: 'function (x, y) { return x + y; }'
string
FunctionInput
Name
Description
Value
dataType
The (Azure Stream Analytics supported) data type of the function input parameter. A list of valid Azure Stream Analytics data types are described at https://msdn.microsoft.com/library/azure/dn835065.aspx
string
isConfigurationParameter
A flag indicating if the parameter is a configuration parameter. True if this input parameter is expected to be a constant. Default is false.
bool
FunctionOutput
Name
Description
Value
dataType
The (Azure Stream Analytics supported) data type of the function output. A list of valid Azure Stream Analytics data types are described at https://msdn.microsoft.com/library/azure/dn835065.aspx
string
Input
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with an input. Required on PUT (CreateOrReplace) requests.
Specifies the encoding of the incoming data in the case of input and the encoding of outgoing data in the case of output. Required on PUT (CreateOrReplace) requests.
'UTF8'
fieldDelimiter
Specifies the delimiter that will be used to separate comma-separated value (CSV) records. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a list of supported values. Required on PUT (CreateOrReplace) requests.
string
JsonSerialization
Name
Description
Value
type
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Json' (required)
properties
The properties that are associated with the JSON serialization type. Required on PUT (CreateOrReplace) requests.
Specifies the encoding of the incoming data in the case of input and the encoding of outgoing data in the case of output. Required on PUT (CreateOrReplace) requests.
'UTF8'
format
This property only applies to JSON serialization of outputs only. It is not applicable to inputs. This property specifies the format of the JSON the output will be written in. The currently supported values are 'lineSeparated' indicating the output will be formatted by having each JSON object separated by a new line and 'array' indicating the output will be formatted as an array of JSON objects. Default value is 'lineSeparated' if left null.
'Array' 'LineSeparated'
ReferenceInputProperties
Name
Description
Value
type
Indicates whether the input is a source of reference data or stream data. Required on PUT (CreateOrReplace) requests.
'Reference' (required)
datasource
Describes an input data source that contains reference data. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The name of an IoT Hub Consumer Group that should be used to read events from the IoT Hub. If not specified, the input uses the Iot Hub’s default consumer group.
string
endpoint
The IoT Hub endpoint to connect to (ie. messages/events, messages/operationsMonitoringEvents, etc.).
string
iotHubNamespace
The name or the URI of the IoT Hub. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyKey
The shared access policy key for the specified shared access policy. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyName
The shared access policy name for the IoT Hub. This policy must contain at least the Service connect permission. Required on PUT (CreateOrReplace) requests.
string
EventHubStreamInputDataSource
Name
Description
Value
type
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
properties
The properties that are associated with an Event Hub input containing stream data. Required on PUT (CreateOrReplace) requests.
The name of an Event Hub Consumer Group that should be used to read events from the Event Hub. Specifying distinct consumer group names for multiple inputs allows each of those inputs to receive the same events from the Event Hub. If not specified, the input uses the Event Hub’s default consumer group.
string
eventHubName
The name of the Event Hub. Required on PUT (CreateOrReplace) requests.
string
serviceBusNamespace
The namespace that is associated with the desired Event Hub, Service Bus Queue, Service Bus Topic, etc. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyKey
The shared access policy key for the specified shared access policy. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyName
The shared access policy name for the Event Hub, Service Bus Queue, Service Bus Topic, etc. Required on PUT (CreateOrReplace) requests.
string
BlobStreamInputDataSource
Name
Description
Value
type
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
properties
The properties that are associated with a blob input containing stream data. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
sourcePartitionCount
The partition count of the blob input data source. Range 1 - 1024.
int
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The name of the Azure Data Lake Store account. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in filePathPrefix, the value of this property is used as the date format instead.
string
filePathPrefix
The location of the file to which the output should be written to. Required on PUT (CreateOrReplace) requests.
string
refreshToken
A refresh token that can be used to obtain a valid access token that can then be used to authenticate with the data source. A valid refresh token is currently only obtainable via the Azure Portal. It is recommended to put a dummy string value here when creating the data source and then going to the Azure Portal to authenticate the data source which will update this property with a valid refresh token. Required on PUT (CreateOrReplace) requests.
string
tenantId
The tenant id of the user used to obtain the refresh token. Required on PUT (CreateOrReplace) requests.
string
timeFormat
The time format. Wherever {time} appears in filePathPrefix, the value of this property is used as the time format instead.
string
tokenUserDisplayName
The user display name of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
tokenUserPrincipalName
The user principal name (UPN) of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
EventHubOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
properties
The properties that are associated with an Event Hub output. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The DocumentDB account name or ID. Required on PUT (CreateOrReplace) requests.
string
accountKey
The account key for the DocumentDB account. Required on PUT (CreateOrReplace) requests.
string
collectionNamePattern
The collection name pattern for the collections to be used. The collection name format can be constructed using the optional {partition} token, where partitions start from 0. See the DocumentDB section of https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for more information. Required on PUT (CreateOrReplace) requests.
string
database
The name of the DocumentDB database. Required on PUT (CreateOrReplace) requests.
string
documentId
The name of the field in output events used to specify the primary key which insert or update operations are based on.
string
partitionKey
The name of the field in output events used to specify the key for partitioning output across collections. If 'collectionNamePattern' contains the {partition} token, this property is required to be specified.
string
AzureTableOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Table' (required)
properties
The properties that are associated with an Azure Table output. Required on PUT (CreateOrReplace) requests.
The account key for the Azure Storage account. Required on PUT (CreateOrReplace) requests.
string
accountName
The name of the Azure Storage account. Required on PUT (CreateOrReplace) requests.
string
batchSize
The number of rows to write to the Azure Table at a time.
int
columnsToRemove
If specified, each item in the array is the name of a column to remove (if present) from output event entities.
string[]
partitionKey
This element indicates the name of a column from the SELECT statement in the query that will be used as the partition key for the Azure Table. Required on PUT (CreateOrReplace) requests.
string
rowKey
This element indicates the name of a column from the SELECT statement in the query that will be used as the row key for the Azure Table. Required on PUT (CreateOrReplace) requests.
string
table
The name of the Azure Table. Required on PUT (CreateOrReplace) requests.
string
PowerBIOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'PowerBI' (required)
properties
The properties that are associated with a Power BI output. Required on PUT (CreateOrReplace) requests.
The name of the Power BI dataset. Required on PUT (CreateOrReplace) requests.
string
groupId
The ID of the Power BI group.
string
groupName
The name of the Power BI group. Use this property to help remember which specific Power BI group id was used.
string
refreshToken
A refresh token that can be used to obtain a valid access token that can then be used to authenticate with the data source. A valid refresh token is currently only obtainable via the Azure Portal. It is recommended to put a dummy string value here when creating the data source and then going to the Azure Portal to authenticate the data source which will update this property with a valid refresh token. Required on PUT (CreateOrReplace) requests.
string
table
The name of the Power BI table under the specified dataset. Required on PUT (CreateOrReplace) requests.
string
tokenUserDisplayName
The user display name of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
tokenUserPrincipalName
The user principal name (UPN) of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
Sku
Name
Description
Value
name
The name of the SKU. Required on PUT (CreateOrReplace) requests.
'Standard'
Transformation
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with a transformation. Required on PUT (CreateOrReplace) requests.
Specifies the query that will be run in the streaming job. You can learn more about the Stream Analytics Query Language (SAQL) here: https://msdn.microsoft.com/library/azure/dn834998 . Required on PUT (CreateOrReplace) requests.
string
streamingUnits
Specifies the number of streaming units that the streaming job uses.
int
Quickstart templates
The following quickstart templates deploy this resource type.
This template creates a Standard Stream Analytics Job. For more information, Azure Stream Analytics is a real-time analytics and complex event-processing engine that is designed to analyze and process high volumes of fast streaming data from multiple sources simultaneously. Patterns and relationships can be identified in information extracted from a number of input sources including devices, sensors, clickstreams, social media feeds, and applications. These patterns can be used to trigger actions and initiate workflows such creating alerts, feeding information to a reporting tool, or storing transformed data for later use. Also, Stream Analytics is available on Azure IoT Edge runtime, and supports the same exact language or syntax as cloud.
ARM template resource definition
The streamingjobs resource type can be deployed with operations that target:
Controls certain runtime behaviors of the streaming job.
'1.0'
dataLocale
The data locale of the stream analytics job. Value should be the name of a supported .NET Culture from the set https://msdn.microsoft.com/library/system.globalization.culturetypes(v=vs.110).aspx. Defaults to 'en-US' if none specified.
string
eventsLateArrivalMaxDelayInSeconds
The maximum tolerable delay in seconds where events arriving late could be included. Supported range is -1 to 1814399 (20.23:59:59 days) and -1 is used to specify wait indefinitely. If the property is absent, it is interpreted to have a value of -1.
int
eventsOutOfOrderMaxDelayInSeconds
The maximum tolerable delay in seconds where out-of-order events can be adjusted to be back in order.
int
eventsOutOfOrderPolicy
Indicates the policy to apply to events that arrive out of order in the input event stream.
'Adjust' 'Drop'
functions
A list of one or more functions for the streaming job. The name property for each function is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual transformation.
A list of one or more inputs to the streaming job. The name property for each input is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual input.
Indicates the policy to apply to events that arrive at the output and cannot be written to the external storage due to being malformed (missing column values, column values of wrong type or size).
'Drop' 'Stop'
outputs
A list of one or more outputs for the streaming job. The name property for each output is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual output.
This property should only be utilized when it is desired that the job be started immediately upon creation. Value may be JobStartTime, CustomTime, or LastOutputEventTime to indicate whether the starting point of the output event stream should start whenever the job is started, start at a custom user time stamp specified via the outputStartTime property, or start from the last event output time.
'CustomTime' 'JobStartTime' 'LastOutputEventTime'
outputStartTime
Value is either an ISO-8601 formatted time stamp that indicates the starting point of the output event stream, or null to indicate that the output event stream will start whenever the streaming job is started. This property must have a value if outputStartMode is set to CustomTime.
string
sku
Describes the SKU of the streaming job. Required on PUT (CreateOrReplace) requests.
Indicates the query and the number of streaming units to use for the streaming job. The name property of the transformation is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual transformation.
The API key used to authenticate with Request-Response endpoint.
string
batchSize
Number between 1 and 10000 describing maximum number of rows for every Azure ML RRS execute request. Default is 1000.
int
endpoint
The Request-Response execute endpoint of the Azure Machine Learning web service. Find out more here: https://docs.microsoft.com/azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs
string
inputs
The inputs for the Azure Machine Learning web service endpoint.
The name of the input. This is the name provided while authoring the endpoint.
string
AzureMachineLearningWebServiceInputColumn
Name
Description
Value
dataType
The (Azure Machine Learning supported) data type of the input column. A list of valid Azure Machine Learning data types are described at https://msdn.microsoft.com/library/azure/dn905923.aspx .
string
mapTo
The zero based index of the function parameter this input maps to.
int
name
The name of the input column.
string
AzureMachineLearningWebServiceOutputColumn
Name
Description
Value
dataType
The (Azure Machine Learning supported) data type of the output column. A list of valid Azure Machine Learning data types are described at https://msdn.microsoft.com/library/azure/dn905923.aspx .
The JavaScript code containing a single function definition. For example: 'function (x, y) { return x + y; }'
string
FunctionInput
Name
Description
Value
dataType
The (Azure Stream Analytics supported) data type of the function input parameter. A list of valid Azure Stream Analytics data types are described at https://msdn.microsoft.com/library/azure/dn835065.aspx
string
isConfigurationParameter
A flag indicating if the parameter is a configuration parameter. True if this input parameter is expected to be a constant. Default is false.
bool
FunctionOutput
Name
Description
Value
dataType
The (Azure Stream Analytics supported) data type of the function output. A list of valid Azure Stream Analytics data types are described at https://msdn.microsoft.com/library/azure/dn835065.aspx
string
Input
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with an input. Required on PUT (CreateOrReplace) requests.
Specifies the encoding of the incoming data in the case of input and the encoding of outgoing data in the case of output. Required on PUT (CreateOrReplace) requests.
'UTF8'
fieldDelimiter
Specifies the delimiter that will be used to separate comma-separated value (CSV) records. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a list of supported values. Required on PUT (CreateOrReplace) requests.
string
JsonSerialization
Name
Description
Value
type
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Json' (required)
properties
The properties that are associated with the JSON serialization type. Required on PUT (CreateOrReplace) requests.
Specifies the encoding of the incoming data in the case of input and the encoding of outgoing data in the case of output. Required on PUT (CreateOrReplace) requests.
'UTF8'
format
This property only applies to JSON serialization of outputs only. It is not applicable to inputs. This property specifies the format of the JSON the output will be written in. The currently supported values are 'lineSeparated' indicating the output will be formatted by having each JSON object separated by a new line and 'array' indicating the output will be formatted as an array of JSON objects. Default value is 'lineSeparated' if left null.
'Array' 'LineSeparated'
ReferenceInputProperties
Name
Description
Value
type
Indicates whether the input is a source of reference data or stream data. Required on PUT (CreateOrReplace) requests.
'Reference' (required)
datasource
Describes an input data source that contains reference data. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The name of an IoT Hub Consumer Group that should be used to read events from the IoT Hub. If not specified, the input uses the Iot Hub’s default consumer group.
string
endpoint
The IoT Hub endpoint to connect to (ie. messages/events, messages/operationsMonitoringEvents, etc.).
string
iotHubNamespace
The name or the URI of the IoT Hub. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyKey
The shared access policy key for the specified shared access policy. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyName
The shared access policy name for the IoT Hub. This policy must contain at least the Service connect permission. Required on PUT (CreateOrReplace) requests.
string
EventHubStreamInputDataSource
Name
Description
Value
type
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
properties
The properties that are associated with an Event Hub input containing stream data. Required on PUT (CreateOrReplace) requests.
The name of an Event Hub Consumer Group that should be used to read events from the Event Hub. Specifying distinct consumer group names for multiple inputs allows each of those inputs to receive the same events from the Event Hub. If not specified, the input uses the Event Hub’s default consumer group.
string
eventHubName
The name of the Event Hub. Required on PUT (CreateOrReplace) requests.
string
serviceBusNamespace
The namespace that is associated with the desired Event Hub, Service Bus Queue, Service Bus Topic, etc. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyKey
The shared access policy key for the specified shared access policy. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyName
The shared access policy name for the Event Hub, Service Bus Queue, Service Bus Topic, etc. Required on PUT (CreateOrReplace) requests.
string
BlobStreamInputDataSource
Name
Description
Value
type
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
properties
The properties that are associated with a blob input containing stream data. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
sourcePartitionCount
The partition count of the blob input data source. Range 1 - 1024.
int
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The name of the Azure Data Lake Store account. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in filePathPrefix, the value of this property is used as the date format instead.
string
filePathPrefix
The location of the file to which the output should be written to. Required on PUT (CreateOrReplace) requests.
string
refreshToken
A refresh token that can be used to obtain a valid access token that can then be used to authenticate with the data source. A valid refresh token is currently only obtainable via the Azure Portal. It is recommended to put a dummy string value here when creating the data source and then going to the Azure Portal to authenticate the data source which will update this property with a valid refresh token. Required on PUT (CreateOrReplace) requests.
string
tenantId
The tenant id of the user used to obtain the refresh token. Required on PUT (CreateOrReplace) requests.
string
timeFormat
The time format. Wherever {time} appears in filePathPrefix, the value of this property is used as the time format instead.
string
tokenUserDisplayName
The user display name of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
tokenUserPrincipalName
The user principal name (UPN) of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
EventHubOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
properties
The properties that are associated with an Event Hub output. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The DocumentDB account name or ID. Required on PUT (CreateOrReplace) requests.
string
accountKey
The account key for the DocumentDB account. Required on PUT (CreateOrReplace) requests.
string
collectionNamePattern
The collection name pattern for the collections to be used. The collection name format can be constructed using the optional {partition} token, where partitions start from 0. See the DocumentDB section of https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for more information. Required on PUT (CreateOrReplace) requests.
string
database
The name of the DocumentDB database. Required on PUT (CreateOrReplace) requests.
string
documentId
The name of the field in output events used to specify the primary key which insert or update operations are based on.
string
partitionKey
The name of the field in output events used to specify the key for partitioning output across collections. If 'collectionNamePattern' contains the {partition} token, this property is required to be specified.
string
AzureTableOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Table' (required)
properties
The properties that are associated with an Azure Table output. Required on PUT (CreateOrReplace) requests.
The account key for the Azure Storage account. Required on PUT (CreateOrReplace) requests.
string
accountName
The name of the Azure Storage account. Required on PUT (CreateOrReplace) requests.
string
batchSize
The number of rows to write to the Azure Table at a time.
int
columnsToRemove
If specified, each item in the array is the name of a column to remove (if present) from output event entities.
string[]
partitionKey
This element indicates the name of a column from the SELECT statement in the query that will be used as the partition key for the Azure Table. Required on PUT (CreateOrReplace) requests.
string
rowKey
This element indicates the name of a column from the SELECT statement in the query that will be used as the row key for the Azure Table. Required on PUT (CreateOrReplace) requests.
string
table
The name of the Azure Table. Required on PUT (CreateOrReplace) requests.
string
PowerBIOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'PowerBI' (required)
properties
The properties that are associated with a Power BI output. Required on PUT (CreateOrReplace) requests.
The name of the Power BI dataset. Required on PUT (CreateOrReplace) requests.
string
groupId
The ID of the Power BI group.
string
groupName
The name of the Power BI group. Use this property to help remember which specific Power BI group id was used.
string
refreshToken
A refresh token that can be used to obtain a valid access token that can then be used to authenticate with the data source. A valid refresh token is currently only obtainable via the Azure Portal. It is recommended to put a dummy string value here when creating the data source and then going to the Azure Portal to authenticate the data source which will update this property with a valid refresh token. Required on PUT (CreateOrReplace) requests.
string
table
The name of the Power BI table under the specified dataset. Required on PUT (CreateOrReplace) requests.
string
tokenUserDisplayName
The user display name of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
tokenUserPrincipalName
The user principal name (UPN) of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
Sku
Name
Description
Value
name
The name of the SKU. Required on PUT (CreateOrReplace) requests.
'Standard'
Transformation
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with a transformation. Required on PUT (CreateOrReplace) requests.
Specifies the query that will be run in the streaming job. You can learn more about the Stream Analytics Query Language (SAQL) here: https://msdn.microsoft.com/library/azure/dn834998 . Required on PUT (CreateOrReplace) requests.
string
streamingUnits
Specifies the number of streaming units that the streaming job uses.
int
Quickstart templates
The following quickstart templates deploy this resource type.
This template creates a Standard Stream Analytics Job. For more information, Azure Stream Analytics is a real-time analytics and complex event-processing engine that is designed to analyze and process high volumes of fast streaming data from multiple sources simultaneously. Patterns and relationships can be identified in information extracted from a number of input sources including devices, sensors, clickstreams, social media feeds, and applications. These patterns can be used to trigger actions and initiate workflows such creating alerts, feeding information to a reporting tool, or storing transformed data for later use. Also, Stream Analytics is available on Azure IoT Edge runtime, and supports the same exact language or syntax as cloud.
Terraform (AzAPI provider) resource definition
The streamingjobs resource type can be deployed with operations that target:
Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.StreamAnalytics/streamingjobs resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.StreamAnalytics/streamingjobs@2016-03-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
compatibilityLevel = "1.0"
dataLocale = "string"
eventsLateArrivalMaxDelayInSeconds = int
eventsOutOfOrderMaxDelayInSeconds = int
eventsOutOfOrderPolicy = "string"
functions = [
{
name = "string"
properties = {
type = "string"
// For remaining properties, see FunctionProperties objects
}
}
]
inputs = [
{
name = "string"
properties = {
serialization = {
type = "string"
// For remaining properties, see Serialization objects
}
type = "string"
// For remaining properties, see InputProperties objects
}
}
]
outputErrorPolicy = "string"
outputs = [
{
name = "string"
properties = {
datasource = {
type = "string"
// For remaining properties, see OutputDataSource objects
}
serialization = {
type = "string"
// For remaining properties, see Serialization objects
}
}
}
]
outputStartMode = "string"
outputStartTime = "string"
sku = {
name = "Standard"
}
transformation = {
name = "string"
properties = {
query = "string"
streamingUnits = int
}
}
}
})
}
FunctionProperties objects
Set the type property to specify the type of object.
For Scalar, use:
type = "Scalar"
properties = {
binding = {
type = "string"
// For remaining properties, see FunctionBinding objects
}
inputs = [
{
dataType = "string"
isConfigurationParameter = bool
}
]
output = {
dataType = "string"
}
}
FunctionBinding objects
Set the type property to specify the type of object.
For Microsoft.MachineLearning/WebService, use:
type = "Microsoft.MachineLearning/WebService"
properties = {
apiKey = "string"
batchSize = int
endpoint = "string"
inputs = {
columnNames = [
{
dataType = "string"
mapTo = int
name = "string"
}
]
name = "string"
}
outputs = [
{
dataType = "string"
name = "string"
}
]
}
For Microsoft.StreamAnalytics/JavascriptUdf, use:
type = "Microsoft.StreamAnalytics/JavascriptUdf"
properties = {
script = "string"
}
InputProperties objects
Set the type property to specify the type of object.
For Reference, use:
type = "Reference"
datasource = {
type = "string"
// For remaining properties, see ReferenceInputDataSource objects
}
For Stream, use:
type = "Stream"
datasource = {
type = "string"
// For remaining properties, see StreamInputDataSource objects
}
Serialization objects
Set the type property to specify the type of object.
Controls certain runtime behaviors of the streaming job.
"1.0"
dataLocale
The data locale of the stream analytics job. Value should be the name of a supported .NET Culture from the set https://msdn.microsoft.com/library/system.globalization.culturetypes(v=vs.110).aspx. Defaults to 'en-US' if none specified.
string
eventsLateArrivalMaxDelayInSeconds
The maximum tolerable delay in seconds where events arriving late could be included. Supported range is -1 to 1814399 (20.23:59:59 days) and -1 is used to specify wait indefinitely. If the property is absent, it is interpreted to have a value of -1.
int
eventsOutOfOrderMaxDelayInSeconds
The maximum tolerable delay in seconds where out-of-order events can be adjusted to be back in order.
int
eventsOutOfOrderPolicy
Indicates the policy to apply to events that arrive out of order in the input event stream.
"Adjust" "Drop"
functions
A list of one or more functions for the streaming job. The name property for each function is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual transformation.
A list of one or more inputs to the streaming job. The name property for each input is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual input.
Indicates the policy to apply to events that arrive at the output and cannot be written to the external storage due to being malformed (missing column values, column values of wrong type or size).
"Drop" "Stop"
outputs
A list of one or more outputs for the streaming job. The name property for each output is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual output.
This property should only be utilized when it is desired that the job be started immediately upon creation. Value may be JobStartTime, CustomTime, or LastOutputEventTime to indicate whether the starting point of the output event stream should start whenever the job is started, start at a custom user time stamp specified via the outputStartTime property, or start from the last event output time.
"CustomTime" "JobStartTime" "LastOutputEventTime"
outputStartTime
Value is either an ISO-8601 formatted time stamp that indicates the starting point of the output event stream, or null to indicate that the output event stream will start whenever the streaming job is started. This property must have a value if outputStartMode is set to CustomTime.
string
sku
Describes the SKU of the streaming job. Required on PUT (CreateOrReplace) requests.
Indicates the query and the number of streaming units to use for the streaming job. The name property of the transformation is required when specifying this property in a PUT request. This property cannot be modify via a PATCH operation. You must use the PATCH API available for the individual transformation.
The API key used to authenticate with Request-Response endpoint.
string
batchSize
Number between 1 and 10000 describing maximum number of rows for every Azure ML RRS execute request. Default is 1000.
int
endpoint
The Request-Response execute endpoint of the Azure Machine Learning web service. Find out more here: https://docs.microsoft.com/azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs
string
inputs
The inputs for the Azure Machine Learning web service endpoint.
The name of the input. This is the name provided while authoring the endpoint.
string
AzureMachineLearningWebServiceInputColumn
Name
Description
Value
dataType
The (Azure Machine Learning supported) data type of the input column. A list of valid Azure Machine Learning data types are described at https://msdn.microsoft.com/library/azure/dn905923.aspx .
string
mapTo
The zero based index of the function parameter this input maps to.
int
name
The name of the input column.
string
AzureMachineLearningWebServiceOutputColumn
Name
Description
Value
dataType
The (Azure Machine Learning supported) data type of the output column. A list of valid Azure Machine Learning data types are described at https://msdn.microsoft.com/library/azure/dn905923.aspx .
The JavaScript code containing a single function definition. For example: 'function (x, y) { return x + y; }'
string
FunctionInput
Name
Description
Value
dataType
The (Azure Stream Analytics supported) data type of the function input parameter. A list of valid Azure Stream Analytics data types are described at https://msdn.microsoft.com/library/azure/dn835065.aspx
string
isConfigurationParameter
A flag indicating if the parameter is a configuration parameter. True if this input parameter is expected to be a constant. Default is false.
bool
FunctionOutput
Name
Description
Value
dataType
The (Azure Stream Analytics supported) data type of the function output. A list of valid Azure Stream Analytics data types are described at https://msdn.microsoft.com/library/azure/dn835065.aspx
string
Input
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with an input. Required on PUT (CreateOrReplace) requests.
Specifies the encoding of the incoming data in the case of input and the encoding of outgoing data in the case of output. Required on PUT (CreateOrReplace) requests.
"UTF8"
fieldDelimiter
Specifies the delimiter that will be used to separate comma-separated value (CSV) records. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a list of supported values. Required on PUT (CreateOrReplace) requests.
string
JsonSerialization
Name
Description
Value
type
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
"Json" (required)
properties
The properties that are associated with the JSON serialization type. Required on PUT (CreateOrReplace) requests.
Specifies the encoding of the incoming data in the case of input and the encoding of outgoing data in the case of output. Required on PUT (CreateOrReplace) requests.
"UTF8"
format
This property only applies to JSON serialization of outputs only. It is not applicable to inputs. This property specifies the format of the JSON the output will be written in. The currently supported values are 'lineSeparated' indicating the output will be formatted by having each JSON object separated by a new line and 'array' indicating the output will be formatted as an array of JSON objects. Default value is 'lineSeparated' if left null.
"Array" "LineSeparated"
ReferenceInputProperties
Name
Description
Value
type
Indicates whether the input is a source of reference data or stream data. Required on PUT (CreateOrReplace) requests.
"Reference" (required)
datasource
Describes an input data source that contains reference data. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The name of an IoT Hub Consumer Group that should be used to read events from the IoT Hub. If not specified, the input uses the Iot Hub’s default consumer group.
string
endpoint
The IoT Hub endpoint to connect to (ie. messages/events, messages/operationsMonitoringEvents, etc.).
string
iotHubNamespace
The name or the URI of the IoT Hub. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyKey
The shared access policy key for the specified shared access policy. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyName
The shared access policy name for the IoT Hub. This policy must contain at least the Service connect permission. Required on PUT (CreateOrReplace) requests.
string
EventHubStreamInputDataSource
Name
Description
Value
type
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
"Microsoft.ServiceBus/EventHub" (required)
properties
The properties that are associated with an Event Hub input containing stream data. Required on PUT (CreateOrReplace) requests.
The name of an Event Hub Consumer Group that should be used to read events from the Event Hub. Specifying distinct consumer group names for multiple inputs allows each of those inputs to receive the same events from the Event Hub. If not specified, the input uses the Event Hub’s default consumer group.
string
eventHubName
The name of the Event Hub. Required on PUT (CreateOrReplace) requests.
string
serviceBusNamespace
The namespace that is associated with the desired Event Hub, Service Bus Queue, Service Bus Topic, etc. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyKey
The shared access policy key for the specified shared access policy. Required on PUT (CreateOrReplace) requests.
string
sharedAccessPolicyName
The shared access policy name for the Event Hub, Service Bus Queue, Service Bus Topic, etc. Required on PUT (CreateOrReplace) requests.
string
BlobStreamInputDataSource
Name
Description
Value
type
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
"Microsoft.Storage/Blob" (required)
properties
The properties that are associated with a blob input containing stream data. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
sourcePartitionCount
The partition count of the blob input data source. Range 1 - 1024.
int
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The name of the Azure Data Lake Store account. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in filePathPrefix, the value of this property is used as the date format instead.
string
filePathPrefix
The location of the file to which the output should be written to. Required on PUT (CreateOrReplace) requests.
string
refreshToken
A refresh token that can be used to obtain a valid access token that can then be used to authenticate with the data source. A valid refresh token is currently only obtainable via the Azure Portal. It is recommended to put a dummy string value here when creating the data source and then going to the Azure Portal to authenticate the data source which will update this property with a valid refresh token. Required on PUT (CreateOrReplace) requests.
string
tenantId
The tenant id of the user used to obtain the refresh token. Required on PUT (CreateOrReplace) requests.
string
timeFormat
The time format. Wherever {time} appears in filePathPrefix, the value of this property is used as the time format instead.
string
tokenUserDisplayName
The user display name of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
tokenUserPrincipalName
The user principal name (UPN) of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
EventHubOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
"Microsoft.ServiceBus/EventHub" (required)
properties
The properties that are associated with an Event Hub output. Required on PUT (CreateOrReplace) requests.
The name of a container within the associated Storage account. This container contains either the blob(s) to be read from or written to. Required on PUT (CreateOrReplace) requests.
string
dateFormat
The date format. Wherever {date} appears in pathPattern, the value of this property is used as the date format instead.
string
pathPattern
The blob path pattern. Not a regular expression. It represents a pattern against which blob names will be matched to determine whether or not they should be included as input or output to the job. See https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-input or https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for a more detailed explanation and example.
string
storageAccounts
A list of one or more Azure Storage accounts. Required on PUT (CreateOrReplace) requests.
The DocumentDB account name or ID. Required on PUT (CreateOrReplace) requests.
string
accountKey
The account key for the DocumentDB account. Required on PUT (CreateOrReplace) requests.
string
collectionNamePattern
The collection name pattern for the collections to be used. The collection name format can be constructed using the optional {partition} token, where partitions start from 0. See the DocumentDB section of https://docs.microsoft.com/rest/api/streamanalytics/stream-analytics-output for more information. Required on PUT (CreateOrReplace) requests.
string
database
The name of the DocumentDB database. Required on PUT (CreateOrReplace) requests.
string
documentId
The name of the field in output events used to specify the primary key which insert or update operations are based on.
string
partitionKey
The name of the field in output events used to specify the key for partitioning output across collections. If 'collectionNamePattern' contains the {partition} token, this property is required to be specified.
string
AzureTableOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
"Microsoft.Storage/Table" (required)
properties
The properties that are associated with an Azure Table output. Required on PUT (CreateOrReplace) requests.
The account key for the Azure Storage account. Required on PUT (CreateOrReplace) requests.
string
accountName
The name of the Azure Storage account. Required on PUT (CreateOrReplace) requests.
string
batchSize
The number of rows to write to the Azure Table at a time.
int
columnsToRemove
If specified, each item in the array is the name of a column to remove (if present) from output event entities.
string[]
partitionKey
This element indicates the name of a column from the SELECT statement in the query that will be used as the partition key for the Azure Table. Required on PUT (CreateOrReplace) requests.
string
rowKey
This element indicates the name of a column from the SELECT statement in the query that will be used as the row key for the Azure Table. Required on PUT (CreateOrReplace) requests.
string
table
The name of the Azure Table. Required on PUT (CreateOrReplace) requests.
string
PowerBIOutputDataSource
Name
Description
Value
type
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
"PowerBI" (required)
properties
The properties that are associated with a Power BI output. Required on PUT (CreateOrReplace) requests.
The name of the Power BI dataset. Required on PUT (CreateOrReplace) requests.
string
groupId
The ID of the Power BI group.
string
groupName
The name of the Power BI group. Use this property to help remember which specific Power BI group id was used.
string
refreshToken
A refresh token that can be used to obtain a valid access token that can then be used to authenticate with the data source. A valid refresh token is currently only obtainable via the Azure Portal. It is recommended to put a dummy string value here when creating the data source and then going to the Azure Portal to authenticate the data source which will update this property with a valid refresh token. Required on PUT (CreateOrReplace) requests.
string
table
The name of the Power BI table under the specified dataset. Required on PUT (CreateOrReplace) requests.
string
tokenUserDisplayName
The user display name of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
tokenUserPrincipalName
The user principal name (UPN) of the user that was used to obtain the refresh token. Use this property to help remember which user was used to obtain the refresh token.
string
Sku
Name
Description
Value
name
The name of the SKU. Required on PUT (CreateOrReplace) requests.
"Standard"
Transformation
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with a transformation. Required on PUT (CreateOrReplace) requests.
Specifies the query that will be run in the streaming job. You can learn more about the Stream Analytics Query Language (SAQL) here: https://msdn.microsoft.com/library/azure/dn834998 . Required on PUT (CreateOrReplace) requests.
string
streamingUnits
Specifies the number of streaming units that the streaming job uses.