Microsoft.Synapse workspaces/sqlPools/workloadGroups

Definicja zasobu Bicep

Typ zasobu workspaces/sqlPools/workloadGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Synapse/workspaces/sqlPools/workloadGroups, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.Synapse/workspaces/sqlPools/workloadGroups

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: workspaces/sqlPools
Właściwości Właściwości zasobu. WorkloadGroupProperties

WorkloadGroupProperties

Nazwa Opis Wartość
znaczenie Poziom ważności grupy obciążeń. ciąg
maxResourcePercent Zasób procentowy grupy obciążeń. int (wymagane)
maxResourcePercentPerRequest Maksymalna wartość procentowa dotacji dla grupy obciążeń. Int
minResourcePercent Minimalna wartość procentowa grupy obciążeń. int (wymagane)
minResourcePercentPerRequest Minimalna wartość procentowa dotacji dla grupy obciążeń. int (wymagane)
queryExecutionTimeout Limit czasu wykonywania zapytania grupy obciążeń. Int

Przykłady użycia

Przykłady Bicep

Podstawowy przykład wdrażania grupy obciążeń puli SQL usługi Synapse.

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

Definicja zasobu szablonu usługi ARM

Typ zasobu workspaces/sqlPools/workloadGroups można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Synapse/workspaces/sqlPools/workloadGroups, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.Synapse/workspaces/sqlPools/workloadGroups

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2021-06-01'
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zasobu. WorkloadGroupProperties
typ Typ zasobu "Microsoft.Synapse/workspaces/sqlPools/workloadGroups"

WorkloadGroupProperties

Nazwa Opis Wartość
znaczenie Poziom ważności grupy obciążeń. ciąg
maxResourcePercent Zasób procentowy grupy obciążeń. int (wymagane)
maxResourcePercentPerRequest Maksymalna wartość procentowa dotacji dla grupy obciążeń. Int
minResourcePercent Minimalna wartość procentowa grupy obciążeń. int (wymagane)
minResourcePercentPerRequest Minimalna wartość procentowa dotacji dla grupy obciążeń. int (wymagane)
queryExecutionTimeout Limit czasu wykonywania zapytania grupy obciążeń. Int

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu workspaces/sqlPools/workloadGroups można wdrożyć przy użyciu operacji docelowych:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Synapse/workspaces/sqlPools/workloadGroups, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.Synapse/workspaces/sqlPools/workloadGroups

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: workspaces/sqlPools
Właściwości Właściwości zasobu. WorkloadGroupProperties
typ Typ zasobu "Microsoft.Synapse/workspaces/sqlPools/workloadGroups@2021-06-01"

WorkloadGroupProperties

Nazwa Opis Wartość
znaczenie Poziom ważności grupy obciążeń. ciąg
maxResourcePercent Zasób procentowy grupy obciążeń. int (wymagane)
maxResourcePercentPerRequest Maksymalna wartość procentowa dotacji dla grupy obciążeń. Int
minResourcePercent Minimalna wartość procentowa grupy obciążeń. int (wymagane)
minResourcePercentPerRequest Minimalna wartość procentowa dotacji dla grupy obciążeń. int (wymagane)
queryExecutionTimeout Limit czasu wykonywania zapytania grupy obciążeń. Int

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania grupy obciążeń puli SQL usługi Synapse.

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    = ["*"]
}