Bagikan melalui

AzCopy

AzCopy adalah utilitas baris perintah yang kuat yang dirancang untuk memfasilitasi transfer data antar akun Azure Storage. Karena Microsoft OneLake mendukung API, SDK, dan alat yang sama dengan Azure Storage, Anda juga dapat menggunakan AzCopy untuk memuat data ke dan dari OneLake. Artikel ini membantu Anda menggunakan AzCopy dengan OneLake, mulai dari menyalin data antar artefak hingga mengunggah atau mengunduh data.

Mengapa menggunakan AzCopy dan OneLake?

AzCopy dioptimalkan untuk operasi sarana data dalam skala besar dan pergerakan data skala besar. Saat Anda menyalin data antara akun penyimpanan (termasuk OneLake), data berpindah langsung dari server penyimpanan ke server penyimpanan, meminimalkan penyempitan performa. AzCopy juga mudah digunakan dan dapat diandalkan, dengan mekanisme bawaan untuk menangani gangguan dan percobaan ulang jaringan. Dengan AzCopy, mudah untuk mengunggah data ke OneLake, atau memuat data dari sumber yang ada langsung ke item Anda di Fabric!

Akses ruang kerja terpercaya dan AzCopy

Akses ruang kerja tepercaya memungkinkan Anda mengakses akun Azure Storage yang mendukung firewall dengan aman dengan mengonfigurasi aturan instans sumber daya pada akun Azure Storage. Aturan ini memungkinkan workspace Fabric spesifik Anda untuk mengakses firewall akun penyimpanan dari pengalaman-pengalaman Fabric tertentu, seperti pintasan, pipeline, dan AzCopy. Dengan mengonfigurasi akses ruang kerja tepercaya, AzCopy dapat menyalin data dari akun Azure Storage yang mendukung firewall ke OneLake tanpa memengaruhi perlindungan firewall. Pelajari selengkapnya di akses ruang kerja tepercaya.

Memulai Langkah Awal

Jika Anda baru menggunakan AzCopy, Anda dapat mempelajari cara mengunduh dan mulai menggunakan AzCopy di Mulai menggunakan AzCopy.

Saat Anda menggunakan AzCopy dengan OneLake, ada beberapa poin penting yang perlu diingat:

  1. Tambahkan "fabric.microsoft.com" sebagai domain tepercaya menggunakan parameter --trusted-microsoft-suffixes.
  2. Pilih langganan akun Azure Storage sumber Anda saat masuk dengan ID Microsoft Entra Anda, karena OneLake hanya peduli tentang penyewa.
  3. Gunakan tanda kutip ganda saat menggunakan AzCopy di prompt perintah, dan tanda kutip tunggal saat di PowerShell.

Sampel dalam artikel ini juga mengasumsikan bahwa ID Microsoft Entra Anda memiliki izin yang sesuai untuk mengakses sumber dan tujuan.

Terakhir, Anda memerlukan setidaknya satu sumber dan tujuan untuk pergerakan data Anda - sampel di halaman ini menggunakan dua Fabric lakehouse dan satu akun ADLS.

Sampel: Menyalin data antar ruang kerja Fabric

Gunakan sampel ini untuk menyalin file dari lakehouse di satu ruang kerja ke ruang kerja yang berbeda dengan menggunakan perintah azcopy copy . Ingatlah untuk mengautentikasi terlebih dahulu dengan menjalankan azcopy login terlebih dahulu.

Sintaksis


azcopy copy "https://onelake.dfs.fabric.microsoft.com/<source-workspace-name>/<source-item-name>/Files/<source-file-path>" "https://onelake.dfs.fabric.microsoft.com/<destination-workspace-name>/<destination-item-name>/Files/<destination-file-path>" --trusted-microsoft-suffixes "fabric.microsoft.com"

Operasi salin sinkron sehingga ketika perintah kembali, semua file disalin.

Sampel: Menyalin data dari ADLS ke OneLake dengan tanda tangan akses bersama (SAS)

Tanda tangan akses bersama (SAS) menyediakan akses jangka pendek yang didelegasikan ke Azure Storage dan OneLake, dan merupakan opsi yang bagus untuk menyediakan alat atau pengguna akses sementara ke penyimpanan untuk unggahan atau unduhan satu kali. SAS juga merupakan opsi yang bagus jika akun Azure Storage berada di penyewa yang berbeda dari OneLake Anda, karena otorisasi Entra tidak akan berfungsi jika penyewa berbeda.

Sampel ini menggunakan token SAS unik untuk mengautentikasi ke Azure Storage dan OneLake. Untuk mempelajari selengkapnya tentang membuat dan menggunakan token SAS dengan Azure Storage dan OneLake, lihat halaman berikut:

Nota

Saat menggunakan token SAS untuk mengautentikasi ke OneLake di AzCopy, Anda harus mengatur parameter ''-s2s-preserve-access-tier' ke false.


azcopy copy "https://<account-name>.blob.core.windows.net/<source-container-name>/<source-file-path>?<blob-sas-token>" "https://onelake.dfs.fabric.microsoft.com/<destination-workspace-name>/<destination-item-name>/Files/<destination-file-path>?<onelake-sas-token>" --trusted-microsoft-suffixes "fabric.microsoft.com" --s2s-preserve-access-tier=false

Keterbatasan

Karena OneLake adalah data lake terkelola, beberapa operasi tidak didukung dengan AzCopy. Misalnya, Anda tidak dapat menggunakan AzCopy untuk memindahkan atau menyalin seluruh item atau ruang kerja. Sebagai gantinya, buat item baru di lokasi tujuan Anda menggunakan pengalaman Fabric (seperti portal), lalu gunakan AzCopy untuk memindahkan konten item yang ada ke item baru.

Konten terkait