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

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Ç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.

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 - Alt İş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.

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

Değişken Ayarla etkinliğini sistem değişkenlerini İçerecek şekilde genişlettik İşlem Hattı Dönüş Değeri. 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 Değişken Ayarla etkinliğini işlem hattı tuvaline sürükleyin.
2. Tuvalde Henüz seçili değilse Değişken Ayarla etkinliğini 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 (4 MB) boyut sınırıyla sınırlıdır.

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'
Expression	Önceki etkinliklerden gelen çıkışa başvurmanızı sağlar. 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
Satışa Arz	Float türünde sayısal bir değer. Örneğin: 2.71828
Object	Yalnızca karmaşık kullanım örnekleri uyarır. 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"}}
]

İşlem Hattını Çağıran Değer Alınıyor

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,

• Bekleme etkinliğinin bekleme süresini tanımlamak için alt işlem hattından gelen int değeri
• Web etkinliğinin URL'sini tanımlamak için bir dize değeri
• Günlüğe kaydetme amacıyla bir betik etkinliği için ifade değeri yükü.

İşlem hattı dönüş değerlerine başvuruda bulunan iki dikkat çekici açıklama balonu vardır.

1. Nesne türü ile, @activity('İşlem Hattını Yürüt1').output.pipelineReturnValue.keyName.nextLevelKey gibi iç içe json nesnesine genişletebilirsiniz
2. Dizi türü ile, @activity('Execute Pipeline1').output.pipelineReturnValue.keyName[0] ile listede dizini belirtebilirsiniz. Sayı sıfır dizine eklenir, yani 0 ile başlar.

Not

Lütfen başvurduğunuz keyName değerinin alt işlem hattınızda bulunduğundan emin olun. ADF ifade oluşturucusu sizin için başvurusal denetimi onaylayabilir. Başvuruda bulunılan 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.

Yukarıda açıklanan çağrı işlem hattında eksik anahtar durumunu ö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ürler kullanmayı göz önünde bulundurun.

İlgili içerik

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

• Değişken Etkinliğini Ayarla
• Değişken Ekleme Etkinliği