Mulai cepat: Membuat ruang kerja Synapse menggunakan Azure CLI

Azure CLI adalah pengalaman baris perintah Azure untuk mengelola sumber daya Azure. Anda dapat menggunakannya di browser Anda dengan Azure Cloud Shell. Anda juga dapat memasangnya di macOS, Linux, atau Windows, dan menjalankannya dari baris perintah.

Dalam mulai cepat ini, Anda belajar membuat ruang kerja Synapse dengan menggunakan Azure CLI.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Prasyarat

• Unduh dan pasang jq, prosesor JSON baris perintah yang ringan dan fleksibel

• Akun penyimpanan Azure Data Lake Storage Gen2

  Penting

  Ruang kerja Azure Synapse harus dapat membaca dan menulis ke akun ADLS Gen2 yang dipilih. Selain itu, untuk akun penyimpanan apa pun yang Anda tautkan sebagai akun penyimpanan utama, Anda harus mengaktifkan namespace layanan hierarkis saat membuat akun penyimpanan, seperti yang dijelaskan di halaman Membuat Akun Penyimpanan.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Membuat ruang kerja Azure Synapse menggunakan Azure CLI

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

   Nama Variabel Lingkungan	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.

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

   az group create --name $SynapseResourceGroup --location $Region
   

3. Membuat ruang kerja Azure Synapse:

   az synapse workspace create \
     --name $SynapseWorkspaceName \
     --resource-group $SynapseResourceGroup \
     --storage-account $StorageAccountName \
     --file-system $FileShareName \
     --sql-admin-login-user $SqlUser \
     --sql-admin-login-password $SqlPassword \
     --location $Region
   

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

   WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
   
   WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
   

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

   ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
   ClientIP=${ClientIP##'Client Ip address : '}
   echo "Creating a firewall rule to enable access for IP address: $ClientIP"
   
   az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
   

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

   echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
   

   

7. Setelah disebarkan, izin tambahan diperlukan.

• Di portal Azure, tetapkan pengguna lain dari ruang kerja ke peran Kontributor di ruang kerja. Untuk langkah-langkah mendetail, lihat Menetapkan peran Azure menggunakan portal 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 Anda ingin menghapus ruang kerja Azure Synapse, selesaikan perintah berikut ini:

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

Langkah berikutnya

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