Big Data Pools - Create Or Update

Buat kumpulan Big Data.
Buat kumpulan Big Data baru.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
bigDataPoolName
path True

string

Nama kumpulan Big Data

resourceGroupName
path True

string

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

subscriptionId
path True

string

ID langganan target.

workspaceName
path True

string

Nama ruang kerja.

api-version
query True

string

Versi API yang digunakan untuk operasi ini.

force
query

boolean

Apakah akan menghentikan pekerjaan yang sedang berjalan di kumpulan Big Data

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
location True

string

Lokasi geografis tempat sumber daya berada

properties.autoPause

AutoPauseProperties

Properti jeda otomatis kumpulan Spark
Properti jeda otomatis

properties.autoScale

AutoScaleProperties

Properti penskalakan otomatis kumpulan Spark
Properti penskalakan otomatis

properties.cacheSize

integer

Ukuran cache

properties.customLibraries

LibraryInfo[]

Daftar pustaka/paket kustom yang terkait dengan kumpulan spark.

properties.defaultSparkLogFolder

string

Folder default tempat log Spark akan ditulis.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Alokasi Pelaksana Dinamis

properties.isAutotuneEnabled

boolean

Aktifkan Autotune
Apakah autotune diperlukan atau tidak.

properties.isComputeIsolationEnabled

boolean

Apakah isolasi komputasi diperlukan atau tidak.

properties.libraryRequirements

LibraryRequirements

Persyaratan versi pustaka kumpulan Spark
Persyaratan versi pustaka

properties.nodeCount

integer

Jumlah simpul di kumpulan Big Data.

properties.nodeSize

NodeSize

Tingkat daya komputasi yang dimiliki setiap simpul di kumpulan Big Data.

properties.nodeSizeFamily

NodeSizeFamily

Jenis simpul yang disediakan oleh kumpulan Big Data.

properties.provisioningState

string

Status kumpulan Big Data.

properties.sessionLevelPackagesEnabled

boolean

Apakah paket tingkat sesi diaktifkan.

properties.sparkConfigProperties

SparkConfigProperties

Properti Konfigurasi kumpulan Spark
File konfigurasi Spark untuk menentukan properti tambahan

properties.sparkEventsFolder

string

Folder peristiwa Spark

properties.sparkVersion

string

Versi Apache Spark.

tags

object

Tag sumber daya.

Respons

Nama Jenis Deskripsi
200 OK

BigDataPoolResourceInfo

OK

202 Accepted

BigDataPoolResourceInfo

Other Status Codes

ErrorResponse

Contoh

Create or update a Big Data pool

Sample Request

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

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

Sample Response

{
  "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
  }
}
{
  "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
  }
}
{
  "error": {
    "code": "Error code",
    "message": "Error message"
  }
}

Definisi

Nama Deskripsi
AutoPauseProperties

Properti jeda otomatis kumpulan Spark

AutoScaleProperties

Properti penskalakan otomatis kumpulan Spark

BigDataPoolResourceInfo

Kumpulan Big Data

ConfigurationType

Jenis file properti konfigurasi spark.

DynamicExecutorAllocation

Properti Alokasi Pelaksana Dinamis

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

LibraryInfo

Informasi tentang pustaka/paket yang dibuat di tingkat ruang kerja.

LibraryRequirements

Persyaratan versi pustaka kumpulan Spark

NodeSize

Tingkat daya komputasi yang dimiliki setiap simpul di kumpulan Big Data.

NodeSizeFamily

Jenis simpul yang disediakan oleh kumpulan Big Data.

SparkConfigProperties

Properti Konfigurasi kumpulan Spark

AutoPauseProperties

Properti jeda otomatis kumpulan Spark

Nama Jenis Deskripsi
delayInMinutes

integer

Jumlah menit waktu menganggur sebelum kumpulan Big Data secara otomatis dijeda.

enabled

boolean

Apakah jeda otomatis diaktifkan untuk kumpulan Big Data.

AutoScaleProperties

Properti penskalakan otomatis kumpulan Spark

Nama Jenis Deskripsi
enabled

boolean

Apakah penskalaan otomatis diaktifkan untuk kumpulan Big Data.

maxNodeCount

integer

Jumlah maksimum simpul yang dapat didukung oleh kumpulan Big Data.

minNodeCount

integer

Jumlah minimum simpul yang dapat didukung oleh kumpulan Big Data.

BigDataPoolResourceInfo

Kumpulan Big Data

Nama Jenis Deskripsi
id

string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya.

properties.autoPause

AutoPauseProperties

Properti jeda otomatis kumpulan Spark
Properti jeda otomatis

properties.autoScale

AutoScaleProperties

Properti penskalakan otomatis kumpulan Spark
Properti penskalakan otomatis

properties.cacheSize

integer

Ukuran cache

properties.creationDate

string

Waktu ketika kumpulan Big Data dibuat.

properties.customLibraries

LibraryInfo[]

Daftar pustaka/paket kustom yang terkait dengan kumpulan spark.

properties.defaultSparkLogFolder

string

Folder default tempat log Spark akan ditulis.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Alokasi Pelaksana Dinamis

properties.isAutotuneEnabled

boolean

Aktifkan Autotune
Apakah autotune diperlukan atau tidak.

properties.isComputeIsolationEnabled

boolean

Apakah isolasi komputasi diperlukan atau tidak.

properties.lastSucceededTimestamp

string

Waktu ketika kumpulan Big Data berhasil diperbarui.

properties.libraryRequirements

LibraryRequirements

Persyaratan versi pustaka kumpulan Spark
Persyaratan versi pustaka

properties.nodeCount

integer

Jumlah simpul di kumpulan Big Data.

properties.nodeSize

NodeSize

Tingkat daya komputasi yang dimiliki setiap simpul di kumpulan Big Data.

properties.nodeSizeFamily

NodeSizeFamily

Jenis simpul yang disediakan oleh kumpulan Big Data.

properties.provisioningState

string

Status kumpulan Big Data.

properties.sessionLevelPackagesEnabled

boolean

Apakah paket tingkat sesi diaktifkan.

properties.sparkConfigProperties

SparkConfigProperties

Properti Konfigurasi kumpulan Spark
File konfigurasi Spark untuk menentukan properti tambahan

properties.sparkEventsFolder

string

Folder peristiwa Spark

properties.sparkVersion

string

Versi Apache Spark.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ConfigurationType

Jenis file properti konfigurasi spark.

Nama Jenis Deskripsi
Artifact

string

File

string

DynamicExecutorAllocation

Properti Alokasi Pelaksana Dinamis

Nama Jenis Deskripsi
enabled

boolean

Menunjukkan apakah Alokasi Pelaksana Dinamis diaktifkan atau tidak.

maxExecutors

integer

Jumlah maksimum pelaksana yang dialokasikan

minExecutors

integer

Jumlah minimum pelaksana yang dialokasikan

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

LibraryInfo

Informasi tentang pustaka/paket yang dibuat di tingkat ruang kerja.

Nama Jenis Deskripsi
containerName

string

Nama kontainer blob penyimpanan.

creatorId

string

Id Pembuat pustaka/paket.

name

string

Nama pustaka.

path

string

Jalur blob penyimpanan pustaka.

provisioningStatus

string

Status provisi pustaka/paket.

type

string

Jenis pustaka.

uploadedTimestamp

string

Waktu pembaruan terakhir pustaka.

LibraryRequirements

Persyaratan versi pustaka kumpulan Spark

Nama Jenis Deskripsi
content

string

Persyaratan pustaka.

filename

string

Nama file file persyaratan pustaka.

time

string

Waktu pembaruan terakhir file persyaratan pustaka.

NodeSize

Tingkat daya komputasi yang dimiliki setiap simpul di kumpulan Big Data.

Nama Jenis Deskripsi
Large

string

Medium

string

None

string

Small

string

XLarge

string

XXLarge

string

XXXLarge

string

NodeSizeFamily

Jenis simpul yang disediakan oleh kumpulan Big Data.

Nama Jenis Deskripsi
HardwareAcceleratedFPGA

string

HardwareAcceleratedGPU

string

MemoryOptimized

string

None

string

SparkConfigProperties

Properti Konfigurasi kumpulan Spark

Nama Jenis Deskripsi
configurationType

ConfigurationType

Jenis file properti konfigurasi spark.

content

string

Properti konfigurasi spark.

filename

string

Nama file file properti konfigurasi spark.

time

string

Waktu pembaruan terakhir dari file properti konfigurasi spark.