catalog.create_environment_variable (SSISDB-database)

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

van toepassing op:SQL Server-

Maak een omgevingsvariabele in de Integration Services-catalogus.

Syntaxis

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  

Argumenten

[@folder_name =] folder_name
De naam van de map die de omgeving bevat. De folder_name is nvarchar(128).

[@environment_name =] environment_name
De naam van de omgeving. De environment_name is nvarchar(128).

[@variable_name =] variable_name
De naam van de omgevingsvariabele. De variable_name is nvarchar(128).

[@data_type =] data_type
Het gegevenstype van de variabele. Ondersteunde gegevenstypen voor omgevingsvariabelen zijn Booleaanse, Byte, DateTime, Double, Int16, Int32, Int64, Single, String, UInt32en UInt64. Gegevenstypen voor niet-ondersteunde omgevingsvariabelen omvatten Char, DBNull-, Objecten Sbyte-. Het gegevenstype van de parameter data_type is nvarchar(128).

[@sensitive =] gevoelige
Geeft aan of de variabele een gevoelige waarde bevat of niet. Gebruik een waarde van 1 om aan te geven dat de waarde van de omgevingsvariabele gevoelig is of een waarde van 0 om aan te geven dat dit niet het is. Een gevoelige waarde wordt versleuteld wanneer deze wordt opgeslagen. Een waarde die niet gevoelig is, wordt opgeslagen in tekst zonder opmaak.Gevoelige is bit.

[@value =] waarde
De waarde van de omgevingsvariabele. De waarde is sql_variant.

[@description =] beschrijving
De beschrijving van de omgevingsvariabele. De waarde is nvarchar(1024).

Retourcodewaarde

0 (geslaagd)

Resultatensets

Geen

Machtigingen

Voor deze opgeslagen procedure zijn een van de volgende machtigingen vereist:

• Lees- en WIJZIGINGsmachtigingen voor de omgeving

• Lidmaatschap van de ssis_admin-databaserol

• Lidmaatschap van de sysadmin serverfunctie

Fouten en waarschuwingen

In de volgende lijst worden enkele voorwaarden beschreven die een fout of waarschuwing kunnen veroorzaken:

• De naam van de map, de omgevingsnaam of de naam van de omgevingsvariabele is ongeldig

• De naam van de variabele bestaat al in de omgeving

• De gebruiker beschikt niet over de juiste machtigingen

Opmerkingen

Een omgevingsvariabele kan worden gebruikt om efficiënt een waarde toe te wijzen aan een projectparameter of pakketparameter voor gebruik bij het uitvoeren van een pakket. Omgevingsvariabelen maken de organisatie van parameterwaarden mogelijk. Namen van variabelen moeten uniek zijn binnen een omgeving.

De opgeslagen procedure valideert het gegevenstype van de variabele om ervoor te zorgen dat deze wordt ondersteund door de Integration Services-catalogus.

Fooi

Overweeg het gegevenstype Int16 in Integration Services te gebruiken in plaats van het niet-ondersteunde Sbyte gegevenstype.

De waarde die is doorgegeven aan deze opgeslagen procedure met de waarde parameter wordt geconverteerd van een Integration Services-gegevenstype naar een SQL Server-gegevenstype volgens de volgende tabel:

Gegevenstype Integration Services	SQL Server-gegevenstype
Booleaanse	bit
Byte-	binairevarbinaire
DateTime-	datetime, datetime2, datetimeoffset, smalldatetime
Dubbele	Exacte numerieke waarde: decimale, numerieke; Bij benadering numeriek: zwevende, echte
Int16-	kleine
Int32-
Int64-	grote
enkele	Exacte numerieke waarde: decimale, numerieke; Bij benadering numeriek: zwevende, echte
tekenreeks	varchar, nvarchar, teken
UInt32-	int (int is de dichtstbijzijnde beschikbare toewijzing aan Uint32.)
UInt64-	bigint (int is de dichtstbijzijnde beschikbare toewijzing aan Uint64-.)