Big Data Pools - Create Or Update

참조

서비스:: Synapse

API 버전:: 2021-06-01

빅 데이터 풀을 만듭니다.
새 빅 데이터 풀을 만듭니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/bigDataPools/{bigDataPoolName}?api-version=2021-06-01

선택적 매개 변수:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/bigDataPools/{bigDataPoolName}?api-version=2021-06-01&force={force}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
bigDataPoolName	path	True	string	빅 데이터 풀 이름
resourceGroupName	path	True	string	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
subscriptionId	path	True	string	대상 구독의 ID입니다.
workspaceName	path	True	string	작업 영역의 이름입니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.
force	query		boolean	빅 데이터 풀에서 실행 중인 작업을 중지할지 여부

요청 본문

Name	필수	형식	Description
location	True	string	리소스가 있는 지리적 위치
properties.autoPause		AutoPauseProperties	Spark 풀 자동 일시 중지 속성 자동 일시 중지 속성
properties.autoScale		AutoScaleProperties	Spark 풀 자동 크기 조정 속성 자동 크기 조정 속성
properties.cacheSize		integer	캐시 크기
properties.customLibraries		LibraryInfo[]	Spark 풀과 연결된 사용자 지정 라이브러리/패키지 목록입니다.
properties.defaultSparkLogFolder		string	Spark 로그를 쓸 기본 폴더입니다.
properties.dynamicExecutorAllocation		DynamicExecutorAllocation	동적 실행기 할당
properties.isAutotuneEnabled		boolean	Autotune 사용 autotune이 필요한지 여부입니다.
properties.isComputeIsolationEnabled		boolean	컴퓨팅 격리가 필요한지 여부입니다.
properties.libraryRequirements		LibraryRequirements	Spark 풀 라이브러리 버전 요구 사항 라이브러리 버전 요구 사항
properties.nodeCount		integer	빅 데이터 풀의 노드 수입니다.
properties.nodeSize		NodeSize	빅 데이터 풀의 각 노드에 있는 컴퓨팅 성능 수준입니다.
properties.nodeSizeFamily		NodeSizeFamily	빅 데이터 풀에서 제공하는 노드의 종류입니다.
properties.provisioningState		string	빅 데이터 풀의 상태입니다.
properties.sessionLevelPackagesEnabled		boolean	세션 수준 패키지를 사용할 수 있는지 여부입니다.
properties.sparkConfigProperties		SparkConfigProperties	Spark 풀 구성 속성 추가 속성을 지정하는 Spark 구성 파일
properties.sparkEventsFolder		string	Spark 이벤트 폴더
properties.sparkVersion		string	Apache Spark 버전입니다.
tags		object	리소스 태그.

응답

Name	형식	Description
200 OK	BigDataPoolResourceInfo	그래
202 Accepted	BigDataPoolResourceInfo
Other Status Codes	ErrorResponse

예제

Create or update a Big Data pool

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/01234567-89ab-4def-0123-456789abcdef/resourceGroups/ExampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/bigDataPools/ExamplePool?api-version=2021-06-01

{
  "tags": {
    "key": "value"
  },
  "location": "West US 2",
  "properties": {
    "sparkVersion": "3.3",
    "nodeCount": 4,
    "nodeSize": "Medium",
    "nodeSizeFamily": "MemoryOptimized",
    "autoScale": {
      "enabled": true,
      "minNodeCount": 3,
      "maxNodeCount": 50
    },
    "autoPause": {
      "enabled": true,
      "delayInMinutes": 15
    },
    "sparkEventsFolder": "/events",
    "libraryRequirements": {
      "content": "",
      "filename": "requirements.txt"
    },
    "defaultSparkLogFolder": "/logs",
    "isAutotuneEnabled": false
  }
}

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/01234567-89ab-4def-0123-456789abcdef/resourceGroups/ExampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/bigDataPools/ExamplePool",
  "type": "Microsoft.Synapse/workspaces/bigDataPools",
  "location": "West US 2",
  "name": "ExamplePool",
  "tags": {
    "key": "value"
  },
  "properties": {
    "provisioningState": "Provisioning",
    "sparkVersion": "3.3",
    "nodeCount": 4,
    "nodeSize": "Medium",
    "nodeSizeFamily": "MemoryOptimized",
    "autoScale": {
      "enabled": true,
      "minNodeCount": 3,
      "maxNodeCount": 50
    },
    "autoPause": {
      "enabled": true,
      "delayInMinutes": 15
    },
    "creationDate": "1970-01-01T00:00:00Z",
    "sparkEventsFolder": "/events",
    "libraryRequirements": {
      "time": "1970-01-01T00:00:00Z",
      "content": "",
      "filename": "requirements.txt"
    },
    "defaultSparkLogFolder": "/logs",
    "lastSucceededTimestamp": "1970-01-01T10:00:00Z",
    "isAutotuneEnabled": false
  }
}

상태 코드:: 202

{
  "id": "/subscriptions/01234567-89ab-4def-0123-456789abcdef/resourceGroups/ExampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/bigDataPools/ExamplePool",
  "type": "Microsoft.Synapse/workspaces/bigDataPools",
  "location": "West US 2",
  "name": "ExamplePool",
  "tags": {
    "key": "value"
  },
  "properties": {
    "provisioningState": "Provisioning",
    "sparkVersion": "3.3",
    "nodeCount": 4,
    "nodeSize": "Medium",
    "nodeSizeFamily": "MemoryOptimized",
    "autoScale": {
      "enabled": true,
      "minNodeCount": 3,
      "maxNodeCount": 50
    },
    "autoPause": {
      "enabled": true,
      "delayInMinutes": 15
    },
    "creationDate": "1970-01-01T00:00:00Z",
    "sparkEventsFolder": "/events",
    "libraryRequirements": {
      "time": "1970-01-01T00:00:00Z",
      "content": "",
      "filename": "requirements.txt"
    },
    "defaultSparkLogFolder": "/logs",
    "isAutotuneEnabled": false
  }
}

상태 코드:: default

{
  "error": {
    "code": "Error code",
    "message": "Error message"
  }
}

정의

Name	Description
AutoPauseProperties	Spark 풀 자동 일시 중지 속성
AutoScaleProperties	Spark 풀 자동 크기 조정 속성
BigDataPoolResourceInfo	빅 데이터 풀
ConfigurationType	Spark 구성 속성 파일의 형식입니다.
DynamicExecutorAllocation	동적 실행기 할당 속성
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
LibraryInfo	작업 영역 수준에서 만든 라이브러리/패키지에 대한 정보입니다.
LibraryRequirements	Spark 풀 라이브러리 버전 요구 사항
NodeSize	빅 데이터 풀의 각 노드에 있는 컴퓨팅 성능 수준입니다.
NodeSizeFamily	빅 데이터 풀에서 제공하는 노드의 종류입니다.
SparkConfigProperties	Spark 풀 구성 속성

AutoPauseProperties

Spark 풀 자동 일시 중지 속성

Name	형식	Description
delayInMinutes	integer	빅 데이터 풀이 자동으로 일시 중지되기까지의 유휴 시간(분)입니다.
enabled	boolean	빅 데이터 풀에 대해 자동 일시 중지를 사용할 수 있는지 여부입니다.

AutoScaleProperties

Spark 풀 자동 크기 조정 속성

Name	형식	Description
enabled	boolean	빅 데이터 풀에 대해 자동 크기 조정을 사용할 수 있는지 여부입니다.
maxNodeCount	integer	빅 데이터 풀에서 지원할 수 있는 최대 노드 수입니다.
minNodeCount	integer	빅 데이터 풀에서 지원할 수 있는 최소 노드 수입니다.

BigDataPoolResourceInfo

빅 데이터 풀

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties.autoPause	AutoPauseProperties	Spark 풀 자동 일시 중지 속성 자동 일시 중지 속성
properties.autoScale	AutoScaleProperties	Spark 풀 자동 크기 조정 속성 자동 크기 조정 속성
properties.cacheSize	integer	캐시 크기
properties.creationDate	string	빅 데이터 풀을 만든 시간입니다.
properties.customLibraries	LibraryInfo[]	Spark 풀과 연결된 사용자 지정 라이브러리/패키지 목록입니다.
properties.defaultSparkLogFolder	string	Spark 로그를 쓸 기본 폴더입니다.
properties.dynamicExecutorAllocation	DynamicExecutorAllocation	동적 실행기 할당
properties.isAutotuneEnabled	boolean	Autotune 사용 autotune이 필요한지 여부입니다.
properties.isComputeIsolationEnabled	boolean	컴퓨팅 격리가 필요한지 여부입니다.
properties.lastSucceededTimestamp	string	빅 데이터 풀이 성공적으로 업데이트된 시간입니다.
properties.libraryRequirements	LibraryRequirements	Spark 풀 라이브러리 버전 요구 사항 라이브러리 버전 요구 사항
properties.nodeCount	integer	빅 데이터 풀의 노드 수입니다.
properties.nodeSize	NodeSize	빅 데이터 풀의 각 노드에 있는 컴퓨팅 성능 수준입니다.
properties.nodeSizeFamily	NodeSizeFamily	빅 데이터 풀에서 제공하는 노드의 종류입니다.
properties.provisioningState	string	빅 데이터 풀의 상태입니다.
properties.sessionLevelPackagesEnabled	boolean	세션 수준 패키지를 사용할 수 있는지 여부입니다.
properties.sparkConfigProperties	SparkConfigProperties	Spark 풀 구성 속성 추가 속성을 지정하는 Spark 구성 파일
properties.sparkEventsFolder	string	Spark 이벤트 폴더
properties.sparkVersion	string	Apache Spark 버전입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ConfigurationType

Spark 구성 속성 파일의 형식입니다.

Name	형식	Description
Artifact	string
File	string

DynamicExecutorAllocation

동적 실행기 할당 속성

Name	형식	Description
enabled	boolean	동적 실행기 할당을 사용할지 여부를 나타냅니다.
maxExecutors	integer	할당된 최대 실행기 수
minExecutors	integer	할당된 최소 실행기 수

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

LibraryInfo

작업 영역 수준에서 만든 라이브러리/패키지에 대한 정보입니다.

Name	형식	Description
containerName	string	스토리지 Blob 컨테이너 이름입니다.
creatorId	string	라이브러리/패키지의 작성자 ID입니다.
name	string	라이브러리의 이름입니다.
path	string	라이브러리의 스토리지 Blob 경로입니다.
provisioningStatus	string	라이브러리/패키지의 프로비전 상태입니다.
type	string	라이브러리의 형식입니다.
uploadedTimestamp	string	라이브러리의 마지막 업데이트 시간입니다.

LibraryRequirements

Spark 풀 라이브러리 버전 요구 사항

Name	형식	Description
content	string	라이브러리 요구 사항입니다.
filename	string	라이브러리 요구 사항 파일의 파일 이름입니다.
time	string	라이브러리 요구 사항 파일의 마지막 업데이트 시간입니다.

NodeSize

빅 데이터 풀의 각 노드에 있는 컴퓨팅 성능 수준입니다.

Name	형식	Description
Large	string
Medium	string
None	string
Small	string
XLarge	string
XXLarge	string
XXXLarge	string

NodeSizeFamily

빅 데이터 풀에서 제공하는 노드의 종류입니다.

Name	형식	Description
HardwareAcceleratedFPGA	string
HardwareAcceleratedGPU	string
MemoryOptimized	string
None	string

SparkConfigProperties

Spark 풀 구성 속성

Name	형식	Description
configurationType	ConfigurationType	Spark 구성 속성 파일의 형식입니다.
content	string	Spark 구성 속성입니다.
filename	string	Spark 구성 속성 파일의 파일 이름입니다.
time	string	Spark 구성 속성 파일의 마지막 업데이트 시간입니다.

다음을 통해 공유