catalog.create_environment_variable (databáze SSISDB)

Článek
2025-03-05

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

platí pro:SQL Server

Vytvořte proměnnou prostředí v katalogu Integrační služby.

Syntax

catalog.create_environment_variable [ @folder_name = ] folder_name  
    , [ @environment_name = ] environment_name  
    , [ @variable_name = ] variable_name  
    , [ @data_type = ] data_type  
    , [ @sensitive = ] sensitive  
    , [ @value = ] value  
    , [ @description = ] description

Argumenty

[@folder_name =] folder_name
Název složky, která obsahuje prostředí. folder_name je nvarchar(128).

[@environment_name =] environment_name
Název prostředí. environment_name je nvarchar(128).

[@variable_name =] variable_name
Název proměnné prostředí. variable_name je nvarchar(128).

[@data_type =] data_type
Datový typ proměnné. Mezi podporované datové typy proměnných prostředí patří logická, bajtové, DateTime , Double, Int16, Int32, Int64 , single, String, UInt32a UInt64. Mezi nepodporované datové typy proměnných prostředí patří Char, DBNull, Objecta Sbyte. Datový typ parametru data_type je nvarchar(128).

[@sensitive =] citlivé
Určuje, zda proměnná obsahuje citlivou hodnotu, nebo ne. Použijte hodnotu 1 k označení, že hodnota proměnné prostředí je citlivá nebo hodnota 0, která indikuje, že není. Citlivá hodnota se při uložení zašifruje. Hodnota, která není citlivá, je uložena v prostém textu.citlivé je bit.

[@value =] hodnota
Hodnota proměnné prostředí. Hodnota je sql_variant.

[@description =] popis
Popis proměnné prostředí. Hodnota je nvarchar(1024).

Návratová hodnota kódu

0 (úspěch)

Sady výsledků

Žádný

Dovolení

Tato uložená procedura vyžaduje jedno z následujících oprávnění:

Oprávnění READ a MODIFY v prostředí
Členství v roli databáze ssis_admin
Členství v roli serveru správce systému

Chyby a upozornění

Následující seznam popisuje některé podmínky, které mohou vyvolat chybu nebo upozornění:

Název složky, název prostředí nebo název proměnné prostředí není platný.
Název proměnné již v prostředí existuje.
Uživatel nemá příslušná oprávnění.

Poznámky

Proměnnou prostředí lze použít k efektivnímu přiřazení hodnoty k parametru projektu nebo parametru balíčku pro použití při provádění balíčku. Proměnné prostředí umožňují uspořádání hodnot parametrů. Názvy proměnných musí být v rámci prostředí jedinečné.

Uložená procedura ověří datový typ proměnné, aby se ujistil, že je podporován katalogem integračních služeb.

Spropitné

Zvažte použití datového typu Int16 v integračních službách místo nepodporovaného datového typu Sbyte.

Hodnota předaná této uložené proceduře s hodnotou parametr je převedena z datového typu Integrační služby na datový typ SQL Serveru podle následující tabulky:

Datový typ integračních služeb	Datový typ SQL Serveru
logických	bitová
bajtové	binární, varbinární
DateTime	datetime , datetime2, datetimeoffset, smalldatetime
double	Přesné číslo: desetinných míst, číselné; Přibližná číselná hodnota: plovoucí, skutečné
Int16	malé
Int32	int
Int64	bigint
single	Přesné číslo: desetinných míst, číselné; Přibližná číselná hodnota: plovoucí, skutečné
řetězce	varchar, nvarchar, char
UInt32	int (int je nejbližší dostupné mapování na Uint32.)
UInt64	bigint (int je nejbližší dostupné mapování na Uint64.)

Sdílet prostřednictvím