Pindahkan pintasan ke wilayah baru

Pintasan di OneLake berada di wilayah yang sama dengan workspace yang memuatnya, jadi Anda tidak bisa memindahkannya ke wilayah lain secara mandiri. Untuk memindahkan pintasan, Anda perlu membuat ulang definisi pintasan di ruang kerja Fabric di wilayah tujuan. Karena pintasan adalah referensi logis ke data, bukan salinannya, proses ini memindahkan referensi tanpa memindahkan data dasar.

Lokasi di mana pintasan muncul adalah jalur pintasan. Lokasi data yang ditunjuk pintasan adalah jalur target. Artikel ini menggunakan tujuan untuk wilayah dan workspace tempat Anda membuat ulang jalur pintasan.

Di Fabric, ruang kerja berada dalam kapasitas tertentu, dan setiap kapasitas berada di satu wilayah. Kapasitas yang Anda tetapkan untuk workspace menentukan wilayahnya. Meskipun Anda dapat memindahkan beberapa workspace ke wilayah lain dengan menugaskannya kembali ke kapasitas di wilayah tersebut, Anda harus terlebih dahulu menghapus item yang tidak mendukung penugasan ulang. Untuk informasi lebih lanjut, lihat Pembatasan penugasan ulang kapasitas dan masalah umum.

Pintasan OneLake adalah objek yang berada di dalam lakehouse atau database KQL. Karena item-item ini tidak mendukung penugasan ulang workspace, memindahkan workspace yang ada akan mengharuskan Anda menghapusnya dan shortcut terlebih dahulu. Artikel ini sebaliknya menggunakan workspace tujuan terpisah sehingga Anda dapat mempertahankan sumber daya asli hingga Anda memvalidasi pintasan yang dibuat ulang dan konsumen hilir.

Artikel ini menjelaskan cara merencanakan relokasi, membuat ulang pintasan Anda di wilayah tujuan, memperbarui konsumen hilir, dan memvalidasi hasilnya.

Prasyarat

Sebelum memulai, pastikan bahwa:

  • Workspace Fabric disediakan di wilayah tujuan.
  • Kapasitas Fabric ditetapkan ke workspace tujuan.
  • Anda memiliki izin untuk administrasi workspace Fabric dan akses ke data di jalur target pintasan.
  • Jalur target pintasan dapat diakses dari wilayah tujuan.

Rencanakan waktu henti

Proses ini tidak memerlukan waktu henti platform Fabric. Namun, pengguna mungkin mengalami ketidaktersediaan data sementara selama jendela migrasi sampai Anda membuat ulang pintasan dan memperbarui koneksi.

Prepare

Sebelum Anda memindahkan pintasan Anda, dokumentasikan konfigurasi yang ada dan identifikasi ketergantungan hilir.

Tinjau konfigurasi pintasan

  1. Identifikasi semua pintasan di workspace asli. Untuk mencantumkan pintasan secara programatik, panggil List Shortcuts REST API untuk setiap lakehouse atau database KQL. Untuk menemukan item-item tersebut di seluruh workspace, gunakan katalog OneLake dan API REST Fabric.
  2. Dokumentasikan detail setiap pintasan, termasuk:
    • Jalur pintasan di database lakehouse atau KQL.
    • Jenis target dan jalur.
    • Referensi autentikasi atau kredensial.
  3. Validasi bahwa data di setiap jalur target dapat diakses.

Identifikasi ketergantungan hilir

Identifikasi beban kerja yang mengonsumsi data pintasan, seperti:

  • Model semantik Power BI.
  • Fabric data agents.
  • Fabric notebooks.
  • Alur.
  • Endpoint analitik SQL.

Untuk melihat bagaimana item di workspace mengonsumsi data pintasan, gunakan tampilan garis keturunan workspace.

Untuk menghindari pergeseran konfigurasi, bekukan perubahan pada konfigurasi pintasan selama jendela migrasi.

Siapkan ruang kerja tujuan

  1. Sediakan ruang kerja Fabric di wilayah tujuan.
  2. Buat setiap database lakehouse atau KQL tujuan yang akan berisi pintasan yang dibuat ulang. Buat ulang folder yang diperlukan agar Anda dapat menggunakan jalur pintasan yang terdokumentasi.
  3. Konfigurasikan peran yang diperlukan untuk membuat pintasan di setiap item tujuan. Untuk detailnya, lihat Buat dan hapus pintasan.

Buat ulang pintasan antar ruang kerja Fabric

Buat ulang pintasan internal OneLake di workspace tujuan dengan menggunakan portal Fabric atau API REST.

Untuk membuat ulang pintasan di portal Fabric, ikuti langkah-langkah dalam artikel create untuk sumber tersebut, seperti Buat pintasan internal OneLake, Buat pintasan Azure Data Lake Storage Gen2, atau Buat pintasan Amazon S3. Untuk daftar lengkap sumber eksternal yang didukung, lihat Jenis pintasan.

Untuk workspace dengan banyak pintasan, yang umum terjadi pada relokasi lintas wilayah, gunakan API REST pintasan OneLake sebagai pengganti portal. API REST mendukung pembuatan programatik dan lebih efisien untuk diotomatisasi dalam skala besar.

Buat ulang pintasan ke penyimpanan eksternal

Koneksi penyimpanan eksternal, seperti Azure Data Lake Storage (ADLS) Gen2 dan Amazon S3, bersifat tenant-scope dan tidak terikat pada wilayah Fabric tertentu. Gunakan kembali koneksi yang Anda buat di workspace asli saat Anda membuat ulang pintasan di workspace tujuan. Anda tidak perlu membuat ulang kredensial atau objek koneksi karena relokasi lintas wilayah, selama akun penyimpanan atau bucket yang mendasarinya tidak berubah.

Jika akun penyimpanan eksternal berada di wilayah yang berbeda dari kapasitas Fabric tujuan, setiap kueri menarik data melintasi batas wilayah dengan harga latensi dan egress lintas wilayah. Jika memungkinkan, sesuaikan wilayah akun penyimpanan dengan wilayah kapasitas Fabric tujuan untuk menghindari biaya tersebut.

Perbarui konsumen hilir

Pintasan yang dibuat ulang dan item yang berisi adalah sumber daya baru, meskipun nama, jalur pintasan, dan jalur targetnya sesuai dengan sumber daya asli. Sebelum validasi, perbarui item hilir agar menggunakan workspace tujuan dan item.

  1. Perbarui binding sumber data untuk item hilir, termasuk model semantik dan agen data Fabric, sehingga mereka menggunakan item tujuan dan pintasan yang dibuat ulang.
  2. Perbarui referensi yang sudah dikodekan, seperti ID workspace, ID item, nama lakehouse, dan jalur folder, dalam notebook, pipeline, dan model semantik.
  3. Segarkan metadata atau skema yang di-cache pada item hilir agar mereka menemukan pintasan yang dibuat ulang.
  4. Konfigurasikan izin yang diperlukan untuk mengakses pintasan baru. Konsumen membutuhkan akses baca ke jalur pintasan. Jalur target tidak bergerak, jadi izin yang ada tidak perlu dibuat ulang. Untuk detail, lihat Model otentikasi pintasan.

Tetap tersedia workspace dan pintasan asli selama validasi. Jika Anda mengalami masalah, arahkan konsumen kembali ke workspace asli.

Validate

Setelah Anda memperbarui dependensi hilir, validasi pintasan yang dibuat ulang dan konsumen yang sekarang merujuknya. Pertahankan workspace asli hingga Anda menyelesaikan validasi dan memastikan bahwa lingkungan tujuan sehat.

Validasi pintasan

  • Pastikan pintasan berhasil teratasi.
  • Validasi visibilitas skema dan metadata.
  • Untuk pintasan di lakehouse, pastikan Anda dapat melakukan query data melalui lakehouse, endpoint SQL analytics, atau Apache Spark.
  • Untuk pintasan di database KQL, pastikan Anda dapat melakukan query data dengan menggunakan fungsi tersebutexternal_table().
  • Konfirmasi bahwa Anda telah membuat ulang setiap pintasan dengan membandingkan jumlah pintasan di workspace tujuan dengan inventaris asli Anda menggunakan API REST List Shortcuts.

Validasi konsumen hilir

  • Validasi kueri Power BI, dan segarkan model semantik yang bergantung pada data pintasan. Pastikan setiap model semantik menggunakan pintasan yang dibuat ulang. Untuk opsi penyegaran, lihat Penyegaran data di Power BI.
  • Validasi respons agen data Fabric terhadap setiap sumber data rebound.
  • Validasi notebook dan pipeline yang mengonsumsi data pintasan.
  • Validasi alur kerja analitik end-to-end.
  • Tinjau akses data melalui pintasan yang dibuat ulang dengan OneLake Diagnostics atau log audit Fabric.

Note

Tinjau persyaratan wilayah dan perilaku model semantik Direct Lake sebelum Anda memperbarui binding sumber data mereka. Tergantung pada konfigurasi Anda, Anda mungkin perlu mengikat ulang atau membuat ulang model semantik yang bergantung pada lakehouse tujuan. Untuk informasi selengkapnya, lihat Gambaran umum Direct Lake.

Bersihkan sumber daya asli

Dapatkan persetujuan fungsional dan bisnis sebelum Anda membersihkan sumber daya asli.

Setelah migrasi dan validasi yang sukses:

  1. Hapus pintasan dari workspace asli. Untuk menghapus pintasan secara programatik, gunakan Delete Shortcut REST API. Untuk langkah-langkah portal, lihat Edit atau hapus pintasan.
  2. Arsipkan dokumentasi konfigurasi pintasan.
  3. Perbarui diagram arsitektur dan prosedur operasi standar Anda.

Important

Hapus pintasan asli hanya setelah validasi dan persetujuan bisnis.

Limitations

  • Pintasan OneLake tidak mendukung relokasi lintas wilayah secara langsung. Anda harus membuat ulang definisi pintasan di workspace tujuan.
  • Riwayat metadata pintasan tidak dipertahankan setelah relokasi.
  • Dukungan penulisan bervariasi tergantung jenis pintasan. Pintasan OneLake dan ADLS Gen2 mendukung operasi baca dan tulis, termasuk menulis ke tabel dan file Delta. Pintasan Amazon S3 dan Google Cloud Storage hanya bisa dibaca.
  • Di folder Tabel lakehouse, Anda hanya dapat membuat pintasan di tingkat atas. Pintasan di subdirektori folder Tables tidak didukung.
  • Jalan pintas adalah tautan simbolik yang independen dari targetnya. Pintasan akan terputus jika jalur target dipindahkan, diganti nama, atau dihapus.
  • Menghapus pintasan hanya menghilangkan objek pintasan. Data di lokasi target tidak terpengaruh.
  • Shortcut bukanlah solusi pemulihan bencana atau failover. Akses lintas wilayah ke sumber data eksternal dapat menimbulkan latensi dan biaya keluar data, tergantung pada lokasi penyimpanan.

Konten terkait

  • Terakhir diperbarui pada