Aree di lavoro Microsoft.Synapse
Articolo 07/01/2023
1 contributore
Commenti e suggerimenti
In questo articolo
Definizione di risorsa Bicep
Il tipo di risorsa delle aree di lavoro può essere distribuito con operazioni destinate:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche .
Per creare una risorsa Microsoft.Synapse/workspaces, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Synapse/workspaces@2021-06-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
userAssignedIdentities: {}
}
properties: {
azureADOnlyAuthentication: bool
cspWorkspaceAdminProperties: {
initialWorkspaceAdminObjectId: 'string'
}
defaultDataLakeStorage: {
accountUrl: 'string'
createManagedPrivateEndpoint: bool
filesystem: 'string'
resourceId: 'string'
}
encryption: {
cmk: {
kekIdentity: {
userAssignedIdentity: 'string'
useSystemAssignedIdentity: any()
}
key: {
keyVaultUrl: 'string'
name: 'string'
}
}
}
managedResourceGroupName: 'string'
managedVirtualNetwork: 'string'
managedVirtualNetworkSettings: {
allowedAadTenantIdsForLinking: [
'string'
]
linkedAccessCheckOnTargetResource: bool
preventDataExfiltration: bool
}
privateEndpointConnections: [
{
properties: {
privateEndpoint: {}
privateLinkServiceConnectionState: {
description: 'string'
status: 'string'
}
}
}
]
publicNetworkAccess: 'string'
purviewConfiguration: {
purviewResourceId: 'string'
}
sqlAdministratorLogin: 'string'
sqlAdministratorLoginPassword: 'string'
trustedServiceBypassEnabled: bool
virtualNetworkProfile: {
computeSubnetId: 'string'
}
workspaceRepositoryConfiguration: {
accountName: 'string'
collaborationBranch: 'string'
hostName: 'string'
lastCommitId: 'string'
projectName: 'string'
repositoryName: 'string'
rootFolder: 'string'
tenantId: 'string'
type: 'string'
}
}
}
Valori delle proprietà
aree di lavoro
Nome
Descrizione
valore
name
Nome della risorsa
stringa (obbligatoria) Limite di caratteri: 1-50 Caratteri validi: Lettere minuscole, trattini e numeri. Deve iniziare e terminare con una lettera o un numero. Non può contenere -ondemand
Il nome della risorsa deve essere univoco in Azure.
posizione
Posizione geografica in cui vive la risorsa
stringa (obbligatoria)
tags
Tag di risorse.
Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
identity
Identità dell'area di lavoro
ManagedIdentity
properties
Proprietà delle risorse dell'area di lavoro
Proprietà dell'area di lavoro
ManagedIdentity
Nome
Descrizione
Valore
tipo
Tipo di identità gestita per l'area di lavoro
'Nessuno' 'SystemAssigned' 'SystemAssigned,UserAssigned'
userAssignedIdentities
Identità gestite assegnate dall'utente.
object
Proprietà dell'area di lavoro
Nome
Descrizione
Valore
azureADOnlyAuthentication
Abilitare o disabilitare AzureADOnlyAuthentication in tutte le sottoresource dell'area di lavoro
bool
cspWorkspaceAdminProperties
Proprietà di amministratore dell'area di lavoro iniziale di AAD per una sottoscrizione CSP
CspWorkspaceAdminProperties
defaultDataLakeStorage
Dettagli dell'account di archiviazione data lake predefinito dell'area di lavoro
DataLakeStorageAccountDetails
Crittografia
Dettagli della crittografia dell'area di lavoro
EncryptionDetails
managedResourceGroupName
Gruppo di risorse gestite dall'area di lavoro. Il nome del gruppo di risorse identifica in modo univoco il gruppo di risorse all'interno dell'id sottoscrizione utente. Il nome del gruppo di risorse non deve essere più di 90 caratteri lunghi e deve essere caratteri alfanumerici (Char.IsLetterOrDigit()) e '-', '_', '(', '', ')' e'.'. Si noti che il nome non può terminare con '.'
string
managedVirtualNetwork
L'impostazione di questa opzione su "impostazione predefinita" garantisce che tutto il calcolo per questa area di lavoro si trova in una rete virtuale gestita per conto dell'utente.
string
managedVirtualNetworkSettings
Impostazioni di Rete virtuale gestite
ManagedVirtualNetworkSettings
privateEndpointConnections
Connessioni endpoint private all'area di lavoro
PrivateEndpointConnection []
publicNetworkAccess
Abilitare o disabilitare l'accesso di rete pubblica all'area di lavoro
'Disabilitato' 'Enabled'
purviewConfiguration
Configurazione di Purview
PurviewConfiguration
sqlAdministratorLogin
Account di accesso per l'amministratore di SQL active directory dell'area di lavoro
string
sqlAdministratorLoginPassword
Password di accesso dell'amministratore SQL
string
trustedServiceBypassEnabled
TrustedServiceBypassEnabled per l'area di lavoro
bool
virtualNetworkProfile
profilo Rete virtuale
VirtualNetworkProfile
workspaceRepositoryConfiguration
Impostazioni di integrazione Git
WorkspaceRepositoryConfiguration
CspWorkspaceAdminProperties
Nome
Descrizione
Valore
initialWorkspaceAdminObjectId
ID oggetto AAD dell'amministratore dell'area di lavoro iniziale
string
DataLakeStorageAccountDetails
Nome
Descrizione
Valore
accountUrl
URL dell'account
string
createManagedPrivateEndpoint
Creare o meno un endpoint privato gestito per questo account di archiviazione
bool
file system
Nome file system
string
resourceId
ID risorsa ARM di questo account di archiviazione
string
EncryptionDetails
CustomerManagedKeyDetails
KekIdentityProperties
Nome
Descrizione
Valore
userAssignedIdentity
ID risorsa identità assegnata dall'utente
string
useSystemAssignedIdentity
Valore booleano che specifica se usare o meno l'identità assegnata dal sistema
Per Bicep, è possibile usare la funzione any().
WorkspaceKeyDetails
Nome
Descrizione
Valore
keyVaultUrl
URL dell'insieme di credenziali delle chiavi della chiave dell'area di lavoro
string
name
Nome della sotto-risorsa chiave dell'area di lavoro
string
ManagedVirtualNetworkSettings
Nome
Descrizione
Valore
allowedAadTenantIdsForLinking
ID tenant Aad consentiti per il collegamento
string[]
linkedAccessCheckOnTargetResource
Controllo di accesso collegato nella risorsa di destinazione
bool
preventDataExfiltration
Impedire l'esfiltrazione dei dati
bool
PrivateEndpointConnection
PrivateEndpointConnectionProperties
PrivateEndpoint
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
PrivateLinkServiceConnectionState
Nome
Descrizione
Valore
description
Descrizione della connessione al servizio collegamento privato.
string
status
Stato di connessione del servizio di collegamento privato.
string
PurviewConfiguration
Nome
Descrizione
Valore
purviewResourceId
ID risorsa Purview
string
VirtualNetworkProfile
Nome
Descrizione
Valore
computeSubnetId
ID subnet usato per i calcoli nell'area di lavoro
string
WorkspaceRepositoryConfiguration
Nome
Descrizione
Valore
accountName
Nome account
string
collaborationBranch
Ramo di collaborazione
string
hostName
Nome host GitHub Enterprise. ad esempio https://github.mydomain.com
string
lastCommitId
Ultimo ID commit
string
projectName
Nome del progetto VSTS
string
repositoryName
Nome del repository
string
rootFolder
Cartella radice da usare nel repository
string
TenantId
The VSTS tenant ID
string
type
Tipo di configurazione repositoryID dell'area di lavoro. Esempio di WorkspaceVSTSConfiguration, WorkspaceGitHubConfiguration
string
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Modello
Descrizione
Azure Synapse proof-of-concept
Questo modello crea un ambiente di prova del concetto per Azure Synapse, inclusi pool SQL e pool apache Spark facoltativi
Definizione della risorsa modello di Resource Manager
Il tipo di risorsa delle aree di lavoro può essere distribuito con operazioni destinate:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche .
Per creare una risorsa Microsoft.Synapse/workspaces, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Synapse/workspaces",
"apiVersion": "2021-06-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"azureADOnlyAuthentication": "bool",
"cspWorkspaceAdminProperties": {
"initialWorkspaceAdminObjectId": "string"
},
"defaultDataLakeStorage": {
"accountUrl": "string",
"createManagedPrivateEndpoint": "bool",
"filesystem": "string",
"resourceId": "string"
},
"encryption": {
"cmk": {
"kekIdentity": {
"userAssignedIdentity": "string",
"useSystemAssignedIdentity": {}
},
"key": {
"keyVaultUrl": "string",
"name": "string"
}
}
},
"managedResourceGroupName": "string",
"managedVirtualNetwork": "string",
"managedVirtualNetworkSettings": {
"allowedAadTenantIdsForLinking": [ "string" ],
"linkedAccessCheckOnTargetResource": "bool",
"preventDataExfiltration": "bool"
},
"privateEndpointConnections": [
{
"properties": {
"privateEndpoint": {},
"privateLinkServiceConnectionState": {
"description": "string",
"status": "string"
}
}
}
],
"publicNetworkAccess": "string",
"purviewConfiguration": {
"purviewResourceId": "string"
},
"sqlAdministratorLogin": "string",
"sqlAdministratorLoginPassword": "string",
"trustedServiceBypassEnabled": "bool",
"virtualNetworkProfile": {
"computeSubnetId": "string"
},
"workspaceRepositoryConfiguration": {
"accountName": "string",
"collaborationBranch": "string",
"hostName": "string",
"lastCommitId": "string",
"projectName": "string",
"repositoryName": "string",
"rootFolder": "string",
"tenantId": "string",
"type": "string"
}
}
}
Valori delle proprietà
aree di lavoro
Nome
Descrizione
Valore
tipo
Tipo di risorsa
'Microsoft.Synapse/workspaces'
apiVersion
Versione dell'API risorsa
'2021-06-01'
name
Nome della risorsa
stringa (obbligatoria) Limite di caratteri: 1-50 Caratteri validi: Lettere minuscole, trattini e numeri. Deve iniziare e terminare con una lettera o un numero. Non può contenere -ondemand
Il nome della risorsa deve essere univoco in Azure.
posizione
Posizione geografica in cui vive la risorsa
stringa (obbligatoria)
tags
Tag di risorse.
Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
identity
Identità dell'area di lavoro
ManagedIdentity
properties
Proprietà delle risorse dell'area di lavoro
WorkspaceProperties
ManagedIdentity
Nome
Descrizione
Valore
tipo
Tipo di identità gestita per l'area di lavoro
'Nessuno' 'SystemAssigned' 'SystemAssigned,UserAssigned'
userAssignedIdentities
Identità gestite assegnate dall'utente.
object
WorkspaceProperties
Nome
Descrizione
Valore
azureADOnlyAuthentication
Abilitare o disabilitare AzureADOnlyAuthentication in tutte le sottorisorse dell'area di lavoro
bool
cspWorkspaceAdminProperties
Proprietà di amministratore di AAD dell'area di lavoro iniziale per una sottoscrizione CSP
CspWorkspaceAdminProperties
defaultDataLakeStorage
Dettagli dell'account di archiviazione data lake predefinito dell'area di lavoro
DataLakeStorageAccountDetails
Crittografia
Dettagli della crittografia dell'area di lavoro
EncryptionDetails
managedResourceGroupName
Gruppo di risorse gestite dell'area di lavoro. Il nome del gruppo di risorse identifica in modo univoco il gruppo di risorse all'interno dell'id sottoscrizione utente. Il nome del gruppo di risorse non deve superare i 90 caratteri e deve contenere caratteri alfanumerici (Char.IsLetterOrDigit()) e '-', '_', '(', ')' e'.'. Si noti che il nome non può terminare con '.'
string
managedVirtualNetwork
L'impostazione di questa opzione su "default" garantisce che tutte le risorse di calcolo per questa area di lavoro si trovano in una rete virtuale gestita per conto dell'utente.
string
managedVirtualNetworkSettings
Impostazioni di Rete virtuale gestite
ManagedVirtualNetworkSettings
privateEndpointConnections
Connessioni endpoint privato all'area di lavoro
PrivateEndpointConnection []
publicNetworkAccess
Abilitare o disabilitare l'accesso alla rete pubblica all'area di lavoro
'Disabilitato' 'Enabled'
purviewConfiguration
Configurazione di Purview
PurviewConfiguration
sqlAdministratorLogin
Account di accesso per l'amministratore di ACTIVE Directory SQL dell'area di lavoro
string
sqlAdministratorLoginPassword
Password di accesso amministratore SQL
string
trustedServiceBypassEnabled
TrustedServiceBypassEnabled per l'area di lavoro
bool
virtualNetworkProfile
profilo Rete virtuale
VirtualNetworkProfile
workspaceRepositoryConfiguration
Impostazioni di integrazione Git
WorkspaceRepositoryConfiguration
CspWorkspaceAdminProperties
Nome
Descrizione
Valore
initialWorkspaceAdminObjectId
ID oggetto AAD dell'amministratore dell'area di lavoro iniziale
string
DataLakeStorageAccountDetails
Nome
Descrizione
Valore
accountUrl
URL dell'account
string
createManagedPrivateEndpoint
Creare o meno un endpoint privato gestito per questo account di archiviazione
bool
file system
Nome file system
string
resourceId
ID risorsa ARM di questo account di archiviazione
string
EncryptionDetails
CustomerManagedKeyDetails
KekIdentityProperties
Nome
Descrizione
Valore
userAssignedIdentity
ID risorsa identity assegnata dall'utente
string
useSystemAssignedIdentity
Boolean che specifica se usare l'identità assegnata dal sistema o meno
WorkspaceKeyDetails
Nome
Descrizione
Valore
keyVaultUrl
URL dell'insieme di credenziali delle chiavi della chiave secondaria dell'area di lavoro
string
name
Nome della risorsa secondaria della chiave dell'area di lavoro
string
ManagedVirtualNetworkSettings
Nome
Descrizione
Valore
allowedAadTenantIdsForLinking
ID tenant Aad consentiti per il collegamento
string[]
linkedAccessCheckOnTargetResource
Controllo accesso collegato nella risorsa di destinazione
bool
preventDataExfiltration
Impedire l'esfiltrazione dei dati
bool
PrivateEndpointConnection
PrivateEndpointConnectionProperties
PrivateEndpoint
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
PrivateLinkServiceConnectionState
Nome
Descrizione
Valore
description
Descrizione della connessione al servizio collegamento privato.
string
status
Stato di connessione del servizio di collegamento privato.
string
PurviewConfiguration
Nome
Descrizione
Valore
purviewResourceId
ID risorsa Purview
string
VirtualNetworkProfile
Nome
Descrizione
Valore
computeSubnetId
ID subnet usato per i calcoli nell'area di lavoro
string
WorkspaceRepositoryConfiguration
Nome
Descrizione
Valore
accountName
Nome account
string
collaborationBranch
Ramo di collaborazione
string
hostName
Nome host GitHub Enterprise. ad esempio https://github.mydomain.com
string
lastCommitId
Ultimo ID commit
string
projectName
Nome del progetto VSTS
string
repositoryName
Nome del repository
string
rootFolder
Cartella radice da usare nel repository
string
TenantId
The VSTS tenant ID
string
type
Tipo di configurazione repositoryID dell'area di lavoro. Esempio di WorkspaceVSTSConfiguration, WorkspaceGitHubConfiguration
string
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Modello
Descrizione
Azure Synapse modello di verifica
Questo modello crea un ambiente di verifica per Azure Synapse, inclusi pool SQL e pool Apache Spark facoltativi
Il tipo di risorsa delle aree di lavoro può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche .
Per creare una risorsa Microsoft.Synapse/workspaces, aggiungere il codice Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Synapse/workspaces@2021-06-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
azureADOnlyAuthentication = bool
cspWorkspaceAdminProperties = {
initialWorkspaceAdminObjectId = "string"
}
defaultDataLakeStorage = {
accountUrl = "string"
createManagedPrivateEndpoint = bool
filesystem = "string"
resourceId = "string"
}
encryption = {
cmk = {
kekIdentity = {
userAssignedIdentity = "string"
}
key = {
keyVaultUrl = "string"
name = "string"
}
}
}
managedResourceGroupName = "string"
managedVirtualNetwork = "string"
managedVirtualNetworkSettings = {
allowedAadTenantIdsForLinking = [
"string"
]
linkedAccessCheckOnTargetResource = bool
preventDataExfiltration = bool
}
privateEndpointConnections = [
{
properties = {
privateEndpoint = {}
privateLinkServiceConnectionState = {
description = "string"
status = "string"
}
}
}
]
publicNetworkAccess = "string"
purviewConfiguration = {
purviewResourceId = "string"
}
sqlAdministratorLogin = "string"
sqlAdministratorLoginPassword = "string"
trustedServiceBypassEnabled = bool
virtualNetworkProfile = {
computeSubnetId = "string"
}
workspaceRepositoryConfiguration = {
accountName = "string"
collaborationBranch = "string"
hostName = "string"
lastCommitId = "string"
projectName = "string"
repositoryName = "string"
rootFolder = "string"
tenantId = "string"
type = "string"
}
}
})
}
Valori delle proprietà
aree di lavoro
Nome
Descrizione
Valore
tipo
Tipo di risorsa
"Microsoft.Synapse/workspaces@2021-06-01"
name
Nome della risorsa
stringa (obbligatorio) Limite di caratteri: 1-50 Caratteri validi: Lettere minuscole, trattini e numeri. Deve iniziare e terminare con una lettera o un numero. Non può contenere -ondemand
Il nome della risorsa deve essere univoco in Azure.
posizione
Posizione geografica in cui risiede la risorsa
stringa (obbligatorio)
parent_id
Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse.
stringa (obbligatorio)
tags
Tag delle risorse.
Dizionario di nomi e valori di tag.
identity
Identità dell'area di lavoro
ManagedIdentity
properties
Proprietà delle risorse dell'area di lavoro
WorkspaceProperties
ManagedIdentity
Nome
Descrizione
Valore
tipo
Tipo di identità gestita per l'area di lavoro
"SystemAssigned" "SystemAssigned,UserAssigned"
identity_ids
Identità gestite assegnate dall'utente.
Matrice di ID identità utente.
WorkspaceProperties
Nome
Descrizione
Valore
azureADOnlyAuthentication
Abilitare o disabilitare AzureADOnlyAuthentication in tutte le sottorisorse dell'area di lavoro
bool
cspWorkspaceAdminProperties
Proprietà di amministratore di AAD dell'area di lavoro iniziale per una sottoscrizione CSP
CspWorkspaceAdminProperties
defaultDataLakeStorage
Dettagli dell'account di archiviazione data lake predefinito dell'area di lavoro
DataLakeStorageAccountDetails
Crittografia
Dettagli della crittografia dell'area di lavoro
EncryptionDetails
managedResourceGroupName
Gruppo di risorse gestite dell'area di lavoro. Il nome del gruppo di risorse identifica in modo univoco il gruppo di risorse all'interno dell'id sottoscrizione utente. Il nome del gruppo di risorse non deve superare i 90 caratteri e deve contenere caratteri alfanumerici (Char.IsLetterOrDigit()) e '-', '_', '(', ')' e'.'. Si noti che il nome non può terminare con '.'
string
managedVirtualNetwork
L'impostazione di questa opzione su "default" garantisce che tutte le risorse di calcolo per questa area di lavoro si trovano in una rete virtuale gestita per conto dell'utente.
string
managedVirtualNetworkSettings
Impostazioni di Rete virtuale gestite
ManagedVirtualNetworkSettings
privateEndpointConnections
Connessioni endpoint privato all'area di lavoro
PrivateEndpointConnection []
publicNetworkAccess
Abilitare o disabilitare l'accesso alla rete pubblica all'area di lavoro
"Disabilitato" "Abilitato"
purviewConfiguration
Configurazione di Purview
PurviewConfiguration
sqlAdministratorLogin
Account di accesso per l'amministratore di ACTIVE Directory SQL dell'area di lavoro
string
sqlAdministratorLoginPassword
Password di accesso amministratore SQL
string
trustedServiceBypassEnabled
TrustedServiceBypassEnabled per l'area di lavoro
bool
virtualNetworkProfile
profilo Rete virtuale
VirtualNetworkProfile
workspaceRepositoryConfiguration
Impostazioni di integrazione Git
WorkspaceRepositoryConfiguration
CspWorkspaceAdminProperties
Nome
Descrizione
Valore
initialWorkspaceAdminObjectId
ID oggetto AAD dell'amministratore dell'area di lavoro iniziale
string
DataLakeStorageAccountDetails
Nome
Descrizione
Valore
accountUrl
URL dell'account
string
createManagedPrivateEndpoint
Creare o meno un endpoint privato gestito per questo account di archiviazione
bool
file system
Nome file system
string
resourceId
ID risorsa ARM di questo account di archiviazione
string
EncryptionDetails
CustomerManagedKeyDetails
KekIdentityProperties
Nome
Descrizione
Valore
userAssignedIdentity
ID risorsa identità assegnata dall'utente
string
useSystemAssignedIdentity
Valore booleano che specifica se usare o meno l'identità assegnata dal sistema
WorkspaceKeyDetails
Nome
Descrizione
Valore
keyVaultUrl
URL dell'insieme di credenziali delle chiavi della chiave dell'area di lavoro
string
name
Nome della sotto-risorsa chiave dell'area di lavoro
string
ManagedVirtualNetworkSettings
Nome
Descrizione
Valore
allowedAadTenantIdsForLinking
ID tenant Aad consentiti per il collegamento
string[]
linkedAccessCheckOnTargetResource
Controllo di accesso collegato nella risorsa di destinazione
bool
preventDataExfiltration
Impedire l'esfiltrazione dei dati
bool
PrivateEndpointConnection
PrivateEndpointConnectionProperties
PrivateEndpoint
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
PrivateLinkServiceConnectionState
Nome
Descrizione
Valore
description
Descrizione della connessione al servizio di collegamento privato.
string
status
Stato della connessione al servizio di collegamento privato.
string
PurviewConfiguration
Nome
Descrizione
Valore
purviewResourceId
ID risorsa Purview
string
VirtualNetworkProfile
Nome
Descrizione
Valore
computeSubnetId
ID subnet usato per le risorse di calcolo nell'area di lavoro
string
WorkspaceRepositoryConfiguration
Nome
Descrizione
Valore
accountName
Nome account
string
collaborationBranch
Ramo di collaborazione
string
hostName
Nome host GitHub Enterprise. ad esempio https://github.mydomain.com
string
lastCommitId
Ultimo ID commit
string
projectName
Nome del progetto VSTS
string
repositoryName
Nome del repository
string
rootFolder
Cartella radice da usare nel repository
string
TenantId
The VSTS tenant ID
string
type
Tipo di configurazione repositoryID dell'area di lavoro. Esempio di WorkspaceVSTSConfiguration, WorkspaceGitHubConfiguration
string