catalog.set_environment_reference_type (SSISDB-Datenbank)
Legt den Verweistyp und den Umgebungsnamen fest, die einem vorhandenen Umgebungsverweis für ein Projekt im Integration Services-Katalog zugeordnet sind.
Syntax
set_environment_reference_location [ @reference_id = reference_id
, [ @reference_type = ] reference_type
[ , [ @environment_folder_name = ] environment_folder_name ]
Argumente
[ @reference\_id = ] reference_id
Der eindeutige Bezeichner des Umgebungsverweises, der aktualisiert werden soll. Die reference_id ist bigint.[ @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 Ordner, in dem sich die Umgebung befindet. Dieser Wert ist für absolute Verweise erforderlich. Der environment_folder_name ist nvarchar(128).
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, der Umgebungsname oder die Verweis-ID ist ungültig.
Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.
Im reference_location-Parameter wird mit dem Zeichen A ein absoluter Verweis angegeben, jedoch wurde im environment_folder_name-Parameter nicht der Name des Ordners angegeben.
Hinweise
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.
Wichtig |
---|
Wenn ein relativer Verweis angegeben wird, wird der environment_folder_name-Parameterwert nicht verwendet, und der Umgebungsordnername wird automatisch auf NULL festgelegt. Wenn ein absoluter Verweis angegeben wird, muss der Umgebungsordnername im environment_folder_name-Parameter angegeben werden. |