Share via


Inputs - Test

Testa se a fonte de dados de uma entrada é acessível e utilizável pelo serviço do Azure Stream Analytics.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StreamAnalytics/streamingjobs/{jobName}/inputs/{inputName}/test?api-version=2020-03-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
inputName
path True

string

Nome da entrada.

jobName
path True

string

O nome do trabalho de streaming.

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
name

string

Nome do recurso

properties InputProperties:

As propriedades associadas a uma entrada. Necessário em solicitações PUT (CreateOrReplace).

Respostas

Nome Tipo Description
200 OK

ResourceTestStatus

A operação de teste foi concluída com êxito.

202 Accepted

A solicitação de teste foi iniciada com êxito.

Other Status Codes

Error

Erro.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Test the connection for an input

Sample Request

POST https://management.azure.com/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourcegroups/sjrg8440/providers/Microsoft.StreamAnalytics/streamingjobs/sj9597/inputs/input7225/test?api-version=2020-03-01

Sample Response

{
  "status": "TestSucceeded"
}

Definições

Nome Description
AuthenticationMode

Modo de autenticação. Os modos válidos são ConnectionString, Msi e 'UserToken'.

AvroSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato Avro.

AzureSqlReferenceInputDataSource

Descreve uma fonte de dados de entrada de referência de banco de dados SQL do Azure.

BlobReferenceInputDataSource

Descreve uma fonte de dados de entrada de blob que contém dados de referência.

BlobStreamInputDataSource

Descreve uma fonte de dados de entrada de blob que contém dados de fluxo.

Compression

Descreve como os dados de entrada são compactados

CompressionType

Indica o tipo de compactação que a entrada usa. Necessário em solicitações PUT (CreateOrReplace).

CsvSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato CSV.

DiagnosticCondition

Condição aplicável ao recurso ou ao trabalho em geral, que garante a atenção do cliente.

Diagnostics

Descreve as condições aplicáveis à Entrada, à Saída ou ao trabalho em geral, que garantem a atenção do cliente.

Encoding

Especifica a codificação dos dados de entrada no caso de entrada e a codificação de dados de saída no caso de saída.

Error

Representação de erro comum.

ErrorResponse

Descreve o erro ocorrido.

EventHubStreamInputDataSource

Descreve uma fonte de dados de entrada do Hub de Eventos que contém dados de fluxo.

EventHubV2StreamInputDataSource

Descreve uma fonte de dados de entrada do Hub de Eventos que contém dados de fluxo.

EventSerializationType

Indica o tipo de serialização que a entrada ou saída usa. Necessário em solicitações PUT (CreateOrReplace).

FileReferenceInputDataSource

Descreve uma fonte de dados de entrada de arquivo que contém dados de referência.

GatewayMessageBusStreamInputDataSource

Descreve uma fonte de dados de entrada de blob que contém dados de fluxo.

Input

Um objeto de entrada que contém todas as informações associadas à entrada nomeada. Todas as entradas estão contidas em um trabalho de streaming.

IoTHubStreamInputDataSource

Descreve uma fonte de dados de entrada Hub IoT que contém dados de fluxo.

JsonOutputSerializationFormat

Especifica o formato do JSON no qual a saída será gravada. Os valores com suporte no momento são 'lineSeparated' indicando que a saída será formatada com cada objeto JSON separado por uma nova linha e 'array' indicando que a saída será formatada como uma matriz de objetos JSON.

JsonSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato JSON.

ParquetSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato Parquet.

ReferenceInputProperties

As propriedades associadas a uma entrada que contém dados de referência.

RefreshType

Indica o tipo de opção de atualização de dados.

ResourceTestStatus

Descreve o status da operação de teste junto com informações de erro, se aplicável.

StorageAccount

As propriedades associadas a uma conta de Armazenamento do Azure

StreamInputProperties

As propriedades associadas a uma entrada que contém dados de fluxo.

AuthenticationMode

Modo de autenticação. Os modos válidos são ConnectionString, Msi e 'UserToken'.

Nome Tipo Description
ConnectionString

string

Msi

string

UserToken

string

AvroSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato Avro.

Nome Tipo Description
type string:

Avro

Indica o tipo de serialização que a entrada ou saída usa. Necessário em solicitações PUT (CreateOrReplace).

AzureSqlReferenceInputDataSource

Descreve uma fonte de dados de entrada de referência de banco de dados SQL do Azure.

Nome Tipo Description
properties.database

string

Este elemento é associado ao elemento datasource. Esse é o nome do banco de dados no qual a saída será gravada.

properties.deltaSnapshotQuery

string

Este elemento é associado ao elemento datasource. Essa consulta é usada para buscar alterações incrementais do banco de dados SQL. Para usar essa opção, recomendamos usar tabelas temporais no banco de dados SQL do Azure.

properties.fullSnapshotQuery

string

Este elemento é associado ao elemento datasource. Essa consulta é usada para buscar dados do banco de dados sql.

properties.password

string

Este elemento é associado ao elemento datasource. Essa é a senha que será usada para se conectar à instância do banco de dados SQL.

properties.refreshRate

string

Este elemento é associado ao elemento datasource. Isso indica com que frequência os dados serão buscados do banco de dados. É do formato DateTime.

properties.refreshType

RefreshType

Indica o tipo de opção de atualização de dados.

properties.server

string

Este elemento é associado ao elemento datasource. Esse é o nome do servidor que contém o banco de dados no qual será gravado.

properties.table

string

Este elemento é associado ao elemento datasource. O nome da tabela no banco de dados SQL do Azure..

properties.user

string

Este elemento é associado ao elemento datasource. Esse é o nome de usuário que será usado para se conectar à instância do banco de dados SQL.

type string:

Microsoft.Sql/Server/Database

Indica o tipo de fonte de dados de entrada que contém dados de referência. Necessário em solicitações PUT (CreateOrReplace).

BlobReferenceInputDataSource

Descreve uma fonte de dados de entrada de blob que contém dados de referência.

Nome Tipo Valor padrão Description
properties.authenticationMode

AuthenticationMode

ConnectionString

Modo de autenticação.

properties.container

string

O nome de um contêiner dentro da conta de Armazenamento associada. Esse contêiner contém os blobs a serem lidos ou gravados. Necessário em solicitações PUT (CreateOrReplace).

properties.dateFormat

string

O formato de data. Onde quer que {date} apareça em pathPattern, o valor dessa propriedade é usado como o formato de data.

properties.pathPattern

string

O padrão de caminho do blob. Não é uma expressão regular. Ele representa um padrão em relação ao qual os nomes de blob serão correspondidos para determinar se eles devem ou não ser incluídos como entrada ou saída para o trabalho. Confira https://docs.microsoft.com/en-us/rest/api/streamanalytics/stream-analytics-input ou https://docs.microsoft.com/en-us/rest/api/streamanalytics/stream-analytics-output para obter uma explicação e um exemplo mais detalhados.

properties.storageAccounts

StorageAccount[]

Uma lista de uma ou mais contas de Armazenamento do Azure. Necessário em solicitações PUT (CreateOrReplace).

properties.timeFormat

string

O formato de hora. Onde quer que {time} apareça em pathPattern, o valor dessa propriedade é usado como o formato de hora.

type string:

Microsoft.Storage/Blob

Indica o tipo de fonte de dados de entrada que contém dados de referência. Necessário em solicitações PUT (CreateOrReplace).

BlobStreamInputDataSource

Descreve uma fonte de dados de entrada de blob que contém dados de fluxo.

Nome Tipo Valor padrão Description
properties.authenticationMode

AuthenticationMode

ConnectionString

Modo de autenticação.

properties.container

string

O nome de um contêiner dentro da conta de Armazenamento associada. Esse contêiner contém os blobs a serem lidos ou gravados. Necessário em solicitações PUT (CreateOrReplace).

properties.dateFormat

string

O formato de data. Onde quer que {date} apareça em pathPattern, o valor dessa propriedade é usado como o formato de data.

properties.pathPattern

string

O padrão de caminho do blob. Não é uma expressão regular. Ele representa um padrão em relação ao qual os nomes de blob serão correspondidos para determinar se eles devem ou não ser incluídos como entrada ou saída para o trabalho. Confira https://docs.microsoft.com/en-us/rest/api/streamanalytics/stream-analytics-input ou https://docs.microsoft.com/en-us/rest/api/streamanalytics/stream-analytics-output para obter uma explicação e um exemplo mais detalhados.

properties.sourcePartitionCount

integer

A contagem de partições da fonte de dados de entrada de blob. Intervalo de 1 a 1024.

properties.storageAccounts

StorageAccount[]

Uma lista de uma ou mais contas de Armazenamento do Azure. Necessário em solicitações PUT (CreateOrReplace).

properties.timeFormat

string

O formato de hora. Onde quer que {time} apareça em pathPattern, o valor dessa propriedade é usado como o formato de hora.

type string:

Microsoft.Storage/Blob

Indica o tipo de fonte de dados de entrada que contém dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

Compression

Descreve como os dados de entrada são compactados

Nome Tipo Valor padrão Description
type

CompressionType

None

Indica o tipo de compactação que a entrada usa. Necessário em solicitações PUT (CreateOrReplace).

CompressionType

Indica o tipo de compactação que a entrada usa. Necessário em solicitações PUT (CreateOrReplace).

Nome Tipo Description
Deflate

string

GZip

string

None

string

CsvSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato CSV.

Nome Tipo Description
properties.encoding

Encoding

Especifica a codificação dos dados de entrada no caso de entrada e a codificação de dados de saída no caso de saída. Necessário em solicitações PUT (CreateOrReplace).

properties.fieldDelimiter

string

Especifica o delimitador que será usado para separar registros CSV (valores separados por vírgula). Confira https://docs.microsoft.com/en-us/rest/api/streamanalytics/stream-analytics-input ou https://docs.microsoft.com/en-us/rest/api/streamanalytics/stream-analytics-output para obter uma lista de valores com suporte. Necessário em solicitações PUT (CreateOrReplace).

type string:

Csv

Indica o tipo de serialização que a entrada ou saída usa. Necessário em solicitações PUT (CreateOrReplace).

DiagnosticCondition

Condição aplicável ao recurso ou ao trabalho em geral, que garante a atenção do cliente.

Nome Tipo Description
code

string

O código de diagnóstico opaco.

message

string

A mensagem legível por humanos que descreve a condição em detalhes. Localizado no Accept-Language da solicitação do cliente.

since

string

O carimbo de data/hora UTC de quando a condição foi iniciada. Os clientes devem ser capazes de encontrar um evento correspondente no log de operações neste momento.

Diagnostics

Descreve as condições aplicáveis à Entrada, à Saída ou ao trabalho em geral, que garantem a atenção do cliente.

Nome Tipo Description
conditions

DiagnosticCondition[]

Uma coleção de zero ou mais condições aplicáveis ao recurso ou ao trabalho em geral, que garantem a atenção do cliente.

Encoding

Especifica a codificação dos dados de entrada no caso de entrada e a codificação de dados de saída no caso de saída.

Nome Tipo Description
UTF8

string

Error

Representação de erro comum.

Nome Tipo Description
error

Error

Propriedades de definição de erro.

ErrorResponse

Descreve o erro ocorrido.

Nome Tipo Description
code

string

Código de erro associado ao erro ocorrido.

message

string

Descreve o erro em detalhes.

EventHubStreamInputDataSource

Descreve uma fonte de dados de entrada do Hub de Eventos que contém dados de fluxo.

Nome Tipo Valor padrão Description
authenticationMode

AuthenticationMode

ConnectionString

Modo de autenticação.

properties.consumerGroupName

string

O nome de um Grupo de Consumidores do Hub de Eventos que deve ser usado para ler eventos do Hub de Eventos. Especificar nomes de grupos de consumidores distintos para várias entradas permite que cada uma dessas entradas receba os mesmos eventos do Hub de Eventos. Se não for especificada, a entrada usará o grupo de consumidores padrão do Hub de Eventos.

properties.eventHubName

string

O nome do Hub de Eventos. Necessário em solicitações PUT (CreateOrReplace).

serviceBusNamespace

string

O namespace associado ao Hub de Eventos desejado, fila do Barramento de Serviço, Tópico do Barramento de Serviço etc. Necessário em solicitações PUT (CreateOrReplace).

sharedAccessPolicyKey

string

A chave de política de acesso compartilhado para a política de acesso compartilhado especificada. Necessário em solicitações PUT (CreateOrReplace).

sharedAccessPolicyName

string

O nome da política de acesso compartilhado para o Hub de Eventos, Fila do Barramento de Serviço, Tópico do Barramento de Serviço etc. Necessário em solicitações PUT (CreateOrReplace).

type string:

Microsoft.ServiceBus/EventHub

Indica o tipo de fonte de dados de entrada que contém dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

EventHubV2StreamInputDataSource

Descreve uma fonte de dados de entrada do Hub de Eventos que contém dados de fluxo.

Nome Tipo Valor padrão Description
authenticationMode

AuthenticationMode

ConnectionString

Modo de autenticação.

properties.consumerGroupName

string

O nome de um Grupo de Consumidores do Hub de Eventos que deve ser usado para ler eventos do Hub de Eventos. Especificar nomes de grupos de consumidores distintos para várias entradas permite que cada uma dessas entradas receba os mesmos eventos do Hub de Eventos. Se não for especificada, a entrada usará o grupo de consumidores padrão do Hub de Eventos.

properties.eventHubName

string

O nome do Hub de Eventos. Necessário em solicitações PUT (CreateOrReplace).

serviceBusNamespace

string

O namespace associado ao Hub de Eventos desejado, fila do Barramento de Serviço, Tópico do Barramento de Serviço etc. Necessário em solicitações PUT (CreateOrReplace).

sharedAccessPolicyKey

string

A chave de política de acesso compartilhado para a política de acesso compartilhado especificada. Necessário em solicitações PUT (CreateOrReplace).

sharedAccessPolicyName

string

O nome da política de acesso compartilhado para o Hub de Eventos, Fila do Barramento de Serviço, Tópico do Barramento de Serviço etc. Necessário em solicitações PUT (CreateOrReplace).

type string:

Microsoft.EventHub/EventHub

Indica o tipo de fonte de dados de entrada que contém dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

EventSerializationType

Indica o tipo de serialização que a entrada ou saída usa. Necessário em solicitações PUT (CreateOrReplace).

Nome Tipo Description
Avro

string

Csv

string

Json

string

Parquet

string

FileReferenceInputDataSource

Descreve uma fonte de dados de entrada de arquivo que contém dados de referência.

Nome Tipo Description
properties.path

string

O caminho do arquivo.

type string:

File

Indica o tipo de fonte de dados de entrada que contém dados de referência. Necessário em solicitações PUT (CreateOrReplace).

GatewayMessageBusStreamInputDataSource

Descreve uma fonte de dados de entrada de blob que contém dados de fluxo.

Nome Tipo Description
properties.topic

string

O nome do tópico do Barramento de Serviço.

type string:

GatewayMessageBus

Indica o tipo de fonte de dados de entrada que contém dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

Input

Um objeto de entrada que contém todas as informações associadas à entrada nomeada. Todas as entradas estão contidas em um trabalho de streaming.

Nome Tipo Description
id

string

ID do recurso

name

string

Nome do recurso

properties InputProperties:

As propriedades associadas a uma entrada. Necessário em solicitações PUT (CreateOrReplace).

type

string

Tipo de recurso

IoTHubStreamInputDataSource

Descreve uma fonte de dados de entrada Hub IoT que contém dados de fluxo.

Nome Tipo Description
properties.consumerGroupName

string

O nome de um grupo de consumidores Hub IoT que deve ser usado para ler eventos do Hub IoT. Se não for especificado, a entrada usará o grupo de consumidores padrão do Hub Iot.

properties.endpoint

string

O Hub IoT ponto de extremidade ao qual se conectar (ou seja, mensagens/eventos, mensagens/operaçõesMonitoringEvents etc.).

properties.iotHubNamespace

string

O nome ou o URI do Hub IoT. Necessário em solicitações PUT (CreateOrReplace).

properties.sharedAccessPolicyKey

string

A chave de política de acesso compartilhado para a política de acesso compartilhado especificada. Necessário em solicitações PUT (CreateOrReplace).

properties.sharedAccessPolicyName

string

O nome da política de acesso compartilhado para o Hub IoT. Essa política deve conter pelo menos a permissão conexão de serviço. Necessário em solicitações PUT (CreateOrReplace).

type string:

Microsoft.Devices/IotHubs

Indica o tipo de fonte de dados de entrada que contém dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

JsonOutputSerializationFormat

Especifica o formato do JSON no qual a saída será gravada. Os valores com suporte no momento são 'lineSeparated' indicando que a saída será formatada com cada objeto JSON separado por uma nova linha e 'array' indicando que a saída será formatada como uma matriz de objetos JSON.

Nome Tipo Description
Array

string

LineSeparated

string

JsonSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato JSON.

Nome Tipo Description
properties.encoding

Encoding

Especifica a codificação dos dados de entrada no caso de entrada e a codificação de dados de saída no caso de saída. Necessário em solicitações PUT (CreateOrReplace).

properties.format

JsonOutputSerializationFormat

Essa propriedade só se aplica à serialização JSON de saídas. Não é aplicável a entradas. Essa propriedade especifica o formato do JSON no qual a saída será gravada. Os valores com suporte no momento são 'lineSeparated' indicando que a saída será formatada com cada objeto JSON separado por uma nova linha e 'array' indicando que a saída será formatada como uma matriz de objetos JSON. O valor padrão será 'lineSeparated' se for nulo à esquerda.

type string:

Json

Indica o tipo de serialização que a entrada ou saída usa. Necessário em solicitações PUT (CreateOrReplace).

ParquetSerialization

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída no formato Parquet.

Nome Tipo Description
type string:

Parquet

Indica o tipo de serialização que a entrada ou saída usa. Necessário em solicitações PUT (CreateOrReplace).

ReferenceInputProperties

As propriedades associadas a uma entrada que contém dados de referência.

Nome Tipo Description
compression

Compression

Descreve como os dados de entrada são compactados

datasource ReferenceInputDataSource:

Descreve uma fonte de dados de entrada que contém dados de referência. Necessário em solicitações PUT (CreateOrReplace).

diagnostics

Diagnostics

Descreve as condições aplicáveis à Entrada, à Saída ou ao trabalho em geral, que garantem a atenção do cliente.

etag

string

A marca de entidade atual para a entrada. Essa é uma cadeia de caracteres opaca. Você pode usá-lo para detectar se o recurso foi alterado entre solicitações. Você também pode usá-lo nos cabeçalhos If-Match ou If-None-Match para operações de gravação para simultaneidade otimista.

partitionKey

string

partitionKey Descreve uma chave nos dados de entrada que é usada para particionar os dados de entrada

serialization Serialization:

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída. Necessário em solicitações PUT (CreateOrReplace).

type string:

Reference

Indica se a entrada é uma fonte de dados de referência ou dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

RefreshType

Indica o tipo de opção de atualização de dados.

Nome Tipo Description
RefreshPeriodicallyWithDelta

string

RefreshPeriodicallyWithFull

string

Static

string

ResourceTestStatus

Descreve o status da operação de teste junto com informações de erro, se aplicável.

Nome Tipo Description
error

ErrorResponse

Descreve o erro ocorrido.

status

string

O status da operação de teste.

StorageAccount

As propriedades associadas a uma conta de Armazenamento do Azure

Nome Tipo Description
accountKey

string

A chave de conta para a conta de Armazenamento do Azure. Necessário em solicitações PUT (CreateOrReplace).

accountName

string

O nome da conta de Armazenamento do Azure. Necessário em solicitações PUT (CreateOrReplace).

StreamInputProperties

As propriedades associadas a uma entrada que contém dados de fluxo.

Nome Tipo Description
compression

Compression

Descreve como os dados de entrada são compactados

datasource StreamInputDataSource:

Descreve uma fonte de dados de entrada que contém dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).

diagnostics

Diagnostics

Descreve as condições aplicáveis à Entrada, à Saída ou ao trabalho em geral, que garantem a atenção do cliente.

etag

string

A marca de entidade atual para a entrada. Essa é uma cadeia de caracteres opaca. Você pode usá-lo para detectar se o recurso foi alterado entre solicitações. Você também pode usá-lo nos cabeçalhos If-Match ou If-None-Match para operações de gravação para simultaneidade otimista.

partitionKey

string

partitionKey Descreve uma chave nos dados de entrada que é usada para particionar os dados de entrada

serialization Serialization:

Descreve como os dados de uma entrada são serializados ou como os dados são serializados quando gravados em uma saída. Necessário em solicitações PUT (CreateOrReplace).

type string:

Stream

Indica se a entrada é uma fonte de dados de referência ou dados de fluxo. Necessário em solicitações PUT (CreateOrReplace).