Azure Data Factory ve Azure Synapse Analytics Değişken Etkinliğini 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.

Data Factory veya Synapse işlem hattında tanımlanan Dize, Bool veya Dizi türünde mevcut bir değişkenin değerini ayarlamak için Değişken Ayarla etkinliğini kullanın ya da işlem hattı dönüş değeri (önizleme) ayarlamak için Değişken Ayarla etkinliğini kullanın.

Kullanıcı arabirimiyle Değişken Ayarla etkinliği oluşturun

İşlem hattında Değişken Ayarla etkinliğini kullanmak için aşağıdaki adımları tamamlayın:

  1. İşlem hattı tuvalinin arka planını seçin ve değişken eklemek için Değişkenler sekmesini kullanın:

Değişkenler sekmesinin TestVariable adlı bir dizi türü değişkeniyle seçili olduğu boş bir işlem hattı tuvalinin ekran görüntüsü.

  1. İşlem hattı Etkinlikleri bölmesinde "Değişken Ayarla"yı arayın ve bir Değişken Ayarla etkinliğini işlem hattı kanvasına sürükleyin.

  2. Henüz seçili değilse tuvalde Değişken Ayarla etkinliğini seçin ve ardından ayrıntılarını düzenlemek için Ayarlar sekmesini seçin.

  3. İşlem hattı değişkeni seçeneğini Değişken türünüz olarak seçin.

  4. Name özelliğinin değişkenini seçin.

  5. Değişkenlerin değerini ayarlamak için bir ifade girin. Bu ifade değişmez bir dize ifadesi veya dinamik ifadelerin, işlevlerin, sistem değişkenlerinin veya diğer etkinliklerden gelen çıkışların herhangi bir bileşimi olabilir.

Değişken ayarla etkinliğinin kullanıcı arabiriminin ekran görüntüsü.

Kullanıcı arabirimiyle işlem hattı dönüş değeri ayarlama

Aşağıdaki senaryoda, Set Variable etkinliğini, alt işlem hattından çağıran işlem hattına iletişim sağlayan İşlem Hattı Dönüş Değeri adlı özel bir sistem değişkeni içerecek şekilde genişlettik.

Değişkeni kullanmadan önce tanımlamanız gerekmez. Daha fazla bilgi için bkz. İşlem Hattı Dönüş Değeri

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

Tür özellikleri

Özellik Açıklama Gerekli
Adı İşlem hattındaki etkinliğin adı evet
açıklama Etkinliğin ne yaptığını açıklayan metin hayır
Tip SetVariable olarak ayarlanmalıdır evet
variableName Bu etkinlik tarafından ayarlanan değişkenin adı evet
değer Değişkenin atandığı dize değişmez değeri veya ifade nesnesi değeri evet

Değişkeni artırma

Değişken içeren yaygın bir senaryo, bir değişkeni Until veya ForEach etkinliğinde yineleyici olarak kullanmaktır. Değişken ayarla etkinliğinde, value alanında ayarlanan değişkene başvuramazsınız; yani kendi kendine başvuru yapamazsınız. Bu sınırlamaya geçici bir çözüm bulmak için geçici bir değişken ayarlayın ve ardından ikinci bir Değişken ayarla etkinliği oluşturun. İkinci Değişken Ayarla etkinliği, yineleyicinin değerini geçici değişkene belirler. Aşağıda bu desenin bir örneği verilmişti:

  • İlk olarak iki değişken tanımlarsınız: biri yineleyici için, biri geçici depolama için.

Değişkenleri tanımlamayı gösteren ekran görüntüsü.

  • Ardından değerleri artırmak için iki etkinlik kullanırsınız

Artım değişkenlerini gösteren ekran görüntüsü. 

{
    "name": "pipeline1",
    "properties": {
        "activities": [
            {
                "name": "Increment J",
                "type": "SetVariable",
                "dependsOn": [],
                "policy": {
                    "secureOutput": false,
                    "secureInput": false
                },
                "userProperties": [],
                "typeProperties": {
                    "variableName": "temp_j",
                    "value": {
                        "value": "@add(variables('counter_i'),1)",
                        "type": "Expression"
                    }
                }
            },
            {
                "name": "Set I",
                "type": "SetVariable",
                "dependsOn": [
                    {
                        "activity": "Increment J",
                        "dependencyConditions": [
                            "Succeeded"
                        ]
                    }
                ],
                "policy": {
                    "secureOutput": false,
                    "secureInput": false
                },
                "userProperties": [],
                "typeProperties": {
                    "variableName": "counter_i",
                    "value": {
                        "value": "@variables('temp_j')",
                        "type": "Expression"
                    }
                }
            }
        ],
        "variables": {
            "counter_i": {
                "type": "Integer",
                "defaultValue": 0
            },
            "temp_j": {
                "type": "Integer",
                "defaultValue": 0
            }
        },
        "annotations": []
    }
}

Değişkenlerin kapsamı işlem hattı düzeyindedir. Bu, iş parçacığı güvenliği sağlamadıkları anlamına gelir ve eğer paralel bir yineleme işlemi, örneğin bir ForEach döngüsü içinde erişilirlerse, özellikle de değer bu ForEach işleminde değiştiriliyorsa, beklenmeyen ve istenmeyen davranışlara yol açabilirler.

İlgili içerik

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

  • Last updated on