catalog.create_environment_reference (SSISDB-Datenbank)

Artikel
05/23/2023

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

Erstellt einen Umgebungsverweis für ein Projekt im Integration Services-Katalog.

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 ]

Argumente

[ @folder_name = ] folder_name
Der Name des Ordners des Projekts, das auf die Umgebung verweist. Der folder_name ist nvarchar(128) .

[ @project_name = ] project_name
Der Name des Projekts, das auf die Umgebung verweist. Der project_name ist nvarchar(128) .

[ @environment_name = ] environment_name
Der Name der Umgebung, auf die verwiesen wird. Der environment_name ist nvarchar(128) .

[ @reference_type = ] reference_type
Gibt an, ob sich die Umgebung im gleichen Ordner wie das Projekt (relativer Verweis) oder in einem anderen Ordner (absoluter Verweis) befinden kann. Verwenden Sie den Wert R , um einen relativen Verweis anzugeben. Verwenden Sie den Wert A , um einen absoluten Verweis anzugeben. Der reference_type ist char(1) .

[ @environment_folder_name = ] environment_folder_name
Der Name des Ordners, in dem sich die Umgebung befindet, auf die verwiesen wird. Dieser Wert ist für absolute Verweise erforderlich. Der environment_folder_name ist nvarchar(128) .

[ @reference_id = ] reference_id
Gibt den eindeutigen Bezeichner für den neuen Verweis zurück. Dieser Parameter ist optional. Der reference_id ist bigint.

Rückgabecodewert

0 (Erfolg)

Resultsets

Keine

Berechtigungen

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:

READ-Berechtigung und MODIFY-Berechtigung für das Projekt und READ-Berechtigung für die Umgebung
Mitgliedschaft in der Datenbankrolle ssis_admin
Mitgliedschaft in der Serverrolle sysadmin

Fehler und Warnungen

In der folgenden Liste werden einige Bedingungen beschrieben, die möglicherweise einen Fehler oder eine Warnung auslösen:

Der Ordnername ist ungültig.
Der Projektname ist ungültig.
Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.
Im A -Parameter wird mit dem Zeichen A ein absoluter Verweis angegeben, jedoch wurde im environment_folder_name -Parameter nicht der Name des Ordners angegeben.

Bemerkungen

Ein Projekt kann über relative oder absolute Umgebungsverweise verfügen. Relative Verweise verweisen mit dem Namen auf die Umgebung und erfordern, dass sich diese im gleichen Ordner wie das Projekt befindet. Absolute Verweise verweisen mit Name und Ordner auf die Umgebung und verweisen möglicherweise auf Umgebungen, die sich in einem anderen Ordner als das Projekt befinden. Ein Projekt kann auf mehrere Umgebungen verweisen.