Partager via

Déployer des solutions de modèle à l’aide de l’Assistant Déploiement

S’applique à : SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

L’Assistant Déploiement de SQL Server Analysis Services utilise des fichiers de sortie JSON générés à partir d’un projet SQL Server Analysis Services en tant que fichiers d’entrée. Ces fichiers d’entrée sont facilement modifiables pour personnaliser le déploiement d’un projet SQL Server Analysis Services. Le script de déploiement généré peut ensuite être exécuté immédiatement ou enregistré pour un déploiement ultérieur.

L’Assistant Déploiement/Utilitaire est installé avec SQL Server Management Studio (SSMS). Veillez à utiliser la dernière version. Si vous exécutez à partir de l’invite de commandes, par défaut, la dernière version de l’Assistant déploiement est installée sur C :\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

Vous pouvez déployer à l’aide de l’Assistant, comme décrit ici. Vous pouvez également automatiser le déploiement ou utiliser la fonctionnalité Synchroniser. Si la base de données déployée est volumineuse, envisagez d’utiliser des partitions sur les systèmes cibles. Vous pouvez automatiser la création et la population de partitions à l’aide du modèle objet tabulaire (TOM), du langage de critique du modèle tabulaire (TMSL) et des objets AMO (Analysis Management Objects).

Important

Ni les fichiers de sortie ni le script de déploiement ne contiennent l’ID d’utilisateur ou le mot de passe s’ils sont spécifiés dans la chaîne de connexion pour une source de données ou à des fins d’emprunt d’identité. Étant donné qu’elles sont requises à des fins de traitement dans ce scénario, vous allez ajouter ces informations manuellement. Si le déploiement n’inclut pas de traitement, vous pouvez ajouter cette connexion et les informations d'usurpation d'identité si nécessaire après le déploiement. Si le déploiement inclut un traitement, vous pouvez ajouter ces informations dans l’Assistant ou dans le script de déploiement après l’enregistrement du script.

Exécuter l’Assistant Déploiement

L’Assistant Déploiement peut être exécuté de la manière suivante :

  • Interactivement : lorsqu’il est exécuté de manière interactive, l’Assistant Déploiement génère un script de déploiement basé sur les fichiers d’entrée, comme modifié de manière interactive par l’entrée utilisateur. L’Assistant applique toutes les modifications utilisateur uniquement au script de déploiement. L’Assistant ne modifie pas les fichiers d’entrée.

  • À partir de l’invite de commandes : lors de l’exécution à l’invite de commandes, l’Assistant Déploiement génère un script de déploiement basé sur les commutateurs que vous utilisez pour exécuter l’Assistant. L’Assistant peut effectuer l’une des opérations suivantes : vous inviter à fournir une saisie utilisateur et modifier les fichiers d’entrée en fonction de cette saisie ; exécuter un déploiement silencieux sans assistance à l’aide des fichiers d’entrée tels quels ; ou créer un script de déploiement que vous pourrez utiliser ultérieurement.

Exécuter de manière interactive

Quand il s’exécute de manière interactive, l’Assistant Déploiement lit les valeurs des fichiers d’entrée et présente ces informations à vous. Vous pouvez modifier ces valeurs d’entrée, telles que la destination du déploiement, les paramètres de configuration, les options de déploiement et les mots de passe de chaîne de connexion, ou les laisser telles quelles. Si vous modifiez les valeurs d'entrée, l'Assistant applique ces modifications pour générer le script de déploiement. Toutefois, l’Assistant n’apporte aucune modification aux valeurs du fichier d’entrée.

Note

Si vous souhaitez que l’Assistant Déploiement modifie les valeurs d’entrée, exécutez l’Assistant à l’invite de commandes et définissez l’Assistant pour qu’il s’exécute en mode fichier réponse.

Après avoir examiné les valeurs d’entrée et apporté les modifications souhaitées, l’Assistant génère le script de déploiement. Vous pouvez exécuter ce script de déploiement immédiatement sur le serveur de destination ou enregistrer le script pour une utilisation ultérieure.

Pour exécuter l’Assistant Déploiement Analysis Services de manière interactive

  • Cliquez sur Start, puis tapez Assistant de déploiement des services d'analyse.

    - ou -

  • Dans le dossier Projets du projet SQL Server Analysis Services, double-cliquez sur le <fichier nom> du projet.asdatabase.

    Note

    Si vous ne trouvez pas le fichier .asdatabase, essayez d’utiliser La recherche et spécifiez *.asdatabase. Vous devrez peut-être créer le projet dans SSDT.

Exécuter à l’invite de commandes

L’Assistant Déploiement peut également être exécuté à l’invite de commandes. Lorsque vous exécutez une commande à l'invite de commandes, vous fournissez le chemin complet du fichier .asdatabase et exécutez l'assistant dans l'un des modes suivants :

Mode fichier réponse
En mode fichier réponse, l’Assistant vous permet de modifier de manière interactive les fichiers d’entrée qui ont été générés à l’origine lorsque le projet SQL Server Analysis Services a été créé dans SQL Server Data Tools. L’Assistant enregistre ces fichiers d’entrée modifiés avant de générer le script de déploiement. Les fichiers d’entrée modifiés deviennent le nouveau point de départ lorsque l'Assistant est relancé.

Pour exécuter l’Assistant en mode fichier réponse, utilisez le commutateur /a .

Mode silencieux
En mode silencieux, l'Assistant effectue automatiquement un déploiement non interactif, basé sur les informations présentes dans les fichiers d'entrée.

Pour exécuter l’Assistant en mode silencieux, utilisez l'option /s. Lorsque vous exécutez l’Assistant en mode silencieux, les messages sont écrits dans la console ou dans un fichier journal si celui-ci est spécifié.

Mode sortie
En mode sortie, l’Assistant génère un script de déploiement pour une exécution ultérieure en fonction des fichiers d’entrée.

Pour exécuter l’Assistant en mode sortie, utilisez le commutateur /o et fournissez un nom de fichier de sortie.

Pour plus d’informations sur ces commutateurs de ligne de commande, consultez Déployer des solutions de modèle avec l’utilitaire de déploiement.

Pour exécuter l’Assistant Déploiement d’Analysis Services à l’invite de commandes

  1. Si elle est installée avec SSMS 18.x, ouvrez une invite de commandes et accédez au chemin d’accès par défaut C :\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

  2. Tapez Microsoft.AnalysisServices.Deployment.exe suivi des commutateurs correspondant au mode dans lequel vous souhaitez exécuter l’Assistant.

Présentation du script de déploiement

Le script de déploiement XMLA généré par l’Assistant Déploiement se compose de deux sections :

  • La première partie du script de déploiement contient les commandes requises pour créer, modifier ou supprimer les objets Microsoft SQL Server appropriés dans la base de données de destination. Par défaut, les fichiers d’entrée générés par le projet SQL Server Analysis Services sont basés sur un déploiement incrémentiel. Par conséquent, le script de déploiement XMLA affecte uniquement les objets qui ont été modifiés ou supprimés.

  • La deuxième partie du script de déploiement contient les commandes requises pour traiter uniquement les objets créés ou modifiés sur le serveur de destination (l’option Processus par défaut) ou pour traiter entièrement la base de données de destination. Vous pouvez également choisir d’avoir le script de déploiement sans commandes de traitement.

L’ensemble du script de déploiement peut s’exécuter dans une transaction unique ou dans plusieurs transactions. Si le script s’exécute dans plusieurs transactions, la première partie du script s’exécute en tant que transaction unique et chaque objet est traité dans sa propre transaction.

Important

L’Assistant Déploiement de SQL Server Analysis Services déploie uniquement des objets dans une base de données SQL Server Analysis Services unique. Il ne déploie aucun objet ou données au niveau du serveur.

Fichiers de script de déploiement - Entrée utilisée pour créer un script de déploiement

Lorsque vous générez un projet, SQL Server Data Tools génère des fichiers pour le projet. SQL Server Data Tools place ensuite ces fichiers dans le dossier Sortie du projet. Par défaut, la sortie est placée dans le dossier \Bin. Le tableau suivant répertorie les fichiers XML créés par SQL Server Data Tools :

Fichier Descriptif
< nom> du projet. asdatabase Fichier XMLA pour les projets de modèles tabulaires multidimensionnels ou 1100/1103, ou un fichier JSON pour les projets de modèle Tabulaire 1200 et versions ultérieures. Contient les définitions déclaratives de tous les objets SQL Server Analysis Services du projet.
< nom> du projet. deploymenttargets Contient le nom de l’instance et de la base de données SQL Server Analysis Services dans lesquelles les objets SQL Server Analysis Services seront créés.
< nom> du projet. configsettings Contient des paramètres spécifiques à l’environnement, tels que les informations de connexion de source de données et les emplacements de stockage d’objets. Les paramètres de ce fichier remplacent les paramètres dans le < fichier nom> du projet.asdatabase.
< nom> du projet. deploymentoptions Contient des options de déploiement, telles que si le déploiement est transactionnel et si les objets déployés doivent être traités après le déploiement.

SQL Server Data Tools ne stocke jamais les mots de passe dans les fichiers projet.

Modification des fichiers d’entrée

La modification des valeurs dans les fichiers d’entrée ou les valeurs récupérées à partir des fichiers d’entrée permet de modifier la destination du déploiement, les paramètres de configuration et les options de déploiement sans modifier l’ensemble < du fichier project name.asdatabase >(ou un fichier de script entier si vous générez un script à partir d’une base de données SQL Server Analysis Services existante). La possibilité de modifier des fichiers individuels vous permet de créer facilement différents scripts de déploiement à des fins différentes.

Fichiers de script de déploiement - Spécification de la cible d’installation

L’Assistant Déploiement lit les informations de la cible d’installation à partir du fichier <project name>.deploymenttargets. SQL Server Data Tools crée ce fichier lorsque vous générez le projet. SQL Server Data Tools utilise la base de données et le serveur spécifiés dans la page Déploiement de la <boîte de dialogue Pages de propriétés du nom>du projet pour créer le fichier < du > projet.

Modification de la cible d’installation

Dans certains cas, vous devrez peut-être déployer un projet sur une base de données ou une instance différente de celle spécifiée dans la page Déploiement . Par exemple, vous pouvez déployer le projet sur un serveur à des fins de test avant le déploiement, puis le déployer sur un serveur de production une fois le test terminé. Vous pouvez également déployer un projet terminé et testé sur plusieurs serveurs de production dans un cluster d’équilibrage de charge réseau, ou sur un serveur intermédiaire et un serveur de production.

Pour déployer un projet sur une autre base de données ou instance, modifiez la cible d’installation dans le fichier d’entrée à l’aide de l’une des méthodes décrites dans la procédure suivante :

Pour modifier la cible d’installation après la génération des fichiers d’entrée

  • Exécutez de manière interactive l'Assistant de déploiement des services d'analyse SQL Server. Dans la page Cible d’installation , spécifiez une nouvelle destination pour l’instance et la base de données SQL Server Analysis Services.

    - ou -

  • Exécutez l’assistant de déploiement de SQL Server Analysis Services à l’invite de commandes et configurez-le pour qu’il s’exécute en mode fichier réponse.

    - ou -

  • Modifiez le fichier <nom du projet>.deploymenttargets à l’aide d'un éditeur de texte.

Fichiers de script de déploiement - Options de déploiement de partition et de rôle

L’Assistant Déploiement lit les options de déploiement de partition et de rôle à partir du fichier <nom_de_projet>.deploymentoptions. SQL Server Data Tools crée ce fichier lorsque vous générez le projet. SQL Server Data Tools utilise ensuite les options de déploiement de partition et de rôle du projet actuel lorsque le < fichier nom.deploymentoptions du > est créé.

Examen des options de déploiement des partitions et des rôles

Les options de déploiement dans le fichier <nom du projet>.deploymentoptions incluent les éléments suivants :

Options de déploiement de partition
Le < fichier project name.deploymentoptions> spécifie si les partitions existantes de la base de données de destination sont conservées ou remplacées (par défaut). Si les partitions existantes sont conservées, seules les nouvelles partitions sont déployées et les partitions et les conceptions d’agrégation sur tous les groupes de mesures existants restent inchangées.

Si le groupe de mesures dans lequel la partition existe est supprimé, la partition est automatiquement supprimée.

Options de déploiement de rôle
Le < fichier project name.deploymentoptions> spécifie l’une des options de déploiement de rôle suivantes :

  • Les rôles et les membres de rôle existants dans la base de données de destination sont conservés, et seuls les nouveaux rôles et les membres de rôle sont déployés.

  • Tous les rôles et membres existants dans la base de données de destination sont remplacés par les rôles et les membres déployés.

  • Les rôles et les membres de rôle existants dans la base de données de destination sont conservés et aucun nouveau rôle n’est déployé.

Lorsque les rôles et les membres existants sont conservés, les autorisations associées à ces rôles sont réinitialisées à aucune. Les autorisations de sécurité sont contenues par les objets qu’ils sécurisent, et non par les rôles de sécurité auxquels ils sont associés. Pour plus d’informations sur l’utilisation de ce comportement à l’aide de l’Assistant de déploiement des services d'analyse, consultez « Conserver les rôles et les membres » dans la Base de connaissances de Microsoft.

Modification des options de déploiement de partition et de rôle

Vous devrez peut-être déployer le projet à l’aide de différentes options de partition et de rôle que celles stockées dans le < fichier nom> de projet.deploymentoptions. Par exemple, vous pouvez conserver des partitions, des rôles et des membres de rôle existants, au lieu de remplacer toutes les partitions, rôles et membres existants, comme indiqué dans le < fichier nom> de projet.deploymentoptions.

Pour modifier le déploiement de partitions et de rôles dans un projet, vous ne pouvez pas modifier les paramètres de partition et de rôles dans le projet, car la boîte de dialogue <>du nom de projet dans SQL Server Data Tools n’affiche pas ces options. Si vous souhaitez modifier les options de déploiement pour les rôles et les partitions, vous devez modifier ces informations dans le < fichier project name.deploymentoptions >lui-même. La procédure suivante décrit comment modifier les options de déploiement de partition et de rôle dans le fichier nom.deploymentoptions <du >.

Pour modifier le déploiement de partitions ou de rôles après la génération des fichiers d’entrée

  • Exécutez l’Assistant Déploiement de manière interactive et, dans la page Options de déploiement de partition et de rôle , spécifiez les nouvelles options de déploiement pour les partitions et les rôles.

    - ou -

  • Exécutez l’Assistant Déploiement à l’invite de commandes et configurez l’Assistant pour qu’il fonctionne en mode fichier réponse.

    - ou -

  • Ouvrez le <nom> du projet.deploymentoptions dans n’importe quel éditeur de texte et modifiez manuellement les options. Les options de PartitionDeployment sont DeployPartitions, RetainPartitions. Les options pour RoleDeployment sont DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

Fichiers de script de déploiement - Paramètres de configuration du déploiement de solution

L’Assistant Déploiement lit les options de déploiement de partition et de rôle que vous utilisez dans le script de déploiement à partir du fichier <nom du projet>.configsettings. Pour les projets multidimensionnels, SQL Server Data Tools crée ce fichier lorsque vous générez le projet. Pour les projets tabulaires, selon la version, il peut être nécessaire d’exécuter l’Assistant Déploiement en mode Réponse pour générer le fichier .configsettings. SQL Server Data Tools utilise les paramètres de configuration du projet actuel pour créer le fichier nom.configsettings <du >.

Examen des paramètres de configuration

Voici les paramètres de configuration stockés dans le fichier <project name.configsettings > :

  • Chaînes de connexion de source de données : il s’agit des chaînes de connexion pour chaque source de données en fonction des valeurs spécifiées dans le projet. L’ID d’utilisateur et le mot de passe sont toujours supprimés de la chaîne de connexion avant que le reste de la chaîne soit stocké dans ce fichier. Toutefois, si l’Assistant Déploiement est déployé directement sur une instance Analysis Services, vous pouvez ajouter les informations d’id utilisateur et de mot de passe appropriées dans l’Assistant pour permettre un traitement réussi de la base de données de déploiement. Ces informations de connexion ne sont pas stockées dans le script de déploiement lui-même s’ils sont enregistrés par l’Assistant Déploiement.

  • Comptes d'usurpation d'identité : ce paramètre spécifie le nom d’utilisateur que SQL Server Analysis Services utilise pour exécuter des instructions dans chaque source de données. Si aucun compte d'usurpation d'identité n'est spécifié, SQL Server Analysis Services utilise son compte de connexion pour exécuter des instructions. Si le compte d’ouverture de session reçoit des autorisations directement dans la source de données, tous les administrateurs de base de données de toutes les bases de données de l’instance SQL Server Analysis Services ont accès à la source de données via le compte d’ouverture de session. Si un compte d’utilisateur et un mot de passe sont spécifiés, ces informations sont toujours supprimées avant que les informations d’emprunt d’identité ne soient stockées dans ce fichier. Toutefois, si l’Assistant Déploiement est déployé directement sur une instance Analysis Services, vous pouvez ajouter les informations d’id utilisateur et de mot de passe appropriées dans l’Assistant pour permettre un traitement réussi de la base de données de déploiement. Les informations d’usurpation d'identité ne seront pas stockées dans le script de déploiement lui-même si un script est enregistré par l'Assistant de déploiement.

    Note

    Pour les modèles tabulaires au niveau de compatibilité 1400 et supérieur, avec des connexions à des sources de données de fournisseur structurées, lorsque vous sélectionnez Conserver les paramètres de configuration des objets existants dans la page Spécifier les propriétés de configuration de l’Assistant, le nom d'utilisateur et le mot de passe stockés dans la base de données du modèle tabulaire sur le serveur cible ne sont pas conservés. Les administrateurs doivent définir manuellement le nom d’utilisateur et le mot de passe à l’aide de SSMS une fois le déploiement terminé.

  • Fichiers journaux d’erreurs clés : ce paramètre spécifie le nom de fichier et le chemin d’accès du fichier journal d’erreurs de clé pour chaque cube, groupe de mesures, partition et dimension dans la base de données.

  • Emplacements de stockage : ce paramètre spécifie l’emplacement de stockage de chaque cube, groupe de mesures et partition dans la base de données. Si aucune valeur n’est fournie pour un objet, l’Assistant Déploiement utilise l’emplacement par défaut de l’objet. Par exemple, les partitions utilisent l’emplacement du groupe de mesures, les groupes de mesures utilisent l’emplacement du cube et les cubes utilisent l’emplacement par défaut pour les objets sur l’instance de serveur. L’emplacement de stockage peut être un chemin LOCAL ou UNC (Universal Naming Convention).

  • Serveur de rapports : ce paramètre spécifie l’emplacement du serveur de rapports et du dossier pour chaque action de rapport définie dans chaque cube de la base de données.

Modification des paramètres de configuration

Dans certains cas, vous devrez peut-être déployer le projet à l’aide de paramètres de configuration différents de ceux stockés dans le < fichier nom> de projet.configsettings. Par exemple, vous pouvez modifier la chaîne de connexion en une ou plusieurs sources de données, ou spécifier des emplacements de stockage pour des partitions ou des groupes de mesures spécifiques.

Pour modifier le déploiement de partitions et de rôles dans un projet, vous devez modifier ces informations dans le < fichier nom.configsettings du >, comme décrit dans la procédure ci-dessous. Vous ne pouvez pas modifier les paramètres de partition et de rôles dans le projet, car la boîte de dialogue < propriétés du >nom du projet dans SQL Server Data Tools n’affiche pas ces options.

Note

Les paramètres de configuration peuvent s’appliquer à tous les objets ou uniquement aux objets nouvellement créés. Appliquez les paramètres de configuration aux objets nouvellement créés uniquement lorsque vous déployez des objets supplémentaires sur une base de données SQL Server Analysis Services précédemment déployée et que vous ne souhaitez pas remplacer les objets existants. Pour spécifier si les paramètres de configuration s’appliquent à tous les objets ou uniquement aux nouveaux objets créés, définissez cette option dans le < fichier project name.deploymentoptions>.

Pour modifier les paramètres de configuration une fois les fichiers d’entrée générés

  • Exécutez l’Assistant Déploiement de manière interactive et, dans la page Paramètres de configuration, spécifiez le paramètre de configuration des objets en cours de déploiement.

    - ou -

  • Exécutez l’Assistant Déploiement à l’invite de commandes et configurez l'Assistant pour l'exécution en mode fichier de réponses.

    - ou -

  • Modifiez le fichier <project name>.configsettings à l’aide de n’importe quel éditeur de texte.

Fichiers de script de déploiement - Options de traitement

L’Assistant Déploiement lit les options de traitement à partir du < fichier nom.deploymentoptions du >. SQL Server Data Tools crée ce fichier lorsque vous générez le projet. SQL Server Data Tools utilise les options de traitement spécifiées dans la page Déploiement du dialogue Pages de Propriétés de <>de projet pour créer le fichier <nom_de_projet>.deploymentoptions.

Examen des options de traitement

Les paramètres de configuration stockés dans le fichier nom.deploymentoptions <du > sont les suivants :

  • Méthode de traitement : ce paramètre contrôle si les objets déployés sont traités après le déploiement et le type de traitement qui sera effectué. Il existe trois options de traitement :

    • Le traitement par défaut (valeur par défaut) détecte l’état de processus des objets de base de données et effectue le traitement nécessaire pour fournir des objets non traités ou partiellement traités à un état entièrement traité.

    • Le traitement complet traite un objet et tous les objets qu’il contient. Lorsque Process Full est exécuté sur un objet déjà traité, Analysis Services supprime toutes les données de l’objet, puis traite l’objet.

    • Aucun signifie qu’aucun traitement n’est effectué.

  • Options de table d’écriture différée : si l’écriture différée est activée dans le projet, ce paramètre définit la façon dont l’écriture différée est gérée. Il existe trois options de table d’écriture différée :

    • Par défaut, si une table d’écriture différée existe, elle sera utilisée. Si une table d’écriture différée n’existe pas, une nouvelle table d’écriture différée est créée.

    • Si une table d’écriture différée existe déjà, le déploiement échoue. Si une table d’écriture différée n’existe pas, une nouvelle table d’écriture différée est créée.

    • Indépendamment de l’existence d’une table d’écriture différée, une nouvelle table d’écriture différée est créée. Dans ce cas, l’Assistant Déploiement supprime toute table existante et la remplace par une nouvelle table d’écriture différée.

  • Déploiement transactionnel : ce paramètre contrôle si le déploiement des modifications de métadonnées et des commandes de processus se produit dans une transaction unique ou dans des transactions distinctes.

    • Si cette option a la valeur True (valeur par défaut), SQL Server Analysis Services déploie toutes les modifications de métadonnées et toutes les commandes de processus au sein d’une seule transaction.

    • Si cette option a la valeur False, SQL Server Analysis Services déploie les modifications de métadonnées dans une transaction unique et déploie chaque commande de traitement dans sa propre transaction.

Modification des options de traitement

Toutefois, vous devrez peut-être déployer le projet à l’aide d’options de traitement différentes de celles stockées dans le < fichier name.deploymentoptions du >. Par exemple, vous souhaiterez peut-être que tous les objets soient entièrement traités ou traités à l’aide de l’option de traitement par défaut ou qu’aucun traitement ne se produise. Si les cubes ou dimensions sont activés en écriture, vous pouvez spécifier si une table de remontée nouvelle ou existante doit être utilisée.

Pour modifier les options de traitement utilisées pendant le déploiement, vous pouvez modifier et reconstruire le projet, ou modifier les options de traitement dans le fichier d’entrée à l’aide de l’une des méthodes décrites dans la procédure suivante.

Pour modifier les options de traitement après la génération des fichiers d’entrée

  • Exécutez l’Assistant Déploiement de manière interactive. Dans la page Options de traitement , spécifiez les options de traitement du projet en cours de déploiement.

    - ou -

  • Exécutez l’Assistant Déploiement à l’invite de commandes et configurez-le pour qu'il fonctionne en mode fichier réponse.

    - ou -

  • Modifiez le fichier <project name>.deploymentoptions à l’aide d’> n’importe quel éditeur de texte.

Voir aussi

Déployer des solutions de modèle à l’aide de XMLA
Déployer des solutions de modèle avec l’utilitaire de déploiement

  • Last updated on