Tutorial: Berbagi data menggunakan Azure Data Share

Dalam tutorial ini, Anda akan mempelajari cara menyiapkan Azure Data Share baru dan mulai berbagi data Anda dengan pelanggan dan mitra di luar organisasi Azure Anda.

Dalam tutorial ini, Anda akan mempelajari cara:

• Membuat Berbagi Data.
• Tambahkan himpunan data ke Berbagi Data Anda.
• Aktifkan jadwal snapshot untuk Berbagi Data Anda.
• Tambahkan penerima ke Berbagi Data Anda.

Prasyarat

• Langganan Azure: Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum memulai.
• Alamat email Azure penerima Anda (menggunakan alias email mereka tidak akan berfungsi).
• Jika penyimpanan data Azure sumber berada dalam langganan Azure yang berbeda dari yang akan Anda gunakan untuk membuat sumber daya Data Share, daftarkan penyedia sumber daya Microsoft.DataShare di langganan tempat penyimpanan data Azure berada.

Berbagi dari akun penyimpanan

• Akun Azure Storage: Jika Anda belum memilikinya, Anda bisa membuat akun Azure Storage
• Izin untuk menulis ke akun penyimpanan, yang ada di Microsoft.Storage/storageAccounts/write. Izin ini ada dalam peran Kontributor Akun Penyimpanan.
• Izin untuk menambahkan penetapan peran ke akun penyimpanan, yang ada di Microsoft.Authorization/role assignments/write. Izin ini ada dalam peran Pemilik.

Berbagi dari sumber berbasis SQL

Di bawah ini adalah daftar prasyarat untuk berbagi data dari sumber SQL.

Prasyarat untuk berbagi dari Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW)

• Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW) dengan tabel dan tampilan yang ingin Anda bagikan.
• Izin untuk menulis ke database di server SQL, yang ada di Microsoft.Sql/servers/databases/write. Izin ini ada di dalam peran Kontributor.
• Microsoft Entra Admin server SQL
• Akses Firewall SQL Server. Ini dapat dilakukan melalui langkah-langkah berikut:
  1. Di portal Microsoft Azure, navigasikan ke server SQL. Pilih Firewall dan jaringan virtual dari navigasi kiri.
  2. Pilih Ya untuk Izinkan layanan dan sumber daya Azure mengakses server ini.
  3. Pilih +Tambahkan IP klien. Alamat IP klien dapat berubah. Proses ini mungkin perlu diulang saat Anda berbagi data SQL dari portal Azure berikutnya. Anda juga dapat menambahkan rentang IP.
  4. Pilih Simpan.

Prasyarat untuk berbagi dari kumpulan SQL Azure Synapse Analytics (ruang kerja)

• • Kumpulan SQL khusus Azure Synapse Analytics (ruang kerja) dengan tabel yang ingin Anda bagikan. Berbagi tampilan saat ini tidak didukung. Berbagi dari kumpulan SQL tanpa server saat ini tidak didukung.

• Izin untuk menulis ke kumpulan SQL di ruang kerja Synapse, yang ada di Microsoft.Synapse/workspaces/sqlPools/write. Izin ini ada di dalam peran Kontributor.

• Izin untuk identitas terkelola sumber daya Data Share guna mengakses kumpulan SQL ruang kerja Synapse. Hal ini dapat dilakukan melalui langkah-langkah berikut:

  1. Di portal Microsoft Azure, navigasikan ke ruang kerja Synapse. Pilih admin Direktori Aktif SQL dari navigasi kiri dan atur diri Anda sebagai admin Microsoft Entra.

  2. Buka Synapse Studio, pilih Kelola dari navigasi kiri. Pilih Kontrol akses di bawah Keamanan. Tetapkan sendiri peran Anda sebagai admin SQL atau Admin ruang kerja.

  3. Di Synapse Studio, pilih Kembangkan dari navigasi kiri. Jalankan skrip berikut di kumpulan SQL untuk menambahkan Identitas Terkelola dari sumber daya Data Share sebagai db_datareader.

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     <share_acc_name> adalah nama sumber daya Data Share Anda. Jika Anda belum membuat sumber daya Data Share, Anda dapat kembali ke prasyarat ini nanti.

• Akses Firewall ruang kerja Synapse. Hal ini dapat dilakukan melalui langkah-langkah berikut:

  1. Di portal Microsoft Azure, navigasikan ke ruang kerja Synapse. Pilih Firewall dari navigasi kiri.
  2. Pilih AKTIF untuk Izinkan layanan dan sumber daya Azure mengakses ruang kerja ini.
  3. Pilih +Tambahkan IP klien. Alamat IP klien dapat berubah. Proses ini mungkin perlu diulang saat Anda berbagi data SQL dari portal Azure berikutnya. Anda juga dapat menambahkan rentang IP.
  4. Pilih Simpan.

Berbagi dari Azure Data Explorer

• Klaster Azure Data Explorer dengan database yang ingin Anda bagikan.
• Izin untuk menulis ke klaster Azure Data Explorer, yang ada di Microsoft.Kusto/clusters/write. Izin ini ada di dalam peran Kontributor.

Masuk ke portal Microsoft Azure.

Masuk ke portal Azure.

Membuat Akun Berbagi Data

Portal

Buat sumber daya Berbagi Data Azure di grup sumber daya Azure.

1. Pilih tombol menu di pojok kiri atas portal, lalu pilih Buat sumber daya (+).

2. Cari Data Share.

3. Pilih Data Share dan Pilih Buat.

4. Isi detail dasar sumber daya Azure Data Share Anda dengan informasi berikut.

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   Langganan	Langganan Anda	Pilih langganan Azure yang ingin Anda gunakan untuk akun berbagi data Anda.
   Grup sumber daya	testresourcegroup	Gunakan grup sumber daya yang sudah ada atau buat grup sumber daya baru.
   Lokasi	US Timur 2	Pilih wilayah untuk akun berbagi data Anda.
   Nama	datashareaccount	Tentukan nama untuk akun data share Anda.

5. Pilih Tinjau + buat, lalu Buat untuk membuat akun berbagi data Anda. Membuat akun berbagi data baru biasanya memakan waktu sekitar 2 menit atau kurang.

6. Setelah penyebaran selesai, pilih Buka sumber daya.

Azure CLI

Buat sumber daya Berbagi Data Azure di grup sumber daya Azure.

Mulailah dengan mempersiapkan lingkungan Anda untuk Azure CLI:

• 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.

Gunakan perintah ini untuk membuat sumber daya:

1. Gunakan perintah az account set untuk mengatur langganan Anda menjadi langganan default saat ini:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Jalankan perintah az provider register untuk mendaftarkan penyedia sumber daya:

   az provider register --name "Microsoft.DataShare"
   

3. Jalankan perintah az group create untuk membuat grup sumber daya atau gunakan grup sumber daya yang sudah ada:

   az group create --name testresourcegroup --location "East US 2"
   

4. Jalankan perintah az datashare account create untuk membuat akun Berbagi Data:

   az datashare account create --resource-group testresourcegroup --name datashareaccount --location "East US 2" 
   

   Jalankan perintah az datashare account list untuk melihat akun Berbagi Data Anda:

   az datashare account list --resource-group testresourcegroup
   

PowerShell

Buat sumber daya Berbagi Data Azure di grup sumber daya Azure.

Mulailah dengan menyiapkan lingkungan Anda untuk PowerShell. Anda dapat menjalankan perintah PowerShell secara lokal atau menggunakan lingkungan Bash di Azure Cloud Shell.

• Jika Anda memilih untuk menggunakan Azure PowerShell secara lokal:
  • Instal versi terbaru modul Az PowerShell.
  • Sambungkan ke akun Azure Anda menggunakan cmdlet Connect-AzAccount.
• Jika Anda memilih untuk menggunakan Azure Cloud Shell:
  • Lihat Gambaran Umum Azure Cloud Shell untuk informasi selengkapnya.

Gunakan perintah ini untuk membuat sumber daya:

1. Gunakan perintah Koneksi-AzAccount untuk menyambungkan ke akun Azure Anda.

   Connect-AzAccount
   

2. Jalankan perintah Set-AzContext untuk mengatur langganan yang benar, jika Anda memiliki beberapa langganan.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Jalankan perintah New-AzResourceGroup untuk membuat grup sumber daya, atau gunakan grup sumber daya yang sudah ada:

   New-AzResourceGroup -Name <String> -Location <String>
   

4. Jalankan perintah New-AzDataShare untuk membuat akun Data Share:

    New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
   

   Jalankan perintah Get-AzDataShareAccount untuk melihat akun Data Share Anda:

   Get-AzDataShareAccount
   

Membuat berbagi

Portal

1. Navigasi ke halaman Gambaran Umum Azure Data Share Anda.

   

2. Pilih Mulai berbagi data Anda.

3. Pilih Buat.

4. Isi detail untuk berbagi data Anda. Tentukan nama, jenis data, deskripsi konten data, dan ketentuan penggunaan (opsional).

   

5. Pilih Lanjutkan.

6. Untuk menambahkan Himpunan Data ke berbagi data, pilih Tambahkan Himpunan Data.

   

7. Pilih jenis himpunan data yang ingin Anda tambahkan. Anda akan melihat daftar jenis himpunan data yang berbeda tergantung pada jenis berbagi (rekam jepret atau di tempat) yang telah Anda pilih di langkah sebelumnya. Jika berbagi dari Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW), Anda akan dimintai metode autentikasi untuk mencantumkan tabel. Pilih autentikasi Microsoft Entra, dan centang kotak Izinkan Data Share untuk menjalankan skrip 'buat pengguna' di atas atas nama saya.

   

8. Navigasi ke objek yang ingin Anda bagikan dan pilih 'Tambahkan Himpunan Data'.

   

9. Pada tab Penerima, masukkan alamat email Konsumen Data Anda dengan memilih '+ Tambah Penerima'.

   

10. Pilih Lanjutkan.

11. Jika Anda telah memilih jenis berbagi data snapshot, Anda dapat mengonfigurasi jadwal snapshot untuk memberikan pembaruan data Anda kepada konsumen data Anda.

    

12. Pilih waktu mulai dan interval pengulangan.

13. Pilih Lanjutkan.

14. Di tab Tinjau + Buat, tinjau Isi Paket, Pengaturan, Penerima, dan Pengaturan Sinkronisasi Anda. Pilih Buat.

Azure CLI

1. Jalankan perintah az storage account create untuk membuat akun Storage untuk Data Share ini:

   az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
   

2. Gunakan perintah az storage container create untuk membuat kontainer di dalam akun penyimpanan yang dibuat di perintah sebelumnya:

   az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
   

3. Jalankan perintah buat datashare az untuk membuat Berbagi Data Anda:

   az datashare create --resource-group testresourcegroup \
     --name ContosoMarketplaceDataShare --account-name ContosoMarketplaceAccount \
     --description "Data Share" --share-kind "CopyBased" --terms "Confidential"
   

4. Gunakan perintah buat undangan az datashare untuk membuat undangan untuk alamat yang ditentukan:

   az datashare invitation create --resource-group testresourcegroup \
     --name DataShareInvite --share-name ContosoMarketplaceDataShare \
     --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam.com"
   

PowerShell

1. Jika Anda belum memiliki data yang ingin Anda bagikan, Anda dapat mengikuti langkah-langkah ini untuk membuat akun penyimpanan. Jika Anda sudah memiliki penyimpanan, Anda dapat melompat ke langkah 2.

   1. Jalankan perintah New-AzStorageAccount untuk membuat akun Azure Storage:

      $storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>
      
      $ctx = $storageAccount.Context
      

   2. Jalankan perintah New-AzStorageContainer untuk membuat kontainer di akun Azure Storage baru Anda yang akan menyimpan data Anda:

      $containerName = <String>
      
      New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
      

   3. Jalankan perintah Set-AzStorageBlobContent untuk mengunggah file. Contoh berikut mengunggah textfile.csv dari folder D:\testFiles pada memori lokal, ke kontainer yang Anda buat.

      Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
      

   Untuk informasi selengkapnya tentang bekerja dengan Azure Storage di PowerShell, ikuti panduan Azure Storage PowerShell ini.

2. Jalankan perintah New-AzDataShare untuk membuat Data Share Anda:

   New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -Description <String> -TermsOfUse <String>
   

3. Gunakan perintah New-AzDataShareInvitation untuk membuat undangan untuk alamat yang ditentukan:

   New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>
   

4. Gunakan perintah New-AzDataShareSynchronizationSetting untuk mengatur pengulangan sinkronisasi untuk berbagi Anda. Ini bisa setiap hari, per jam, atau pada waktu tertentu.

   New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
   

Azure Data Share Anda sekarang telah dibuat dan penerima Berbagi Data Anda sekarang siap untuk menerima undangan Anda.

Membersihkan sumber daya

Saat sumber daya tidak lagi diperlukan, buka halaman Ringkasan Azure Data Share dan pilih Hapus untuk menghapusnya.

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari cara membuat Azure Data Share dan mengundang penerima. Untuk mempelajari tentang bagaimana Konsumen Data dapat menerima dan mendapatkan berbagi data, lanjutkan ke tutorial mendapatkan dan menerima data.

Tutorial: Menerima dan mendapatkan data menggunakan Azure Data Share