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(다음 안에) 필수 형식 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 필수 형식 Description
If-Match

string

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

요청 본문

Name 형식 Description
name

string

리소스 이름

properties FunctionProperties:

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

응답

Name 형식 Description
200 OK

Function

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

Headers

ETag: string

Other Status Codes

Error

오류.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

정의

Name Description
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 형식 Description
etag

string

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

properties.binding FunctionBinding:

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

properties.inputs

FunctionInput[]

함수의 한 입력 매개 변수에 대해 설명합니다.

properties.output

FunctionOutput

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

type string:

Aggregate

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

AzureMachineLearningWebServiceFunctionBinding

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

Name 형식 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

AzureMachineLearningWebServiceInputs

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

properties.outputs

AzureMachineLearningWebServiceOutputColumn[]

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

type string:

Microsoft.MachineLearning/WebService

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

AzureMachineLearningWebServiceInputColumn

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

Name 형식 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 형식 Description
columnNames

AzureMachineLearningWebServiceInputColumn[]

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

name

string

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

AzureMachineLearningWebServiceOutputColumn

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

Name 형식 Description
dataType

string

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

name

string

출력 열의 이름입니다.

Error

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

Name 형식 Description
error

Error

오류 정의 속성입니다.

Function

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

Name 형식 Description
id

string

리소스 ID

name

string

리소스 이름

properties FunctionProperties:

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

type

string

리소스 유형

FunctionInput

함수의 한 입력 매개 변수에 대해 설명합니다.

Name 형식 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 형식 Description
dataType

string

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

JavaScriptFunctionBinding

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

Name 형식 Description
properties.script

string

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

type string:

Microsoft.StreamAnalytics/JavascriptUdf

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

ScalarFunctionProperties

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

Name 형식 Description
etag

string

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

properties.binding FunctionBinding:

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

properties.inputs

FunctionInput[]

함수의 한 입력 매개 변수에 대해 설명합니다.

properties.output

FunctionOutput

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

type string:

Scalar

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