catalog.create_environment_reference (SSISDB Database)

Artikel
2025-03-05

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

gäller för:SQL Server

Skapar en miljöreferens för ett projekt i Integration Services-katalogen.

Syntax

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 ]

Argument

[ @folder_name = ] folder_name
Namnet på mappen för projektet som refererar till miljön. folder_name är nvarchar(128).

[ @project_name = ] project_name
Namnet på projektet som refererar till miljön. project_name är nvarchar(128).

[ @environment_name = ] environment_name
Namnet på den miljö som refereras till. environment_name är nvarchar(128).

[ @reference_type = ] reference_type
Anger om miljön kan finnas i samma mapp som projektet (relativ referens) eller i en annan mapp (absolut referens). Använd värdet R för att ange en relativ referens. Använd värdet A för att ange en absolut referens. reference_type är tecken(1).

[ @environment_folder_name = ] environment_folder_name
Namnet på mappen där miljön som refereras finns. Det här värdet krävs för absoluta referenser. environment_folder_name är nvarchar(128).

[ @reference_id = ] reference_id
Returnerar den unika identifieraren för den nya referensen. Den här parametern är valfri. Den reference_id är bigint.

Returnera kodvärde

0 (lyckades)

Resultatuppsättningar

Ingen

Behörigheter

Den här lagrade proceduren kräver någon av följande behörigheter:

LÄS- och ÄNDRA-behörigheter för projektet och LÄS-behörighet för miljön
Medlemskap i ssis_admin databasrollen
Medlemskap i serverrollen sysadmin

Fel och varningar

I följande lista beskrivs vissa villkor som kan orsaka ett fel eller en varning:

Mappnamnet är ogiltigt
Projektnamnet är inte giltigt
Användaren har inte rätt behörigheter
En absolut referens anges med hjälp av A-tecknet i parametern reference_location, men namnet på mappen angavs inte med parametern environment_folder_name.

Anmärkningar

Ett projekt kan ha relativa eller absoluta miljöreferenser. Relativa referenser refererar till miljön efter namn och kräver att den finns i samma mapp som projektet. Absoluta referenser refererar till miljön efter namn och mapp och kan referera till miljöer som finns i en annan mapp än projektet. Ett projekt kan referera till flera miljöer.

Dela via