Distribuire un pacchetto di distribuzione di modelli tramite MDSModelDeployDeploy a Model Deployment Package by Using MDSModelDeploy

In Master Data ServicesMaster Data Servicesutilizzare lo strumento MDSModelDeploy per distribuire un pacchetto contenente:In Master Data ServicesMaster Data Services, use the MDSModelDeploy tool to deploy a package that contains either:

Importante

I pacchetti possono essere distribuiti solo nella versione di SQL ServerSQL Server utilizzata per crearli.Packages can be deployed to the edition of SQL ServerSQL Server they were created in only. Pertanto non è possibile distribuire pacchetti creati in SQL Server 2012SQL Server 2012 a SQL Server 2014SQL Server 2014 o versione successiva.This means that packages created in SQL Server 2012SQL Server 2012 cannot be deployed to SQL Server 2014SQL Server 2014 or higher.

PrerequisitiPrerequisites

Per eseguire questa procedura:To perform this procedure:

  • È necessario disporre dell'autorizzazione per accedere all'area funzionale Amministrazione sistema nell'ambiente Master Data ServicesMaster Data Services di destinazione.You must have permission to access the System Administration functional area in the target Master Data ServicesMaster Data Services environment.

  • È necessario che sia già disponibile un pacchetto di distribuzione di modelli.A model deployment package must exist. Per altre informazioni, vedere Creare un pacchetto di distribuzione di modelli tramite MDSModelDeploy.For more information, see Create a Model Deployment Package by Using MDSModelDeploy.

  • È necessario essere un amministratore nell'ambiente in cui viene distribuito il modello.You must be an administrator in the environment where you are deploying the model. Per altre informazioni, vedere Amministratori (Master Data Services).For more information, see Administrators (Master Data Services).

  • Se si aggiorna un modello con i dati, la versione nella quale si esegue la distribuzione non può avere lo stato Bloccato o Commit eseguito.If you are updating a model with data, the version you’re deploying to cannot be Locked or Committed.

Per distribuire un pacchetto di distribuzione di modelliTo deploy a model deployment package

  1. Determinare se si distribuisce un nuovo modello, un clone di un modello o si aggiorna un modello clonato in precedenza.Determine whether you are deploying a new model, a clone of a model, or updating a previously-cloned model. Per altre informazioni, vedere Opzioni di distribuzione dei modelli (Master Data Services).For more information, see Model Deployment Options (Master Data Services).

  2. Aprire un prompt dei comandi con privilegi di amministratore e passare a MDSModelDeploy.exe.Open an Administrator: Command Prompt and navigate to MDSModelDeploy.exe.

    • Se MDS è stato installato nel percorso predefinito, lo strumento è disponibile in unità:\Programmi\Microsoft SQL Server\130\Master Data Services\ConfigurationIf MDS is installed at the default location, the tool is available at drive:\Program Files\Microsoft SQL Server\130\Master Data Services\Configuration

    • Se MDS non è stato installato nel percorso predefinito, cercare MDSModelDeploy.exe nel computer locale.If MDS is not installed at the default location, search the local computer for MDSModelDeploy.exe.

  3. Facoltativa.Optional. Visualizzare le opzioni e la Guida.View options and help.

    • Per visualizzare tutte le opzioni disponibili, digitare MDSModelDeploy e premere Invio.To display all available options, type MDSModelDeploy and press Enter.

    • Per visualizzare la Guida per un'opzione, digitare quanto segue, dove OptionName è il nome dell'opzione: MDSModelDeploy help OptionName.To display help for an option, type the following, where OptionName is the name of the option: MDSModelDeploy help OptionName.

  4. Facoltativa.Optional. Se sono disponibili più applicazioni Web, determinare il nome del servizio in cui verrà eseguita la distribuzione digitando questo comando e premendo INVIO:If you have multiple web applications, determine the name of the service you will deploy to by typing this command and pressing Enter:

    MDSModelDeploy listservices  
    

    Verrà restituito un elenco di valori, ad esempio MDS1, Default Web Site, MDS.A list of values is returned, for example MDS1, Default Web Site, MDS. Il primo valore di questo elenco, in questo caso MDS1, è necessario per distribuire il modello.The first value in this list (in this case, MDS1) is needed to deploy the model.

  5. A seconda del fatto che si crei, si cloni o si aggiorni un modello, al prompt dei comandi digitare quanto segue e premere INVIO.Depending on whether you are creating a model, cloning a model, or updating a model, at the command prompt, type the following and press Enter.

    • Per creare un nuovo modello:To create a new model:

      MDSModelDeploy deploynew -package PackageName -model ModelName -service ServiceName  
      
    • Per creare un clone di un modello:To create a clone of a model:

      MDSModelDeploy deployclone -package PackageName  
      
    • Per aggiornare un modello esistente e i relativi dati:To update an existing model and its data:

      MDSModelDeploy deployupdate -package PackageName -version VersionName  
      

    Importante

    Se si utilizza lo strumento MDSModelDeploy per aggiornare un modello esistente e i relativi dati e nel pacchetto non è contenuto alcun attributo, entità o membro disponibile nel modello di destinazione, questi elementi non saranno eliminati dal modello tramite MDSModelDeploy.If you use the MDSModelDeploy tool to update an existing model and its data, and the package does not contain an entity, attribute, or member that exists in the destination model, MDSModelDeploy will not delete that entity, attribute, or member from the model.

    Dove PackageName è il nome del file di pacchetto (con estensione pkg), ModelName è il nome del nuovo modello, VersionName è il nome della versione e ServiceName è il nome del servizio del passaggio precedente.Where PackageName is the name of the package (.pkg) file, ModelName is the name of the new model, VersionName is the name of the version, and ServiceName is the name of the service that you returned in the previous step. Assicurarsi che i nomi della versione e del modello corrispondano esattamente ai nomi, rispettando la distinzione tra maiuscole e minuscole.Ensure that the model and version names match the exact case-sensitive names.

  6. Al termine della distribuzione del pacchetto, verrà visualizzato un messaggio "Operazione MDSModelDeploy completata".When the package is successfully deployed, a message stating “MDSModelDeploy operation completed successfully” is displayed.

    Note:Notes:

  • Se una vista sottoscrizioni nel pacchetto ha lo stesso nome di una vista sottoscrizioni in un modello esistente, viene visualizzato l'avviso: la vista delle sottoscrizioni del deployer è stata rinominata e la vista viene creata come modelname.subscriptionviewname.If a subscription view in the package has the same name as a subscription view in an existing model, this warning is displayed: Deployer subscription view renamed and the view is created as modelname.subscriptionviewname. Se questo nome è già in uso, la vista della sottoscrizione non viene creata.If this name is already in use, the subscription view is not created.

  • Il processo di distribuzione si svolge in quattro passaggi:The deployment process has four steps:

    1. Creazione degli oggetti modello.The model objects are created.

    2. Creazione delle regole business.Business rules are created.

    3. Creazione delle viste sottoscrizioni.Subscription views are created.

    4. Popolamento dei dati master.Master data is populated.

  • Quando si crea un nuovo modello o se ne clona uno esistente, se si verifica un errore durante un qualsiasi passaggio del processo, il modello viene eliminato.When creating a new or cloned model, if the process fails during any step, the model is deleted.

    Quando si aggiorna un modello, se si verifica un errore durante i primi tre passaggi, l'operazione viene interrotta; tuttavia il rollback delle modifiche già effettuate non viene eseguito.When updating a model, if the process fails during the first three steps, it does not proceed; however, changes that are already made are not rolled back. Se si verifica un errore durante il quarto passaggio, viene eseguito l'aggiornamento dei membri che è possibile aggiornare.If the process fails in step 4, members that can be updated are updated.

Passaggi successiviNext Steps

Gli attributi file e le autorizzazioni di utenti e gruppi non sono inclusi nei pacchetti di distribuzione dei modelli.File attributes, and user and group permissions are not included in model deployment packages. Dopo avere distribuito un modello, è necessario aggiornare questi elementi manualmente.After you deploy a model, you must update these manually. Per altre informazioni, vedere:For more information, see:

Vedere ancheSee Also

Distribuzione di modelli (Master Data Services)Deploying Models (Master Data Services)