Functions - Update

기존 스트리밍 작업에서 기존 함수를 업데이트합니다. 작업 또는 함수 정의의 나머지 부분에 영향을 주지 않고 함수를 부분적으로 업데이트(예: 하나 또는 두 개의 속성 업데이트)하는 데 사용할 수 있습니다.

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

URI 매개 변수

Name In Required Type Description
functionName
path True
  • string

함수의 이름입니다.

jobName
path True
  • string

스트리밍 작업의 이름입니다.

resourceGroupName
path True
  • string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

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

subscriptionId
path True
  • string

대상 구독의 ID입니다.

api-version
query True
  • string

이 작업에 사용할 API 버전입니다.

요청 헤더

Name Required Type Description
If-Match
  • string

함수의 ETag입니다. 현재 함수를 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.

요청 본문

Name Type Description
name
  • string

리소스 이름

properties FunctionProperties:

함수와 연결된 속성입니다.

응답

Name Type Description
200 OK

함수가 성공적으로 업데이트되었습니다.

Headers

  • ETag: string
Other Status Codes

오류.

보안

azure_auth

OAuth2 Flow Azure Active Directory

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

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
        }
      }
    }
  }
}

정의

AggregateFunctionProperties

집계 함수와 연결된 속성입니다.

AzureMachineLearningWebServiceFunctionBinding

Azure Machine Learning 웹 서비스에 대한 바인딩입니다.

AzureMachineLearningWebServiceInputColumn

Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력 열을 설명합니다.

AzureMachineLearningWebServiceInputs

Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력입니다.

AzureMachineLearningWebServiceOutputColumn

Azure Machine Learning 웹 서비스 엔드포인트에 대한 출력 열을 설명합니다.

Error

일반적인 오류 표현입니다.

Function

명명된 함수와 연결된 모든 정보를 포함하는 함수 개체입니다. 모든 함수는 스트리밍 작업 아래에 포함됩니다.

FunctionInput

함수의 입력 매개 변수 하나를 설명합니다.

FunctionOutput

함수의 출력을 설명합니다.

JavaScriptFunctionBinding

JavaScript 함수에 대한 바인딩입니다.

ScalarFunctionProperties

스칼라 함수와 연결된 속성입니다.

AggregateFunctionProperties

집계 함수와 연결된 속성입니다.

Name Type Description
etag
  • string

함수의 현재 엔터티 태그입니다. 불투명 문자열입니다. 이를 사용하여 요청 간에 리소스가 변경되었는지 여부를 검색할 수 있습니다. 낙관적 동시성을 위한 쓰기 작업에는 If-Match 또는 If-None-Match 헤더에서 사용할 수도 있습니다.

properties.binding FunctionBinding:

함수의 물리적 바인딩입니다. 예를 들어 Azure Machine Learning 웹 서비스의 경우 엔드포인트를 설명합니다.

properties.inputs

함수의 입력 매개 변수 하나를 설명합니다.

properties.output

함수의 출력을 설명합니다.

type string:
  • Aggregate

함수의 형식을 나타냅니다.

AzureMachineLearningWebServiceFunctionBinding

Azure Machine Learning 웹 서비스에 대한 바인딩입니다.

Name Type Description
properties.apiKey
  • string

Request-Response 엔드포인트에서 인증하는 데 사용되는 API 키입니다.

properties.batchSize
  • integer

모든 Azure ML RRS 실행 요청에 대한 최대 행 수를 설명하는 1에서 10000 사이의 수입니다. 기본값은 1000입니다.

properties.endpoint
  • string

Request-Response Azure Machine Learning 웹 서비스의 엔드포인트를 실행합니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/en-us/azure/machine-learning/machine-learning-consume-web-services#request-response-service-rrs

properties.inputs

Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력입니다.

properties.outputs

Azure Machine Learning 웹 서비스 엔드포인트 실행의 출력 목록입니다.

type string:
  • Microsoft.MachineLearning/WebService

함수 바인딩 형식을 나타냅니다.

AzureMachineLearningWebServiceInputColumn

Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력 열을 설명합니다.

Name Type Description
dataType
  • string

입력 열의 (Azure Machine Learning 지원되는) 데이터 형식입니다. 유효한 Azure Machine Learning 데이터 형식 목록은 에 https://msdn.microsoft.com/en-us/library/azure/dn905923.aspx 설명되어 있습니다.

mapTo
  • integer

이 입력이 매핑되는 함수 매개 변수의 0부터 시작하는 인덱스입니다.

name
  • string

입력 열의 이름입니다.

AzureMachineLearningWebServiceInputs

Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력입니다.

Name Type Description
columnNames

Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력 열 목록입니다.

name
  • string

입력의 이름입니다. 엔드포인트를 작성하는 동안 제공되는 이름입니다.

AzureMachineLearningWebServiceOutputColumn

Azure Machine Learning 웹 서비스 엔드포인트에 대한 출력 열을 설명합니다.

Name Type Description
dataType
  • string

출력 열의 (Azure Machine Learning 지원되는) 데이터 형식입니다. 유효한 Azure Machine Learning 데이터 형식 목록은 에 https://msdn.microsoft.com/en-us/library/azure/dn905923.aspx 설명되어 있습니다.

name
  • string

출력 열의 이름입니다.

Error

일반적인 오류 표현입니다.

Name Type Description
error

오류 정의 속성입니다.

Function

명명된 함수와 연결된 모든 정보를 포함하는 함수 개체입니다. 모든 함수는 스트리밍 작업 아래에 포함됩니다.

Name Type Description
id
  • string

리소스 ID

name
  • string

리소스 이름

properties FunctionProperties:

함수와 연결된 속성입니다.

type
  • string

리소스 유형

FunctionInput

함수의 입력 매개 변수 하나를 설명합니다.

Name Type Description
dataType
  • string

함수 입력 매개 변수의 (Azure Stream Analytics 지원) 데이터 형식입니다. 유효한 Azure Stream Analytics 데이터 형식 목록은 에 설명되어 있습니다. https://msdn.microsoft.com/en-us/library/azure/dn835065.aspx

isConfigurationParameter
  • boolean

매개 변수가 구성 매개 변수인지 여부를 나타내는 플래그입니다. True이면 이 입력 매개 변수가 상수여야 합니다. 기본값은 false입니다.

FunctionOutput

함수의 출력을 설명합니다.

Name Type Description
dataType
  • string

함수 출력의 (Azure Stream Analytics 지원) 데이터 형식입니다. 유효한 Azure Stream Analytics 데이터 형식 목록은 에 설명되어 있습니다. https://msdn.microsoft.com/en-us/library/azure/dn835065.aspx

JavaScriptFunctionBinding

JavaScript 함수에 대한 바인딩입니다.

Name Type Description
properties.script
  • string

단일 함수 정의를 포함하는 JavaScript 코드입니다. 예: 'function (x, y) { return x + y; }'

type string:
  • Microsoft.StreamAnalytics/JavascriptUdf

함수 바인딩 형식을 나타냅니다.

ScalarFunctionProperties

스칼라 함수와 연결된 속성입니다.

Name Type Description
etag
  • string

함수의 현재 엔터티 태그입니다. 불투명 문자열입니다. 이를 사용하여 요청 간에 리소스가 변경되었는지 여부를 검색할 수 있습니다. 낙관적 동시성을 위한 쓰기 작업에는 If-Match 또는 If-None-Match 헤더에서 사용할 수도 있습니다.

properties.binding FunctionBinding:

함수의 물리적 바인딩입니다. 예를 들어 Azure Machine Learning 웹 서비스의 경우 엔드포인트를 설명합니다.

properties.inputs

함수의 입력 매개 변수 하나를 설명합니다.

properties.output

함수의 출력을 설명합니다.

type string:
  • Scalar

함수의 형식을 나타냅니다.