Tutorial: Menerima & mendapatkan data - Azure Data Share

Artikel
02/12/2025

Dalam tutorial ini, Anda akan mempelajari cara menerima undangan berbagi data menggunakan Azure Data Share. Anda akan mempelajari cara menerima data yang dibagikan dengan Anda, dan cara mengaktifkan interval refresh reguler untuk memastikan bahwa Anda selalu memiliki rekam jepret terbaru data yang dibagikan dengan Anda.

Cara menerima undangan Azure Data Share
Membuat akun Azure Data Share
Menentukan tujuan untuk data Anda
Membuat langganan untuk berbagi data Anda untuk penyegaran terjadwal

Prasyarat

Sebelum dapat menerima undangan berbagi data, Anda harus membuat beberapa sumber daya Azure, yang tercantum di bawah ini.

Pastikan bahwa semua prasyarat selesai sebelum menerima undangan berbagi data.

Langganan Azure: Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum memulai.
Undangan Data Share: Undangan dari Microsoft Azure dengan subjek berjudul "Undangan Azure Data Share dari yourdataprovider@domain.com".
Daftarkan penyedia sumber daya Microsoft.DataShare di langganan Azure tempat Anda akan membuat sumber daya Data Share dan langganan Azure tempat penyimpanan data Azure target Anda berada.

Menerima data ke dalam akun penyimpanan

Akun Azure Storage: Jika Anda belum memilikinya, Anda dapat 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.

Menerima data ke dalam target berbasis SQL

Jika memilih untuk menerima data ke Azure SQL Database, Azure Synapse Analytics, di bawah ini adalah daftar prasyaratnya.

Prasyarat untuk menerima data ke Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW)

Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW).
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 server SQL di portal Microsoft Azure, navigasikan ke Firewall dan jaringan virtual
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 menerima data ke kumpulan SQL Azure Synapse Analytics (ruang kerja)

Kumpulan SQL khusus Azure Synapse Analytics (ruang kerja). Menerima data ke 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 dari 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 Microsoft Entra 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, db_datawriter, db_ddladmin'.
```
create user "<share_acc_name>" from external provider; 
exec sp_addrolemember db_datareader, "<share_acc_name>"; 
exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
exec sp_addrolemember db_ddladmin, "<share_acc_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.

Menerima data ke dalam kluster Azure Data Explorer:

Kluster Azure Data Explorer di pusat data Azure yang sama dengan kluster Data Explorer penyedia data: Jika belum memilikinya, Anda dapat membuat kluster Azure Data Explorer. Jika Anda tidak mengetahui pusat data Azure dari kluster penyedia data, Anda dapat membuat kluster tersebut nanti dalam prosesnya.
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 Azure.

Membuka undangan

Anda dapat membuka undangan dari email atau langsung dari portal Microsoft Azure.

Untuk membuka undangan dari email, periksa kotak masuk Anda untuk membuka undangan dari penyedia data Anda. Undangan berasal dari Microsoft Azure, berjudul Undangan Azure Data Share dari yourdataprovider@domain.com. Pilih Tampilkan undangan untuk melihat undangan Anda di Azure.

Untuk membuka undangan dari portal Microsoft Azure secara langsung, cari Undangan Data Share di portal Microsoft Azure. Ini akan membawa Anda ke daftar undangan Data Share.

Jika Anda adalah pengguna tamu penyewa, Anda akan diminta untuk memverifikasi alamat email untuk penyewa sebelum melihat undangan Data Share untuk pertama kalinya. Setelah diverifikasi, ini berlaku selama 12 bulan.
Pilih undangan yang ingin Anda tampilkan.

Siapkan lingkungan Azure CLI Anda, lalu lihat undangan Anda.

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.

Jalankan perintah az datashare consumer-invitation list-invitation untuk melihat undangan Anda saat ini:

az datashare consumer consumer-invitation list-invitation

Salin ID undangan Anda untuk digunakan di bagian selanjutnya.

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 Koneksi-AzAccount untuk menyambungkan ke akun Azure Anda.
```
Connect-AzAccount
```
Jalankan perintah Set-AzContext untuk mengatur langganan yang benar, jika Anda memiliki beberapa langganan.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Jalankan perintah Get-AzDataShareReceivedInvitation untuk melihat undangan Anda saat ini:
```
Get-AzDataShareReceivedInvitation
```

Salin ID undangan Anda untuk digunakan di bagian selanjutnya.

Menerima undangan

Pastikan semua bidang ditinjau, termasuk Persyaratan Penggunaan. Jika Anda menyetujui persyaratan penggunaan, Anda akan diminta untuk mencentang kotak untuk menunjukkan bahwa Anda setuju.
Di bawah Akun Data Share Target, pilih Langganan dan Grup Sumber Daya tempat Anda akan menyebarkan Data Share.

Untuk bidang Akun Data Share, pilih Buat baru jika Anda belum memiliki akun Data Share. Jika sudah memiliki akun, pilih akun Data Share yang ada untuk menerima data.

Untuk bidang Nama Berbagi yang Diterima, Anda dapat membiarkan default yang ditentukan oleh penyediaan data, atau menentukan nama baru untuk berbagi yang diterima.

Setelah Anda menyetujui persyaratan penggunaan dan menetapkan akun Data Share untuk mengelola pembagian yang Anda terima, Pilih Terima dan konfigurasikan. Langganan berbagi data akan dibuat.

Tindakan ini membawa Anda ke berbagi yang diterima di akun Data Share Anda.

Jika Anda tidak ingin menerima undangan, Pilih Tolak.

Gunakan perintah az datashare share-subscription create untuk membuat Data Share.

az datashare share-subscription create --resource-group share-rg \
  --name "fabrikamsolutions" --account-name FabrikamDataShareAccount \
  --invitation-id 89abcdef-0123-4567-89ab-cdef01234567 \
  --source-share-location "East US 2"

Gunakan perintah New-AzDataShareSubscription untuk membuat Data Share. InvitationId akan menjadi ID yang Anda kumpulkan dari langkah sebelumnya.

New-AzDataShareSubscription -ResourceGroupName share-rg -AccountName FabrikamDataShareAccount -Name "Fabrikam Solutions" -InvitationId "89abcdef-0123-4567-89ab-cdef01234567"

Ikuti langkah-langkah di bawah ini untuk mengonfigurasi tempat Anda ingin menerima data.

Pilih tab Himpunan Data. Centang kotak di samping himpunan data yang ingin Anda tetapkan tujuannya. Pilih + Peta untuk ditargetkan untuk memilih penyimpanan data target.
Pilih jenis penyimpanan data target yang Anda inginkan untuk penempatan data. File atau tabel data apa pun di penyimpanan data target dengan jalur dan nama yang sama akan ditimpa. Jika Anda menerima data ke Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW), centang kotak Izinkan Data Share untuk menjalankan skrip 'buat pengguna' di atas atas nama saya.

Untuk berbagi di tempat, pilih penyimpanan data di Lokasi yang ditentukan. Lokasi adalah pusat data Azure tempat penyimpanan data sumber penyedia data berada. Setelah himpunan data dipetakan, Anda dapat mengikuti tautan di Jalur Target untuk mengakses data.
Untuk berbagi data berbasis rekam jepret, jika penyedia data telah membuat jadwal rekam jepret untuk memberikan pembaruan rutin pada data, Anda juga dapat mengaktifkan jadwal rekam jepret dengan memilih tab Jadwal Rekam Jepret. Centang kotak di samping jadwal rekam jepret dan pilih + Aktifkan. Rekam jepret terjadwal pertama akan dimulai dalam satu menit dari waktu jadwal dan rekam jepret berikutnya akan dimulai dalam hitungan detik dari waktu yang dijadwalkan.

Metadata file yang disalin tidak bertahan setelah setiap eksekusi. Ini memang disengaja.

Gunakan perintah ini untuk mengonfigurasi tempat Anda ingin menerima data.

Jalankan perintah az datashare consumer-source-data-set list untuk mendapatkan ID himpunan data:

az datashare consumer-source-data-set list --resource-group "share-rg" \
 --account-name "FabrikamDataShareAccount" \
   --share-subscription-name "fabrikamsolutions" \

Jika Anda memerlukan akun penyimpanan, jalankan perintah az storage account create untuk membuat akun penyimpanan untuk Data Share ini:
```
az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
```

Gunakan perintah az storage account show untuk mendapatkan ID akun penyimpanan:

az storage account show --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
 --query "id"

Gunakan perintah berikut untuk mendapatkan ID utama akun:

az datashare account show --resource-group "share-rg" --name "FabrikamDataShareAccount" \
  --query "identity.principalId"

Gunakan perintah az role assignment create untuk membuat penetapan peran untuk perwakilan akun menggunakan ID utama akun dan ID akun penyimpanan Anda:

az role assignment create --role "Contributor" \
  --assignee-object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 
  --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"

Buat variabel untuk pemetaan berdasarkan ID himpunan data dari langkah 1:

$mapping='{\"data_set_id\":\"' + $dataset_id + '\",\"container_name\":\"newcontainer\",
  \"storage_account_name\":\"datashareconsumersa\",\"kind\":\"BlobFolder\",\"prefix\":\"consumer\"}'

Gunakan perintah az datashare data-set-mapping create untuk membuat pemetaan himpunan data:

az datashare data-set-mapping create --account-name "FabrikamDataShareAccount" \
 --data-set-mapping-name "datasetmapping" --resource-group "share-rg" \
 --share-subscription-name "fabrikamsolutions" --blob-folder-data-set-mapping $mapping

Jalankan perintah az datashare share-subscription synchronize untuk memulai sinkronisasi himpunan data.

az datashare share-subscription synchronize \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount"  \
  --name "Fabrikam Solutions" --synchronization-mode "Incremental" \

Jalankan perintah az datashare share-subscription list-synchronization untuk melihat daftar sinkronisasi Anda:

az datashare share-subscription list-synchronization \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" \

Gunakan perintah az datashare share-subscription list-source-share-synchronization-setting untuk melihat pengaturan sinkronisasi yang diatur pada berbagi Anda.

az datashare share-subscription list-source-share-synchronization-setting \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions"

Gunakan perintah ini untuk mengonfigurasi tempat Anda ingin menerima data.

Jalankan perintah Get-AzDataShareSourceDataSet untuk mendapatkan ID himpunan data:

Get-AzDataShareSourceDataSet -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Jika Anda belum memiliki lokasi tempat Anda ingin menyimpan data bersama, Anda dapat mengikuti langkah-langkah ini untuk membuat akun penyimpanan. Jika Anda sudah memiliki penyimpanan, Anda dapat melompat ke langkah berikutnya.
1. Jalankan perintah New-AzStorageAccount untuk membuat akun Azure Storage:
```
$storageAccount = New-AzStorageAccount -ResourceGroupName "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS

$ctx = $storageAccount.Context
```
2. Jalankan perintah New-AzStorageContainer untuk membuat kontainer di akun Azure Storage baru Anda yang akan menyimpan data Anda:
```
$containerName = "StorageContainer"

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.

Gunakan perintah Get-AzStorageAccount untuk mendapatkan ID akun penyimpanan:

Get-AzStorageAccount -ResourceGroupName "share-rg" -Name FabrikamStorageAccount

Gunakan ID himpunan data dari langkah pertama, lalu jalankan perintah New-AzDataShareDataSetMapping untuk membuat pemetaan himpunan data:

New-AzDataShareDataSetMapping -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -Name "Fabrikam Solutions" -StorageAccountResourceId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"  -DataSetId "0123abcd-ef01-2345-6789-abcdef012345"  -Container "StorageContainer"

Jalankan perintah Start-AzDataShareSubscriptionSynchronization untuk memulai sinkronisasi himpunan data.

Start-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationMode "Incremental"

Jalankan perintah Get-AzDataShareSubscriptionSynchronization untuk melihat daftar sinkronisasi Anda:

Get-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Gunakan perintah Get-AzDataShareSubscriptionSynchronizationDetail untuk melihat pengaturan sinkronisasi yang diatur pada berbagi Anda.

Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationId "a6ee5c8d-0ce0-485e-b2f2-966b187dc6c7"

Memicu snapshot

Langkah-langkah ini hanya berlaku untuk berbagi data berbasis snapshot.

Anda dapat memicu snapshot dengan memilih tab Detail, kemudian Picu snapshot. Di sini, Anda dapat memicu rekam jepret penuh atau tahapan data Anda. Jika ini adalah pertama kalinya Anda menerima data dari penyedia data Anda, pilih salinan lengkap.
Ketika status terakhir adalah berhasil, buka penyimpanan data target untuk melihat data yang diterima. Pilih Himpunan Data, dan pilih tautan di Jalur Target.

Jalankan perintah buat pemicu az datashare untuk memicu rekam jepret:

az datashare trigger create --account-name "FabrikamDataShareAccount" --resource-group "share-rg" --share-subscription-name "Fabrikam Solutions" --scheduled-trigger recurrence-interval="Day" synchronization-mode="Incremental" synchronization-time="2018-11-14T04:47:52.9614956Z" --name "Trigger1"

Langkah-langkah ini hanya berlaku untuk berbagi data berbasis snapshot.

Jalankan perintah New-AzDataShareTrigger untuk memicu rekam jepret:

New-AzDataShareTrigger -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

Lihat riwayat

Langkah ini hanya berlaku untuk berbagi data berbasis rekam jepret. Untuk melihat riwayat snapshot Anda, pilih tab Riwayat. Di sini Anda akan menemukan riwayat semua snapshot yang dibuat selama 30 hari terakhir.

Membersihkan sumber daya

Saat sumber daya tidak lagi diperlukan, buka halaman Gambaran Umum Berbagi Data, dan pilih Hapus untuk menghapusnya.

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari cara menerima dan menerima Azure Data Share. Untuk mempelajari selengkapnya tentang konsep Azure Data Share, lanjutkan ke Terminologi Azure Data Share.

Konsep Azure Data Share

Bagikan melalui

Prasyarat

Menerima data ke dalam akun penyimpanan

Menerima data ke dalam target berbasis SQL

Prasyarat untuk menerima data ke Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW)

Prasyarat untuk menerima data ke kumpulan SQL Azure Synapse Analytics (ruang kerja)

Menerima data ke dalam kluster Azure Data Explorer:

Membuka undangan

Menerima undangan

Memicu snapshot

Lihat riwayat

Membersihkan sumber daya

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan:

Bagikan melalui

Tutorial: Menerima dan mendapatkan data menggunakan Azure Data Share

Prasyarat

Menerima data ke dalam akun penyimpanan

Menerima data ke dalam target berbasis SQL

Prasyarat untuk menerima data ke Azure SQL Database atau Azure Synapse Analytics (sebelumnya Azure SQL DW)

Prasyarat untuk menerima data ke kumpulan SQL Azure Synapse Analytics (ruang kerja)

Menerima data ke dalam kluster Azure Data Explorer:

Masuk ke portal Microsoft Azure.

Membuka undangan

Menerima undangan

Konfigurasikan bagian yang diterima

Memicu snapshot

Lihat riwayat

Membersihkan sumber daya

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan: