catalog.create_environment_reference (Banco de Dados SSISDB)

se aplica a:SQL Server SSIS Integration Runtime no Azure Data Factory

Aplica-se a:SQL Server

Cria uma referência de ambiente para um projeto no catálogo do Integration Services.

Sintaxe

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 ]  

Argumentos

[ @folder_name = ] folder_name
O nome da pasta do projeto que está fazendo referência ao ambiente. O folder_name é nvarchar(128).

[ @project_name = ] project_name
O nome do projeto que está fazendo referência ao ambiente. O project_name é nvarchar(128).

[ @environment_name = ] environment_name
O nome do ambiente que está sendo referenciado. O environment_name é nvarchar(128).

[ @reference_type = ] reference_type
Indica se o ambiente pode estar localizado na mesma pasta que o projeto (referência relativa) ou em uma pasta diferente (referência absoluta). Use o valor R para indicar uma referência relativa. Use o valor A para indicar uma referência absoluta. O reference_type é char(1).

[ @environment_folder_name = ] environment_folder_name
O nome da pasta na qual o ambiente que está sendo referenciado está localizado. Este valor é necessário para referências absolutas. O environment_folder_name é nvarchar(128).

[ @reference_id = ] reference_id
Retorna o identificador exclusivo para a nova referência. Este parâmetro é opcional. O reference_id é bigint.

Valor do código de retorno

0 (sucesso)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado requer uma das seguintes permissões:

• Permissões LER e MODIFICAR no projeto e permissão LER no ambiente

• Associação à função de banco de dados ssis_admin

• Associação à função de servidor sysadmin

Erros e Avisos

A lista a seguir descreve algumas condições que podem gerar um erro ou aviso:

• O nome da pasta não é válido

• O nome do projeto não é válido

• O usuário não se apropria de permissões

• Uma referência absoluta é especificada usando o caractere A no parâmetro reference_location, mas o nome da pasta não foi especificado com o parâmetro environment_folder_name.

Comentários

Um projeto pode ter referências de ambiente relativas ou absolutas. As referências relativas referem-se ao ambiente pelo nome e exigem que ele resida na mesma pasta do projeto. As referências absolutas referem-se ao ambiente por nome e pasta, e podem referir-se a ambientes que residem em uma pasta diferente do projeto. Um projeto pode fazer referência a vários ambientes.