Espaços de trabalho Microsoft.Synapse/sqlPools/workloadGroups

Definição de recursos do bíceps

O tipo de recurso workspaces/sqlPools/workloadGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Synapse/workspaces/sqlPools/workloadGroups, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Synapse/workspaces/sqlPools/workloadGroups@2021-06-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    importance: 'string'
    maxResourcePercent: int
    maxResourcePercentPerRequest: int
    minResourcePercent: int
    minResourcePercentPerRequest: int
    queryExecutionTimeout: int
  }
}

Valores de propriedade

Microsoft.Synapse/workspaces/sqlPools/workloadGroups

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
elemento principal No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para o recurso do tipo: workspaces/sqlPools
propriedades Propriedades do recurso. WorkloadGroupProperties

WorkloadGroupProperties

Designação Descrição Valor
Importância O nível de importância do grupo de carga de trabalho. cadeia (de caracteres)
maxResourcePercent O recurso de porcentagem de limite do grupo de carga de trabalho. int (obrigatório)
maxResourcePercentPerRequest A porcentagem máxima de concessão da solicitação do grupo de carga de trabalho. Int
minResourcePercent O recurso de porcentagem mínima do grupo de carga de trabalho. int (obrigatório)
minResourcePercentPerRequest O grupo de carga de trabalho solicita a porcentagem mínima de concessão. int (obrigatório)
queryExecutionTimeout O tempo limite de execução da consulta do grupo de carga de trabalho. Int

Exemplos de uso

Amostras de bíceps

Um exemplo básico de implantação do Synapse SQL Pool Workload Group.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@description('The SQL administrator login for the Synapse workspace')
param sqlAdministratorLogin string
@secure()
@description('The SQL administrator login password for the Synapse workspace')
param sqlAdministratorLoginPassword string

resource blobService 'Microsoft.Storage/storageAccounts/blobServices@2022-09-01' existing = {
  name: 'default'
  parent: storageAccount
}

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {}
}

resource workspace 'Microsoft.Synapse/workspaces@2021-06-01' = {
  name: resourceName
  location: location
  properties: {
    defaultDataLakeStorage: {
      accountUrl: storageAccount.properties.primaryEndpoints.dfs
      filesystem: container.name
    }
    managedVirtualNetwork: ''
    publicNetworkAccess: 'Enabled'
    sqlAdministratorLogin: sqlAdministratorLogin
    sqlAdministratorLoginPassword: sqlAdministratorLoginPassword
  }
}

resource sqlPool 'Microsoft.Synapse/workspaces/sqlPools@2021-06-01' = {
  name: resourceName
  location: location
  parent: workspace
  sku: {
    name: 'DW100c'
  }
  properties: {
    createMode: 'Default'
  }
}

resource container 'Microsoft.Storage/storageAccounts/blobServices/containers@2022-09-01' = {
  name: resourceName
  parent: blobService
  properties: {
    metadata: {
      key: 'value'
    }
  }
}

resource workloadGroup 'Microsoft.Synapse/workspaces/sqlPools/workloadGroups@2021-06-01' = {
  name: resourceName
  parent: sqlPool
  properties: {
    importance: 'normal'
    maxResourcePercent: 100
    maxResourcePercentPerRequest: 3
    minResourcePercent: 0
    minResourcePercentPerRequest: 3
  }
}

Definição de recurso de modelo ARM

O tipo de recurso workspaces/sqlPools/workloadGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Synapse/workspaces/sqlPools/workloadGroups, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Synapse/workspaces/sqlPools/workloadGroups",
  "apiVersion": "2021-06-01",
  "name": "string",
  "properties": {
    "importance": "string",
    "maxResourcePercent": "int",
    "maxResourcePercentPerRequest": "int",
    "minResourcePercent": "int",
    "minResourcePercentPerRequest": "int",
    "queryExecutionTimeout": "int"
  }
}

Valores de propriedade

Microsoft.Synapse/workspaces/sqlPools/workloadGroups

Designação Descrição Valor
Versão da API A versão api '2021-06-01'
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do recurso. WorkloadGroupProperties
tipo O tipo de recurso 'Microsoft.Synapse/workspaces/sqlPools/workloadGroups'

WorkloadGroupProperties

Designação Descrição Valor
Importância O nível de importância do grupo de carga de trabalho. cadeia (de caracteres)
maxResourcePercent O recurso de porcentagem de limite do grupo de carga de trabalho. int (obrigatório)
maxResourcePercentPerRequest A porcentagem máxima de concessão da solicitação do grupo de carga de trabalho. Int
minResourcePercent O recurso de porcentagem mínima do grupo de carga de trabalho. int (obrigatório)
minResourcePercentPerRequest O grupo de carga de trabalho solicita a porcentagem mínima de concessão. int (obrigatório)
queryExecutionTimeout O tempo limite de execução da consulta do grupo de carga de trabalho. Int

Exemplos de uso

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso workspaces/sqlPools/workloadGroups pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Synapse/workspaces/sqlPools/workloadGroups, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Synapse/workspaces/sqlPools/workloadGroups@2021-06-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      importance = "string"
      maxResourcePercent = int
      maxResourcePercentPerRequest = int
      minResourcePercent = int
      minResourcePercentPerRequest = int
      queryExecutionTimeout = int
    }
  }
}

Valores de propriedade

Microsoft.Synapse/workspaces/sqlPools/workloadGroups

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID para recurso do tipo: workspaces/sqlPools
propriedades Propriedades do recurso. WorkloadGroupProperties
tipo O tipo de recurso "Microsoft.Synapse/workspaces/sqlPools/workloadGroups@2021-06-01"

WorkloadGroupProperties

Designação Descrição Valor
Importância O nível de importância do grupo de carga de trabalho. cadeia (de caracteres)
maxResourcePercent O recurso de porcentagem de limite do grupo de carga de trabalho. int (obrigatório)
maxResourcePercentPerRequest A porcentagem máxima de concessão da solicitação do grupo de carga de trabalho. Int
minResourcePercent O recurso de porcentagem mínima do grupo de carga de trabalho. int (obrigatório)
minResourcePercentPerRequest O grupo de carga de trabalho solicita a porcentagem mínima de concessão. int (obrigatório)
queryExecutionTimeout O tempo limite de execução da consulta do grupo de carga de trabalho. Int

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Synapse SQL Pool Workload Group.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "sql_administrator_login" {
  type        = string
  description = "The SQL administrator login for the Synapse workspace"
}

variable "sql_administrator_login_password" {
  type        = string
  description = "The SQL administrator login password for the Synapse workspace"
  sensitive   = true
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2021-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
    }
    sku = {
      name = "Standard_LRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_action" "listKeys" {
  type                   = "Microsoft.Storage/storageAccounts@2022-09-01"
  resource_id            = azapi_resource.storageAccount.id
  action                 = "listKeys"
  response_export_values = ["*"]
}

data "azapi_resource" "blobService" {
  type      = "Microsoft.Storage/storageAccounts/blobServices@2022-09-01"
  parent_id = azapi_resource.storageAccount.id
  name      = "default"
}

resource "azapi_resource" "container" {
  type      = "Microsoft.Storage/storageAccounts/blobServices/containers@2022-09-01"
  name      = var.resource_name
  parent_id = data.azapi_resource.blobService.id
  body = {
    properties = {
      metadata = {
        key = "value"
      }
    }
  }
  response_export_values = ["*"]
}

resource "azapi_resource" "workspace" {
  type      = "Microsoft.Synapse/workspaces@2021-06-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type         = "SystemAssigned"
    identity_ids = []
  }
  body = {
    properties = {
      defaultDataLakeStorage = {
        accountUrl = azapi_resource.storageAccount.output.properties.primaryEndpoints.dfs
        filesystem = azapi_resource.container.name
      }
      managedVirtualNetwork         = ""
      publicNetworkAccess           = "Enabled"
      sqlAdministratorLogin         = var.sql_administrator_login
      sqlAdministratorLoginPassword = var.sql_administrator_login_password
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "sqlPool" {
  type      = "Microsoft.Synapse/workspaces/sqlPools@2021-06-01"
  parent_id = azapi_resource.workspace.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      createMode = "Default"
    }
    sku = {
      name = "DW100c"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "workloadGroup" {
  type      = "Microsoft.Synapse/workspaces/sqlPools/workloadGroups@2021-06-01"
  parent_id = azapi_resource.sqlPool.id
  name      = var.resource_name
  body = {
    properties = {
      importance                   = "normal"
      maxResourcePercent           = 100
      maxResourcePercentPerRequest = 3
      minResourcePercent           = 0
      minResourcePercentPerRequest = 3
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}