Not defteri çalıştırarak verileri dönüştürme

Microsoft Fabric'de oluşturduğunuz notebooks çalıştırmak için Data Factory işlem hatlarınızın bir parçası olarak Notebook etkinliğini kullanın. Not defterleri , verilerinizi veri iş akışlarınızın bir parçası olarak getirmek, temizlemek veya dönüştürmek için Apache Spark işleri çalıştırmanıza olanak tanır. Fabric'da işlem hatlarınıza Not Defteri etkinliği eklemek kolaydır ve bu kılavuz her adımda size yol gösterir.

Önkoşullar

Başlamak için aşağıdaki önkoşulları tamamlamanız gerekir:

• Microsoft Fabric üzerinde tanımlanmış bir kapasite bulunan bir kiracıya erişiminiz olmalıdır. Fabric'i ücretsiz deneme ile deneyin.
• O kapasiteye atanan bir Fabric çalışma alanı.

• Çalışma alanınızda bir not defteri oluşturulur. Yeni not defteri oluşturmak için bkz. >Microsoft Fabric not defterleri oluşturma.

Not defteri etkinliği oluşturma

1. Çalışma alanınızda yeni bir işlem hattı oluşturun.

2. İşlem hattı Etkinlikleri bölmesinde Not Defteri'ni arayın ve bunu seçerek işlem hattı tuvaline ekleyin.

   

3. Henüz seçili değilse tuvaldeki yeni Not Defteri etkinliğini seçin.

   

   Genel ayarlar sekmesini yapılandırmak için Genel ayarlar kılavuzuna bakın.

Not defteri ayarlarını yapılandırma

Ayarlar sekmesini seçin.

Bağlantı'nın altında, not defteri çalıştırması için kimlik doğrulama yöntemini seçin ve gerekli kimlik bilgilerini sağlayın.

Not Defteri açılan listesinden mevcut bir not defterini seçin ve isteğe bağlı olarak not defterine geçireceğiniz parametreleri belirtin.

Not Defteri etkinliğinde Fabric Çalışma Alanı Kimliğini (WI) kullanma

1. Çalışma Alanı Kimliği Oluşturma

   Çalışma alanınızda WI'yi etkinleştirmeniz gerekir (bu işlemin yüklenmesi biraz zaman alabilir). Fabric çalışma alanınızda bir Çalışma Alanı Kimliği oluşturun. Unutmayın, WI'nizin Pipeline'ınızla aynı çalışma alanında oluşturulması gerekmektedir.

   Çalışma Alanı Kimliği ile ilgili belgelere göz atın.

2. Kiracı düzeyi ayarlarını etkinleştirme

   Aşağıdaki kiracı ayarını etkinleştirin (varsayılan olarak devre dışıdır): Hizmet sorumluları Fabric genel API'leri çağırabilir.

   Bu ayarı Fabric yönetici portalında etkinleştirebilirsiniz. Bu ayar hakkında daha fazla bilgi için yönetici API'leri için service principal kimlik doğrulamasını etkinleştirme makalesine bakın.

3. Çalışma Alanı Kimliğine çalışma alanı izinleri verme

   Çalışma alanını açın, Erişimi yönet'i seçin ve Çalışma Alanı Kimliği'ne izinler atayın. Çoğu senaryo için katkıda bulunma yetkisi yeterlidir. Not Defteriniz İşlem Hattınızla aynı çalışma alanında değilse, İşlem Hattınızın çalışma alanında oluşturduğunuz WI'yi en azından Not Defterinizin çalışma alanına Katkıda Bulunan erişimi olarak atamanız gerekir.

   Kullanıcılara çalışma alanlarına erişim verme sayfasındaki belgelere göz atın.

Not Defteri etkinliği için temel parametreleri otomatik olarak doldurma

Temel parametreleri otomatik olarak doldur , not defterinde tanımlanan parametreleri otomatik olarak bulur ve işlem hattı yazma sırasında bunları Not Defteri etkinliğine doldurur. Bu özellik el ile yapılandırmayı azaltır, hataları önler ve işlem hatlarını not defteri mantığıyla uyumlu tutar.

Önkoşullar

• Not defteriniz bir parametre hücresi içermelidir.
• Yalnızca bu hücrede tanımlanan değişkenler parametre olarak algılandı.

Nasıl çalışır?

Not Defteri etkinliğinde bir not defteri seçtiğinizde:

• Ayarlar'da Temel parametrelere geçtiğinizde sistem not defterinden parametreleri otomatik olarak alır.
• Temel parametreler bölümü aşağıdakilerle doldurulur:
  • Names
  • Türler
  • Varsayılan değerler

Otomatik doldurulan parametreleri gözden geçirebilir ve (isteğe bağlı olarak) parametre değerlerini geçersiz kılabilirsiniz.

Temel davranışlar

• Bir not defteri seçtiğinizde parametreler otomatik olarak doldurulur.
• Not defterlerinin değiştirilmesi parametre listesini yeniler.
• Parametre hücresi yok → hiçbir parametre doldurulmaz.

Oturum etiketini ayarlama

Not defteri işinizi yürütmek için gereken süreyi en aza indirmek için isteğe bağlı olarak bir oturum etiketi ayarlayabilirsiniz. Oturum etiketini ayarlamak Spark'a mevcut Spark oturumlarını yeniden kullanma talimatı ve bu da başlangıç süresini en aza indirir. Oturum etiketi için herhangi bir rastgele dize değeri kullanılabilir. Oturum yoksa etiket değeri kullanılarak yeni bir oturum oluşturulur.

Not

Oturum etiketini kullanabilmek için birden çok not defteri çalıştıran işlem hattı için yüksek eşzamanlılık modu seçeneğinin açık olması gerekir. Bu seçenek Spark ayarları için Yüksek eşzamanlılık modu altında Çalışma Alanı ayarları altında bulunabilir

İşlem hattını kaydetme ve çalıştırma veya zamanlama

İşlem hattı düzenleyicisinin üst kısmındaki Giriş sekmesine geçin ve işlem hattınızı kaydetmek için kaydet düğmesini seçin. Doğrudan çalıştırmak için Çalıştır'ı veya belirli zamanlarda veya aralıklarda çalıştırmaları zamanlamak için Zamanla'yı seçin. İşlem hattı çalıştırmaları hakkında daha fazla bilgi için bkz. İşlem hattı çalıştırmalarını zamanlama.

Çalıştırdıktan sonra, tuvalin altındaki Çıkış sekmesinden işlem hattı yürütmesini izleyebilir ve çalıştırma geçmişini görüntüleyebilirsiniz.

Bilinen sorunlar

• AnlamSal Bağlantı kodu içeren bir not defterini çalıştırmak için Hizmet Sorumlusu'nun kullanılması işlevsel sınırlamalara sahiptir ve yalnızca semantik bağlantı özelliklerinin bir alt kümesini destekler. Ayrıntılar için desteklenen anlamsal bağlantı işlevlerine bakın. Diğer özellikleri kullanmak için hizmet sorumlusuyla semantik bağlantının kimliğini el ile doğrulamanız önerilir.
• Notebook etkinliği, bölgeler arası notebook’leri çağırmayı desteklemez.

İlgili içerik

• İşlem hattı çalıştırmalarını nasıl izleriz