Etkinliğe genel bakış

Etkinlikler, Microsoft Fabric'te uçtan uca veri iş akışları oluşturmanıza yardımcı olan yapı taşlarıdır. Bunları, verilerinizi iş gereksinimlerinizi karşılayacak şekilde taşıyıp dönüştüren görevler olarak düşünün. Verileri SQL Server'dan Azure Blob Depolama'ya taşımak için kopyalama etkinliği kullanabilirsiniz. Ardından, verileri raporlama için Azure Synapse Analytics'e yüklemeden önce işlemek ve dönüştürmek için bir Veri Akışı etkinliği veya Not Defteri etkinliği ekleyebilirsiniz.

Etkinlikler, belirli hedeflere ulaşmak için işlem hatlarında birlikte gruplandırılır. Örneğin, aşağıdaki gibi bir işlem hattı oluşturabilirsiniz:

  • Farklı kaynaklardan günlük verilerini çeker
  • Bu verileri temizler ve düzenler
  • İçgörüleri bulmak için analiz çalıştırır

Etkinliklerinizi bir işlem hattında gruplandırma, her etkinliği ayrı ayrı işlemek yerine tüm bu adımları tek bir birim olarak yönetmenize olanak tanır. İşlem hattının tamamını ihtiyacınız olduğunda çalışacak şekilde tek seferde dağıtabilir ve zamanlayabilirsiniz.

Microsoft Fabric üç tür etkinlik sunar:

Veri taşıma etkinlikleri

Bu etkinlikler, işlem hattınızdaki verileri bir yerden diğerine taşımanıza yardımcı olur.

Hareket etkinliği Description
Verileri kopyalama Desteklenen herhangi bir kaynaktan desteklenen herhangi bir hedefe veri kopyalayabilirsiniz. Nelerin kullanılabilir olduğunu görmek için Bağlayıcıya genel bakış bölümüne bakın.
İşi kopyalama Kopyalama işleri, verileri hızla taşımak için basitleştirilmiş bir yöntemdir.

Farklı veri taşıma seçenekleri arasında seçim yapmanız gerekiyorsa veri taşıma karar kılavuzu makalesine bakın.

Veri dönüştürme etkinlikleri

Bu etkinlikler verilerinizi işlemenize ve dönüştürmenize yardımcı olur. Bunları tek tek kullanabilir veya diğer etkinliklerle birlikte zincirleyebilirsiniz.

Daha fazla bilgi için veri dönüştürme etkinlikleri makalesine bakın.

Veri dönüştürme etkinliği İşlem ortamı
Verileri kopyalama Fabric tarafından hesaplama yöneticisi
Veri Akışı 2. Nesil Fabric tarafından hesaplama yöneticisi
Verileri silme Fabric tarafından hesaplama yöneticisi
Kumaş kaplı defter Fabric tarafından yönetilen Apache Spark kümeleri
HDInsight etkinliği Fabric tarafından yönetilen Apache Spark kümeleri
Spark iş tanımı Fabric tarafından yönetilen Apache Spark kümeleri
Saklı yordam Azure SQL, Azure Synapse Analytics veya SQL Server
SQL betiği Azure SQL, Azure Synapse Analytics veya SQL Server

Denetim akışı etkinlikleri

Bu etkinlikler işlem hattınızın nasıl çalıştığını denetlemenize yardımcı olur:

Denetim etkinliği Description
Ekleme değişkeni Var olan bir dizi değişkenine değer ekleyin.
Onay etkinliği İşlem hattı yürütmesini duraklatır ve belirlenen gözden geçirenlerden onay veya reddetme kararı ister.
Azure Batch etkinliği Bir Azure Batch betiği çalıştırır.
Azure Databricks etkinliği Bir Azure Databricks işi (Not Defteri, Jar, Python) çalıştırır.
Azure Machine Learning etkinliği Azure Machine Learning işini çalıştırır.
İş faaliyeti Logic Apps bağlantısı üzerinden kurumsal uygulama eylemi çalıştırır.
Etkinliği devre dışı bırakma Başka bir etkinliği devre dışı bırakır.
Fabric Actions etkinliği Bir Fabric REST API işlemi çalıştırır.
Fail İşlem hattı yürütmesinin, özelleştirilmiş bir hata iletisi ve hata koduyla başarısız olmasına neden olur.
Filter Giriş dizisine filtre ifadesi uygulama.
ForEach ForEach Etkinliği, işlem hattınızda yinelenen bir denetim akışını tanımlar. Bu etkinlik bir koleksiyon üzerinde yinelemek için kullanılır ve bir döngüde belirtilen etkinlikleri yürütür. Bu etkinliğin döngü uygulaması, programlama dillerindeki Foreach döngü yapısına benzer.
İşlevler etkinliği Bir Azure İşlevi yürütür.
Meta verileri alma GetMetadata etkinliği, Data Factory veya Azure Synapse pipeline'daki herhangi bir verinin meta verilerini almak için kullanılabilir.
If koşulu Eğer Koşulu, doğru veya yanlış olarak değerlendirilen bir koşula dayanarak dallanmak için kullanılabilir. If Koşulu etkinliği, programlama dilerindeki If deyimiyle aynı işlevselliği sağlar. Koşul true sonucunu verdiğinde bir dizi etkinliği, false sonucu verdiğinde ise başka bir dizi etkinliği değerlendirmeye alır.
İşlem hattını çağırma Execute Pipeline activity, bir Data Factory veya Azure Synapse pipeline'ın başka bir pipeline çağırmasına izin verir.
KQL etkinliği Kusto örneği üzerinde bir KQL betiği yürütür.
Lakehouse bakım etkinliği Bir göl evinde Fabric boru hattından rutin masa bakımı yapın.
Arama etkinliği Arama Etkinliği, herhangi bir dış kaynaktan kayıt, tablo adı veya değeri okumak ya da aramak için kullanılabilir. Sonraki etkinliklerde bu çıktıya daha fazla başvurulabilir.
Maddeleşmiş göl görünümü aktivitesini yenile Bir göl evinde en güncel verileri yansıtacak şekilde bir göl görünümünü yeniler.
SQL analiz uç noktası etkinliğini yenile Lakehouse SQL analitik uç noktasını en son verileri yansıtacak şekilde yeniler.
Değişken ayarlama Mevcut bir değişkenin değerini ayarlayın.
Etkinlik değiştirme İfadenin her olası sonucu için birden çok sonraki etkinlere izin veren bir anahtar ifadesi uygular.
Teams etkinliği Teams kanalında veya grup sohbetinde ileti gönderir.
Etkinliğe kadar Programlama dillerindeki do-until döngü yapısına benzer bir do-until döngüsü gerçekleştirir. Etkinlikle ilişkilendirilmiş olan koşul doğru sonucunu verene kadar bir dizi etkinliği döngüsel olarak yürütür. Until etkinliği için bir zaman aşımı değeri belirtebilirsiniz.
Bekleme etkinliği Bir pipeline'da bekleme etkinliği kullandığınızda, pipeline belirlenen süre boyunca bekler, ardından sonraki faaliyetlerin yürütülmesine devam eder.
Web etkinliği Web etkinliği, bir boru hattından özel bir REST uç noktası çağırmak için kullanılabilir.
Webhook etkinliği Web kancası etkinliğini kullanarak bir uç noktayı çağırın ve bir geri çağırma URL'si geçirin. İşlem hattının çalışması, sonraki etkinliğe geçmeden önce geri çağırmanın tetiklenmesini bekler.

Microsoft Fabric kullanıcı arabirimiyle işlem hattına etkinlik ekleme

İşlem hattınıza etkinlikleri şu şekilde ekleyebilir ve yapılandırabilirsiniz:

  1. Çalışma alanınızda yeni bir işlem hattı oluşturun.
  2. Aktiviteler sekmesine gidin ve mevcut aktivitelere göz atın. Tüm seçenekleri görmek için sağa kaydırın, ardından işlem hattı düzenleyicisine eklemek için bir etkinlik seçin.
  3. Bir etkinlik ekleyip tuvalde seçtiğinizde, genel ayarlarını aşağıdaki özellikler bölmesinde görürsünüz.
  4. Her etkinliğin özellikler bölmesindeki diğer sekmelerde başka yapılandırma seçenekleri vardır.

Etkinlikler sekmesi, araç çubuğu, kopyalama etkinliği ve özelliklerinin Genel sekmesi vurgulanmış şekilde işlem hattı düzenleyicisini gösteren ekran görüntüsü.

Genel ayarlar

İşlem hattına yeni bir etkinlik ekleyip bunu seçtiğinizde, ekranın alt kısmında bu etkinliğin özelliklerini görürsünüz. Bunlar Genel, Ayarlar ve bazen diğer sekmeleri içerir.

Etkinliğin Genel ayarlar sekmesini gösteren ekran görüntüsü.

Her etkinlik, genel ayarlardaki Ad ve Açıklama alanlarını içerir. Bazı etkinlikler şu seçeneklere de sahiptir:

Setting Description
Timeout Bir aktivitenin zaman aşımına uğramadan önce çalışabileceği süre. Varsayılan süre 12 saat olup, maksimum süre yedi gündür. D.HH:MM:SS biçimini kullanın.
Yeniden denemeleri etkinleştirme Seçildiğinde, etkinlik başarısız olursa otomatik olarak yeniden denenir.
Retry Etkinlik başarısız olursa kaç kez yeniden denenecek? Varsayılan değer 1'tir.
Yeniden deneme koşulları (önizleme) Yeniden denemeyi tetikleyen belirli hata koşullarını yapılandırın.
Yeniden deneme aralığı (sn) Yeniden deneme denemeleri arasında kaç saniye bekliyebileceği. Varsayılan değer 30 saniyedir.
(Gelişmiş özellikler) Güvenli çıkış Seçildiğinde, etkinlik çıkışı günlüklerde görünmez.
(Gelişmiş özellikler) Güvenli giriş Seçildiğinde, etkinlik girişi günlüklerde görünmez.

Note

Varsayılan olarak, işlem hattı başına en fazla 120 etkinliğiniz olabilir. Buna kapsayıcıların iç aktiviteleri dahildir.

Etkinliği yeniden deneme

İşlem hattı yürütme sırasında bir etkinlik başarısız olduğunda, çalıştırmayı başarısız olarak işaretlemeden önce otomatik olarak yeniden deneyecek şekilde yapılandırabilirsiniz. Bu özellik, ağ zaman aşımları, hizmetin geçici olarak kullanılamaması veya aralıklı bağlantı sorunları gibi geçici hataları ele almak için kullanışlıdır.

Yeniden deneme ayarları ve yeniden denemelerin nasıl yapılandırılacağı hakkında daha fazla bilgi edinin burada.

Etkinliği devre dışı bırakma

Doğrulama ve işlem hattı çalıştırmaları sırasında atlamak için işlem hattından bir veya daha fazla etkinliği devre dışı bırakabilirsiniz. Bu özellik işlem hattı geliştirici verimliliğini artırarak işlem hattının bir bölümünü tuvalden silmeden açıklama eklemenizi sağlar. Etkinlikleri daha sonra yeniden etkinleştirebilirsiniz.

Etkinlikleri devre dışı bırakma

Bir etkinliği devre dışı bırakmanın iki yolu vardır: Tek bir etkinliği Genel sekmesindendevre dışı bırakma veya sağ tıklamayla birden çok etkinliği devre dışı bırakma.

Sonraki zamanlanmış işlem hattı çalıştırması sırasında etkinlikleri devre dışı bırakmak için değişiklikleri kaydedin.

Tek bir etkinliği devre dışı bırakma

  1. Devre dışı bırakmak istediğiniz etkinliği seçin
  2. Genel sekmesinde Etkinlik durumu için Devre Dışı Bırakıldı'yı seçin
  3. Bir etkinliği olarak işaretlemek için bir durum seçin. Başarılı, Başarısız veya Atlandı arasından seçim yapın

Genel ayarlar bölmesinde ActivityDeactivated web etkinliği Etkin Değil olarak ayarlanmış olan Fabric Data Factory işlem hattı düzenleyicisinin ekran görüntüsü.

Birden çok etkinliği devre dışı bırakma

  1. Çoklu seçim yapmak için Ctrl tuşuna basın. Farenizi kullanarak, devre dışı bırakmak istediğiniz tüm etkinliklere sol tıklayın
  2. Açılan menüyü açmak için sağ tıklayın
  3. Tümünü devre dışı bırakmak için Devre Dışı Bırak'ı seçin
  4. Etkinliği işaretle ayarlarına ince ayar yapmak için etkinliğin Genel sekmesine gidin ve uygun değişiklikleri yapın.

Birden çok etkinliği aynı anda devre dışı bırakmanın ekran görüntüsü.

Etkinlikleri yeniden etkinleştirme

Etkinlikleri yeniden etkinleştirmek için Etkinlik Durumu için Etkinleştirildi'yi seçin ve beklendiği gibi önceki davranışlarına geri dönerler.

Etkin olmayan etkinlik davranışları

Etkin olmayan bir etkinlik işlem hattında farklı davranır.

  • Tuvalde etkin olmayan etkinlik gri görünür ve etkinlik türünün yanına Etkin Olmayan işareti yerleştirilir

  • Tuval üzerinde, Etkinliği şu şekilde işaretle ayarını görselleştirmek için kutuya bir durum işareti (Başarılı, Başarısız veya Atlandı) yerleştirilir.

  • Etkinlik işlem hattı doğrulamasının dışında tutulur. Bu nedenle, etkin olmayan bir etkinlik için tüm gerekli alanları sağlamanız gerekmez.

  • Hata ayıklama çalışması ve işlem hattı çalışması sırasında etkinlik yürütülmeyecektir. Bunun yerine, Etkin olmayan ayrılmış durumda bir yer tutucu satır öğesi çalıştırıyor.

  • Dallanma seçeneği, Etkinliği seçenek olarak işaretle seçeneğiyle denetleniyor. Başka bir deyişle:

    • Etkinliği Başarılı olarak işaretlerseniz UponSuccess veya UponCompletion dalı çalışır
    • Etkinliği Başarısız olarak işaretlerseniz UponFailure veya UponCompletion dalı çalışır
    • Etkinliği Atlandı olarak işaretlerseniz UponSkip dalı çalışır

    Etkin olmayan bir etkinliğin etkinlik çalıştırma durumunu gösteren ekran görüntüsü.

Devre dışı bırakma için en iyi yöntemler

Devre dışı bırakma, işlem hattı geliştiricileri için güçlü bir araçtır. Geliştiricilerin, etkinlikleri kalıcı olarak silmeden kodun bir bölümünü "yorum satırına almalarına" olanak tanır. Aşağıdaki senaryolarda parlar:

  • Bir işlem hattı geliştirirken, geliştirici tüm gerekli alanları doldurmadan önce yer tutucu etkin olmayan etkinlikler ekleyebilir. Örneğin, SQL Server'dan depoya bir Kopyalama etkinliği'e ihtiyacım var ama henüz tüm bağlantıları kurmadım. Bu nedenle yinelemeli geliştirme süreci için yer tutucu olarak etkin olmayan bir kopyalama etkinliği kullanıyorum.
  • Dağıtımdan sonra geliştirici, maliyeti yüksek tekrar denemelerden kaçınmak için sürekli sorun çıkaran bazı etkinlikleri yorum satırı hâline getirebilir. Örneğin, şirket içi SQL sunucumda ağ bağlantısı sorunları var ve kopyalama etkinliklerimin kesin olarak başarısız olduğunu biliyorum. Yeniden deneme isteklerinin kırılgan sisteme taşmasını önlemek için kopyalama etkinliğini devre dışı bırakmak isteyebilirim.

Note

Etkin olmayan bir etkinlik gerçekte hiçbir zaman çalıştırılmaz. Bu, etkinliğin hata alanına veya tipik çıkış alanlarına sahip olmayacağı anlamına gelir. Eksik alanlara yapılan tüm başvurular aşağı akışta hatalara neden olabilir.