catalog.create_environment_variable (database SSISDB)

Articolo
05/23/2023

Si applica a:SQL Server Integration Runtime SSIS in Azure Data Factory

Si applica a:SQL Server

Creare una variabile di ambiente nel catalogo di Integration Services.

Sintassi

catalog.create_environment_variable [ @folder_name = ] folder_name  
    , [ @environment_name = ] environment_name  
    , [ @variable_name = ] variable_name  
    , [ @data_type = ] data_type  
    , [ @sensitive = ] sensitive  
    , [ @value = ] value  
    , [ @description = ] description

Argomenti

[@folder_name =] folder_name
Nome della cartella in cui è contenuto l'ambiente. folder_name è di tipo nvarchar(128) .

[@environment_name =] environment_name
Il nome dell'ambiente. environment_name è di tipo nvarchar(128) .

[@variable_name =] variable_name
Nome della variabile di ambiente. variable_name è di tipo nvarchar(128).

[@data_type =] data_type
Tipo di dati della variabile. I tipi di dati di variabile di ambiente supportati includono Boolean, Byte, DateTime, Double, Int16, Int32, Int64, Single, String, UInt32 e UInt64. Tra i tipi di dati di variabile di ambiente non supportati sono inclusi Char, DBNull, Object e Sbyte. Il tipo di dati del parametro data_type è nvarchar(128).

[@sensitive =] sensitive
Viene indicato se nella variabile è contenuto o meno un valore importante. Utilizzare un valore pari a 1, per indicare che il valore della variabile di ambiente è importante o, in caso contrario, un valore pari a 0. Un valore, se importante, viene crittografato quando viene archiviato; altrimenti, viene archiviato non crittografato. Sensitive è di tipo bit.

[@value =] value
Valore della variabile di ambiente. value è di tipo sql_variant.

[@description =] description
Descrizione della variabile di ambiente. value è di tipo nvarchar(1024).

Valore del codice restituito

0 (esito positivo)

Set di risultati

nessuno

Autorizzazioni

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:

Autorizzazioni READ e MODIFY sull'ambiente
Appartenenza al ruolo del database ssis_admin
Appartenenza al ruolo del server sysadmin

Errori e avvisi

Nell'elenco seguente vengono descritte alcune condizioni che possono generare un errore o un avviso:

Nome della cartella, nome dell'ambiente o nome della variabile di ambiente non valido
Nome della variabile già esistente nell'ambiente
Utente senza autorizzazioni appropriate.

Osservazioni

Una variabile di ambiente può essere utilizzata per assegnare in modo efficace un valore a un parametro del progetto o a un parametro del pacchetto da utilizzare nell'esecuzione di un pacchetto. Le variabili di ambiente consentono l'organizzazione dei valori del parametro. I nomi della variabile devono essere univoci all'interno di un ambiente.

La stored procedure consente di convalidare il tipo di dati della variabile per assicurarsi che sia supportato dal catalogo di Integration Services.

Suggerimento

In Integration Services si consideri di usare il tipo di dati Int16 al posto del tipo di dati Sbyte non supportato.

Il valore passato a questa stored procedure con il parametro value viene convertito da un tipo di dati di Integration Services in un tipo di dati di SQL Server in base alla tabella seguente:

Tipo di dati di Integration Services	Tipo di dati di SQL Server
Boolean	bit
Byte	binary, varbinary
DateTime	datetime, datetime2, datetimeoffset, smalldatetime
Double	Numerico esatto: decimale, numerico; numerico approssimato: float, reale
Int16	smallint
Int32	int
Int64	bigint
Singolo	Numerico esatto: decimale, numerico; numerico approssimato: float, reale
Stringa	varchar, nvarchar, char
UInt32	int (int è il mapping disponibile più vicino a Uint32).
UInt64	bigint (int è il mapping disponibile più vicino a Uint64).

Condividi tramite