Partilhar via


Implantar um pacote de implantação de modelo usando MDSModelDeploy

Aplica-se a:SQL Server no Windows Azure SQL Managed Instance

Importante

Os Serviços de Dados Mestres (MDS) foram removidos no SQL Server 2025 (17.x). Continuamos a oferecer suporte ao MDS no SQL Server 2022 (16.x) e em versões anteriores.

Nos Master Data Services, utilizar a ferramenta MDSModelDeploy para implantar um pacote que contém ou:

  • Apenas objetos modelo.

  • Modele objetos e dados.

Se desejar implantar um pacote que contenha somente objetos de modelo, você poderá usar o assistente de implantação de modelo no aplicativo Web Master Data Manager. Para obter mais informações, consulte Implantar um pacote de implantação de modelo usando o assistente.

Importante

Os pacotes podem ser implantados somente na edição do SQL Server em que foram criados. Isso significa que os pacotes criados no SQL Server 2012 (11.x) não podem ser implantados no SQL Server 2014 (12.x) ou superior.

Pré-requisitos

Para executar este procedimento:

  • Você deve ter permissão para acessar a área funcional Administração do Sistema no ambiente de destino do Master Data Services.

  • Um pacote de implantação de modelo deve existir. Para obter mais informações, consulte Criar um pacote de implantação de modelo usando MDSModelDeploy.

  • Você deve ser um administrador no ambiente em que está implantando o modelo. Para obter mais informações, consulte Administradores (Master Data Services).

  • Se você estiver atualizando um modelo com dados, a versão na qual você está implantando não poderá ser bloqueada ou confirmada.

Para implementar um pacote de implementação de modelo

  1. Determine se você está implantando um novo modelo, um clone de um modelo ou atualizando um modelo clonado anteriormente. Para obter mais informações, consulte Opções de implantação de modelo (Master Data Services).

  2. Abra um Prompt de Comando do Administrador e navegue até MDSModelDeploy.exe.

    • Se o MDS estiver instalado no local padrão, a ferramenta estará disponível na unidade:\Arquivos de Programas\Microsoft SQL Server\130\Master Data Services\Configuration

    • Se o MDS não estiver instalado no local padrão, pesquise por MDSModelDeploy.exeno computador local.

  3. Opcional. Veja opções e ajuda.

    • Para exibir todas as opções disponíveis, digite MDSModelDeploy e pressione Enter.

    • Para exibir a ajuda de uma opção, digite o seguinte, onde OptionName é o nome da opção: MDSModelDeploy help OptionName.

  4. Opcional. Se você tiver vários aplicativos Web, determine o nome do serviço no qual será implantado digitando este comando e pressionando Enter:

    MDSModelDeploy listservices  
    

    Uma lista de valores é retornada, por exemplo MDS1, Default Web Site, MDS. O primeiro valor nesta lista (neste caso, MDS1) é necessário para implantar o modelo.

  5. Dependendo se você estiver criando um modelo, clonando um modelo ou atualizando um modelo, no prompt de comando, digite o seguinte e pressione Enter.

    • Para criar um novo modelo:

      MDSModelDeploy deploynew -package PackageName -model ModelName -service ServiceName  
      
    • Para criar um clone de um modelo:

      MDSModelDeploy deployclone -package PackageName  
      
    • Para atualizar um modelo existente e seus dados:

      MDSModelDeploy deployupdate -package PackageName -version VersionName  
      

    Importante

    Se você usar a ferramenta MDSModelDeploy para atualizar um modelo existente e seus dados, e o pacote não contiver uma entidade, atributo ou membro que exista no modelo de destino, o MDSModelDeploy não excluirá essa entidade, atributo ou membro do modelo.

    Onde PackageName é o nome do arquivo de pacote (.pkg), ModelName é o nome do novo modelo, VersionName é o nome da versão e ServiceName é o nome do serviço que você retornou na etapa anterior. Certifique-se de que os nomes do modelo e da versão correspondam exatamente aos nomes com distinção entre maiúsculas e minúsculas.

  6. Quando o pacote é implantado com êxito, uma mensagem informando "MDSModelDeploy operação concluída com êxito" é exibida.

Notas:

  • Se uma vista de assinatura no pacote tiver o mesmo nome que uma vista de assinatura em um modelo existente, este aviso será exibido: vista de assinatura do implantador foi renomeada e é criado como modelname.subscriptionviewname. Se este nome já estiver em uso, a vista de subscrição não será criada.

  • O processo de implantação tem quatro etapas:

    1. Os objetos de modelo são criados.

    2. São criadas regras de negócio.

    3. São criadas visualizações de subscrição.

    4. Os dados mestre são preenchidos.

  • Ao criar um modelo novo ou clonado, se o processo falhar durante qualquer etapa, o modelo será excluído.

    Ao atualizar um modelo, se o processo falhar durante as três primeiras etapas, ele não prossegue; no entanto, as alterações já feitas não são revertidas. Se o processo falhar na etapa 4, os membros que podem ser atualizados serão atualizados.

Próximas Etapas

Os atributos de arquivo e as permissões de usuário e grupo não estão incluídos nos pacotes de implantação de modelo. Depois de implantar um modelo, você deve atualizá-los manualmente. Para obter mais informações, consulte:

Ver também

Implantando modelos (Master Data Services)