Udostępnij za pośrednictwem


Big Data Pools - Create Or Update

Utwórz pulę danych big data.
Utwórz nową pulę danych big data.

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}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
bigDataPoolName
path True

string

Nazwa puli danych big data

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

workspaceName
path True

string

Nazwa obszaru roboczego.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

force
query

boolean

Czy zatrzymać wszystkie uruchomione zadania w puli danych big data

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

properties.autoPause

AutoPauseProperties

Właściwości automatycznego wstrzymujące pulę platformy Spark
Automatycznie wstrzymując właściwości

properties.autoScale

AutoScaleProperties

Właściwości automatycznego skalowania puli platformy Spark
Właściwości automatycznego skalowania

properties.cacheSize

integer

Rozmiar pamięci podręcznej

properties.customLibraries

LibraryInfo[]

Lista niestandardowych bibliotek/pakietów skojarzonych z pulą platformy Spark.

properties.defaultSparkLogFolder

string

Domyślny folder, w którym będą zapisywane dzienniki platformy Spark.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Alokacja funkcji wykonawczej dynamicznej

properties.isAutotuneEnabled

boolean

Włączanie automatycznego dostrajania
Niezależnie od tego, czy autotune jest wymagane, czy nie.

properties.isComputeIsolationEnabled

boolean

Niezależnie od tego, czy izolacja obliczeniowa jest wymagana, czy nie.

properties.libraryRequirements

LibraryRequirements

Wymagania dotyczące wersji biblioteki puli platformy Spark
Wymagania dotyczące wersji biblioteki

properties.nodeCount

integer

Liczba węzłów w puli danych big data.

properties.nodeSize

NodeSize

Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data.

properties.nodeSizeFamily

NodeSizeFamily

Rodzaj węzłów zapewnianych przez pulę danych big data.

properties.provisioningState

string

Stan puli danych big data.

properties.sessionLevelPackagesEnabled

boolean

Określa, czy pakiety na poziomie sesji są włączone.

properties.sparkConfigProperties

SparkConfigProperties

Właściwości konfiguracji puli platformy Spark
Plik konfiguracji platformy Spark w celu określenia dodatkowych właściwości

properties.sparkEventsFolder

string

Folder zdarzeń platformy Spark

properties.sparkVersion

string

Wersja platformy Apache Spark.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

BigDataPoolResourceInfo

OK

202 Accepted

BigDataPoolResourceInfo

Other Status Codes

ErrorResponse

Przykłady

Create or update a Big Data pool

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
AutoPauseProperties

Właściwości automatycznego wstrzymujące pulę platformy Spark

AutoScaleProperties

Właściwości automatycznego skalowania puli platformy Spark

BigDataPoolResourceInfo

Pula danych big data

ConfigurationType

Typ pliku właściwości konfiguracji platformy Spark.

DynamicExecutorAllocation

Właściwości alokacji funkcji wykonawczej dynamicznej

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

LibraryInfo

Informacje o bibliotece/pakiecie utworzonym na poziomie obszaru roboczego.

LibraryRequirements

Wymagania dotyczące wersji biblioteki puli platformy Spark

NodeSize

Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data.

NodeSizeFamily

Rodzaj węzłów zapewnianych przez pulę danych big data.

SparkConfigProperties

Właściwości konfiguracji puli platformy Spark

AutoPauseProperties

Właściwości automatycznego wstrzymujące pulę platformy Spark

Nazwa Typ Opis
delayInMinutes

integer

Liczba minut bezczynności przed automatycznym wstrzymaniem puli danych big data.

enabled

boolean

Określa, czy automatyczne wstrzymanie jest włączone dla puli danych big data.

AutoScaleProperties

Właściwości automatycznego skalowania puli platformy Spark

Nazwa Typ Opis
enabled

boolean

Określa, czy automatyczne skalowanie jest włączone dla puli danych big data.

maxNodeCount

integer

Maksymalna liczba węzłów, które może obsługiwać pula danych big data.

minNodeCount

integer

Minimalna liczba węzłów, które może obsługiwać pula danych big data.

BigDataPoolResourceInfo

Pula danych big data

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.autoPause

AutoPauseProperties

Właściwości automatycznego wstrzymujące pulę platformy Spark
Automatycznie wstrzymując właściwości

properties.autoScale

AutoScaleProperties

Właściwości automatycznego skalowania puli platformy Spark
Właściwości automatycznego skalowania

properties.cacheSize

integer

Rozmiar pamięci podręcznej

properties.creationDate

string

Godzina utworzenia puli danych big data.

properties.customLibraries

LibraryInfo[]

Lista niestandardowych bibliotek/pakietów skojarzonych z pulą platformy Spark.

properties.defaultSparkLogFolder

string

Domyślny folder, w którym będą zapisywane dzienniki platformy Spark.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Alokacja funkcji wykonawczej dynamicznej

properties.isAutotuneEnabled

boolean

Włączanie automatycznego dostrajania
Niezależnie od tego, czy autotune jest wymagane, czy nie.

properties.isComputeIsolationEnabled

boolean

Niezależnie od tego, czy izolacja obliczeniowa jest wymagana, czy nie.

properties.lastSucceededTimestamp

string

Czas pomyślnej aktualizacji puli danych big data.

properties.libraryRequirements

LibraryRequirements

Wymagania dotyczące wersji biblioteki puli platformy Spark
Wymagania dotyczące wersji biblioteki

properties.nodeCount

integer

Liczba węzłów w puli danych big data.

properties.nodeSize

NodeSize

Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data.

properties.nodeSizeFamily

NodeSizeFamily

Rodzaj węzłów zapewnianych przez pulę danych big data.

properties.provisioningState

string

Stan puli danych big data.

properties.sessionLevelPackagesEnabled

boolean

Określa, czy pakiety na poziomie sesji są włączone.

properties.sparkConfigProperties

SparkConfigProperties

Właściwości konfiguracji puli platformy Spark
Plik konfiguracji platformy Spark w celu określenia dodatkowych właściwości

properties.sparkEventsFolder

string

Folder zdarzeń platformy Spark

properties.sparkVersion

string

Wersja platformy Apache Spark.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ConfigurationType

Typ pliku właściwości konfiguracji platformy Spark.

Nazwa Typ Opis
Artifact

string

File

string

DynamicExecutorAllocation

Właściwości alokacji funkcji wykonawczej dynamicznej

Nazwa Typ Opis
enabled

boolean

Wskazuje, czy dynamiczna alokacja funkcji wykonawczej jest włączona, czy nie.

maxExecutors

integer

Maksymalna liczba funkcji wykonawczych przydzielanych

minExecutors

integer

Minimalna liczba funkcji wykonawczych przydzielanych

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

LibraryInfo

Informacje o bibliotece/pakiecie utworzonym na poziomie obszaru roboczego.

Nazwa Typ Opis
containerName

string

Nazwa kontenera obiektów blob magazynu.

creatorId

string

Identyfikator twórcy biblioteki/pakietu.

name

string

Nazwa biblioteki.

path

string

Ścieżka obiektu blob magazynu biblioteki.

provisioningStatus

string

Stan aprowizacji biblioteki/pakietu.

type

string

Typ biblioteki.

uploadedTimestamp

string

Czas ostatniej aktualizacji biblioteki.

LibraryRequirements

Wymagania dotyczące wersji biblioteki puli platformy Spark

Nazwa Typ Opis
content

string

Wymagania dotyczące biblioteki.

filename

string

Nazwa pliku wymagań biblioteki.

time

string

Czas ostatniej aktualizacji pliku wymagań biblioteki.

NodeSize

Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data.

Nazwa Typ Opis
Large

string

Medium

string

None

string

Small

string

XLarge

string

XXLarge

string

XXXLarge

string

NodeSizeFamily

Rodzaj węzłów zapewnianych przez pulę danych big data.

Nazwa Typ Opis
HardwareAcceleratedFPGA

string

HardwareAcceleratedGPU

string

MemoryOptimized

string

None

string

SparkConfigProperties

Właściwości konfiguracji puli platformy Spark

Nazwa Typ Opis
configurationType

ConfigurationType

Typ pliku właściwości konfiguracji platformy Spark.

content

string

Właściwości konfiguracji platformy Spark.

filename

string

Nazwa pliku właściwości konfiguracji platformy Spark.

time

string

Czas ostatniej aktualizacji pliku właściwości konfiguracji platformy Spark.