Attività di impostazione della variabile in Azure Data FactorySet Variable Activity in Azure Data Factory

SI APPLICA A: sìAzure Data Factory sìAzure Synapse Analytics (anteprima) APPLIES TO: yesAzure Data Factory yesAzure Synapse Analytics (Preview)

Usare l'attività di impostazione della variabile per impostare il valore di una variabile esistente di tipo String, Bool o Array definita in una pipeline di Data Factory.Use the Set Variable activity to set the value of an existing variable of type String, Bool, or Array defined in a Data Factory pipeline.

Proprietà del tipoType properties

ProprietàProperty DescrizioneDescription ObbligatoriaRequired
namename Nome dell'attività nella pipelineName of the activity in pipeline yes
descriptiondescription Testo che descrive l'attivitàText describing what the activity does nono
typetype Il valore deve essere impostato su SetVariableMust be set to SetVariable yes
Valorevalue Valore letterale stringa o valore di oggetto espressione a cui è assegnata la variabile specificataString literal or expression object value that the variable is assigned to yes
variableNamevariableName Nome della variabile impostata da questa attivitàName of the variable that is set by this activity yes

Incremento di una variabileIncrementing a variable

Uno scenario comune che riguarda le variabili in Azure Data Factory consiste nell'utilizzo di una variabile come iteratore all'interno di un'attività until o foreach.A common scenario involving variables in Azure Data Factory is using a variable as an iterator within an until or foreach activity. In un'attività di impostazione della variabile non è possibile fare riferimento alla variabile da impostare nel campo value.In a set variable activity you cannot reference the variable being set in the value field. Per ovviare a questa limitazione, impostare una variabile temporanea e quindi creare una seconda attività di impostazione della variabile.To workaround this limitation, set a temporary variable and then create a second set variable activity. La seconda attività di impostazione della variabile determina il valore dell'iteratore sulla variabile temporanea.The second set variable activity sets the value of the iterator to the temporary variable.

Di seguito è riportato un esempio di questo modello:Below is an example of this pattern:

Incrementare una variabileIncrement variable

{
    "name": "pipeline3",
    "properties": {
        "activities": [
            {
                "name": "Set I",
                "type": "SetVariable",
                "dependsOn": [
                    {
                        "activity": "Increment J",
                        "dependencyConditions": [
                            "Succeeded"
                        ]
                    }
                ],
                "userProperties": [],
                "typeProperties": {
                    "variableName": "i",
                    "value": {
                        "value": "@variables('j')",
                        "type": "Expression"
                    }
                }
            },
            {
                "name": "Increment J",
                "type": "SetVariable",
                "dependsOn": [],
                "userProperties": [],
                "typeProperties": {
                    "variableName": "j",
                    "value": {
                        "value": "@string(add(int(variables('i')), 1))",
                        "type": "Expression"
                    }
                }
            }
        ],
        "variables": {
            "i": {
                "type": "String",
                "defaultValue": "0"
            },
            "j": {
                "type": "String",
                "defaultValue": "0"
            }
        },
        "annotations": []
    }
}

Passaggi successiviNext steps

Informazioni su un'attività del flusso di controllo correlato supportata da Data Factory:Learn about a related control flow activity supported by Data Factory: