catalog.deploy_project (database SSISDB)catalog.deploy_project (SSISDB Database)

QUESTO ARGOMENTO SI APPLICA A: sìSQL Server (a partire dalla versione 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Viene distribuito un progetto in una cartella del catalogo di Integration ServicesIntegration Services o viene aggiornato un progetto esistente distribuito precedentemente.Deploys a project to a folder in the Integration ServicesIntegration Services catalog or updates an existing project that has been deployed previously.

SintassiSyntax

catalog.deploy_project [@folder_name =] folder_name   
      , [@project_name =] project_name   
      , [@project_stream =] projectstream   
    [ , [@operation_id ] = operation_id OUTPUT ]   

ArgomentiArguments

[@folder_name =] nome_cartella[@folder_name =] folder_name
Il nome della cartella in cui viene distribuito il progetto.The name of the folder where the project is deployed. Il nome_cartella è nvarchar (128).The folder_name is nvarchar(128).

[@project_name =] project_name[@project_name =] project_name
Nome del progetto nuovo o aggiornato nella cartella.The name of the new or updated project in the folder. Il project_name è nvarchar (128).The project_name is nvarchar(128).

[@projectstream =] projectstream[@projectstream =] projectstream
Contenuto binario di un file di distribuzione progetto Integration ServicesIntegration Services (estensione ispac).The binary contents of an Integration ServicesIntegration Services project deployment file (.ispac extension).

È possibile utilizzare un'istruzione SELECT con la funzione OPENROWSET e il provider BULK per set di righe per recuperare il contenuto binario del file.You can use a SELECT statement with the OPENROWSET function and the BULK rowset provider to retrieve the binary contents of the file. Per un esempio, vedere distribuire Integration Services (SSIS) progetti e pacchetti.For an example, see Deploy Integration Services (SSIS) Projects and Packages. Per ulteriori informazioni su OPENROWSET, vedere OPENROWSET ( Transact-SQL ) .For more information about OPENROWSET, see OPENROWSET (Transact-SQL).

Il projectstream è varbinary (max)The projectstream is varbinary(MAX)

[@operation_id =] operation_id[@operation_id =] operation_id
Viene restituito l'identificatore univoco dell'operazione di distribuzione.Returns the unique identifier for the deployment operation. Il operation_id è bigint.The operation_id is bigint.

Valore del codice restituitoReturn Code Value

0 (esito positivo)0 (success)

Set di risultatiResult Sets

NessunoNone

PermissionsPermissions

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:This stored procedure requires one of the following permissions:

  • Autorizzazioni CREATE_OBJECTS sulla cartella per distribuire un nuovo progetto o autorizzazioni MODIFY sul progetto per aggiornare un progettoCREATE_OBJECTS permissions on the folder to deploy a new project or MODIFY permissions on the project to update a project

  • L'appartenenza al ssis_admin ruolo del databaseMembership to the ssis_admin database role

  • L'appartenenza al sysadmin ruolo del serverMembership to the sysadmin server role

Errori e avvisiErrors and Warnings

Nell'elenco seguente vengono descritte alcune condizioni che possono determinare la generazione di un errore da parte della stored procedure:The following list describes some conditions that may cause this stored procedure to raise an error:

  • Parametro che fa riferimento a un oggetto inesistente, parametro che tenta di creare un oggetto già esistente o parametro non valido in alcuni altri modiA parameter refers to an object that does not exist, a parameter tries to create an object that already exists, or a parameter is invalid in some other way

  • Il valore del parametro @project_name non corrisponde al nome del progetto nel file di distribuzioneThe value of the parameter @project_name does not match the name of the project in the deployment file

  • Utente senza autorizzazioni sufficienti.The user does not have sufficient permissions

OsservazioniRemarks

Durante la distribuzione o aggiornamento di un progetto, il livello di protezione dei singoli pacchetti non viene controllato dalla stored procedure.During a project deployment or update, the stored procedure does not check the protection level of individual packages in the project.