Déployer un package de déploiement de modèle à l'aide de MDSModelDeploy

  • Article

S’applique à :SQL Server - Windows uniquement Azure SQL Managed Instance

Dans Master Data Services, utilisez l’outil MDSModelDeploy pour déployer un package qui contient :

  • Des objets de modèle uniquement.

  • Des objets de modèle et des données.

Si vous souhaitez déployer un package qui contient uniquement des objets de modèle, vous pouvez utiliser l’Assistant Déploiement de modèle dans l’application web Master Data Manager à la place. Pour plus d’informations, consultez Déployer un package de déploiement de modèle à l’aide de l’Assistant.

Important

Les packages peuvent être déployés dans l’édition de SQL Server qu’ils ont été créés uniquement. Cela signifie que les packages créés dans SQL Server 2012 (11.x) ne peuvent pas être déployés sur SQL Server 2014 (12.x) ou version ultérieure.

Prerequisites

Pour effectuer cette procédure :

  • Vous devez avoir l’autorisation d’accéder à la zone fonctionnelle Administration système dans l’environnement Master Data Services cible.

  • Un package de déploiement de modèle doit exister. Pour plus d’informations, consultez Créer un package de déploiement de modèle à l'aide de MDSModelDeploy.

  • Vous devez être administrateur dans l'environnement où vous déployez le modèle. Pour plus d’informations, consultez Administrateurs (Master Data Services).

  • Si vous mettez à jour un modèle avec des données, la version que vous déployez ne peut pas avoir l’état Verrouillé ou Activé.

Pour déployer un package de déploiement de modèle

  1. Déterminez si vous déployez un nouveau modèle, un clone d'un modèle, ou si vous mettez à jour un modèle préalablement cloné. Pour plus d’informations, consultez Options de déploiement de modèle (Master Data Services).

  2. Ouvrez une invite de commandes d’administrateur et accédez à MDSModelDeploy.exe.

    • Si MDS est installé à l’emplacement par défaut, l’outil est disponible sur lecteur:\Program Files\Microsoft SQL Server\130\Master Data Services\Configuration

    • Si MDS n'est pas installé dans l'emplacement par défaut, recherchez MDSModelDeploy.exe sur l'ordinateur local.

  3. Facultatif. Consultez les options et l'aide.

    • Pour afficher toutes les options disponibles, tapez MDSModelDeploy et appuyez sur Entrée.

    • Pour afficher l’aide pour une option, tapez la commande suivante, où OptionName est le nom de l’option : MDSModelDeploy help OptionName.

  4. Facultatif. Si vous possédez plusieurs applications Web, déterminez le nom du service que vous allez déployer en entrant cette commande et en appuyant sur ENTRÉE :

    MDSModelDeploy listservices

    Une liste de valeurs est retournée, par exemple MDS1, Default Web Site, MDS. La première valeur de cette liste (dans ce cas, MDS1) est nécessaire pour déployer le modèle.

  5. Selon que vous créez un modèle, clonez modèle ou mettez à jour un modèle, à l'invite de commandes, tapez la commande suivante et appuyez sur Entrée.

    • Pour créer un modèle :

      MDSModelDeploy deploynew -package PackageName -model ModelName -service ServiceName

    • Pour créer un clone d'un modèle :

      MDSModelDeploy deployclone -package PackageName

    • Pour mettre à jour un de modèle existant et ses données :

      MDSModelDeploy deployupdate -package PackageName -version VersionName

    Important

    Si vous utilisez l'outil MDSModelDeploy pour mettre à jour un modèle existant et ses données et que le package ne contient pas une entité, un attribut ou un membre existant dans le modèle de destination, MDSModelDeploy ne supprime pas cette entité, cet attribut ou ce membre du modèle.

    Où PackageName est le nom du fichier de package (.pkg), ModelName est le nom du nouveau modèle, VersionName est le nom de la version et ServiceName est le nom du service que vous avez retourné à l’étape précédente. Vérifiez que les noms de modèle et de version correspondent aux noms en respectant la casse.

  6. Quand le package est déployé, un message indiquant que l’opération de MDSModelDeploy est terminée s’affiche.

Remarques :

  • Si une vue d’abonnement dans le package a le même nom qu’une vue d’abonnement dans un modèle existant, l’avertissement suivant s’affiche : La vue d’abonnement du système de déploiement a été renommée . La vue est alors créée en tant que modelname.subscriptionviewname. Si ce nom existe déjà, la vue d'abonnement n'est pas créée.

  • Le processus de déploiement comporte quatre étapes :

    1. Les objets de modèle sont créés.

    2. Les règles d'entreprise sont créées.

    3. Les vues d'abonnement sont créées.

    4. Les données de référence sont remplies.

  • Lorsque vous créez un modèle nouveau ou cloné, si le processus échoue au cours d'une étape, le modèle est supprimé.

    Lorsque vous mettez à jour un modèle, si le processus échoue au cours des trois premières étapes, il s'arrête ; toutefois, les modifications qui sont déjà effectuées ne sont pas annulées. Si le processus échoue à l'étape 4, les membres qui peuvent être mis à jour sont mis à jour.

Étapes suivantes

Les attributs de fichier et les autorisations d’accès ne sont pas inclus dans les packages de déploiement de modèle. Après avoir déployé un modèle, vous devez les mettre à jour manuellement. Pour plus d'informations, consultez les pages suivantes :

Voir aussi

Déploiement de modèles (Master Data Services)