Pracovní prostory Microsoft.Synapse /sqlPools

Definice prostředku Bicep

Typ prostředku workspaces/sqlPools je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Příklady použití

Ukázky Bicep

Základní příklad nasazení fondu 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: {}
}

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Modul Popis
Azure Synapse Analytics Workspace - Sql Pool AVM Child Module for Azure Synapse Analytics Workspace - Sql Pool

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Synapse/workspaces/sqlPools, přidejte do šablony následující 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'
  }
}

Hodnoty vlastností

Microsoft.Synapse/workspaces/sqlPools

Jméno Popis Hodnota
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
Jméno Název prostředku string (povinné)
nadřazený objekt V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.
Symbolický název prostředku typu: pracovních prostorů
vlastnosti Vlastnosti fondu SQL sqlPoolResourceProperties
SKU (identifikátor zboží) Skladová položka fondu SQL skladové položky
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

Sku

Jméno Popis Hodnota
kapacita Pokud skladová položka podporuje horizontální navýšení/snížení kapacity, měla by být zahrnuta celá čísla kapacity. Pokud není pro prostředek možné horizontální navýšení kapacity nebo jeho snížení kapacity, může se tento parametr vynechat. Int
Jméno Název skladové položky řetězec
přesunout do jiné vrstvy Úroveň služby řetězec

SqlPoolResourceProperties

Jméno Popis Hodnota
kolace Režim kolace řetězec
createMode Určuje režim vytvoření fondu SQL.

Výchozí nastavení: pravidelné vytváření fondu SQL.

PointInTimeRestore: Vytvoří fond SQL obnovením zálohy existujícího fondu SQL k určitému bodu v čase. sourceDatabaseId musí být zadán jako ID prostředku existujícího fondu SQL a musí být zadán restorePointInTime.

Obnovení: Vytvoří fond SQL geograficky replikovanou zálohou. sourceDatabaseId musí být zadán jako obnovitelnýDatabaseId.

Obnovení: Vytvoří fond SQL obnovením zálohy odstraněného fondu SQL. SourceDatabaseId by měl být původní ID prostředku fondu SQL. Musí být zadán sourceDatabaseId a sourceDatabaseDeletionDate.
Výchozí
PointInTimeRestore
Obnovení
Obnovit
maxSizeBytes Maximální velikost v bajtech Int
stav přípravy Stav prostředku řetězec
recoverableDatabaseId Zálohování databáze k obnovení z řetězec
restorePointInTime Čas vytvoření snímku k obnovení řetězec
sourceDatabaseDeletionDate Určuje čas odstranění fondu SQL. řetězec
sourceDatabaseId Zdrojová databáze, ze které se má vytvořit řetězec
storageAccountType Typ účtu úložiště použitý k ukládání záloh pro tento fond SQL. GRS
LRS

TrackedResourceTags

Jméno Popis Hodnota

Definice prostředku šablony ARM

Typ prostředku workspaces/sqlPools je možné nasadit s operacemi, které cílí:

Příklady použití

Šablony azure pro rychlý start

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Šablona Popis
testování konceptu Azure Synapse

nasazení do Azure
Tato šablona vytvoří prostředí pro testování konceptu pro Azure Synapse, včetně fondů SQL a volitelných fondů Apache Spark.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Synapse/workspaces/sqlPools, přidejte do šablony následující 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"
  }
}

Hodnoty vlastností

Microsoft.Synapse/workspaces/sqlPools

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2021-06-01'
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti fondu SQL sqlPoolResourceProperties
SKU (identifikátor zboží) Skladová položka fondu SQL skladové položky
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku Microsoft.Synapse/workspaces/sqlPools

Sku

Jméno Popis Hodnota
kapacita Pokud skladová položka podporuje horizontální navýšení/snížení kapacity, měla by být zahrnuta celá čísla kapacity. Pokud není pro prostředek možné horizontální navýšení kapacity nebo jeho snížení kapacity, může se tento parametr vynechat. Int
Jméno Název skladové položky řetězec
přesunout do jiné vrstvy Úroveň služby řetězec

SqlPoolResourceProperties

Jméno Popis Hodnota
kolace Režim kolace řetězec
createMode Určuje režim vytvoření fondu SQL.

Výchozí nastavení: pravidelné vytváření fondu SQL.

PointInTimeRestore: Vytvoří fond SQL obnovením zálohy existujícího fondu SQL k určitému bodu v čase. sourceDatabaseId musí být zadán jako ID prostředku existujícího fondu SQL a musí být zadán restorePointInTime.

Obnovení: Vytvoří fond SQL geograficky replikovanou zálohou. sourceDatabaseId musí být zadán jako obnovitelnýDatabaseId.

Obnovení: Vytvoří fond SQL obnovením zálohy odstraněného fondu SQL. SourceDatabaseId by měl být původní ID prostředku fondu SQL. Musí být zadán sourceDatabaseId a sourceDatabaseDeletionDate.
Výchozí
PointInTimeRestore
Obnovení
Obnovit
maxSizeBytes Maximální velikost v bajtech Int
stav přípravy Stav prostředku řetězec
recoverableDatabaseId Zálohování databáze k obnovení z řetězec
restorePointInTime Čas vytvoření snímku k obnovení řetězec
sourceDatabaseDeletionDate Určuje čas odstranění fondu SQL. řetězec
sourceDatabaseId Zdrojová databáze, ze které se má vytvořit řetězec
storageAccountType Typ účtu úložiště použitý k ukládání záloh pro tento fond SQL. GRS
LRS

TrackedResourceTags

Jméno Popis Hodnota

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku workspaces/sqlPools je možné nasadit s operacemi, které cílí:

  • Skupiny zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

Ukázky Terraformu

Základní příklad nasazení fondu 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    = ["*"]
}

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Synapse/workspaces/sqlPools, přidejte do šablony následující 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"
    }
  }
}

Hodnoty vlastností

Microsoft.Synapse/workspaces/sqlPools

Jméno Popis Hodnota
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
Jméno Název prostředku string (povinné)
parent_id ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: pracovních prostorů
vlastnosti Vlastnosti fondu SQL sqlPoolResourceProperties
SKU (identifikátor zboží) Skladová položka fondu SQL skladové položky
visačky Značky prostředků Slovník názvů a hodnot značek
typ Typ prostředku Microsoft.Synapse/workspaces/sqlPools@2021-06-01

Sku

Jméno Popis Hodnota
kapacita Pokud skladová položka podporuje horizontální navýšení/snížení kapacity, měla by být zahrnuta celá čísla kapacity. Pokud není pro prostředek možné horizontální navýšení kapacity nebo jeho snížení kapacity, může se tento parametr vynechat. Int
Jméno Název skladové položky řetězec
přesunout do jiné vrstvy Úroveň služby řetězec

SqlPoolResourceProperties

Jméno Popis Hodnota
kolace Režim kolace řetězec
createMode Určuje režim vytvoření fondu SQL.

Výchozí nastavení: pravidelné vytváření fondu SQL.

PointInTimeRestore: Vytvoří fond SQL obnovením zálohy existujícího fondu SQL k určitému bodu v čase. sourceDatabaseId musí být zadán jako ID prostředku existujícího fondu SQL a musí být zadán restorePointInTime.

Obnovení: Vytvoří fond SQL geograficky replikovanou zálohou. sourceDatabaseId musí být zadán jako obnovitelnýDatabaseId.

Obnovení: Vytvoří fond SQL obnovením zálohy odstraněného fondu SQL. SourceDatabaseId by měl být původní ID prostředku fondu SQL. Musí být zadán sourceDatabaseId a sourceDatabaseDeletionDate.
Výchozí
PointInTimeRestore
Obnovení
Obnovit
maxSizeBytes Maximální velikost v bajtech Int
stav přípravy Stav prostředku řetězec
recoverableDatabaseId Zálohování databáze k obnovení z řetězec
restorePointInTime Čas vytvoření snímku k obnovení řetězec
sourceDatabaseDeletionDate Určuje čas odstranění fondu SQL. řetězec
sourceDatabaseId Zdrojová databáze, ze které se má vytvořit řetězec
storageAccountType Typ účtu úložiště použitý k ukládání záloh pro tento fond SQL. GRS
LRS

TrackedResourceTags

Jméno Popis Hodnota