Visual Studio Code'da Microsoft Fabric not defterleri oluşturma ve yönetme

Doku Veri Mühendisliği Visual Studio (VS) Code uzantısı, Doku'daki oluşturma, okuma, güncelleştirme ve silme (CRUD) not defteri işlemlerini tam olarak destekler. Uzantı ayrıca yerel ve uzak çalışma alanları arasında eşitlemeyi de destekler; değişiklikleri eşitlerken, yerel ve uzak çalışma alanınız arasındaki çakışmaları veya farkları giderebilirsiniz.

Bu uzantıyla, not defterlerini Fabric platformu için uzak Apache Spark hesaplaması üzerinde çalıştırabilirsiniz.

Veri Mühendisliği uzantısıyla not defteri açma

Fabric portalındaki not defteri yazma sayfasında VS Code'da Aç düğmesine tıklayarak, Veri Mühendisliği VS Code uzantısını kullanarak aynı not defterini doğrudan açabilirsiniz. Uzantıyı VS Code'da etkinleştirdikten ve not defterini bir kez açtıktan sonra çalışma alanınız otomatik olarak not defterine bağlanmalıdır.

İpucu

İlk olarak Doku Veri Mühendisliği VS Code uzantısını yüklediğinizden emin olun. Daha fazla bilgi için bkz. Doku Veri Mühendisliği VS Code uzantısını yükleme. Uzantı genel kullanıma sunulduktan sonra yükleme otomatikleştirilmiştir.

Not defterleri listesini görüntüleme

Not defteri ağacı düğümü, geçerli çalışma alanında bulunan tüm not defteri öğelerini listeler. VS Code'daki değişikliklerinize bağlı olarak, listede aşağıdaki görüntüde gösterildiği gibi en son durumu göstermek için farklı renkler ve karakterler görüntülenir.

• Varsayılan: Not defteri adının sağında beyaz metin ve sağında hiçbir karakter olmaması, varsayılan veya başlatılmış durumu gösterir. Not defteri uzak çalışma alanında bulunur ve yerel VS Code'unuza indirilmiyor.
• Değiştirildi: Adın sağındaki M karakteri ve sarı metin, not defterini VS Code'da yerel olarak indirip düzenlediğinizi ve bekleyen değişiklikleri uzak çalışma alanında henüz yayımlamadığını gösterir.
• Yerel: L karakteri ve yeşil metin, not defterinin indirilmiş olduğunu ve içeriğin uzak çalışma alanıyla aynı olduğunu gösterir.
• Çakışma: C karakteri ve kırmızı metin, yerel sürümle uzak çalışma alanı sürümü arasında çakışmalar olduğunu gösterir.

Not defteri oluşturma

1. VS Code Gezgini'nde not defteri araç çubuğunun üzerine gelin. Not Defteri Oluştur seçeneği görüntülenir.

   

2. Not Defteri Oluştur'u seçin ve bir ad ve açıklama girin. Uzak çalışma alanında yeni bir not defteri oluşturulur ve not defteri listenizde varsayılan durumda görüntülenir.

Not defteri indir

Not defterinin içeriğini düzenleyebilmeniz için önce not defterini VS Code'a indirmeniz gerekir.

1. VS Code'daki not defteri listesinde not defteri adının üzerine gelin. not defteri adının yanında İndir seçeneği görüntülenir.

   

2. İndir'i seçin ve not defterini yerel çalışma dizininize kaydedin.

Not defterini açma

1. VS Code Explorer'da, indirilen not defterinin adının üzerine gelin. Not defterinin yanında Not Defteri Klasörünü Aç seçeneği de dahil olmak üzere çeşitli seçenekler görüntülenir.

   

2. Not Defteri Klasörünü Aç'ı seçtiğinizde not defteri VS Code Düzenleyicisi ekranında açılır.

Bir defteri sil

İpucu

Başarısızlığı önlemek için, not defterini silmeden önce Gezgin görünümünde not defteri klasörünü kapatın ve düzenleyici görünümünde not defterini kapatın.

Not defterini silmek için:

1. VS Code Gezgini'nde, silmek istediğiniz not defterinin adının üzerine gelin; seçenekleri, Not Defterini Sil seçeneği de dahil olmak üzere adın sağ kısmında görünür.

   

2. Not Defterini Sil seçeneğini belirleyin. İstendiğinde, yalnızca yerel kopyayı veya hem yerel hem de uzak çalışma alanı kopyalarını silmeyi seçin.

Yerel değişiklikleri uzak çalışma alanında yayımlama

Yerel değişikliklerinizi uzak çalışma alanına göndermek için:

1. VS Code Gezgini'nde, uzak çalışma alanında yayımlamak istediğiniz not defterinin adının üzerine gelin; seçenekler, Yayımla seçeneği de dahil olmak üzere adın sağ kısmında görünür.

   

2. Yayımla'yı seçin. Uzak çalışma alanı sürümü yerel VS Code değişikliklerinizle güncelleştirilir.

   • Yerel güncelleştirmeniz herhangi bir birleştirme çakışması oluşturursa, birleştirme işlemi tamamlanmadan önce bunları çözmeniz istenir.

3. Fabric portalında aynı not defterini başka biri açtıysa, aşağıdaki görüntüde gösterildiği gibi yerel VS Code değişikliklerinizi kabul etmeleri veya reddetmeleri için bilgilendirilirler.

   

   • Kabul et: VS Code değişikliğiniz çalışma alanına başarıyla kaydedilir.
   • Reddetme: değişikliğiniz VS Code tarafından yoksayılır.

Uzak çalışma alanından değişiklikleri çekme

Yerel sürümünüzü en son çalışma alanı sürümüyle güncelleştirmek için uzak sürümü çekersiniz:

1. VS Code Gezgini'nde, güncelleştirmek istediğiniz not defterinin adının üzerine gelin; seçenekleri, Not Defterini Güncelleştir seçeneği de dahil olmak üzere adın sağ kısmında görünür.

   

2. Not Defterini Güncelleştir seçeneğini belirleyin. VS Code uzak çalışma alanından en son sürümü çeker ve iki not defteri dosyasını karşılaştırabilmeniz için VS Code fark düzenleyicisini açar. Sol taraftaki ekran çalışma alanından, sağ taraftaki ekran ise yerel sürümdendir:

   

3. Sorunu gidermek için sol taraftaki kod/markdown hücresini güncelleştirin.

4. Tüm çakışmaları ele aldıktan sonra birleştirmenin tamamlanmasını onaylamak için fark düzenleyicisinin sağ üst köşesindeki Birleştir seçeneğini belirleyin. (Birleştir seçeneğini tıklayana kadar, not defteri Çakışma modunda kalır.)

   

Uzak Spark işlemde not defterini çalıştırma veya hata ayıklama

Bu uzantıyla birlikte gönderilen synapse-spark-kernel çekirdeğini seçerek, uzak Spark hesaplama kaynağında kod hücresini çalıştırabilirsiniz. Bu çekirdeği seçtiğinizde uzantı, çalışma zamanı sırasında tüm PySpark API çağrılarını durdurur ve bunları uzak Spark işlem için karşılık gelen http çağrısına çevirir. Python kodu hala yerel ortamda yürütülür.

İlgili içerik

• Visual Studio Code'da Apache Spark iş tanımları oluşturma ve yönetme
• Visual Studio Code'da Microsoft Fabric lakehouses'u keşfedin