Hızlı Başlangıç: Azure PowerShell ile Azure synapse çalışma alanı oluşturma

Makale
05/11/2023

Azure PowerShell, Azure kaynaklarını doğrudan PowerShell'den yönetmeye yönelik bir cmdlet kümesidir. Azure Cloud Shell ile kendi tarayıcınızda da kullanabilirsiniz. MacOS, Linux veya Windows'a da yükleyebilirsiniz.

Bu hızlı başlangıçta, Azure PowerShell kullanarak Synapse çalışma alanı oluşturmayı öğreneceksiniz.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.

Önkoşullar

depolama hesabı Azure Data Lake Storage 2. Nesil

Önemli

Azure Synapse çalışma alanının seçili ADLS 2. Nesil hesabını okuyabilmesi ve yazabilmesi gerekir. Birincil depolama hesabı olarak bağladığınız herhangi bir depolama hesabı için Depolama hesabı oluşturma bölümünde açıklandığı gibi depolama hesabı oluşturulurken hiyerarşik ad alanını etkinleştirmeniz gerekir.

Cloud Shell kullanmayı seçerseniz daha fazla bilgi için bkz. Azure Cloud Shell genel bakış.

Azure PowerShell modülünü yerel olarak yükleme

PowerShell'i yerel olarak kullanmayı seçerseniz, bu makalede Az PowerShell modülünü yüklemeniz ve Connect-AzAccount cmdlet'ini kullanarak Azure hesabınıza bağlanmanız gerekir. Az PowerShell modülünü yükleme hakkında daha fazla bilgi için bkz. yükleme Azure PowerShell.

Azure PowerShell kimlik doğrulaması hakkında daha fazla bilgi için bkz. Azure PowerShell ile oturum açma.

Azure Synapse PowerShell modülünü yükleme

Önemli

Az.Synapse PowerShell modülü önizleme aşamasındayken cmdlet'ini Install-Module kullanarak bunu ayrı olarak yüklemeniz gerekir. Bu PowerShell modülü genel kullanıma sunulduktan sonra, gelecekteki Az PowerShell modülü sürümlerinin bir parçası haline gelecek ve Azure Cloud Shell içinden varsayılan olarak sağlanacaktır.

Install-Module -Name Az.Synapse

Azure PowerShell kullanarak Azure Synapse çalışma alanı oluşturma

Azure Synapse çalışma alanına yönelik kaynaklar oluşturmak için gerekli ortam değişkenlerini tanımlayın.

Değişken adı	Açıklama
StorageAccountName	Mevcut ADLS 2. Nesil depolama hesabınızın adı.
StorageAccountResourceGroup	Mevcut ADLS 2. Nesil depolama hesabı kaynak grubunuzun adı.
FileShareName	Mevcut depolama dosya sisteminizin adı.
SynapseResourceGroup	Azure Synapse kaynak grubunuz için yeni bir ad seçin.
Bölge	Azure bölgelerinden birini seçin.
SynapseWorkspaceName	Yeni Azure Synapse Çalışma Alanınız için benzersiz bir ad seçin.
SqlUser	Yeni kullanıcı adı için bir değer seçin.
SqlPassword	Güvenli bir parola seçin.
ClientIP	PowerShell'i çalıştırdığınız sistemin Genel IP Adresi.

Azure Synapse çalışma alanınız için kapsayıcı olarak bir kaynak grubu oluşturun:
```
New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
```

Azure Synapse Çalışma Alanı oluşturma:

$Cred = New-Object -TypeName System.Management.Automation.PSCredential ($SqlUser, (ConvertTo-SecureString $SqlPassword -AsPlainText -Force))

$WorkspaceParams = @{
  Name = $SynapseWorkspaceName
  ResourceGroupName = $SynapseResourceGroup
  DefaultDataLakeStorageAccountName = $StorageAccountName
  DefaultDataLakeStorageFilesystem = $FileShareName
  SqlAdministratorLoginCredential = $Cred
  Location = $Region
}
New-AzSynapseWorkspace @WorkspaceParams

Azure Synapse Çalışma Alanı için Web ve Geliştirme URL'sini alma:

$WorkspaceWeb = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.web
$WorkspaceDev = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.dev

Makinenizden Azure Synapse Çalışma Alanına erişiminize izin vermek için bir Güvenlik Duvarı Kuralı oluşturun:

$FirewallParams = @{
  WorkspaceName = $SynapseWorkspaceName
  Name = 'Allow Client IP'
  ResourceGroupName = $StorageAccountResourceGroup
  StartIpAddress = $ClientIP
  EndIpAddress = $ClientIP
}
New-AzSynapseFirewallRule @FirewallParams

Çalışma alanınıza erişmek için ortam değişkeninde WorkspaceWeb depolanan Azure Synapse Çalışma Alanı Web URL'si adresini açın:
```
Start-Process $WorkspaceWeb
```
Dağıtıldıktan sonra ek izinler gerekir.

Azure portal çalışma alanının diğer kullanıcılarını çalışma alanında Katkıda Bulunan rolüne atayın. Ayrıntılı adımlar için bkz. Azure portalı kullanarak Azure rolleri atama.
Synapse Studio kullanarak diğer kullanıcılara uygun Synapse RBAC rollerini atayın.
Azure Depolama hesabının Sahip rolünün bir üyesi, Azure Synapse çalışma alanı MSI'sine ve diğer kullanıcılara Depolama Blob Verileri Katkıda Bulunanı rolünü atamalıdır.

Kaynakları temizleme

Azure Synapse çalışma alanını silmek için aşağıdaki adımları izleyin.

Uyarı

bir Azure Synapse çalışma alanının silinmesi analiz altyapılarını ve kapsanan SQL havuzlarının ve çalışma alanı meta verilerinin veritabanında depolanan verileri kaldırır. ARTıK SQL veya Apache Spark uç noktalarına bağlanmak mümkün olmayacaktır. Tüm kod yapıtları silinir (sorgular, not defterleri, iş tanımları ve işlem hatları). Çalışma alanının silinmesi, çalışma alanına bağlı Data Lake Store 2. Nesil'deki verileri etkilemez.

Bu makalede oluşturulan Azure Synapse çalışma alanı gerekli değilse, aşağıdaki örneği çalıştırarak çalışma alanını silebilirsiniz.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Sonraki adımlar

Ardından, verilerinizi analiz etmeye ve keşfetmeye başlamak için SQL havuzları oluşturabilir veya Apache Spark havuzları oluşturabilirsiniz .