catalog.set_environment_reference_type (SSISDB-Datenbank)

  • Artikel

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

Gilt für:SQL Server

Legt den Verweistyp und den Umgebungsnamen fest, die einem vorhandenen Umgebungsverweis für ein Projekt im Integration Services-Katalog zugeordnet sind.

Syntax

catalog.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. Der 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 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.

Wichtig

Wenn ein relativer Verweis angegeben wird, wird der environment_folder_name -Parameterwert nicht verwendet, und der Umgebungsordnername wird automatisch auf NULLfestgelegt. Wenn ein absoluter Verweis angegeben wird, muss der Umgebungsordnername im environment_folder_name -Parameter angegeben werden.