Rendszerváltozók

A következőkre vonatkozik:SQL Server SSIS integrációs futtatókörnyezet az Azure Data Factory-ban

Az SQL Server Integration Services rendszerváltozók készletét biztosítja, amelyek információkat tárolnak a futó csomagról és annak objektumairól. Ezek a változók kifejezésekben és tulajdonságkifejezésekben használhatók csomagok, tárolók, feladatok és eseménykezelők testreszabására.

A rendszer és a felhasználó által definiált összes változó használható azon paraméterkötésekben, amelyeket az SQL-feladat végrehajtása a változók paraméterekhez való leképezéséhez használ.

Rendszerváltozók csomagokhoz

Az alábbi táblázat a csomagokhoz az Integration Services által biztosított rendszerváltozókat ismerteti.

Rendszerváltozó	Adattípus	Description
CancelEvent	Int32	A Windows-eseményobjektum leírója, amelyet a feladat használhat arra, hogy jelezze, amikor a feladatnak le kell állnia.
ContainerStartTime	DateTime	A konténer indulási időpontja.
CreationDate	DateTime	A csomag létrehozásának dátuma.
CreatorComputerName	Lánc	Az a számítógép, amelyen a csomag létre lett hozva.
CreatorName	Lánc	A csomagot létrehozó személy neve.
ExecutionInstanceGUID	Lánc	A csomag végrehajtó példányának egyedi azonosítója.
SikertelenKonfigurációk	Lánc	A sikertelen csomagkonfigurációk neve.
IgnoreConfigurationsOnLoad	logikai	Azt jelzi, hogy a csomagkonfigurációk figyelmen kívül lesznek-e hagyva a csomag betöltésekor.
InteractiveMode	logikai	Azt jelzi, hogy a csomag interaktív módban fut-e. Ha egy csomag az SSIS Designerben fut, ez a tulajdonság Igaz értékre van állítva. Ha egy csomag a DTExec parancssori segédprogrammal fut, a tulajdonság értéke False ( Hamis).
Területi azonosító	Int32	A csomag által használt területi beállítás.
MachineName	Lánc	Annak a számítógépnek a neve, amelyen a csomag fut.
OfflineMode	logikai	Azt jelzi, hogy a csomag offline módban van-e. Az offline mód nem szerez be kapcsolatokat az adatforrásokkal.
PackageID	Lánc	A csomag egyedi azonosítója.
PackageName	Lánc	A csomag neve.
StartTime	DateTime	A csomag futásának időpontja.
ServerExecutionID	Int64	Az Integration Services-kiszolgálón végrehajtott csomag végrehajtási azonosítója. Az alapértelmezett érték nulla. Az érték csak akkor módosul, ha a csomagot az ISServerExec hajtja végre az Integration Services-kiszolgálón. Gyermekcsomag esetén az érték a szülőcsomagból a gyermekcsomagba kerül.
UserName	Lánc	A csomagot létrehozó felhasználó fiókja. A felhasználónevet a tartománynév minősíti.
VersionBuild	Int32	A csomag verziója.
VersionComment	Lánc	Megjegyzések a csomag verziójával kapcsolatban.
VersionGUID	Lánc	A verzió egyedi azonosítója.
VersionMajor	Int32	A csomag főverziója.
VersionMinor	Int32	A csomag alverziója.

Tárolók rendszerváltozói

Az alábbi táblázat a For Loop, a Foreach Loop és a Sequence tárolók számára az Integration Services által biztosított rendszerváltozókat ismerteti.

Rendszerváltozó	Adattípus	Description	Konténer
Területi azonosító	Int32	A tároló által használt lokalizáció.	Huroktároló esetén Foreach Loop-tároló Szekvenciatároló

Rendszerváltozók feladatokhoz

Az alábbi táblázat az Integrációs szolgáltatások által a feladatokhoz biztosított rendszerváltozókat ismerteti.

Rendszerváltozó	Adattípus	Description
Létrehozás neve	Lánc	A feladat neve.
Területi azonosító	Int32	A feladat által használt helyi beállítás.
TaskID	Lánc	Egy feladatpéldány egyedi azonosítója.
TaskName	Lánc	A feladatpéldány neve.
TaskTransactionOption	Int32	A tevékenység által használt tranzakciós lehetőség.

Rendszerváltozók eseménykezelőkhöz

Az alábbi táblázat azOkat a rendszerváltozókat ismerteti, amelyeket az Integration Services biztosít az eseménykezelők számára. Nem minden változó érhető el minden eseménykezelő számára.

Rendszerváltozó	Adattípus	Description	Eseménykezelő
Mégse	logikai	Azt jelzi, hogy az eseménykezelő leáll-e hiba, figyelmeztetés vagy lekérdezéslemondás esetén.	OnError eseménykezelő OnWarning eseménykezelő OnQueryCancel eseménykezelő
ErrorCode	Int32	A hibaazonosító.	OnError eseménykezelő OnInformation eseménykezelő OnWarning eseménykezelő
Hibaleírás	Lánc	A hiba leírása.	OnError eseménykezelő OnInformation eseménykezelő OnWarning eseménykezelő
ExecutionStatus	logikai	Az aktuális végrehajtási állapot.	OnExecStatusChanged eseménykezelő
ExecutionValue	DBNull	A végrehajtási érték.	OnTaskFailed eseménykezelő
Területi azonosító	Int32	Az eseménykezelő által használt helyi beállítás.	Minden eseménykezelő
Százalékkiegészítés	Int32	A befejezett munka százalékos aránya.	OnProgress eseménykezelő
ProgressCountHigh	Int32	A 64 bites érték nagy része, amely az OnProgress esemény által feldolgozott műveletek teljes számát jelzi.	OnProgress eseménykezelő
ProgressCountLow	Int32	A 64 bites érték alacsony része, amely az OnProgress esemény által feldolgozott műveletek teljes számát jelzi.	OnProgress eseménykezelő
ProgressDescription	Lánc	A folyamat leírása.	OnProgress eseménykezelő
Terjesztés	logikai	Azt jelzi, hogy az esemény propagálása magasabb szintű eseménykezelőbe történik-e. Megjegyzés: A Propagálás változó értéke figyelmen kívül lesz hagyva a csomag ellenőrzése során. Ha a propagálásthamis értékre állítja egy gyermekcsomagban, az nem akadályozza meg, hogy egy esemény propagálása a szülőcsomagra terjedjen ki.	Minden eseménykezelő
SourceDescription	Lánc	A végrehajtható fájl leírása az eseményt generáló eseménykezelőben.	Minden eseménykezelő
SourceID	Lánc	A végrehajtható fájl egyedi azonosítója az eseményt generáló eseménykezelőben.	Minden eseménykezelő
SourceName	Lánc	A végrehajtható fájl neve az eseményt felindító eseménykezelőben.	Minden eseménykezelő
VáltozóLeírás	Lánc	A változó leírása.	OnVariableValueChanged eseménykezelő
Változóazonosító	Lánc	A változó egyedi azonosítója.	OnVariableValueChanged eseménykezelő

Rendszerváltozók paraméterkötésekben

Gyakran hasznos a rendszerváltozók értékeinek mentése táblákba a csomag futtatásakor. Például egy olyan csomag, amely dinamikusan hoz létre egy táblát, és megírja annak a csomagvégrehajtási példánynak a GUID-azonosítóját, amely a táblát egy táblaoszlopban hozta létre.

Ha rendszerváltozókkal megfelelteti az SQL-feladat végrehajtására használt SQL-utasítás paramétereit, fontos, hogy az egyes paraméterkötések adattípusát a rendszerváltozó adattípusára állítsa. Ellenkező esetben a rendszerváltozók értékei helytelenül fordíthatók le. Ha például az ExecutionInstanceGUID rendszerváltozót, amely a sztring adattípusával rendelkezik, és egy olyan sztringet tartalmaz, amely egy csomag végrehajtó példányának GUID-azonosítóját képviseli, a GUID adattípusú paraméterkötésben használja, a csomagpéldány GUID-azonosítója helytelenül lesz lefordítva.

Ez a szabály a felhasználó által definiált változókra is vonatkozik. Mivel azonban a rendszerváltozók adattípusai nem módosíthatók, és ezeket a változókat az adattípusokhoz kell igazítani, a felhasználó által definiált adatok rugalmasabbak. A paraméterkötésekben használt felhasználó által definiált változók általában olyan adattípusokkal vannak definiálva, amelyek kompatibilisek a leképezett paraméterek adattípusaival.

Kapcsolódó tevékenységek

Lekérdezési paraméterek leképezése változókra egy SQL-feladat végrehajtása során