Azure Data Factory ve Azure Synapse Analytics İşlem Hattı Dönüş Değerini Ayarlama

ŞUNLARA UYGULANIR: Azure Data Factory Azure Synapse Analytics

İpucu

Microsoft Fabric'daki Data Factory, daha basit bir mimariye, yerleşik yapay zekaya ve yeni özelliklere sahip yeni nesil Azure Data Factory. Veri tümleştirmeyi yeni kullanmaya başladıysanız Fabric Data Factory ile başlayın. Mevcut ADF iş yükleri veri bilimi, gerçek zamanlı analiz ve raporlama genelinde yeni özelliklere erişmek için Fabric yükseltebilir.

Çağıran işlem hattı-alt işlem hattı paradigmasında , alt işlem hattından çağıran işlem hattına değer döndürmek için Değişken Ayarla etkinliğini kullanabilirsiniz. Aşağıdaki senaryoda İşlem Hattı Yürütme Etkinliği aracılığıyla bir alt işlem hattımız vardır. Daha sonra çağrı işlem hattında kullanılmak üzere alt işlem hattından bilgi almak istiyoruz.

ExecutePipeline Etkinliği ile ekran görüntüsü.

Alt işlem hatları ile üst işlem hattı arasındaki iletişimlere olanak tanıyan anahtar değer çiftlerinin sözlüğü olan işlem hattı dönüş değerini tanıtın.

Önkoşul - Çocuk İşlem Hattını Çağırma

Önkoşul olarak tasarımınız alt işlem hattını çağıran bir İşlem Hattı Yürütme Etkinliğine ihtiyaç duyar ve etkinlikte Tamamlanmasını Bekle özelliği etkindir.

İşlemin tamamlanmasını beklemek için ExecutePipeline Etkinliği ayarının ekran görüntüsü.

Alt İşlem Hattında İşlem Hattı Dönüş Değerini Yapılandırma

Değişken Ayarla etkinliğini sistem değişkeni İşlem Hattı Dönüş Değerini içerecek şekilde genişlettik. Bunları işlem hattı düzeyinde tanımlamanız gerekmez (işlem hattında kullandığınız diğer değişkenlerin aksine).

  1. İşlem hattı Etkinlikleri bölmesinde Değişken Ayarla'yı arayın ve bir Değişken Ayarla etkinliğini işlem hattı tuvaline sürükleyin.
  2. Değişken Ayarla etkinliği zaten seçili değilse, tuvalde seçin ve ayrıntılarını düzenlemek için Değişkenler sekmesini seçin.
  3. Değişken türü için İşlem hattı dönüş değeri'ni seçin.
  4. Yeni bir anahtar değer çifti eklemek için Yeni'yi seçin.
  5. Eklenebilecek anahtar-değer çiftlerinin sayısı yalnızca döndürülen JSON'un boyut sınırıyla (4 MB) sınırlıdır.

İşlem hattı dönüş değerinin arayüzünü gösteren ekran görüntüsü.

Değer türleri için birkaç seçenek vardır;

Tür Adı Açıklama
String Sabit dize değeri. örneğin: 'ADF harika'
İfade Önceki etkinliklerin çıktısına başvurmanıza olanak tanır. gibi "The value is @{guid()}"satır içi ifade değerlerini eklemek için burada dize ilişkilendirmesini kullanabilirsiniz.
Dizi Dize değerleri dizisi bekler. Dizideki değerleri ayırmak için "enter" tuşuna basın
Boolean Doğru veya Yanlış
Boş Sinyal yeri tutucu durumu; değer sabit null
Int Tamsayı türünde sayısal bir değer. Örneğin: 42
Halka Arz Float türünde sayısal bir değer. Örneğin: 2.71828
Nesne Yalnızca karmaşık kullanım örnekleri için uyarı. Değer için anahtar değer çiftleri türü listesini eklemenizi sağlar

Nesne türünün değeri aşağıdaki gibi tanımlanır:

[{"key": "myKey1", "value": {"type": "String", "content": "hello world"}}, 
 {"key": "myKey2", "value": {"type": "String", "content": "hi"}}
]

Çağrı Boru Hattında Değerin Alınması

Alt işlem hattının işlem hattı dönüş değeri, İşlem Hattı Yürütme Etkinliğinin etkinlik çıkışı olur. bilgileri @activity('Execute Pipeline1').output.pipelineReturnValue.keyName ile alabilirsiniz. Kullanım örneği sınırsızdır. Örneğin, kullanabilirsiniz.

Arama işlem hattını gösteren ekran görüntüsü.

İşlem hattı dönüş değerlerine referans verirken iki dikkat çekici açıklama vardır.

  1. Nesne türü ile, @activity('Execute Pipeline1').output.pipelineReturnValue.keyName.nextLevelKey gibi iç içe geçmiş json nesnesine genişleyebilirsiniz.
  2. Dizi türüyle, @activity('Execute Pipeline1').output.pipelineReturnValue.keyName[0] ifadesiyle listede dizini belirtebilirsiniz. Sayı sıfır dizine eklenir, yani 0 ile başlar.

Not

Lütfen keyName’in alt işlem hattınızda bulunduğundan emin olun. ADF ifade oluşturucusu sizin için referans denetlemesini onaylayamaz. Referans verilen anahtar yükte eksikse, İşlem Hattı başarısız olur.

Dikkat Edilmesi Gereken Özel Noktalar

  • bir işlem hattına birden çok İşlem Hattı Dönüş Değeri Ayarla etkinliğini dahil edebilirsiniz ancak işlem hattında bunlardan yalnızca birinin yürütülmesini sağlamak önemlidir.

    İşlem Hattı Dönüş Değeri ve Dallanma Gösteren Ekran Görüntüsü.

    Çağrı işlem hattını çalıştırırken daha önce açıklanan eksik anahtar sorununu önlemek için, alt işlem hattındaki tüm dallar için aynı anahtar listesine sahip olmanız önerilir. Belirli bir dalda değerleri olmayan anahtarlar için null türlerini kullanmayı göz önünde bulundurun.

  • Azure Data Factory ifade dili satır içi JSON nesnelerini doğrudan desteklemez. Bunun yerine, dizeleri ve ifadeleri düzgün bir şekilde birleştirmek gerekir.

    Örneğin, aşağıdaki JSON ifadesi için:

    {
  "datetime": "@{utcnow()}",
  "date": "@{substring(utcnow(),0,10)}",
  "year": "@{substring(utcnow(),0,4)}",
  "month": "@{substring(utcnow(),5,2)}",
  "day": "@{substring(utcnow(),8,2)}"
}

    Eşdeğer bir Azure Data Factory ifadesi şöyle olabilir:

    @{
  concat(
    '{',
    '"datetime": "', utcnow(), '", ',
    '"date": "', substring(utcnow(),0,10), '", ',
    '"year": "', substring(utcnow(),0,4), '", ',
    '"month": "', substring(utcnow(),5,2), '", ',
    '"day": "', substring(utcnow(),8,2), '"',
    '}'
  )
}

İlgili içerik

Başka bir ilgili denetim akışı etkinliği hakkında bilgi edinin:

  • Last updated on