Folyamat visszatérési értékének beállítása az Azure Data Factoryben és az Azure Synapse Analyticsben

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

A hívófolyamat-gyermek folyamat paradigmában a Változó beállítása tevékenység használatával visszaadhatja a gyermekfolyamat értékeit a hívási folyamatnak. A következő forgatókönyvben egy gyermekfolyamatot futtatunk a folyamattevékenység végrehajtásával. Szeretnénk lekérni az adatokat a gyermekfolyamatból, majd használni a hívó folyamatban.

A folyamat visszatérési értéke, a kulcsértékpárok szótára, amely lehetővé teszi a gyermekfolyamatok és a szülőfolyamatok közötti kommunikációt.

Előfeltétel – Gyermekfolyamat meghívása

Előfeltételként a tervezéshez gyermekfolyamatot hívó folyamat-végrehajtási tevékenységre van szükség, és a tevékenységen engedélyezve van a várakozás a befejezéskor .

Folyamat visszatérési értékének konfigurálása gyermekfolyamatban

A Változó beállítása tevékenységet kibontottuk, hogy tartalmazza a rendszerváltozók folyamat-visszatérési értékét. Ezeket nem kell folyamatszinten definiálnia (szemben a folyamatban használt többi változóval).

1. Keresse meg a Változó beállítása lehetőséget a folyamattevékenységek panelen, és húzza a Változó beállítása tevékenységet a folyamatvászonra.
2. Ha még nincs kijelölve, jelölje ki a változó beállítása tevékenységet a vásznon, majd a Változók lapon szerkessze a részleteket.
3. Válassza ki a folyamat visszatérési értékét a változótípushoz.
4. Új kulcsértékpár hozzáadásához válassza az Új lehetőséget.
5. A hozzáadható kulcs-érték párok számát csak a visszaadott JSON méretkorlátja (4 MB) korlátozza.

Az értéktípusoknak van néhány lehetősége, többek között

Az objektumtípus értéke a következőképpen van definiálva:

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

Érték lekérése a hívási folyamatban

A gyermekfolyamat folyamatvisszaadási értéke lesz a folyamat-végrehajtási tevékenység tevékenységkimenete. Az adatokat a @activity('Execute Pipeline1').output.pipelineReturnValue.keyName fájllal kérdezheti le. A használati eset korlátlan. Használhatja például a

• A gyermekfolyamatból származó int érték a várakozási tevékenység várakozási időszakának meghatározásához.
• A webes tevékenység URL-címének meghatározására szolgáló sztringérték.
• Kifejezésérték hasznos adat egy szkripttevékenységhez naplózási célokra.

A folyamat visszatérési értékeire való hivatkozás két észrevehető ábrafeliratot tartalmaz.

1. Objektumtípussal tovább bővítheti a beágyazott json objektumot, például @activity('Execute Pipeline1').output.pipelineReturnValue.keyName.nextLevelKey
2. Tömbtípussal megadhatja az indexet a listában @activity('Execute Pipeline1').output.pipelineReturnValue.keyName[0]. A szám nulla indexelt, ami azt jelenti, hogy 0-val kezdődik.

Speciális szempontok

• Bár egy folyamatban több folyamat visszatérési értékének beállítása is szerepelhet, fontos, hogy csak az egyik legyen végrehajtva a folyamatban.

  

  A korábban ismertetett hiányzó kulcsproblémák elkerülése érdekében javasoljuk, hogy a gyermekfolyamat összes ágához ugyanazt a kulcslistát használja. Érdemes lehet null típusú kulcsokat használni olyan kulcsokhoz, amelyek nem rendelkeznek értékekkel egy adott ágban.

• Az Azure Data Factory kifejezési nyelve nem támogatja közvetlenül a beágyazott JSON-objektumokat. Ehelyett sztringeket és kifejezéseket kell megfelelően összefűzni.

  Például a következő JSON-kifejezéshez:

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

  Egyenértékű Azure Data Factory-kifejezés a következő:

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

Kapcsolódó tartalom

További információ egy másik kapcsolódó vezérlőfolyamat-tevékenységről:

• Változótevékenység beállítása
• Változó tevékenység hozzáfűzése