Not defterlerini Azure Synapse Analytics'ten Doku'ya geçirme

Azure Synapse ve Fabric, not defterlerini destekler. Bir not defterini Azure Synapse'ten Doku'ya geçirme işlemi iki farklı yolla yapılabilir:

  • 1. Seçenek: Daha kılavuzlu ve kolaylaştırılmış bir deneyim kullanarak not defterlerini Azure Synapse'den Fabric geçirmek için geçiş yardımcısını kullanabilirsiniz.
  • 2. Seçenek: Not defterlerini Azure Synapse (.ipynb) uygulamasından dışarı aktarabilir ve Fabric (el ile) olarak içeri aktarabilirsiniz.
  • 3. Seçenek: Azure Synapse’ten notebook’ları dışa aktarmak ve bunları API’yi kullanarak Fabric’e içe aktarmak için bir betik kullanabilirsiniz.

Not defteriyle ilgili hususlar için Azure Synapse Spark ile Fabric arasındaki farklara bakın.

Önkoşullar

Henüz bir çalışma alanınız yoksa kiracınız içinde bir Fabric çalışma alanı oluşturun.

1. Seçenek: Geçiş yardımcısı kullanma

Azure Synapse'dan Fabric geçiş için migration yardımcısı kullanabilirsiniz. Notebook’ları ve ilgili kaynakları taşımaya yönelik rehberli ve sorunsuz bir deneyim sunmak için tasarlanmıştır.

2. Seçenek: Not defterini el ile dışarı ve içeri aktarma

Bir not defterini Azure Synapse'ten dışarı aktarmak için:

  1. Synapse Studio'yu açın: Azure'da oturum açın. Azure Synapse çalışma alanınıza gidin ve Synapse Studio'yu açın.
  2. Not defterini bulun: Synapse Studio'da, çalışma alanınızın Not Defterleri bölümünden dışarı aktarmak istediğiniz not defterini bulun.
  3. Not defterini dışarı aktar:
    • Dışarı aktarmak istediğiniz not defterine sağ tıklayın.
    • Dışarı Aktar>Defter (.ipynb) seçin.
    • Bir hedef klasör seçin ve dışarı aktarılan not defteri dosyası için bir ad sağlayın.
  4. Dışarı aktarma işlemi tamamlandıktan sonra, not defteri dosyasını karşıya yükleme için kullanılabilir duruma getirmeniz gerekir.

Synapse notebook dışa aktarma cihazını gösteren ekran görüntüsü.

Dışa aktarılan not defterini Fabric'te içeri aktarmak için:

  1. Fabric çalışma alanına erişin: Fabric'te oturum açın ve çalışma alanınıza erişin.
  2. Veri Mühendisliği ana sayfasına gidin: Fabric çalışma alanınıza girdikten sonra Veri Mühendisliği ana sayfasına gidin.
  3. Notebook'u içe aktar:
    • Not defterini içeri aktar. seçeneğini belirleyin. Yerel bilgisayarınızdan bir veya daha fazla mevcut not defterini Fabric çalışma alanına aktarabilirsiniz.
    • Azure Synapse Analytics'ten indirdiğiniz .ipynb not defteri dosyalarına göz atın.
    • Notebook dosyalarını seçin ve Karşıya Yükle'ye tıklayın.
  4. Defteri açın ve kullanın: İç aktarma işlemi tamamlandıktan sonra, defteri Fabric çalışma alanında açıp kullanabilirsiniz.

Not defteri içeri aktarıldıktan sonra not defteri bağımlılıklarını doğrulayın:

  • Aynı Spark sürümünü kullandığınızdan emin olun.
  • Başvurulan not defterlerini kullanıyorsanız, Fabric'te de msparkutils kullanabilirsiniz. Ancak, başka bir not defterine başvuru içeren bir not defterini içeri aktarırsanız, onu da içeri aktarmanız gerekir. Fabric çalışma alanı şu anda klasörleri desteklemediğinden, diğer klasörlerdeki not defterlerine yönelik tüm başvurular güncellenmelidir. Gerekirse not defteri kaynaklarını kullanabilirsiniz.
  • Not defteri havuza özgü kitaplıkları ve yapılandırmaları kullanıyorsa, bu kitaplıkları ve/veya yapılandırmaları da içeri aktarmanız gerekir.
  • Bağlı hizmetler, veri kaynağı bağlantıları ve bağlama noktaları.

3. Seçenek: Fabric API'sini kullanma

Geçiş için şu önemli adımları izleyin:

  • Önkoşullar.
  • 1. Adım: Not defterlerini Azure Synapse'ten OneLake'e (.ipynb) dışarı aktarma.
  • 2. Adım: Doku API'sini kullanarak not defterlerini otomatik olarak Doku'ya aktarın.

Önkoşullar

Önkoşullar, notebook’leri Fabric’e geçirmeye başlamadan önce dikkate almanız gereken eylemleri içerir.

  • Fabric çalışma alanı.
  • Henüz yoksa, çalışma alanınızda bir Fabric lakehouse oluşturun.

1. Adım: Not defterlerini Azure Synapse çalışma alanından dışarı aktarma

1. Adım'ın odak noktası, not defterlerini Azure Synapse çalışma alanından OneLake'e .ipynb biçiminde dışarı aktarmaktır. Bu işlem aşağıdaki gibidir:

  • 1.1) Geçiş not defterini Doku çalışma alanına aktarın. Bu not defteri , belirli bir Azure Synapse çalışma alanından onelake'deki bir ara dizine tüm not defterlerini dışarı aktarır. Not defterlerini dışarı aktarmak için Synapse API kullanılır.
  • 1.2) İlk komuttaki parametreleri, not defterlerini bir ara depolamaya (OneLake) dışarı aktarmak için yapılandırın. Kaynak ve hedef parametreleri yapılandırmak için aşağıdaki kod parçacığı kullanılır. Bunları kendi değerlerinizle değiştirdiğinden emin olun.
# Azure config
azure_client_id = "<client_id>"
azure_tenant_id = "<tenant_id>"
azure_client_secret = "<client_secret>"

# Azure Synapse workspace config
synapse_workspace_name = "<synapse_workspace_name>"

# Fabric config
workspace_id = "<workspace_id>"
lakehouse_id = "<lakehouse_id>"
export_folder_name = f"export/{synapse_workspace_name}"
prefix = "" # this prefix is used during import {prefix}{notebook_name}

output_folder = f"abfss://{workspace_id}@onelake.dfs.fabric.microsoft.com/{lakehouse_id}/Files/{export_folder_name}"
  • 1.3) Not defterlerini OneLake'e aktarmak için not defterini dışarı/içeri aktarma işleminin ilk iki hücresini çalıştırın. Hücreler tamamlandıktan sonra, ara çıkış dizininin altındaki bu klasör yapısı oluşturulur.

OneLake'te Not Defteri dışarı aktarma işlemini gösteren ekran görüntüsü.

2. Adım: Not defterlerini Fabric'e içe aktarma

2. adım, not defterlerinin ara depolama alanından Doku çalışma alanına aktarılmasıdır. Bu işlem aşağıdaki gibidir:

  • 2.1) 1.2. adımdaki yapılandırmaları doğrulayın; not defterlerini içeri aktarmak için doğru Fabric çalışma alanı ve ön ek değerlerinin belirtildiğinden emin olun.
  • 2.2) Tüm not defterlerini ara konumdan içeri aktarmak için dışarı/içeri aktarma not defterinin üçüncü hücresini çalıştırın.