Partilhar via


catalog.create_environment_reference (Banco de Dados SSISDB)

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

Sintaxe

create_environment_reference [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @environment_name = ] environment_name
     , [ @reference_location = ] reference_location
  [  , [ @environment_folder_name = ] environment_folder_name ]
  [  , [ @reference_id = ] reference_id OUTPUT ]

Argumentos

  • [ @folder\_name = ] folder_name
    O nome da pasta do projeto que está referenciando o ambiente. O folder_name é nvarchar(128).

  • [ @project\_name = ] project_name
    O nome do projeto que está referenciando o ambiente. O project_name é nvarchar(128).

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

  • [ @reference\_location = ] reference_location
    Indica se o ambiente pode ser localizado na mesma pasta do 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_location é char(1).

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

  • [ @reference\_id = ] reference_id
    Retorna o identificador exclusivo da nova referência. Esse parâmetro é opcional. O reference_id é bigint.

Valor de código de retorno

0 (êxito)

Conjuntos de resultados

Nenhum

Permissões

Esse procedimento armazenado exige uma das seguintes permissões:

  • Permissões READ e MODIFY no projeto e permissão READ 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 erros ou avisos:

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

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

  • O usuário não tem as permissões adequadas

  • 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 fazem referência ao ambiente pelo nome e requerem que ele resida na mesma pasta do projeto. As referências absolutas fazem referência ao ambiente por nome e pasta. Elas podem fazer referência a ambientes que residam em uma pasta diferente da pasta do projeto. Um projeto pode fazer referência a vários ambientes.