Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Definição de recursos do bíceps
O tipo de recurso workspaces/sqlPools pode ser implantado com operações que visam:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Exemplos de uso
Amostras de bíceps
Um exemplo básico de implantação do Synapse SQL Pool.
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: {}
}
Formato do recurso
Para criar um recurso Microsoft.Synapse/workspaces/sqlPools, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Synapse/workspaces/sqlPools@2021-03-01' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
collation: 'string'
createMode: 'string'
creationDate: 'string'
maxSizeBytes: int
provisioningState: 'string'
recoverableDatabaseId: 'string'
restorePointInTime: 'string'
sourceDatabaseId: 'string'
status: 'string'
storageAccountType: 'string'
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valores de propriedade
Microsoft.Synapse/workspaces/sqlPools
| Designação | Descrição | Valor |
|---|---|---|
| localização | A geolocalização onde o recurso vive | string (obrigatório) |
| 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 recurso do tipo: espaços de trabalho |
| propriedades | Propriedades do pool SQL | SqlPoolResourceProperties |
| SKU | SQL pool SKU | Referência |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
Referência
| Designação | Descrição | Valor |
|---|---|---|
| capacidade | Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido. | Int |
| Designação | O nome SKU | cadeia (de caracteres) |
| escalão | A camada de serviço | cadeia (de caracteres) |
SqlPoolResourceProperties
| Designação | Descrição | Valor |
|---|---|---|
| agrupamento | Modo de agrupamento | cadeia (de caracteres) |
| createMode | Especifica o modo de criação do pool sql. Padrão: criação regular de pool sql. PointInTimeRestore: Cria um pool sql restaurando um backup point-in-time de um pool sql existente. sourceDatabaseId deve ser especificado como a ID de recurso do pool sql existente e restorePointInTime deve ser especificado. Recuperação: cria um pool sql por meio de um backup replicado geograficamente. sourceDatabaseId deve ser especificado como o recoverableDatabaseId a ser restaurado. Restauração: Cria um pool sql restaurando um backup de um pool sql excluído. SourceDatabaseId deve ser o ID de recurso original do pool sql. SourceDatabaseId e sourceDatabaseDeletionDate devem ser especificados. |
'Inadimplência' 'PointInTimeRestore' 'Recuperação' 'Restaurar' |
| criaçãoData de criação | Data de criação do pool SQL | cadeia (de caracteres) |
| maxSizeBytes | Tamanho máximo em bytes | Int |
| provisionamentoEstado | Estado do recurso | cadeia (de caracteres) |
| recoverableDatabaseId | Banco de dados de backup para restaurar a partir de | cadeia (de caracteres) |
| restorePointInTime | Tempo de restauração do snapshot | cadeia (de caracteres) |
| sourceDatabaseId | Base de dados de origem a partir da qual criar | cadeia (de caracteres) |
| estado | Estado do recurso | cadeia (de caracteres) |
| storageAccountType | O tipo de conta de armazenamento usado para armazenar backups para esse pool sql. | «GRS» «LRS» «ZRS» |
TrackedResourceTags
| Designação | Descrição | Valor |
|---|
Definição de recurso de modelo ARM
O tipo de recurso workspaces/sqlPools pode ser implantado com operações que visam:
- Grupos de recursos - Ver comandos de implementação de grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, consulte registo de alterações.
Exemplos de uso
Modelos de início rápido do Azure
Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.
| Modelo | Descrição |
|---|---|
|
de prova de conceito do Azure Synapse |
Este modelo cria um ambiente de prova de conceito para o Azure Synapse, incluindo SQL Pools e Apache Spark Pools opcionais |
Formato do recurso
Para criar um recurso Microsoft.Synapse/workspaces/sqlPools, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.Synapse/workspaces/sqlPools",
"apiVersion": "2021-03-01",
"name": "string",
"location": "string",
"properties": {
"collation": "string",
"createMode": "string",
"creationDate": "string",
"maxSizeBytes": "int",
"provisioningState": "string",
"recoverableDatabaseId": "string",
"restorePointInTime": "string",
"sourceDatabaseId": "string",
"status": "string",
"storageAccountType": "string"
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valores de propriedade
Microsoft.Synapse/workspaces/sqlPools
| Designação | Descrição | Valor |
|---|---|---|
| Versão da API | A versão api | '2021-03-01' |
| localização | A geolocalização onde o recurso vive | string (obrigatório) |
| Designação | O nome do recurso | string (obrigatório) |
| propriedades | Propriedades do pool SQL | SqlPoolResourceProperties |
| SKU | SQL pool SKU | Referência |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| tipo | O tipo de recurso | 'Microsoft.Synapse/workspaces/sqlPools' |
Referência
| Designação | Descrição | Valor |
|---|---|---|
| capacidade | Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido. | Int |
| Designação | O nome SKU | cadeia (de caracteres) |
| escalão | A camada de serviço | cadeia (de caracteres) |
SqlPoolResourceProperties
| Designação | Descrição | Valor |
|---|---|---|
| agrupamento | Modo de agrupamento | cadeia (de caracteres) |
| createMode | Especifica o modo de criação do pool sql. Padrão: criação regular de pool sql. PointInTimeRestore: Cria um pool sql restaurando um backup point-in-time de um pool sql existente. sourceDatabaseId deve ser especificado como a ID de recurso do pool sql existente e restorePointInTime deve ser especificado. Recuperação: cria um pool sql por meio de um backup replicado geograficamente. sourceDatabaseId deve ser especificado como o recoverableDatabaseId a ser restaurado. Restauração: Cria um pool sql restaurando um backup de um pool sql excluído. SourceDatabaseId deve ser o ID de recurso original do pool sql. SourceDatabaseId e sourceDatabaseDeletionDate devem ser especificados. |
'Inadimplência' 'PointInTimeRestore' 'Recuperação' 'Restaurar' |
| criaçãoData de criação | Data de criação do pool SQL | cadeia (de caracteres) |
| maxSizeBytes | Tamanho máximo em bytes | Int |
| provisionamentoEstado | Estado do recurso | cadeia (de caracteres) |
| recoverableDatabaseId | Banco de dados de backup para restaurar a partir de | cadeia (de caracteres) |
| restorePointInTime | Tempo de restauração do snapshot | cadeia (de caracteres) |
| sourceDatabaseId | Base de dados de origem a partir da qual criar | cadeia (de caracteres) |
| estado | Estado do recurso | cadeia (de caracteres) |
| storageAccountType | O tipo de conta de armazenamento usado para armazenar backups para esse pool sql. | «GRS» «LRS» «ZRS» |
TrackedResourceTags
| Designação | Descrição | Valor |
|---|
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso workspaces/sqlPools pode ser implantado com operações que visam:
- Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja registo de alterações.
Exemplos de uso
Amostras Terraform
Um exemplo básico de implantação do Synapse SQL Pool.
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 = ["*"]
}
Formato do recurso
Para criar um recurso Microsoft.Synapse/workspaces/sqlPools, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Synapse/workspaces/sqlPools@2021-03-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
collation = "string"
createMode = "string"
creationDate = "string"
maxSizeBytes = int
provisioningState = "string"
recoverableDatabaseId = "string"
restorePointInTime = "string"
sourceDatabaseId = "string"
status = "string"
storageAccountType = "string"
}
sku = {
capacity = int
name = "string"
tier = "string"
}
}
}
Valores de propriedade
Microsoft.Synapse/workspaces/sqlPools
| Designação | Descrição | Valor |
|---|---|---|
| localização | A geolocalização onde o recurso vive | string (obrigatório) |
| Designação | O nome do recurso | string (obrigatório) |
| parent_id | A ID do recurso que é o pai para este recurso. | ID do recurso do tipo: espaços de trabalho |
| propriedades | Propriedades do pool SQL | SqlPoolResourceProperties |
| SKU | SQL pool SKU | Referência |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. |
| tipo | O tipo de recurso | "Microsoft.Synapse/workspaces/sqlPools@2021-03-01" |
Referência
| Designação | Descrição | Valor |
|---|---|---|
| capacidade | Se a SKU suportar scaleout/in, o inteiro de capacidade deve ser incluído. Se a expansão/entrada não for possível para o recurso, isso poderá ser omitido. | Int |
| Designação | O nome SKU | cadeia (de caracteres) |
| escalão | A camada de serviço | cadeia (de caracteres) |
SqlPoolResourceProperties
| Designação | Descrição | Valor |
|---|---|---|
| agrupamento | Modo de agrupamento | cadeia (de caracteres) |
| createMode | Especifica o modo de criação do pool sql. Padrão: criação regular de pool sql. PointInTimeRestore: Cria um pool sql restaurando um backup point-in-time de um pool sql existente. sourceDatabaseId deve ser especificado como a ID de recurso do pool sql existente e restorePointInTime deve ser especificado. Recuperação: cria um pool sql por meio de um backup replicado geograficamente. sourceDatabaseId deve ser especificado como o recoverableDatabaseId a ser restaurado. Restauração: Cria um pool sql restaurando um backup de um pool sql excluído. SourceDatabaseId deve ser o ID de recurso original do pool sql. SourceDatabaseId e sourceDatabaseDeletionDate devem ser especificados. |
'Inadimplência' 'PointInTimeRestore' 'Recuperação' 'Restaurar' |
| criaçãoData de criação | Data de criação do pool SQL | cadeia (de caracteres) |
| maxSizeBytes | Tamanho máximo em bytes | Int |
| provisionamentoEstado | Estado do recurso | cadeia (de caracteres) |
| recoverableDatabaseId | Banco de dados de backup para restaurar a partir de | cadeia (de caracteres) |
| restorePointInTime | Tempo de restauração do snapshot | cadeia (de caracteres) |
| sourceDatabaseId | Base de dados de origem a partir da qual criar | cadeia (de caracteres) |
| estado | Estado do recurso | cadeia (de caracteres) |
| storageAccountType | O tipo de conta de armazenamento usado para armazenar backups para esse pool sql. | «GRS» «LRS» «ZRS» |
TrackedResourceTags
| Designação | Descrição | Valor |
|---|