Microsoft.Synapse-Arbeitsbereiche/sqlPools

Bicep-Ressourcendefinition

Der Ressourcentyp "workspaces/sqlPools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Verwendungsbeispiele

Bicep-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von 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: {}
}

Ressourcenformat

Um eine Microsoft.Synapse/workspaces/sqlPools-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

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

Eigenschaftswerte

Microsoft.Synapse/workspaces/sqlPools

Name Beschreibung Wert
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: Arbeitsbereiche
Eigenschaften SQL-Pooleigenschaften SqlPoolResourceProperties-
Sku SQL-Pool-SKU Sku-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

Sku

Name Beschreibung Wert
Fassungsvermögen Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. Int
Name Der SKU-Name Schnur
Rang Die Dienstebene Schnur

SqlPoolResourceProperties

Name Beschreibung Wert
Vergleichung Sortiermodus Schnur
createMode Gibt den Modus der SQL-Poolerstellung an.

Standard: regelmäßige Sql-Poolerstellung.

PointInTimeRestore: Erstellt einen SQL-Pool, indem ein Zeitpunkt der Sicherung eines vorhandenen SQL-Pools wiederhergestellt wird. "sourceDatabaseId" muss als Ressourcen-ID des vorhandenen SQL-Pools angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt einen SQL-Pool durch eine geo-replizierte Sicherung. sourceDatabaseId muss als wiederherstellbareDatabaseId angegeben werden.

Wiederherstellen: Erstellt einen SQL-Pool, indem eine Sicherung eines gelöschten SQL-Pools wiederhergestellt wird. SourceDatabaseId sollte die ursprüngliche Ressourcen-ID des SQL-Pools sein. SourceDatabaseId und sourceDatabaseDeletionDate müssen angegeben werden.
'Standard'
'PointInTimeRestore'
"Wiederherstellung"
"Wiederherstellen"
maxSizeBytes Maximale Größe in Byte Int
provisioningState Ressourcenstatus Schnur
recoverableDatabaseId Sicherungsdatenbank zum Wiederherstellen von Schnur
restorePointInTime Momentaufnahmezeit zum Wiederherstellen Schnur
sourceDatabaseDeletionDate Gibt die Uhrzeit an, zu der der SQL-Pool gelöscht wurde. Schnur
sourceDatabaseId Quelldatenbank, aus der erstellt werden soll Schnur
storageAccountType Der Speicherkontotyp, der zum Speichern von Sicherungen für diesen SQL-Pool verwendet wird. 'GRS'
"LRS"

TrackedResourceTags

Name Beschreibung Wert

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "workspaces/sqlPools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone Beschreibung
Azure Synapse Proof-of-Concept-

Bereitstellen in Azure
Diese Vorlage erstellt eine Machbarkeitsumgebung für Azure Synapse, einschließlich SQL-Pools und optionaler Apache Spark Pools.

Ressourcenformat

Um eine Microsoft.Synapse/workspaces/sqlPools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

Microsoft.Synapse/workspaces/sqlPools

Name Beschreibung Wert
apiVersion Die API-Version '2021-06-01'
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften SQL-Pooleigenschaften SqlPoolResourceProperties-
Sku SQL-Pool-SKU Sku-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp 'Microsoft.Synapse/workspaces/sqlPools'

Sku

Name Beschreibung Wert
Fassungsvermögen Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. Int
Name Der SKU-Name Schnur
Rang Die Dienstebene Schnur

SqlPoolResourceProperties

Name Beschreibung Wert
Vergleichung Sortiermodus Schnur
createMode Gibt den Modus der SQL-Poolerstellung an.

Standard: regelmäßige Sql-Poolerstellung.

PointInTimeRestore: Erstellt einen SQL-Pool, indem ein Zeitpunkt der Sicherung eines vorhandenen SQL-Pools wiederhergestellt wird. "sourceDatabaseId" muss als Ressourcen-ID des vorhandenen SQL-Pools angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt einen SQL-Pool durch eine geo-replizierte Sicherung. sourceDatabaseId muss als wiederherstellbareDatabaseId angegeben werden.

Wiederherstellen: Erstellt einen SQL-Pool, indem eine Sicherung eines gelöschten SQL-Pools wiederhergestellt wird. SourceDatabaseId sollte die ursprüngliche Ressourcen-ID des SQL-Pools sein. SourceDatabaseId und sourceDatabaseDeletionDate müssen angegeben werden.
'Standard'
'PointInTimeRestore'
"Wiederherstellung"
"Wiederherstellen"
maxSizeBytes Maximale Größe in Byte Int
provisioningState Ressourcenstatus Schnur
recoverableDatabaseId Sicherungsdatenbank zum Wiederherstellen von Schnur
restorePointInTime Momentaufnahmezeit zum Wiederherstellen Schnur
sourceDatabaseDeletionDate Gibt die Uhrzeit an, zu der der SQL-Pool gelöscht wurde. Schnur
sourceDatabaseId Quelldatenbank, aus der erstellt werden soll Schnur
storageAccountType Der Speicherkontotyp, der zum Speichern von Sicherungen für diesen SQL-Pool verwendet wird. 'GRS'
"LRS"

TrackedResourceTags

Name Beschreibung Wert

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "workspaces/sqlPools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Change Log.

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von 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    = ["*"]
}

Ressourcenformat

Um eine Microsoft.Synapse/workspaces/sqlPools-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

Microsoft.Synapse/workspaces/sqlPools

Name Beschreibung Wert
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: Arbeitsbereiche
Eigenschaften SQL-Pooleigenschaften SqlPoolResourceProperties-
Sku SQL-Pool-SKU Sku-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.Synapse/workspaces/sqlPools@2021-06-01"

Sku

Name Beschreibung Wert
Fassungsvermögen Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. Int
Name Der SKU-Name Schnur
Rang Die Dienstebene Schnur

SqlPoolResourceProperties

Name Beschreibung Wert
Vergleichung Sortiermodus Schnur
createMode Gibt den Modus der SQL-Poolerstellung an.

Standard: regelmäßige Sql-Poolerstellung.

PointInTimeRestore: Erstellt einen SQL-Pool, indem ein Zeitpunkt der Sicherung eines vorhandenen SQL-Pools wiederhergestellt wird. "sourceDatabaseId" muss als Ressourcen-ID des vorhandenen SQL-Pools angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt einen SQL-Pool durch eine geo-replizierte Sicherung. sourceDatabaseId muss als wiederherstellbareDatabaseId angegeben werden.

Wiederherstellen: Erstellt einen SQL-Pool, indem eine Sicherung eines gelöschten SQL-Pools wiederhergestellt wird. SourceDatabaseId sollte die ursprüngliche Ressourcen-ID des SQL-Pools sein. SourceDatabaseId und sourceDatabaseDeletionDate müssen angegeben werden.
'Standard'
'PointInTimeRestore'
"Wiederherstellung"
"Wiederherstellen"
maxSizeBytes Maximale Größe in Byte Int
provisioningState Ressourcenstatus Schnur
recoverableDatabaseId Sicherungsdatenbank zum Wiederherstellen von Schnur
restorePointInTime Momentaufnahmezeit zum Wiederherstellen Schnur
sourceDatabaseDeletionDate Gibt die Uhrzeit an, zu der der SQL-Pool gelöscht wurde. Schnur
sourceDatabaseId Quelldatenbank, aus der erstellt werden soll Schnur
storageAccountType Der Speicherkontotyp, der zum Speichern von Sicherungen für diesen SQL-Pool verwendet wird. 'GRS'
"LRS"

TrackedResourceTags

Name Beschreibung Wert