다음을 통해 공유

Workspace Settings - Update Spark Settings

서비스:
Spark
API 버전:
v1

작업 영역 Spark 설정을 업데이트합니다.

권한

호출자에게는 관리자 작업 영역 역할이 있어야 합니다.

필요한 위임된 범위

Workspace.ReadWrite.All

Microsoft Entra 지원 ID

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

정체성 지원
사용자 예
서비스 주체 및 관리 ID 예

인터페이스

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/spark/settings

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
workspaceId
 path True

string (uuid)

작업 영역 ID입니다.

요청 본문

Name 형식 Description
automaticLog

AutomaticLogProperties

자동 로그 설정입니다.
environment

EnvironmentProperties

환경 설정.
highConcurrency

HighConcurrencyProperties

높은 동시성 설정입니다.
job

SparkJobsProperties

작업 관리 설정입니다.
pool

PoolProperties

풀 설정.

응답

Name 형식 Description
200 OK

WorkspaceSparkSettings

요청이 성공적으로 완료되었습니다.
Other Status Codes

ErrorResponse

일반적인 오류 코드:

  • UnknownError - 오류가 발생했습니다.

예제

Update workspace Spark settings default pool using pool ID example
Update workspace Spark settings example

Update workspace Spark settings default pool using pool ID example

샘플 요청

PATCH https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/spark/settings

{
  "pool": {
    "defaultPool": {
      "id": "00000000-0000-0000-0000-000000000000"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "automaticLog": {
    "enabled": false
  },
  "highConcurrency": {
    "notebookInteractiveRunEnabled": false
  },
  "pool": {
    "customizeComputeEnabled": false,
    "defaultPool": {
      "name": "Starter Pool",
      "type": "Workspace",
      "id": "00000000-0000-0000-0000-000000000000"
    },
    "starterPool": {
      "maxNodeCount": 3,
      "maxExecutors": 1
    }
  },
  "environment": {
    "name": "environment1",
    "runtimeVersion": "1.2"
  }
}

Update workspace Spark settings example

샘플 요청

PATCH https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/spark/settings

{
  "automaticLog": {
    "enabled": false
  },
  "highConcurrency": {
    "notebookInteractiveRunEnabled": false,
    "notebookPipelineRunEnabled": false
  },
  "pool": {
    "customizeComputeEnabled": false,
    "defaultPool": {
      "name": "Starter Pool",
      "type": "Workspace"
    },
    "starterPool": {
      "maxNodeCount": 3,
      "maxExecutors": 1
    }
  },
  "environment": {
    "name": "environment1",
    "runtimeVersion": "1.2"
  },
  "job": {
    "conservativeJobAdmissionEnabled": false,
    "sessionTimeoutInMinutes": 20
  }
}

샘플 응답

상태 코드:
200 
{
  "automaticLog": {
    "enabled": false
  },
  "highConcurrency": {
    "notebookInteractiveRunEnabled": false,
    "notebookPipelineRunEnabled": false
  },
  "pool": {
    "customizeComputeEnabled": false,
    "defaultPool": {
      "name": "Starter Pool",
      "type": "Workspace",
      "id": "00000000-0000-0000-0000-000000000000"
    },
    "starterPool": {
      "maxNodeCount": 3,
      "maxExecutors": 1
    }
  },
  "environment": {
    "name": "environment1",
    "runtimeVersion": "1.2"
  },
  "job": {
    "conservativeJobAdmissionEnabled": false,
    "sessionTimeoutInMinutes": 20
  }
}

정의

Name Description
AutomaticLogProperties

자동 로그 속성입니다.
CustomPoolType

사용자 지정 풀 유형입니다. 추가 CustomPoolType 형식은 시간이 지남에 따라 추가될 수 있습니다.
EnvironmentProperties

환경의 속성입니다.
ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse

오류 응답입니다.
ErrorResponseDetails

오류 응답 세부 정보입니다.
HighConcurrencyProperties

높은 동시성 속성입니다.
InstancePool
PoolProperties

풀의 속성
SparkJobsProperties

Spark 작업의 속성입니다.
StarterPoolProperties

사용자 지정 시작 풀입니다.
UpdateWorkspaceSparkSettingsRequest

작업 영역 Spark 설정 요청 페이로드를 업데이트합니다.
WorkspaceSparkSettings

작업 영역 Spark 설정입니다.

AutomaticLogProperties

Object

자동 로그 속성입니다.

Name 형식 Description
enabled

boolean

자동 로그의 상태입니다. False - Disabled, true - Enabled.

CustomPoolType

열거형

사용자 지정 풀 유형입니다. 추가 CustomPoolType 형식은 시간이 지남에 따라 추가될 수 있습니다.

값 Description
Workspace

작업 영역 수준 사용자 지정 풀
Capacity

용량 수준 사용자 지정 풀

EnvironmentProperties

Object

환경의 속성입니다.

Name 형식 Description
name

string

기본 환경의 이름입니다. 작업 영역 기본 환경이 없음을 나타내는 빈 문자열입니다.
runtimeVersion

string

런타임 버전입니다. 예: 1.3

ErrorRelatedResource

Object

오류 관련 리소스 세부 정보 개체입니다.

Name 형식 Description
resourceId

string

오류와 관련된 리소스 ID입니다.
resourceType

string

오류와 관련된 리소스의 형식입니다.

ErrorResponse

Object

오류 응답입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
moreDetails

ErrorResponseDetails[]

추가 오류 세부 정보 목록입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.
requestId

string

오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

Object

오류 응답 세부 정보입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.

HighConcurrencyProperties

Object

높은 동시성 속성입니다.

Name 형식 Description
notebookInteractiveRunEnabled

boolean

Notebook 대화형 실행에 대한 높은 동시성의 상태입니다. False - Disabled, true - Enabled.
notebookPipelineRunEnabled

boolean

Notebook 파이프라인 실행에 대한 높은 동시성의 상태입니다. False - Disabled, true - Enabled.

InstancePool

Object
Name 형식 Description
id

string (uuid)

인스턴스 풀 ID입니다.
name

string

인스턴스 풀 이름입니다.
type

CustomPoolType

인스턴스 풀 유형입니다.

PoolProperties

Object

풀의 속성

Name 형식 Description
customizeComputeEnabled

boolean

항목에 대한 컴퓨팅 구성을 사용자 지정합니다. False - Disabled, true - Enabled.
defaultPool

InstancePool

작업 영역에 대한 기본 풀입니다. 유효한 사용자 지정 풀 이름이어야 합니다. "시작 풀"은 시작 풀을 사용한다는 의미입니다.
starterPool

StarterPoolProperties

시작 풀을 사용자 지정합니다. 시작 풀을 구성하는 방법에 대한 자세한 내용은 시작 풀 구성하는참조하세요.

SparkJobsProperties

Object

Spark 작업의 속성입니다.

Name 형식 Description
conservativeJobAdmissionEnabled

boolean

활성 Spark 작업에 대한 최대 코어를 예약합니다. 이 설정을 사용하도록 설정하면 패브릭 용량은 활성 Spark 작업에 필요한 최대 코어 수를 예약하여 작업이 확장될 경우 코어를 사용할 수 있도록 하여 작업 안정성을 보장합니다. 이 설정을 사용하지 않도록 설정하면 필요한 최소 코어 수에 따라 작업이 시작되므로 더 많은 작업이 동시에 실행됩니다. 자세한 내용은 입사 및 관리참조하세요. False - Disabled, true - Enabled.
sessionTimeoutInMinutes

integer (int32)

minimum: 1
maximum: 20160

비활성 Spark 세션을 종료하는 시간입니다. 최댓값은 14일입니다.

StarterPoolProperties

Object

사용자 지정 시작 풀입니다.

Name 형식 Description
maxExecutors

integer (int32)

minimum: 1

최대 실행기 수입니다.
maxNodeCount

integer (int32)

minimum: 1

최대 노드 수입니다.

UpdateWorkspaceSparkSettingsRequest

Object

작업 영역 Spark 설정 요청 페이로드를 업데이트합니다.

Name 형식 Description
automaticLog

AutomaticLogProperties

자동 로그 설정입니다.
environment

EnvironmentProperties

환경 설정.
highConcurrency

HighConcurrencyProperties

높은 동시성 설정입니다.
job

SparkJobsProperties

작업 관리 설정입니다.
pool

PoolProperties

풀 설정.

WorkspaceSparkSettings

Object

작업 영역 Spark 설정입니다.

Name 형식 Description
automaticLog

AutomaticLogProperties

자동 로그 설정입니다.
environment

EnvironmentProperties

환경 설정.
highConcurrency

HighConcurrencyProperties

높은 동시성 설정입니다.
job

SparkJobsProperties

작업 관리 설정입니다.
pool

PoolProperties

풀 설정.