Mulai Cepat: Membuat ruang kerja synapse Azure dengan Azure PowerShell

Azure PowerShell adalah satu set cmdlet untuk mengelola sumber daya Azure langsung dari PowerShell. Anda dapat menggunakannya di browser Anda dengan Azure Cloud Shell. Anda juga dapat menginstalnya di macOS, Linux, atau Windows.

Dalam mulai cepat ini, Anda akan mempelajari cara membuat ruang kerja Synapse menggunakan Azure PowerShell.

Jika Anda tidak memiliki langganan Azure, buat akun Azure gratis sebelum Anda memulai.

Prasyarat

• Akun penyimpanan Azure Data Lake Storage Gen2

  Penting

  Ruang kerja Azure Synapse harus dapat membaca dan menulis ke akun ADLS Gen2 yang dipilih. Untuk akun penyimpanan apa pun yang Anda tautkan sebagai akun penyimpanan utama, Anda harus mengaktifkan kumpulan nama hierarkis saat membuat akun penyimpanan seperti yang dijelaskan dalam Buat akun penyimpanan.

Jika Anda memilih untuk menggunakan Cloud Shell, lihat Ringkasan Azure Cloud Shell untuk informasi selengkapnya.

Pasang modul Azure PowerShell secara lokal

Jika Anda memilih untuk menggunakan PowerShell secara lokal, artikel ini mewajibkan Anda memasang modul Az PowerShell dan menyambungkan ke akun Azure Anda menggunakan cmdlet Sambungkan-AzAccount. Untuk informasi selengkapnya tentang pemasangan modul Az PowerShell, lihat Pasang Azure PowerShell.

Untuk informasi selengkapnya tentang autentikasi ke Azure dengan PowerShell, lihat Masuk dengan Azure PowerShell.

Pasang modul PowerShell Azure Synapse

Penting

Saat modul PowerShell Az.Synapse dalam pratinjau, Anda harus memasangnya secara terpisah menggunakan cmdlet Install-Module. Setelah modul PowerShell ini tersedia secara umum, modul ini akan menjadi bagian dari rilis modul Az PowerShell di masa mendatang dan tersedia secara default dari dalam Azure Cloud Shell.

Install-Module -Name Az.Synapse

Membuat ruang kerja Azure Synapse menggunakan Azure PowerShell

1. Tentukan variabel lingkungan yang diperlukan untuk membuat sumber daya untuk ruang kerja Azure Synapse.

   Nama variabel	Deskripsi
   StorageAccountName	Nama untuk akun penyimpanan ADLS Gen2 Anda yang ada.
   StorageAccountResourceGroup	Nama grup sumber daya akun penyimpanan ADLS Gen2 Anda yang ada.
   FileShareName	Nama sistem file penyimpanan Anda yang sudah ada.
   SynapseResourceGroup	Pilih nama baru untuk grup sumber daya Azure Synapse Anda.
   Wilayah	Pilih salah satu wilayah Azure.
   SynapseWorkspaceName	Pilih nama unik untuk Ruang Kerja Azure Synapse baru Anda.
   SqlUser	Pilih nilai untuk nama pengguna baru.
   SqlPassword	Pilih kata sandi yang aman.
   ClientIP	Alamat IP publik sistem tempat Anda menjalankan PowerShell.

2. Membuat grup sumber daya sebagai kontainer untuk ruang kerja Azure Synapse Anda:

   New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
   

3. Membuat ruang kerja Azure Synapse:

   $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
   

4. Dapatkan URL Web dan Dev untuk Ruang Kerja Azure Synapse:

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

5. Membuat Aturan Firewall untuk mengizinkan akses Anda ke Ruang Kerja Azure Synapse dari komputer Anda:

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

6. Buka alamat URL Web Azure Synapse Workspace yang disimpan dalam variabel lingkungan WorkspaceWeb untuk mengakses ruang kerja Anda:

   Start-Process $WorkspaceWeb
   

   

7. Setelah disebarkan, izin tambahan diperlukan.

• Di portal Azure, tetapkan pengguna lain dari ruang kerja ke peran Kontributor di ruang kerja. Untuk langkah yang lebih detail, lihat Menetapkan peran Azure menggunakan portal Microsoft Azure.
• Tetapkan peran RBAC Synapse yang sesuai kepada pengguna lain menggunakan Synapse Studio.
• Anggota peran Pemilik akun Azure Storage harus menetapkan peran Kontributor Data Blob Storage ke MSI ruang kerja Azure Synapse dan pengguna lain.

Membersihkan sumber daya

Ikuti langkah-langkah di bawah ini untuk menghapus ruang kerja Azure Synapse.

Peringatan

Menghapus ruang kerja Azure Synapse akan menghapus mesin analitik dan data yang disimpan dalam database kumpulan SQL dan metadata ruang kerja yang terkandung. Tidak mungkin lagi terhubung ke titik akhir SQL atau Apache Spark. Semua artefak kode akan dihapus (kueri, buku catatan, definisi kerja, dan alur). Menghapus ruang kerja tidak akan memengaruhi data di Data Lake Store Gen2 yang ditautkan ke ruang kerja.

Jika ruang kerja Azure Synapse yang dibuat dalam artikel ini tidak diperlukan, Anda bisa menghapusnya dengan menjalankan contoh berikut.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Langkah berikutnya

Selanjutnya, Anda dapat membuat kumpulan SQL atau membuat kumpulan Apache Spark untuk mulai menganalisis dan menjelajahi data Anda.