Поделиться через


Big Data Pools - Create Or Update

Создайте пул больших данных.
Создайте пул больших данных.

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}

Параметры URI

Имя В Обязательно Тип Описание
bigDataPoolName
path True

string

Имя пула больших данных

resourceGroupName
path True

string

Имя группы ресурсов. Регистр букв в имени не учитывается.

subscriptionId
path True

string

Идентификатор целевой подписки.

workspaceName
path True

string

имя рабочей области;

api-version
query True

string

Версия API, используемая для данной операции.

force
query

boolean

Следует ли останавливать какие-либо выполняемые задания в пуле больших данных

Текст запроса

Имя Обязательно Тип Описание
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

Включение автозаключения
Требуется ли автозапуск.

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

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

BigDataPoolResourceInfo

ОК

202 Accepted

BigDataPoolResourceInfo

Other Status Codes

ErrorResponse

Примеры

Create or update a Big Data pool

Образец запроса

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

Пример ответа

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

Определения

Имя Описание
AutoPauseProperties

Свойства автоматической приостановки пула Spark

AutoScaleProperties

Свойства автоматического масштабирования пула Spark

BigDataPoolResourceInfo

Пул больших данных

ConfigurationType

Тип файла свойств конфигурации Spark.

DynamicExecutorAllocation

Свойства выделения динамического исполнителя

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

LibraryInfo

Сведения о библиотеке или пакете, созданных на уровне рабочей области.

LibraryRequirements

Требования к версии библиотеки пула Spark

NodeSize

Уровень вычислительной мощности, которую имеет каждый узел в пуле больших данных.

NodeSizeFamily

Тип узлов, которые предоставляет пул больших данных.

SparkConfigProperties

Свойства конфигурации пула Spark

AutoPauseProperties

Свойства автоматической приостановки пула Spark

Имя Тип Описание
delayInMinutes

integer

Количество минут простоя до автоматической приостановки пула больших данных.

enabled

boolean

Включена ли автоматическая приостановка для пула больших данных.

AutoScaleProperties

Свойства автоматического масштабирования пула Spark

Имя Тип Описание
enabled

boolean

Включено ли автоматическое масштабирование для пула больших данных.

maxNodeCount

integer

Максимальное количество узлов, которые может поддерживать пул больших данных.

minNodeCount

integer

Минимальное количество узлов, которые может поддерживать пул больших данных.

BigDataPoolResourceInfo

Пул больших данных

Имя Тип Описание
id

string

Полный идентификатор ресурса. Пример : /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

Включение автозаключения
Требуется ли автозапуск.

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.

Имя Тип Описание
Artifact

string

File

string

DynamicExecutorAllocation

Свойства выделения динамического исполнителя

Имя Тип Описание
enabled

boolean

Указывает, включено ли динамическое выделение исполнителя.

maxExecutors

integer

Максимальное число исполнителей, выделение

minExecutors

integer

Минимальное число исполнителей, выделение

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

LibraryInfo

Сведения о библиотеке или пакете, созданных на уровне рабочей области.

Имя Тип Описание
containerName

string

Имя контейнера BLOB-объектов хранилища.

creatorId

string

Идентификатор создателя библиотеки или пакета.

name

string

Имя библиотеки.

path

string

Путь к большому двоичному объекту хранилища к библиотеке.

provisioningStatus

string

Состояние подготовки библиотеки или пакета.

type

string

Тип библиотеки.

uploadedTimestamp

string

Время последнего обновления библиотеки.

LibraryRequirements

Требования к версии библиотеки пула Spark

Имя Тип Описание
content

string

Требования к библиотеке.

filename

string

Имя файла требований к библиотеке.

time

string

Время последнего обновления файла требований к библиотеке.

NodeSize

Уровень вычислительной мощности, которую имеет каждый узел в пуле больших данных.

Имя Тип Описание
Large

string

Medium

string

None

string

Small

string

XLarge

string

XXLarge

string

XXXLarge

string

NodeSizeFamily

Тип узлов, которые предоставляет пул больших данных.

Имя Тип Описание
HardwareAcceleratedFPGA

string

HardwareAcceleratedGPU

string

MemoryOptimized

string

None

string

SparkConfigProperties

Свойства конфигурации пула Spark

Имя Тип Описание
configurationType

ConfigurationType

Тип файла свойств конфигурации Spark.

content

string

Свойства конфигурации Spark.

filename

string

Имя файла свойств конфигурации Spark.

time

string

Время последнего обновления файла свойств конфигурации Spark.