Sdílet prostřednictvím


Big Data Pools - Create Or Update

Vytvořte fond velkých objemů dat.
Vytvořte nový fond velkých objemů dat.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
bigDataPoolName
path True

string

Název fondu velkých objemů dat

resourceGroupName
path True

string

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

subscriptionId
path True

string

ID cílového předplatného.

workspaceName
path True

string

Název pracovního prostoru.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

force
query

boolean

Jestli chcete zastavit všechny spuštěné úlohy ve fondu velkých objemů dat

Text požadavku

Name Vyžadováno Typ Description
location True

string

Geografické umístění, ve kterém se nachází zdroj

properties.autoPause

AutoPauseProperties

Automatické pozastavení vlastností fondu Sparku
Automatické pozastavení vlastností

properties.autoScale

AutoScaleProperties

Vlastnosti automatického škálování fondu Sparku
Vlastnosti automatického škálování

properties.cacheSize

integer

Velikost mezipaměti

properties.customLibraries

LibraryInfo[]

Seznam vlastních knihoven a balíčků přidružených k fondu Spark

properties.defaultSparkLogFolder

string

Výchozí složka, do které se zapíšou protokoly Sparku.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Přidělení dynamického exekutoru

properties.isAutotuneEnabled

boolean

Povolení automatického ladění
Bez ohledu na to, jestli je automatické ladění povinné, nebo ne.

properties.isComputeIsolationEnabled

boolean

Bez ohledu na to, jestli se vyžaduje izolace výpočetních prostředků, nebo ne.

properties.libraryRequirements

LibraryRequirements

Požadavky na verzi knihovny fondu Sparku
Požadavky na verzi knihovny

properties.nodeCount

integer

Počet uzlů ve fondu velkých objemů dat.

properties.nodeSize

NodeSize

Úroveň výpočetního výkonu, kterou má každý uzel ve fondu velkých objemů dat.

properties.nodeSizeFamily

NodeSizeFamily

Druh uzlů, které fond velkých objemů dat poskytuje.

properties.provisioningState

string

Stav fondu velkých objemů dat.

properties.sessionLevelPackagesEnabled

boolean

Určuje, jestli jsou povolené balíčky na úrovni relace.

properties.sparkConfigProperties

SparkConfigProperties

Vlastnosti konfigurace fondu Sparku
Konfigurační soubor Sparku pro zadání dalších vlastností

properties.sparkEventsFolder

string

Složka událostí Sparku

properties.sparkVersion

string

Verze Apache Sparku.

tags

object

Značky prostředků

Odpovědi

Name Typ Description
200 OK

BigDataPoolResourceInfo

OK

202 Accepted

BigDataPoolResourceInfo

Other Status Codes

ErrorResponse

Příklady

Create or update a Big Data pool

Ukázkový požadavek

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

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

Ukázková odpověď

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

Definice

Name Description
AutoPauseProperties

Automatické pozastavení vlastností fondu Sparku

AutoScaleProperties

Vlastnosti automatického škálování fondu Sparku

BigDataPoolResourceInfo

Fond velkých objemů dat

ConfigurationType

Typ souboru vlastností konfigurace Sparku.

DynamicExecutorAllocation

Vlastnosti přidělení dynamického exekutoru

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

LibraryInfo

Informace o knihovně nebo balíčku vytvořeném na úrovni pracovního prostoru.

LibraryRequirements

Požadavky na verzi knihovny fondu Sparku

NodeSize

Úroveň výpočetního výkonu, kterou má každý uzel ve fondu velkých objemů dat.

NodeSizeFamily

Druh uzlů, které fond velkých objemů dat poskytuje.

SparkConfigProperties

Vlastnosti konfigurace fondu Sparku

AutoPauseProperties

Automatické pozastavení vlastností fondu Sparku

Name Typ Description
delayInMinutes

integer

Počet minut nečinnosti před automatickým pozastavením fondu velkých objemů dat

enabled

boolean

Určuje, jestli je pro fond velkých objemů dat povolené automatické pozastavení.

AutoScaleProperties

Vlastnosti automatického škálování fondu Sparku

Name Typ Description
enabled

boolean

Určuje, jestli je pro fond velkých objemů dat povolené automatické škálování.

maxNodeCount

integer

Maximální počet uzlů, které může fond velkých objemů dat podporovat.

minNodeCount

integer

Minimální početuzlůch

BigDataPoolResourceInfo

Fond velkých objemů dat

Name Typ Description
id

string

Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Geografické umístění, ve kterém se nachází zdroj

name

string

Název prostředku

properties.autoPause

AutoPauseProperties

Automatické pozastavení vlastností fondu Sparku
Automatické pozastavení vlastností

properties.autoScale

AutoScaleProperties

Vlastnosti automatického škálování fondu Sparku
Vlastnosti automatického škálování

properties.cacheSize

integer

Velikost mezipaměti

properties.creationDate

string

Čas vytvoření fondu velkých objemů dat

properties.customLibraries

LibraryInfo[]

Seznam vlastních knihoven a balíčků přidružených k fondu Spark

properties.defaultSparkLogFolder

string

Výchozí složka, do které se zapíšou protokoly Sparku.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Přidělení dynamického exekutoru

properties.isAutotuneEnabled

boolean

Povolení automatického ladění
Bez ohledu na to, jestli je automatické ladění povinné, nebo ne.

properties.isComputeIsolationEnabled

boolean

Bez ohledu na to, jestli se vyžaduje izolace výpočetních prostředků, nebo ne.

properties.lastSucceededTimestamp

string

Čas úspěšné aktualizace fondu velkých objemů dat

properties.libraryRequirements

LibraryRequirements

Požadavky na verzi knihovny fondu Sparku
Požadavky na verzi knihovny

properties.nodeCount

integer

Počet uzlů ve fondu velkých objemů dat.

properties.nodeSize

NodeSize

Úroveň výpočetního výkonu, kterou má každý uzel ve fondu velkých objemů dat.

properties.nodeSizeFamily

NodeSizeFamily

Druh uzlů, které fond velkých objemů dat poskytuje.

properties.provisioningState

string

Stav fondu velkých objemů dat.

properties.sessionLevelPackagesEnabled

boolean

Určuje, jestli jsou povolené balíčky na úrovni relace.

properties.sparkConfigProperties

SparkConfigProperties

Vlastnosti konfigurace fondu Sparku
Konfigurační soubor Sparku pro zadání dalších vlastností

properties.sparkEventsFolder

string

Složka událostí Sparku

properties.sparkVersion

string

Verze Apache Sparku.

tags

object

Značky prostředků

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ConfigurationType

Typ souboru vlastností konfigurace Sparku.

Name Typ Description
Artifact

string

File

string

DynamicExecutorAllocation

Vlastnosti přidělení dynamického exekutoru

Name Typ Description
enabled

boolean

Určuje, jestli je povolené přidělení dynamického exekutoru, nebo ne.

maxExecutors

integer

Maximální počet exekutorů, které jsou přidělené

minExecutors

integer

Minimální počet exekutorů, které jsou přidělené

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

LibraryInfo

Informace o knihovně nebo balíčku vytvořeném na úrovni pracovního prostoru.

Name Typ Description
containerName

string

Název kontejneru objektů blob úložiště

creatorId

string

ID autora knihovny nebo balíčku.

name

string

Název knihovny.

path

string

Cesta k objektu blob úložiště knihovny

provisioningStatus

string

Stav zřizování knihovny nebo balíčku

type

string

Typ knihovny.

uploadedTimestamp

string

Čas poslední aktualizace knihovny.

LibraryRequirements

Požadavky na verzi knihovny fondu Sparku

Name Typ Description
content

string

Požadavky na knihovnu

filename

string

Název souboru požadavků knihovny.

time

string

Čas poslední aktualizace souboru s požadavky knihovny.

NodeSize

Úroveň výpočetního výkonu, kterou má každý uzel ve fondu velkých objemů dat.

Name Typ Description
Large

string

Medium

string

None

string

Small

string

XLarge

string

XXLarge

string

XXXLarge

string

NodeSizeFamily

Druh uzlů, které fond velkých objemů dat poskytuje.

Name Typ Description
HardwareAcceleratedFPGA

string

HardwareAcceleratedGPU

string

MemoryOptimized

string

None

string

SparkConfigProperties

Vlastnosti konfigurace fondu Sparku

Name Typ Description
configurationType

ConfigurationType

Typ souboru vlastností konfigurace Sparku.

content

string

Vlastnosti konfigurace Sparku.

filename

string

Název souboru vlastností konfigurace Sparku.

time

string

Čas poslední aktualizace souboru vlastností konfigurace Sparku.