Big Data Pools - Create Or Update
Criar um pool de Big Data.
Crie um novo pool de 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}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
big
|
path | True |
string |
Nome do pool de Big Data |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
workspace
|
path | True |
string |
O nome do workspace. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
force
|
query |
boolean |
Se deseja interromper trabalhos em execução no pool de Big Data |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
location | True |
string |
A localização geográfica em que o recurso reside |
properties.autoPause |
Propriedades de pausa automática do pool do Spark |
||
properties.autoScale |
Propriedades de dimensionamento automático do pool do Spark |
||
properties.cacheSize |
integer |
O tamanho do cache |
|
properties.customLibraries |
Lista de bibliotecas/pacotes personalizados associados ao pool do Spark. |
||
properties.defaultSparkLogFolder |
string |
A pasta padrão em que os logs do Spark serão gravados. |
|
properties.dynamicExecutorAllocation |
Alocação de Executor Dinâmico |
||
properties.isAutotuneEnabled |
boolean |
Habilitar o Autotune |
|
properties.isComputeIsolationEnabled |
boolean |
Se o isolamento de computação é necessário ou não. |
|
properties.libraryRequirements |
Requisitos de versão da biblioteca do pool do Spark |
||
properties.nodeCount |
integer |
O número de nós no pool de Big Data. |
|
properties.nodeSize |
O nível de poder de computação que cada nó no pool de Big Data tem. |
||
properties.nodeSizeFamily |
O tipo de nós que o pool de Big Data fornece. |
||
properties.provisioningState |
string |
O estado do pool de Big Data. |
|
properties.sessionLevelPackagesEnabled |
boolean |
Se os pacotes de nível de sessão estão habilitados. |
|
properties.sparkConfigProperties |
Propriedades de configuração do pool do Spark |
||
properties.sparkEventsFolder |
string |
A pasta de eventos do Spark |
|
properties.sparkVersion |
string |
A versão do Apache Spark. |
|
tags |
object |
Marcas de recurso. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted | ||
Other Status Codes |
Exemplos
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"
}
}
Definições
Nome | Description |
---|---|
Auto |
Propriedades de pausa automática do pool do Spark |
Auto |
Propriedades de dimensionamento automático do pool do Spark |
Big |
Pool de Big Data |
Configuration |
O tipo do arquivo de propriedades de configuração do Spark. |
Dynamic |
Propriedades de alocação do executor dinâmico |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
Os detalhes do erro. |
Error |
Resposta de erro |
Library |
Informações sobre uma biblioteca/pacote criado no nível do workspace. |
Library |
Requisitos de versão da biblioteca do pool do Spark |
Node |
O nível de poder de computação que cada nó no pool de Big Data tem. |
Node |
O tipo de nós que o pool de Big Data fornece. |
Spark |
Propriedades de configuração do pool do Spark |
AutoPauseProperties
Propriedades de pausa automática do pool do Spark
Nome | Tipo | Description |
---|---|---|
delayInMinutes |
integer |
Número de minutos de tempo ocioso antes que o pool de Big Data seja pausado automaticamente. |
enabled |
boolean |
Se a pausa automática está habilitada para o pool de Big Data. |
AutoScaleProperties
Propriedades de dimensionamento automático do pool do Spark
Nome | Tipo | Description |
---|---|---|
enabled |
boolean |
Se o dimensionamento automático está habilitado para o pool de Big Data. |
maxNodeCount |
integer |
O número máximo de nós aos quais o pool de Big Data pode dar suporte. |
minNodeCount |
integer |
O número mínimo de nós aos quais o pool de Big Data pode dar suporte. |
BigDataPoolResourceInfo
Pool de Big Data
Nome | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A localização geográfica em que o recurso reside |
name |
string |
O nome do recurso |
properties.autoPause |
Propriedades de pausa automática do pool do Spark |
|
properties.autoScale |
Propriedades de dimensionamento automático do pool do Spark |
|
properties.cacheSize |
integer |
O tamanho do cache |
properties.creationDate |
string |
A hora em que o pool de Big Data foi criado. |
properties.customLibraries |
Lista de bibliotecas/pacotes personalizados associados ao pool do Spark. |
|
properties.defaultSparkLogFolder |
string |
A pasta padrão em que os logs do Spark serão gravados. |
properties.dynamicExecutorAllocation |
Alocação de Executor Dinâmico |
|
properties.isAutotuneEnabled |
boolean |
Habilitar o Autotune |
properties.isComputeIsolationEnabled |
boolean |
Se o isolamento de computação é necessário ou não. |
properties.lastSucceededTimestamp |
string |
A hora em que o pool de Big Data foi atualizado com êxito. |
properties.libraryRequirements |
Requisitos de versão da biblioteca do pool do Spark |
|
properties.nodeCount |
integer |
O número de nós no pool de Big Data. |
properties.nodeSize |
O nível de poder de computação que cada nó no pool de Big Data tem. |
|
properties.nodeSizeFamily |
O tipo de nós que o pool de Big Data fornece. |
|
properties.provisioningState |
string |
O estado do pool de Big Data. |
properties.sessionLevelPackagesEnabled |
boolean |
Se os pacotes de nível de sessão estão habilitados. |
properties.sparkConfigProperties |
Propriedades de configuração do pool do Spark |
|
properties.sparkEventsFolder |
string |
A pasta de eventos do Spark |
properties.sparkVersion |
string |
A versão do Apache Spark. |
tags |
object |
Marcas de recurso. |
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
ConfigurationType
O tipo do arquivo de propriedades de configuração do Spark.
Nome | Tipo | Description |
---|---|---|
Artifact |
string |
|
File |
string |
DynamicExecutorAllocation
Propriedades de alocação do executor dinâmico
Nome | Tipo | Description |
---|---|---|
enabled |
boolean |
Indica se a Alocação de Executor Dinâmico está habilitada ou não. |
maxExecutors |
integer |
O número máximo de executores alocados |
minExecutors |
integer |
O número mínimo de executores alocados |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
Os detalhes do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
LibraryInfo
Informações sobre uma biblioteca/pacote criado no nível do workspace.
Nome | Tipo | Description |
---|---|---|
containerName |
string |
Nome do contêiner de blob de armazenamento. |
creatorId |
string |
ID do criador da biblioteca/pacote. |
name |
string |
Nome da biblioteca. |
path |
string |
Caminho de blob de armazenamento da biblioteca. |
provisioningStatus |
string |
Provisionamento status da biblioteca/pacote. |
type |
string |
Tipo da biblioteca. |
uploadedTimestamp |
string |
A hora da última atualização da biblioteca. |
LibraryRequirements
Requisitos de versão da biblioteca do pool do Spark
Nome | Tipo | Description |
---|---|---|
content |
string |
Os requisitos da biblioteca. |
filename |
string |
O nome do arquivo de requisitos da biblioteca. |
time |
string |
A hora da última atualização do arquivo de requisitos da biblioteca. |
NodeSize
O nível de poder de computação que cada nó no pool de Big Data tem.
Nome | Tipo | Description |
---|---|---|
Large |
string |
|
Medium |
string |
|
None |
string |
|
Small |
string |
|
XLarge |
string |
|
XXLarge |
string |
|
XXXLarge |
string |
NodeSizeFamily
O tipo de nós que o pool de Big Data fornece.
Nome | Tipo | Description |
---|---|---|
HardwareAcceleratedFPGA |
string |
|
HardwareAcceleratedGPU |
string |
|
MemoryOptimized |
string |
|
None |
string |
SparkConfigProperties
Propriedades de configuração do pool do Spark
Nome | Tipo | Description |
---|---|---|
configurationType |
O tipo do arquivo de propriedades de configuração do Spark. |
|
content |
string |
As propriedades de configuração do Spark. |
filename |
string |
O nome do arquivo de propriedades de configuração do Spark. |
time |
string |
A hora da última atualização do arquivo de propriedades de configuração do Spark. |