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 |
---|---|---|---|---|
function
|
path | True |
string |
함수의 이름입니다. |
job
|
path | True |
string |
스트리밍 작업의 이름입니다. |
resource
|
path | True |
string |
리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다. Regex pattern: |
subscription
|
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 |
함수가 성공적으로 업데이트되었습니다. Headers ETag: string |
|
Other Status Codes |
오류. |
보안
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 Java |
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 |
---|---|
Aggregate |
집계 함수와 연결된 속성입니다. |
Azure |
Azure Machine Learning 웹 서비스에 대한 바인딩입니다. |
Azure |
Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력 열을 설명합니다. |
Azure |
Azure Machine Learning 웹 서비스 엔드포인트에 대한 입력입니다. |
Azure |
Azure Machine Learning 웹 서비스 엔드포인트에 대한 출력 열을 설명합니다. |
Error |
일반적인 오류 표현입니다. |
Function |
명명된 함수와 연결된 모든 정보를 포함하는 함수 개체입니다. 모든 함수는 스트리밍 작업 아래에 포함됩니다. |
Function |
함수의 한 입력 매개 변수에 대해 설명합니다. |
Function |
함수의 출력을 설명합니다. |
Java |
JavaScript 함수에 대한 바인딩입니다. |
Scalar |
스칼라 함수와 연결된 속성입니다. |
AggregateFunctionProperties
집계 함수와 연결된 속성입니다.
Name | 형식 | 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 | 형식 | 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. |
함수 바인딩 형식을 나타냅니다. |
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 |
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 |
오류 정의 속성입니다. |
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. |
함수 바인딩 형식을 나타냅니다. |
ScalarFunctionProperties
스칼라 함수와 연결된 속성입니다.
Name | 형식 | Description |
---|---|---|
etag |
string |
함수의 현재 엔터티 태그입니다. 불투명 문자열입니다. 이를 사용하여 요청 간에 리소스가 변경되었는지 여부를 검색할 수 있습니다. 낙관적 동시성을 위한 쓰기 작업에 If-Match 또는 If-None-Match 헤더에서 사용할 수도 있습니다. |
properties.binding | FunctionBinding: |
함수의 물리적 바인딩입니다. 예를 들어 Azure Machine Learning 웹 서비스의 경우 엔드포인트에 대해 설명합니다. |
properties.inputs |
함수의 한 입력 매개 변수에 대해 설명합니다. |
|
properties.output |
함수의 출력을 설명합니다. |
|
type |
string:
Scalar |
함수의 형식을 나타냅니다. |