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

Artigo
09/03/2023

Aplica-se a:SQL Server – Somente Windows Instância Gerenciada de SQL do Azure

No Master Data Services, use a ferramenta MDSModelDeploy para implantar um pacote que contém:

Somente objetos de modelo.
Objetos de modelo e dados.

Se desejar implantar um pacote que contém apenas objetos de modelo, você poderá usar o assistente de implantação de modelo no aplicativo Web do 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 na qual eles 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 esse procedimento:

Você deverá ter permissão para acessar a área funcional Administração do Sistema no ambiente do Master Data Services de destino.
Um pacote de implantação de modelo deverá existir. Para obter mais informações, consulte Criar um pacote de implantação de modelo usando MDSModelDeploy.
Você deve ser um administrador no ambiente onde está implantando o modelo. Para obter mais informações, consulte Administradores (Master Data Services).
Se estiver atualizando um modelo com os dados, a versão que está sendo implantada não poderá ser Bloqueada nem Confirmada.

Para implantar um pacote de implantação de modelo

Determine se você está implantando um novo modelo, um clone de um modelo ou atualizando um modelo clonado previamente. Para obter mais informações, consulte Opções de implantação de modelo (Master Data Services).
Abra um Administrador: Prompt de comando e navegue para MDSModelDeploy.exe.
- Se o MDS estiver instalado na local padrão, a ferramenta estará disponível em drive:\Program Files\Microsoft SQL Server\130\Master Data Services\Configuration
- Se o MDS não estiver instalado no local padrão, pesquise MDSModelDeploy.exe no comutador local.
Opcional. Exiba as opções e a ajuda.
- Para exibir todas as opções disponíveis, digite MDSModelDeploy e pressione Enter.
- Para exibir a ajuda para uma opção, digite o seguinte, em que OptionName é o nome da opção: MDSModelDeploy help OptionName.
Opcional. Se houver vários aplicativos Web, determine o nome do serviço no qual você implantará 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.
Dependendo de se você está 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, um atributo ou um membro que exista no modelo de destino, MDSModelDeploy não excluirá a entidade, o atributo ou o membro do modelo.

Em que PackageName é o nome do arquivo do pacote (.pkg), ModelName é o nome do novo modelo, VersionName é o nome da versão e ServiceName é o nome do serviço retornado na etapa anterior. Verifique se os nomes do modelo e da versão correspondem aos nomes exatos com diferenciação de maiúsculas e minúsculas.
Quando o pacote é implantado com êxito, uma mensagem é exibida informando que "A operação MDSModelDeploy foi concluída com êxito".

Observações:

Se uma exibição de assinatura no pacote tiver o mesmo nome que uma exibição de assinatura em um modelo existente, este aviso será exibido: Exibição da assinatura do implantador renomeada e a exibição será criada como modelname.subscriptionviewname. Se esse nome já estiver em uso, a exibição de assinatura não será criada.
O processo de implantação tem quatro etapas:
1. Os objetos de modelo são criados.
2. As regras de negócio são criadas.
3. As exibições de assinatura são criadas.
4. Os dados mestres são preenchidos.
Ao criar um modelo novo ou clonado, se o processo falhar durante alguma etapa, o modelo será excluído.

Na atualização de um modelo, se o processo falhar durante as três primeiras etapas, ele não continuará; no entanto, as alterações já feitas não serã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 permissões de usuário e de grupo não estão incluídos em pacotes de implantação de modelo. Depois de implantar um modelo, você deve atualizar esses objetos manualmente. Para saber mais, veja:

Atribuir permissões de objeto modelo (Master Data Services)

Confira também

Implantando modelos (Master Data Services)