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 |
---|---|---|---|---|
big
|
path | True |
string |
Nazwa puli danych big data |
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
workspace
|
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 |
Właściwości automatycznego wstrzymujące pulę platformy Spark |
||
properties.autoScale |
Właściwości automatycznego skalowania puli platformy Spark |
||
properties.cacheSize |
integer |
Rozmiar pamięci podręcznej |
|
properties.customLibraries |
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 |
Alokacja funkcji wykonawczej dynamicznej |
||
properties.isAutotuneEnabled |
boolean |
Włączanie automatycznego dostrajania |
|
properties.isComputeIsolationEnabled |
boolean |
Niezależnie od tego, czy izolacja obliczeniowa jest wymagana, czy nie. |
|
properties.libraryRequirements |
Wymagania dotyczące wersji biblioteki puli platformy Spark |
||
properties.nodeCount |
integer |
Liczba węzłów w puli danych big data. |
|
properties.nodeSize |
Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data. |
||
properties.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 |
Właściwości konfiguracji puli platformy Spark |
||
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 |
OK |
|
202 Accepted | ||
Other Status Codes |
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 |
---|---|
Auto |
Właściwości automatycznego wstrzymujące pulę platformy Spark |
Auto |
Właściwości automatycznego skalowania puli platformy Spark |
Big |
Pula danych big data |
Configuration |
Typ pliku właściwości konfiguracji platformy Spark. |
Dynamic |
Właściwości alokacji funkcji wykonawczej dynamicznej |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Library |
Informacje o bibliotece/pakiecie utworzonym na poziomie obszaru roboczego. |
Library |
Wymagania dotyczące wersji biblioteki puli platformy Spark |
Node |
Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data. |
Node |
Rodzaj węzłów zapewnianych przez pulę danych big data. |
Spark |
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 |
Właściwości automatycznego wstrzymujące pulę platformy Spark |
|
properties.autoScale |
Właściwości automatycznego skalowania puli platformy Spark |
|
properties.cacheSize |
integer |
Rozmiar pamięci podręcznej |
properties.creationDate |
string |
Godzina utworzenia puli danych big data. |
properties.customLibraries |
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 |
Alokacja funkcji wykonawczej dynamicznej |
|
properties.isAutotuneEnabled |
boolean |
Włączanie automatycznego dostrajania |
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 |
Wymagania dotyczące wersji biblioteki puli platformy Spark |
|
properties.nodeCount |
integer |
Liczba węzłów w puli danych big data. |
properties.nodeSize |
Poziom mocy obliczeniowej, jaką ma każdy węzeł w puli danych big data. |
|
properties.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 |
Właściwości konfiguracji puli platformy Spark |
|
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
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. |