Functions - Update

Atualiza uma função existente em um trabalho de streaming existente. Isso pode ser usado para atualizar parcialmente (ou seja, atualizar uma ou duas propriedades) uma função sem afetar o restante da definição de função ou trabalho.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StreamAnalytics/streamingjobs/{jobName}/functions/{functionName}?api-version=2020-03-01

Parâmetros de URI

Name In Required Type Description
functionName
path True
  • string

O nome da função.

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 essa operação.

Cabeçalho da solicitação

Name Required Type Description
If-Match
  • string

A ETag da função. Omita esse valor para sempre substituir a função atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.

Corpo da solicitação

Name Type Description
name
  • string

Nome do recurso

properties FunctionProperties:

As propriedades associadas a uma função.

Respostas

Name Type Description
200 OK

A função foi atualizada com êxito.

Headers

  • ETag: string
Other Status Codes

Erro.

Segurança

azure_auth

Flow Azure Active Directory OAuth2

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Update a JavaScript function
Update an Azure ML function

Update a JavaScript function

Sample Request

PATCH https://management.azure.com/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourcegroups/sjrg1637/providers/Microsoft.StreamAnalytics/streamingjobs/sj8653/functions/function8197?api-version=2020-03-01

{
  "properties": {
    "type": "Scalar",
    "properties": {
      "binding": {
        "type": "Microsoft.StreamAnalytics/JavascriptUdf",
        "properties": {
          "script": "function (a, b) { return a * b; }"
        }
      }
    }
  }
}

Sample Response

ETag: 94a512d5-2f59-4e39-b9c8-bca4abd74b7e
{
  "id": "/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourceGroups/sjrg1637/providers/Microsoft.StreamAnalytics/streamingjobs/sj8653/functions/function8197",
  "name": "function8197",
  "type": "Microsoft.StreamAnalytics/streamingjobs/functions",
  "properties": {
    "type": "Scalar",
    "properties": {
      "inputs": [
        {
          "dataType": "Any"
        }
      ],
      "output": {
        "dataType": "Any"
      },
      "binding": {
        "type": "Microsoft.StreamAnalytics/JavascriptUdf",
        "properties": {
          "script": "function (a, b) { return a * b; }"
        }
      }
    }
  }
}

Update an Azure ML function

Sample Request

PATCH https://management.azure.com/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourcegroups/sjrg7/providers/Microsoft.StreamAnalytics/streamingjobs/sj9093/functions/function588?api-version=2020-03-01

{
  "properties": {
    "type": "Scalar",
    "properties": {
      "binding": {
        "type": "Microsoft.MachineLearning/WebService",
        "properties": {
          "batchSize": 5000
        }
      }
    }
  }
}

Sample Response

ETag: 281cbf11-cd50-4a44-b833-cf170ce74748
{
  "id": "/subscriptions/56b5e0a9-b645-407d-99b0-c64f86013e3d/resourceGroups/sjrg7/providers/Microsoft.StreamAnalytics/streamingjobs/sj9093/functions/function588",
  "name": "function588",
  "type": "Microsoft.StreamAnalytics/streamingjobs/functions",
  "properties": {
    "type": "Scalar",
    "properties": {
      "inputs": [
        {
          "dataType": "nvarchar(max)"
        }
      ],
      "output": {
        "dataType": "nvarchar(max)"
      },
      "binding": {
        "type": "Microsoft.MachineLearning/WebService",
        "properties": {
          "endpoint": "someAzureMLEndpointURL",
          "inputs": {
            "name": "input1",
            "columnNames": [
              {
                "name": "tweet",
                "dataType": "string",
                "mapTo": 0
              }
            ]
          },
          "outputs": [
            {
              "name": "Sentiment",
              "dataType": "string"
            }
          ],
          "batchSize": 5000
        }
      }
    }
  }
}

Definições

AggregateFunctionProperties

As propriedades associadas a uma função de agregação.

AzureMachineLearningWebServiceFunctionBinding

A associação a um serviço Web Azure Machine Learning.

AzureMachineLearningWebServiceInputColumn

Descreve uma coluna de entrada para o ponto de extremidade do serviço Web Azure Machine Learning.

AzureMachineLearningWebServiceInputs

As entradas para o ponto de extremidade do serviço Web Azure Machine Learning.

AzureMachineLearningWebServiceOutputColumn

Descreve uma coluna de saída para o ponto de extremidade do serviço Web Azure Machine Learning.

Error

Representação de erro comum.

Function

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

FunctionInput

Descreve um parâmetro de entrada de uma função.

FunctionOutput

Descreve a saída de uma função.

JavaScriptFunctionBinding

A associação a uma função JavaScript.

ScalarFunctionProperties

As propriedades associadas a uma função escalar.

AggregateFunctionProperties

As propriedades associadas a uma função de agregação.

Name Type Description
etag
  • string

A marca de entidade atual para a função. Esta é 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.

properties.binding FunctionBinding:

A associação física da função. Por exemplo, no caso do serviço Web Azure Machine Learning, isso descreve o ponto de extremidade.

properties.inputs

Descreve um parâmetro de entrada de uma função.

properties.output

Descreve a saída de uma função.

type string:
  • Aggregate

Indica o tipo de função.

AzureMachineLearningWebServiceFunctionBinding

A associação a um serviço Web Azure Machine Learning.

Name Type Description
properties.apiKey
  • string

A chave de API usada para autenticar com Request-Response ponto de extremidade.

properties.batchSize
  • integer

Número entre 1 e 10000 que descreve o número máximo de linhas para cada solicitação de execução do RRS ML do Azure. O padrão é 1000.

properties.endpoint
  • string

O Request-Response executar o ponto de extremidade do serviço Web Azure Machine Learning. Saiba mais aqui: https://docs.microsoft.com/en-us/azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs

properties.inputs

As entradas para o ponto de extremidade do serviço Web Azure Machine Learning.

properties.outputs

Uma lista de saídas do Azure Machine Learning execução do ponto de extremidade do serviço Web.

type string:
  • Microsoft.MachineLearning/WebService

Indica o tipo de associação de função.

AzureMachineLearningWebServiceInputColumn

Descreve uma coluna de entrada para o ponto de extremidade do serviço Web Azure Machine Learning.

Name Type Description
dataType
  • string

O tipo de dados (Azure Machine Learning com suporte) da coluna de entrada. Uma lista de tipos de dados válidos Azure Machine Learning são descritos em https://msdn.microsoft.com/en-us/library/azure/dn905923.aspx .

mapTo
  • integer

O índice baseado em zero do parâmetro de função para o qual essa entrada é mapeada.

name
  • string

Nome da coluna de entrada.

AzureMachineLearningWebServiceInputs

As entradas para o ponto de extremidade do serviço Web Azure Machine Learning.

Name Type Description
columnNames

Uma lista de colunas de entrada para o ponto de extremidade do serviço Web Azure Machine Learning.

name
  • string

Nome da entrada. Esse é o nome fornecido durante a criação do ponto de extremidade.

AzureMachineLearningWebServiceOutputColumn

Descreve uma coluna de saída para o ponto de extremidade do serviço Web Azure Machine Learning.

Name Type Description
dataType
  • string

O tipo de dados (Azure Machine Learning com suporte) da coluna de saída. Uma lista de tipos de dados válidos Azure Machine Learning são descritos em https://msdn.microsoft.com/en-us/library/azure/dn905923.aspx .

name
  • string

Nome da coluna de saída.

Error

Representação de erro comum.

Name Type Description
error

Propriedades de definição de erro.

Function

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

Name Type Description
id
  • string

ID do recurso

name
  • string

Nome do recurso

properties FunctionProperties:

As propriedades associadas a uma função.

type
  • string

Tipo de recurso

FunctionInput

Descreve um parâmetro de entrada de uma função.

Name Type Description
dataType
  • string

O tipo de dados (com suporte do Azure Stream Analytics) do parâmetro de entrada da função. Uma lista de tipos de dados válidos do Azure Stream Analytics é descrita em https://msdn.microsoft.com/en-us/library/azure/dn835065.aspx

isConfigurationParameter
  • boolean

Um sinalizador que indica se o parâmetro é um parâmetro de configuração. True se esse parâmetro de entrada deve ser uma constante. O padrão é false.

FunctionOutput

Descreve a saída de uma função.

Name Type Description
dataType
  • string

O tipo de dados (com suporte do Azure Stream Analytics) da saída da função. Uma lista de tipos de dados válidos do Azure Stream Analytics é descrita em https://msdn.microsoft.com/en-us/library/azure/dn835065.aspx

JavaScriptFunctionBinding

A associação a uma função JavaScript.

Name Type Description
properties.script
  • string

O código JavaScript que contém uma única definição de função. Por exemplo: 'function (x, y) { return x + y; }'

type string:
  • Microsoft.StreamAnalytics/JavascriptUdf

Indica o tipo de associação de função.

ScalarFunctionProperties

As propriedades associadas a uma função escalar.

Name Type Description
etag
  • string

A marca de entidade atual para a função. Esta é 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.

properties.binding FunctionBinding:

A associação física da função. Por exemplo, no caso do serviço Web Azure Machine Learning, isso descreve o ponto de extremidade.

properties.inputs

Descreve um parâmetro de entrada de uma função.

properties.output

Descreve a saída de uma função.

type string:
  • Scalar

Indica o tipo de função.