Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.DataLake/Accounts' (required)
AzureDataLakeStoreOutputDataSourceProperties
Name
Description
Value
accountName
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
AzureMachineLearningWebServiceFunctionBinding
Name
Description
Value
properties
The binding properties associated with an Azure Machine learning web service.
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: /azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs
string
inputs
The inputs for the Azure Machine Learning web service endpoint.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Table' (required)
AzureTableOutputDataSourceProperties
Name
Description
Value
accountKey
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
BlobOutputDataSource
Name
Description
Value
properties
The properties that are associated with a blob output. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobOutputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of input data source containing reference data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobReferenceInputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobStreamInputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Csv' (required)
CsvSerializationProperties
Name
Description
Value
encoding
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 /rest/api/streamanalytics/stream-analytics-input or /rest/api/streamanalytics/stream-analytics-output for a list of supported values. Required on PUT (CreateOrReplace) requests.
string
DocumentDbOutputDataSource
Name
Description
Value
properties
The properties that are associated with a DocumentDB output. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/DocumentDB' (required)
DocumentDbOutputDataSourceProperties
Name
Description
Value
accountId
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 /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
EventHubOutputDataSource
Name
Description
Value
properties
The properties that are associated with an Event Hub output. Required on PUT (CreateOrReplace) requests.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
EventHubStreamInputDataSourceProperties
Name
Description
Value
consumerGroupName
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
Function
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with a function.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Devices/IotHubs' (required)
IoTHubStreamInputDataSourceProperties
Name
Description
Value
consumerGroupName
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
JavaScriptFunctionBinding
Name
Description
Value
properties
The binding properties associated with a JavaScript function.
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Json' (required)
JsonSerializationProperties
Name
Description
Value
encoding
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'
Microsoft.StreamAnalytics/streamingjobs
Name
Description
Value
location
The geo-location where the resource lives
string
name
The resource name
string (required)
properties
The properties that are associated with a streaming job. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'PowerBI' (required)
PowerBIOutputDataSourceProperties
Name
Description
Value
dataset
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.
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.
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 samples
The following quickstart samples 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:
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.DataLake/Accounts' (required)
AzureDataLakeStoreOutputDataSourceProperties
Name
Description
Value
accountName
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
AzureMachineLearningWebServiceFunctionBinding
Name
Description
Value
properties
The binding properties associated with an Azure Machine learning web service.
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: /azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs
string
inputs
The inputs for the Azure Machine Learning web service endpoint.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Table' (required)
AzureTableOutputDataSourceProperties
Name
Description
Value
accountKey
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
BlobOutputDataSource
Name
Description
Value
properties
The properties that are associated with a blob output. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobOutputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of input data source containing reference data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobReferenceInputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobStreamInputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Csv' (required)
CsvSerializationProperties
Name
Description
Value
encoding
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 /rest/api/streamanalytics/stream-analytics-input or /rest/api/streamanalytics/stream-analytics-output for a list of supported values. Required on PUT (CreateOrReplace) requests.
string
DocumentDbOutputDataSource
Name
Description
Value
properties
The properties that are associated with a DocumentDB output. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/DocumentDB' (required)
DocumentDbOutputDataSourceProperties
Name
Description
Value
accountId
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 /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
EventHubOutputDataSource
Name
Description
Value
properties
The properties that are associated with an Event Hub output. Required on PUT (CreateOrReplace) requests.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
EventHubStreamInputDataSourceProperties
Name
Description
Value
consumerGroupName
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
Function
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with a function.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Devices/IotHubs' (required)
IoTHubStreamInputDataSourceProperties
Name
Description
Value
consumerGroupName
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
JavaScriptFunctionBinding
Name
Description
Value
properties
The binding properties associated with a JavaScript function.
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Json' (required)
JsonSerializationProperties
Name
Description
Value
encoding
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'
Microsoft.StreamAnalytics/streamingjobs
Name
Description
Value
apiVersion
The api version
'2016-03-01'
location
The geo-location where the resource lives
string
name
The resource name
string (required)
properties
The properties that are associated with a streaming job. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'PowerBI' (required)
PowerBIOutputDataSourceProperties
Name
Description
Value
dataset
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.
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.
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"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
compatibilityLevel = "string"
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 = "string"
}
transformation = {
name = "string"
properties = {
query = "string"
streamingUnits = int
}
}
}
})
}
FunctionBinding objects
Set the type property to specify the type of object.
For Microsoft.MachineLearning/WebService, use:
{
properties = {
apiKey = "string"
batchSize = int
endpoint = "string"
inputs = {
columnNames = [
{
dataType = "string"
mapTo = int
name = "string"
}
]
name = "string"
}
outputs = [
{
dataType = "string"
name = "string"
}
]
}
type = "Microsoft.MachineLearning/WebService"
}
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.DataLake/Accounts' (required)
AzureDataLakeStoreOutputDataSourceProperties
Name
Description
Value
accountName
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
AzureMachineLearningWebServiceFunctionBinding
Name
Description
Value
properties
The binding properties associated with an Azure Machine learning web service.
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: /azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs
string
inputs
The inputs for the Azure Machine Learning web service endpoint.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Table' (required)
AzureTableOutputDataSourceProperties
Name
Description
Value
accountKey
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
BlobOutputDataSource
Name
Description
Value
properties
The properties that are associated with a blob output. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobOutputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of input data source containing reference data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobReferenceInputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/Blob' (required)
BlobStreamInputDataSourceProperties
Name
Description
Value
container
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 /rest/api/streamanalytics/stream-analytics-input or /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.
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Csv' (required)
CsvSerializationProperties
Name
Description
Value
encoding
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 /rest/api/streamanalytics/stream-analytics-input or /rest/api/streamanalytics/stream-analytics-output for a list of supported values. Required on PUT (CreateOrReplace) requests.
string
DocumentDbOutputDataSource
Name
Description
Value
properties
The properties that are associated with a DocumentDB output. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'Microsoft.Storage/DocumentDB' (required)
DocumentDbOutputDataSourceProperties
Name
Description
Value
accountId
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 /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
EventHubOutputDataSource
Name
Description
Value
properties
The properties that are associated with an Event Hub output. Required on PUT (CreateOrReplace) requests.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.ServiceBus/EventHub' (required)
EventHubStreamInputDataSourceProperties
Name
Description
Value
consumerGroupName
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
Function
Name
Description
Value
name
Resource name
string
properties
The properties that are associated with a function.
Indicates the type of input data source containing stream data. Required on PUT (CreateOrReplace) requests.
'Microsoft.Devices/IotHubs' (required)
IoTHubStreamInputDataSourceProperties
Name
Description
Value
consumerGroupName
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
JavaScriptFunctionBinding
Name
Description
Value
properties
The binding properties associated with a JavaScript function.
Indicates the type of serialization that the input or output uses. Required on PUT (CreateOrReplace) requests.
'Json' (required)
JsonSerializationProperties
Name
Description
Value
encoding
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'
Microsoft.StreamAnalytics/streamingjobs
Name
Description
Value
location
The geo-location where the resource lives
string
name
The resource name
string (required)
properties
The properties that are associated with a streaming job. Required on PUT (CreateOrReplace) requests.
Indicates the type of data source output will be written to. Required on PUT (CreateOrReplace) requests.
'PowerBI' (required)
PowerBIOutputDataSourceProperties
Name
Description
Value
dataset
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.
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.
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.