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 =] folder_name[@folder_name =] folder_name
Nome della cartella in cui è distribuito il progetto.The name of the folder where the project is deployed. folder_name è di tipo 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. project_name è di tipo 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 progetti e pacchetti di Integration Services (SSIS).For an example, see Deploy Integration Services (SSIS) Projects and Packages. Per altre informazioni su OPENROWSET, vedere OPENROWSET (Transact-SQL).For more information about OPENROWSET, see OPENROWSET (Transact-SQL).

projectstream è di tipo 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. operation_id è di tipo bigint.The operation_id is bigint.

Valore del codice restituitoReturn Code Value

0 (esito positivo)0 (success)

Set di risultatiResult Sets

NoneNone

AutorizzazioniPermissions

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

  • Appartenenza al ruolo del database ssis_adminMembership to the ssis_admin database role

  • Appartenenza al ruolo del server sysadminMembership 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

  • Valore del parametro @project_name non corrispondente 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

RemarksRemarks

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.