Compartilhar via

catalog.set_environment_reference_type (banco de dados SSISDB)

  • Artigo

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

Aplica-se: SQL Server

Define o tipo de referência e o nome de ambiente associados a uma referência de ambiente existente para um projeto no catálogo do Integration Services.

Sintaxe

catalog.set_environment_reference_location [ @reference_id = reference_id  
    , [ @reference_type = ] reference_type  
 [  , [ @environment_folder_name = ] environment_folder_name ]

Argumentos

[ @reference_id = ] reference_id
O identificador exclusivo da referência de ambiente que deve ser atualizada. O reference_id é bigint.

[ @reference_type = ] reference_type
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_type é char(1) .

[ @environment_folder_name = ] environment_folder_name
A pasta na qual o ambiente está localizado. Esse valor é necessário para referências absolutas. O environment_folder_name é nvarchar(128) .

Valor do código de retorno

0 (êxito)

Conjuntos de resultados

Nenhum

Permissões

Este 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 um erro ou um aviso:

  • O nome de pasta, o nome de ambiente ou o ID de referência não é válido

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

  • Uma referência absoluta está 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.

Importante

Se uma referência relativa for especificada, o valor do parâmetro environment_folder_name não será usado e o nome da pasta do ambiente será definido automaticamente como NULL. Se uma referência absoluta for especificada, o nome da pasta de ambiente deverá ser fornecido no parâmetro environment_folder_name.