Mulai cepat: Membuat ruang kerja Azure Synapse Analytics dengan 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 panduan cepat ini, Anda mempelajari cara membuat ruang kerja Azure Synapse Analytics menggunakan Azure CLI.

Jika Anda tidak memiliki akun Azure, buat akun gratis 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 Analytics harus dapat membaca dan menulis ke akun Data Lake Storage Gen2 yang dipilih. Selain itu, untuk akun penyimpanan apa pun yang Anda tautkan sebagai akun penyimpanan utama, Anda harus mengaktifkan namespace hierarkis pada pembuatan akun penyimpanan, seperti yang dijelaskan dalam Membuat akun penyimpanan.

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan 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 Mengautentikasi ke Azure menggunakan Azure CLI.

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

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

Membuat ruang kerja Azure Synapse Analytics dengan menggunakan Azure CLI

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

   Nama Variabel Lingkungan	Deskripsi
   NamaAkunPenyimpanan	Nama untuk akun penyimpanan Data Lake Storage Gen2 yang sudah ada.
   StorageAccountResourceGroup	Nama grup sumber daya akun penyimpanan Data Lake Storage Gen2 Anda yang sudah ada.
   FileShareName	Nama sistem file penyimpanan Anda yang sudah ada.
   SynapseResourceGroup	Pilih nama baru untuk grup sumber daya Azure Synapse Analytics Anda.
   Wilayah	Pilih salah satu wilayah Azure.
   NamaRuangKerjaSynapse	Pilih nama unik untuk ruang kerja Azure Synapse Analytics baru Anda.
   SqlUser	Pilih nilai untuk nama pengguna baru.
   SqlPassword	Pilih kata sandi yang aman.

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

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

3. Buat ruang kerja Azure Synapse Analytics:

   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 Analytics:

   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. Buat aturan firewall untuk mengizinkan akses ke ruang kerja Azure Synapse Analytics Anda 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 ruang kerja Azure Synapse Analytics yang disimpan dalam variabel WorkspaceWeb lingkungan untuk mengakses ruang kerja Anda:

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

   

7. Setelah disebarkan, diperlukan lebih banyak izin:

   • Di portal Azure, tetapkan pengguna lain dari ruang kerja ke peran Kontributor di ruang kerja. Untuk informasi selengkapnya, lihat Menetapkan peran Azure menggunakan portal Azure.
   • Tetapkan peran kontrol akses berbasis peran Azure Synapse Analytics yang sesuai kepada pengguna lain dengan menggunakan Synapse Studio.
   • Anggota peran Pemilik akun Azure Storage harus menetapkan peran Kontributor Data Blob Penyimpanan ke identitas layanan terkelola ruang kerja Azure Synapse Analytics dan pengguna lainnya.

Membersihkan sumber daya

Ikuti langkah-langkah ini untuk menghapus ruang kerja Azure Synapse Analytics.

Peringatan

Menghapus ruang kerja Azure Synapse Analytics 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, notebook, definisi pekerjaan, dan alur).

Menghapus ruang kerja tidak akan memengaruhi data di akun Data Lake Storage Gen2 yang ditautkan ke ruang kerja.

Jika Anda ingin menghapus ruang kerja Azure Synapse Analytics, selesaikan perintah berikut:

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

Konten terkait

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