Microsoft.Synapse 작업 영역/sqlPools

Bicep 리소스 정의

작업 영역/sqlPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

사용 예제

Bicep 샘플

Synapse SQL 풀 배포의 기본 예제입니다.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@description('The SQL administrator login name 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 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 storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {}
}

리소스 형식

Microsoft.Synapse/workspaces/sqlPools 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Synapse/workspaces/sqlPools@2021-06-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    collation: 'string'
    createMode: 'string'
    maxSizeBytes: int
    provisioningState: 'string'
    recoverableDatabaseId: 'string'
    restorePointInTime: 'string'
    sourceDatabaseDeletionDate: 'string'
    sourceDatabaseId: 'string'
    storageAccountType: 'string'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

Microsoft.Synapse/workspaces/sqlPools

이름	묘사	값
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	string(필수)
부모	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.	형식 리소스의 기호 이름: 작업 영역
속성	SQL 풀 속성	sqlPoolResourceProperties
SKU (재고 관리 코드)	SQL 풀 SKU	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

SKU (재고 관리 코드)

이름	묘사	값
용량	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.	정수 (int)
이름	SKU 이름	문자열
계층	서비스 계층	문자열

SqlPoolResourceProperties

이름	묘사	값
조교	데이터 정렬 모드	문자열
createMode	sql 풀 만들기 모드를 지정합니다. 기본값: 일반 sql 풀 만들기. PointInTimeRestore: 기존 sql 풀의 특정 시점 백업을 복원하여 sql 풀을 만듭니다. sourceDatabaseId는 기존 sql 풀의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 통해 SQL 풀을 만듭니다. sourceDatabaseId를 복원하려면 recoverableDatabaseId로 지정해야 합니다. 복원: 삭제된 sql 풀의 백업을 복원하여 sql 풀을 만듭니다. SourceDatabaseId는 sql 풀의 원래 리소스 ID여야 합니다. SourceDatabaseId 및 sourceDatabaseDeletionDate를 지정해야 합니다.	'기본값' 'PointInTimeRestore' 'Recovery' '복원'
maxSizeBytes	최대 크기(바이트)	정수 (int)
provisioningState	리소스 상태	문자열
recoverableDatabaseId	복원할 데이터베이스 백업	문자열
restorePointInTime	복원할 스냅샷 시간	문자열
sourceDatabaseDeletionDate	sql 풀이 삭제된 시간을 지정합니다.	문자열
sourceDatabaseId	만들 원본 데이터베이스	문자열
storageAccountType	이 sql 풀에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.	'GRS' 'LRS'

TrackedResourceTags

이름	묘사	값

ARM 템플릿 리소스 정의

작업 영역/sqlPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플렛	묘사
Azure Synapse 개념 증명 Azure 배포	이 템플릿은 SQL 풀 및 선택적 Apache Spark 풀을 포함하여 Azure Synapse에 대한 개념 증명 환경을 만듭니다.

리소스 형식

Microsoft.Synapse/workspaces/sqlPools 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Synapse/workspaces/sqlPools",
  "apiVersion": "2021-06-01",
  "name": "string",
  "location": "string",
  "properties": {
    "collation": "string",
    "createMode": "string",
    "maxSizeBytes": "int",
    "provisioningState": "string",
    "recoverableDatabaseId": "string",
    "restorePointInTime": "string",
    "sourceDatabaseDeletionDate": "string",
    "sourceDatabaseId": "string",
    "storageAccountType": "string"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

Microsoft.Synapse/workspaces/sqlPools

이름	묘사	값
apiVersion	api 버전	'2021-06-01'
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	string(필수)
속성	SQL 풀 속성	sqlPoolResourceProperties
SKU (재고 관리 코드)	SQL 풀 SKU	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형	리소스 종류	'Microsoft.Synapse/workspaces/sqlPools'

SKU (재고 관리 코드)

이름	묘사	값
용량	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.	정수 (int)
이름	SKU 이름	문자열
계층	서비스 계층	문자열

SqlPoolResourceProperties

이름	묘사	값
조교	데이터 정렬 모드	문자열
createMode	sql 풀 만들기 모드를 지정합니다. 기본값: 일반 sql 풀 만들기. PointInTimeRestore: 기존 sql 풀의 특정 시점 백업을 복원하여 sql 풀을 만듭니다. sourceDatabaseId는 기존 sql 풀의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 통해 SQL 풀을 만듭니다. sourceDatabaseId를 복원하려면 recoverableDatabaseId로 지정해야 합니다. 복원: 삭제된 sql 풀의 백업을 복원하여 sql 풀을 만듭니다. SourceDatabaseId는 sql 풀의 원래 리소스 ID여야 합니다. SourceDatabaseId 및 sourceDatabaseDeletionDate를 지정해야 합니다.	'기본값' 'PointInTimeRestore' 'Recovery' '복원'
maxSizeBytes	최대 크기(바이트)	정수 (int)
provisioningState	리소스 상태	문자열
recoverableDatabaseId	복원할 데이터베이스 백업	문자열
restorePointInTime	복원할 스냅샷 시간	문자열
sourceDatabaseDeletionDate	sql 풀이 삭제된 시간을 지정합니다.	문자열
sourceDatabaseId	만들 원본 데이터베이스	문자열
storageAccountType	이 sql 풀에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.	'GRS' 'LRS'

TrackedResourceTags

이름	묘사	값

Terraform(AzAPI 공급자) 리소스 정의

작업 영역/sqlPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

사용 예제

Terraform 샘플

Synapse SQL 풀 배포의 기본 예제입니다.

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

리소스 형식

Microsoft.Synapse/workspaces/sqlPools 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Synapse/workspaces/sqlPools@2021-06-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      collation = "string"
      createMode = "string"
      maxSizeBytes = int
      provisioningState = "string"
      recoverableDatabaseId = "string"
      restorePointInTime = "string"
      sourceDatabaseDeletionDate = "string"
      sourceDatabaseId = "string"
      storageAccountType = "string"
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  }
}

속성 값

Microsoft.Synapse/workspaces/sqlPools

이름	묘사	값
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	string(필수)
parent_id	이 리소스의 부모인 리소스의 ID입니다.	형식 리소스의 ID: 작업 영역
속성	SQL 풀 속성	sqlPoolResourceProperties
SKU (재고 관리 코드)	SQL 풀 SKU	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다.
형	리소스 종류	"Microsoft.Synapse/workspaces/sqlPools@2021-06-01"

SKU (재고 관리 코드)

이름	묘사	값
용량	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.	정수 (int)
이름	SKU 이름	문자열
계층	서비스 계층	문자열

SqlPoolResourceProperties

이름	묘사	값
조교	데이터 정렬 모드	문자열
createMode	sql 풀 만들기 모드를 지정합니다. 기본값: 일반 sql 풀 만들기. PointInTimeRestore: 기존 sql 풀의 특정 시점 백업을 복원하여 sql 풀을 만듭니다. sourceDatabaseId는 기존 sql 풀의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 통해 SQL 풀을 만듭니다. sourceDatabaseId를 복원하려면 recoverableDatabaseId로 지정해야 합니다. 복원: 삭제된 sql 풀의 백업을 복원하여 sql 풀을 만듭니다. SourceDatabaseId는 sql 풀의 원래 리소스 ID여야 합니다. SourceDatabaseId 및 sourceDatabaseDeletionDate를 지정해야 합니다.	'기본값' 'PointInTimeRestore' 'Recovery' '복원'
maxSizeBytes	최대 크기(바이트)	정수 (int)
provisioningState	리소스 상태	문자열
recoverableDatabaseId	복원할 데이터베이스 백업	문자열
restorePointInTime	복원할 스냅샷 시간	문자열
sourceDatabaseDeletionDate	sql 풀이 삭제된 시간을 지정합니다.	문자열
sourceDatabaseId	만들 원본 데이터베이스	문자열
storageAccountType	이 sql 풀에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.	'GRS' 'LRS'

TrackedResourceTags

이름	묘사	값

피드백

이 페이지가 도움이 되었나요?

2026-07-21 에 마지막으로 업데이트됨

Microsoft.Synapse 작업 영역/sqlPools

Bicep 리소스 정의

사용 예제

Bicep 샘플

리소스 형식

속성 값

Microsoft.Synapse/workspaces/sqlPools

SKU (재고 관리 코드)

SqlPoolResourceProperties

TrackedResourceTags

ARM 템플릿 리소스 정의

사용 예제

Azure 빠른 시작 템플릿

리소스 형식

속성 값

Microsoft.Synapse/workspaces/sqlPools

SKU (재고 관리 코드)

SqlPoolResourceProperties

TrackedResourceTags

Terraform(AzAPI 공급자) 리소스 정의

사용 예제

Terraform 샘플

리소스 형식

속성 값

Microsoft.Synapse/workspaces/sqlPools

SKU (재고 관리 코드)

SqlPoolResourceProperties

TrackedResourceTags

피드백

추가 리소스