Share via


Big Data Pools - Create Or Update

Cree un grupo de macrodatos.
Cree un nuevo grupo de macrodatos.

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 identificador URI

Nombre En Requerido Tipo Description
bigDataPoolName
path True

string

Nombre del grupo de macrodatos

resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

Identificador de la suscripción de destino.

workspaceName
path True

string

El nombre del área de trabajo.

api-version
query True

string

Versión de API que se usará para la operación.

force
query

boolean

Si se deben detener los trabajos en ejecución en el grupo de macrodatos

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación geográfica donde reside el recurso

properties.autoPause

AutoPauseProperties

Propiedades de pausa automática del grupo de Spark
Propiedades de pausa automática

properties.autoScale

AutoScaleProperties

Propiedades de escalado automático del grupo de Spark
Propiedades de escalado automático

properties.cacheSize

integer

Tamaño de caché

properties.customLibraries

LibraryInfo[]

Lista de bibliotecas o paquetes personalizados asociados al grupo de Spark.

properties.defaultSparkLogFolder

string

Carpeta predeterminada donde se escribirán los registros de Spark.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Asignación dinámica del ejecutor

properties.isAutotuneEnabled

boolean

Habilitar Autotune
Indica si el ajuste automático es necesario o no.

properties.isComputeIsolationEnabled

boolean

Si se requiere o no el aislamiento de proceso.

properties.libraryRequirements

LibraryRequirements

Requisitos de la versión de la biblioteca del grupo de Spark
Requisitos de la versión de la biblioteca

properties.nodeCount

integer

Número de nodos del grupo de macrodatos.

properties.nodeSize

NodeSize

Nivel de potencia de proceso que tiene cada nodo del grupo de macrodatos.

properties.nodeSizeFamily

NodeSizeFamily

El tipo de nodos que proporciona el grupo de macrodatos.

properties.provisioningState

string

Estado del grupo de macrodatos.

properties.sessionLevelPackagesEnabled

boolean

Si los paquetes de nivel de sesión están habilitados.

properties.sparkConfigProperties

SparkConfigProperties

Propiedades de configuración del grupo de Spark
Archivo de configuración de Spark para especificar propiedades adicionales

properties.sparkEventsFolder

string

Carpeta de eventos de Spark

properties.sparkVersion

string

La versión de Apache Spark.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

BigDataPoolResourceInfo

Aceptar

202 Accepted

BigDataPoolResourceInfo

Other Status Codes

ErrorResponse

Ejemplos

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

Definiciones

Nombre Description
AutoPauseProperties

Propiedades de pausa automática del grupo de Spark

AutoScaleProperties

Propiedades de escalado automático del grupo de Spark

BigDataPoolResourceInfo

Grupo de macrodatos

ConfigurationType

Tipo del archivo de propiedades de configuración de Spark.

DynamicExecutorAllocation

Propiedades de asignación dinámica del ejecutor

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

LibraryInfo

Información sobre una biblioteca o paquete creado en el nivel de área de trabajo.

LibraryRequirements

Requisitos de la versión de la biblioteca del grupo de Spark

NodeSize

Nivel de potencia de proceso que tiene cada nodo del grupo de macrodatos.

NodeSizeFamily

El tipo de nodos que proporciona el grupo de macrodatos.

SparkConfigProperties

Propiedades de configuración del grupo de Spark

AutoPauseProperties

Propiedades de pausa automática del grupo de Spark

Nombre Tipo Description
delayInMinutes

integer

Número de minutos de tiempo de inactividad antes de que el grupo de macrodatos se pause automáticamente.

enabled

boolean

Indica si la pausa automática está habilitada para el grupo de macrodatos.

AutoScaleProperties

Propiedades de escalado automático del grupo de Spark

Nombre Tipo Description
enabled

boolean

Si el escalado automático está habilitado para el grupo de macrodatos.

maxNodeCount

integer

El número máximo de nodos que puede admitir el grupo de macrodatos.

minNodeCount

integer

El número mínimo de nodos que puede admitir el grupo de macrodatos.

BigDataPoolResourceInfo

Grupo de macrodatos

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.autoPause

AutoPauseProperties

Propiedades de pausa automática del grupo de Spark
Propiedades de pausa automática

properties.autoScale

AutoScaleProperties

Propiedades de escalado automático del grupo de Spark
Propiedades de escalado automático

properties.cacheSize

integer

Tamaño de caché

properties.creationDate

string

Hora a la que se creó el grupo de macrodatos.

properties.customLibraries

LibraryInfo[]

Lista de bibliotecas o paquetes personalizados asociados al grupo de Spark.

properties.defaultSparkLogFolder

string

Carpeta predeterminada donde se escribirán los registros de Spark.

properties.dynamicExecutorAllocation

DynamicExecutorAllocation

Asignación dinámica del ejecutor

properties.isAutotuneEnabled

boolean

Habilitar Autotune
Indica si el ajuste automático es necesario o no.

properties.isComputeIsolationEnabled

boolean

Si se requiere o no el aislamiento de proceso.

properties.lastSucceededTimestamp

string

Hora en que el grupo de macrodatos se actualizó correctamente.

properties.libraryRequirements

LibraryRequirements

Requisitos de la versión de la biblioteca del grupo de Spark
Requisitos de la versión de la biblioteca

properties.nodeCount

integer

Número de nodos del grupo de macrodatos.

properties.nodeSize

NodeSize

Nivel de potencia de proceso que tiene cada nodo del grupo de macrodatos.

properties.nodeSizeFamily

NodeSizeFamily

El tipo de nodos que proporciona el grupo de macrodatos.

properties.provisioningState

string

Estado del grupo de macrodatos.

properties.sessionLevelPackagesEnabled

boolean

Si los paquetes de nivel de sesión están habilitados.

properties.sparkConfigProperties

SparkConfigProperties

Propiedades de configuración del grupo de Spark
Archivo de configuración de Spark para especificar propiedades adicionales

properties.sparkEventsFolder

string

Carpeta de eventos de Spark

properties.sparkVersion

string

La versión de Apache Spark.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ConfigurationType

Tipo del archivo de propiedades de configuración de Spark.

Nombre Tipo Description
Artifact

string

File

string

DynamicExecutorAllocation

Propiedades de asignación dinámica del ejecutor

Nombre Tipo Description
enabled

boolean

Indica si la asignación dinámica del ejecutor está habilitada o no.

maxExecutors

integer

Número máximo de ejecutores alloted

minExecutors

integer

Número mínimo de ejecutores a los que se ha unido

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

LibraryInfo

Información sobre una biblioteca o paquete creado en el nivel de área de trabajo.

Nombre Tipo Description
containerName

string

Nombre del contenedor de blobs de almacenamiento.

creatorId

string

Id. de creador de la biblioteca o paquete.

name

string

Nombre de la biblioteca.

path

string

Ruta de acceso del blob de almacenamiento de la biblioteca.

provisioningStatus

string

Estado de aprovisionamiento de la biblioteca o paquete.

type

string

Tipo de la biblioteca.

uploadedTimestamp

string

Hora de la última actualización de la biblioteca.

LibraryRequirements

Requisitos de la versión de la biblioteca del grupo de Spark

Nombre Tipo Description
content

string

Los requisitos de la biblioteca.

filename

string

Nombre de archivo del archivo de requisitos de la biblioteca.

time

string

Hora de la última actualización del archivo de requisitos de la biblioteca.

NodeSize

Nivel de potencia de proceso que tiene cada nodo del grupo de macrodatos.

Nombre Tipo Description
Large

string

Medium

string

None

string

Small

string

XLarge

string

XXLarge

string

XXXLarge

string

NodeSizeFamily

El tipo de nodos que proporciona el grupo de macrodatos.

Nombre Tipo Description
HardwareAcceleratedFPGA

string

HardwareAcceleratedGPU

string

MemoryOptimized

string

None

string

SparkConfigProperties

Propiedades de configuración del grupo de Spark

Nombre Tipo Description
configurationType

ConfigurationType

Tipo del archivo de propiedades de configuración de Spark.

content

string

Las propiedades de configuración de Spark.

filename

string

Nombre de archivo del archivo de propiedades de configuración de Spark.

time

string

Hora de la última actualización del archivo de propiedades de configuración de Spark.