catalog.create_environment_reference (baza danych SSISDB)

Dotyczy:sql Server SSIS Integration Runtime w usłudze Azure Data Factory

Dotyczy:programu SQL Server

Tworzy odwołanie do środowiska dla projektu w katalogu usług Integration Services.

Składnia

catalog.create_environment_reference [ @folder_name = ] folder_name  
     , [ @project_name = ] project_name  
     , [ @environment_name = ] environment_name  
     , [ @reference_type = ] reference_type  
  [  , [ @environment_folder_name = ] environment_folder_name ]  
  [  , [ @reference_id = ] reference_id OUTPUT ]  

Argumenty

[ @folder_name = ] folder_name
Nazwa folderu projektu odwołującego się do środowiska. folder_name to nvarchar(128).

[ @project_name = ] project_name
Nazwa projektu odwołującego się do środowiska. project_name jest nvarchar(128).

[ @environment_name = ] environment_name
Nazwa przywoływanego środowiska. environment_name to nvarchar(128).

[ @reference_type = ] reference_type
Wskazuje, czy środowisko może znajdować się w tym samym folderze co projekt (odwołanie względne) lub w innym folderze (odwołanie bezwzględne). Użyj wartości R, aby wskazać względne odwołanie. Użyj wartości A, aby wskazać odwołanie bezwzględne. reference_type jest char(1).

[ @environment_folder_name = ] environment_folder_name
Nazwa folderu, w którym znajduje się środowisko, do którego odwołuje się odwołanie. Ta wartość jest wymagana dla odwołań bezwzględnych. environment_folder_name jest nvarchar(128).

[ @reference_id = ] reference_id
Zwraca unikatowy identyfikator nowego odwołania. Ten parametr jest opcjonalny. reference_id jest bigint.

Zwracana wartość kodu

0 (powodzenie)

Zestawy wyników

Żaden

Uprawnienia

Ta procedura składowana wymaga jednego z następujących uprawnień:

• Uprawnienia DO ODCZYTU i MODYFIKOWANIA w projekcie oraz uprawnienia ODCZYT w środowisku

• Członkostwo w roli bazy danych ssis_admin

• Członkostwo w roli serwera sysadmin

Błędy i ostrzeżenia

Na poniższej liście opisano niektóre warunki, które mogą zgłaszać błąd lub ostrzeżenie:

• Nazwa folderu jest nieprawidłowa

• Nazwa projektu jest nieprawidłowa

• Użytkownik nie ma odpowiednich uprawnień

• Bezwzględne odwołanie jest określane przy użyciu znaku A w parametrze reference_location, ale nazwa folderu nie została określona za pomocą parametru environment_folder_name.

Uwagi

Projekt może mieć względne lub bezwzględne odwołania do środowiska. Odwołania względne odwołują się do środowiska według nazwy i wymagają, aby znajdowały się w tym samym folderze co projekt. Odwołania bezwzględne odwołują się do środowiska według nazwy i folderu i mogą odwoływać się do środowisk, które znajdują się w innym folderze niż projekt. Projekt może odwoływać się do wielu środowisk.