Partager via


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

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

L’Assistant Déploiement SQL Server Analysis Services utilise des fichiers de sortie JSON générés à partir d’un projet SQL Server Analysis Services comme 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 alors être immédiatement exécuté ou enregistré en vue d'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 aussi automatiser le déploiement ou utiliser la fonctionnalité de Synchronisation. Si la base de données déployée est de grande taille, 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 d’objet tabulaire (TOM), du langage TMSL (Tabular Model Scriting Language) et des objets de gestion des analyses (AMO).

Important

Ni les fichiers de sortie ni le script de déploiement ne contiennent l’ID utilisateur ou le mot de passe si ceux-ci sont spécifiés dans le chaîne de connexion pour une source de données ou à des fins d’emprunt d’identité. Dans la mesure où ces informations sont nécessaires pour le traitement dans ce scénario, vous devez les ajouter manuellement. Si le déploiement n'inclut pas de traitement, vous pouvez ajouter ces informations de connexion et d'emprunt d'identité en fonction de vos besoins 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 une fois qu'il a été enregistré.

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, tel qu’il est modifié de manière interactive par l’entrée utilisateur. L'Assistant applique les modifications utilisateur uniquement au script de déploiement. Il 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 les opérations suivantes : vous demander une entrée utilisateur et modifier les fichiers d'entrée en fonction de cette entrée, exécuter un déploiement automatisé en mode silencieux en utilisant les fichiers d'entrée tels quels, ou créer un script de déploiement que vous pouvez utiliser ultérieurement.

Exécution interactive

Lors de l’exécution interactive, l’Assistant Déploiement lit les valeurs des fichiers d’entrée et vous présente ces informations. 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 chaîne de connexion mots de passe, ou les laisser en l’état. Si vous modifiez des valeurs d’entrée, l’Assistant utilise ces modifications lors de la génération du script de déploiement. Toutefois, il ne modifie pas les valeurs du fichier d'entrée.

Notes

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 de réponses.

Après avoir passé en revue 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 l'enregistrer en vue d'une utilisation ultérieure.

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

  • Cliquez sur Démarrer, puis tapez Assistant Déploiement d’Analysis Services.

    -ou-

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

    Notes

    Si vous ne trouvez pas le fichier .asdatabase, utilisez la fonction de recherche et spécifiez *.asdatabase. Vous devrez peut-être générer 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 à l’invite de commandes, vous fournissez le chemin d’accès complet au fichier .asdatabase et exécutez l’Assistant dans l’un des modes suivants :

Mode de fichier de réponses
En mode fichier de réponses, 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é intégré 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 deviennent le nouveau point de départ de la prochaine exécution de l'Assistant.

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

Mode silencieux
En mode silencieux, l'Assistant exécute un déploiement automatisé en fonction des informations qui se trouvent dans les fichiers d'entrée.

Pour exécuter l’Assistant en mode silencieux, utilisez le commutateur /s . Lorsque vous exécutez l'Assistant en mode silencieux, les messages sont affichés sur la console ou enregistrés dans un fichier journal (s'il en existe un).

Mode de 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 à partir de l'invite de commandes

  1. S’il est installé 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 qui correspondent au mode dans lequel vous souhaitez exécuter l'Assistant.

Compréhension 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 nécessaires 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 n'affecte que les objets qui ont été modifiés ou supprimés.

  • La seconde 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 (option Traiter par défaut) ou pour traiter intégralement la base de données de destination. Vous pouvez également décider que le script de déploiement ne contiendra aucune commande de traitement.

L'ensemble du script de déploiement peut être exécuté dans une seule transaction ou dans plusieurs transactions. Si le script est exécuté dans plusieurs transactions, la première partie du script est exécutée sous la forme d'une seule transaction, et chaque objet est traité dans sa propre transaction.

Important

L’Assistant Déploiement SQL Server Analysis Services déploie uniquement des objets dans une base de données SQL Server Analysis Services unique. Il ne déploie pas des objets, ni des 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 Description
<nom du> projet. asdatabase Un fichier XMLA pour les projets de modèle tabulaire multidimensionnel ou 1100/1103, ou un fichier JSON pour les projets de modèles tabulaires 1200 et ultérieurs. Contient les définitions déclaratives de tous les objets SQL Server Analysis Services dans le projet.
<nom du> projet. déploiementtargets Contient le nom de la SQL Server Analysis Services instance et de la base de données dans laquelle les objets SQL Server Analysis Services seront créés.
<nom du> projet. configsettings Contient des paramètres spécifiques à l'environnement, par exemple des informations sur la connexion à une source de données et les emplacements de stockage des objets. Les paramètres de ce fichier remplacent les paramètres dans le < fichier project name.asdatabase>.
<nom du> projet. deploymentoptions Contient des options de déploiement qui déterminent, par exemple, 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 des 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 nom> du projet.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 des scripts de déploiement différents selon les buts poursuivis.

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 nom> du projet.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 nom> du projet.targets.

Modification de la cible d’installation

Dans certains cas, vous devrez peut-être déployer un projet sur une base de données ou un instance différent de celui spécifié dans la page Déploiement. Par exemple, vous pouvez choisir de déployer le projet vers un serveur où il sera testé avant son déploiement, puis de le déployer vers un serveur de production une fois les tests terminés. Vous pouvez aussi décider de déployer un projet terminé et testé vers plusieurs serveurs de production dans un cluster d'équilibrage de la charge réseau, ou encore vers un serveur de test 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 l’Assistant Déploiement SQL Server Analysis Services de manière interactive. Dans la page Cible d’installation, spécifiez une nouvelle destination pour le SQL Server Analysis Services instance et la base de données.

    -ou-

  • Exécutez l’Assistant Déploiement SQL Server Analysis Services à l’invite de commandes et définissez l’Assistant pour qu’il s’exécute en mode fichier de réponses.

    -ou-

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

Fichiers de script de déploiement : options de déploiement de partitions et de rôles

L’Assistant Déploiement lit les options de déploiement de partition et de rôle à partir du < fichier project name.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 en cours lors de la création du < fichier nom> du projet.deploymentoptions.

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

Les options de déploiement dans le < fichier project name.deploymentoptions >sont les suivantes :

Options de déploiement de partitions
Le < fichier project name.deploymentoptions> spécifie si les partitions existantes dans 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 restent inchangées.

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

Options de déploiement de rôles
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 existant dans la base de données de destination sont conservés, et seuls les nouveaux rôles et membres de rôle sont déployés.

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

  • Les rôles et les membres de rôle existant 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 membres existants sont conservés, les autorisations associées à ces rôles sont réinitialisées à aucune. Les autorisations de sécurité sont contenues dans les objets qu'elles sécurisent, et non dans les rôles de sécurité auxquels elles sont associées. Pour plus d’informations sur l’utilisation de ce comportement à l’aide de l’Assistant Déploiement d’Analysis Service, consultez « Conserver les rôles et les membres » dans la Base de connaissances Microsoft.

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

Vous devrez peut-être déployer le projet à l’aide d’options de partition et de rôle différentes de celles stockées dans le fichier nom> du < projet.deploymentoptions. Par exemple, vous pouvez conserver les partitions, les rôles et les membres de rôle existants, au lieu de remplacer tous les partitions, rôles et membres existants, comme indiqué dans le fichier nom> du < 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 Pages de propriétés du nom>du< 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 nom> du < projet.deploymentoptions lui-même. La procédure suivante explique comment modifier les options de déploiement de partition et de rôle dans le fichier nom> du < projet.deploymentoptions.

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 de nouvelles options de déploiement pour les partitions et les rôles.

    -ou-

  • Exécutez l’Assistant Déploiement à l’invite de commandes, puis définissez l’Assistant pour qu’il s’exécute en mode fichier de réponses.

    -ou-

  • Ouvrez le nom> du < projet.deploymentoptions dans n’importe quel éditeur de texte et modifiez manuellement les options. Les options pour 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> du projet.configsettings.

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 de chaque source de données en fonction des valeurs spécifiées dans le projet. L'ID et le mot de passe utilisateur sont systématiquement supprimés de la chaîne de connexion avant que le reste de la chaîne ne soit stocké dans ce fichier. Cependant, si l'Assistant Déploiement déploie directement vers une instance Analysis Services, vous pouvez ajouter les informations d'ID et de mot de passe utilisateur appropriées dans l'Assistant pour permettre le traitement correct de la base de données de déploiement. Ces informations de connexion ne seront pas stockées dans le script de déploiement proprement dit, si un script est enregistré par l'Assistant Déploiement.

  • Comptes d’emprunt 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’emprunt d’identité n’est spécifié, SQL Server Analysis Services utilise son compte d’ouverture de session 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 du SQL Server Analysis Services instance ont accès à la source de données via le compte d’ouverture de session. Si un mot de passe et un compte d'utilisateur sont spécifiés, ces informations sont systématiquement supprimées avant que les informations d'emprunt d'identité ne soient stockées dans ce fichier. Cependant, si l'Assistant Déploiement déploie directement vers une instance Analysis Services, vous pouvez ajouter les informations d'ID et de mot de passe utilisateur appropriées dans l'Assistant pour permettre le traitement correct de la base de données de déploiement. Ces informations d'emprunt d'identité ne sont pas stockées dans le script de déploiement proprement dit, si un script est enregistré par l'Assistant Déploiement.

    Notes

    Pour les modèles tabulaires au niveau de compatibilité 1400 et supérieur avec les connexions de source de données de fournisseur structuré, lorsque vous sélectionnez Conserver les paramètres de configuration pour les 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 sur la base de données de modèle tabulaire du 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 de clé : ce paramètre spécifie le nom de fichier et le chemin d’accès du fichier journal des 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 le serveur instance. L'emplacement de stockage peut être un chemin d'accès local ou UNC (Universal Naming Convention).

  • Serveur de rapports : ce paramètre spécifie le serveur de rapports et l’emplacement 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> du projet.configsettings. Par exemple, vous pouvez modifier la chaîne de connexion à 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 project name.configsettings>, 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 Pages propriétés du nom>du projet dans SQL Server Data Tools n’affiche pas ces options.

Notes

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 dans une base de données SQL Server Analysis Services précédemment déployée et que vous ne souhaitez pas remplacer des objets existants. Pour spécifier si les paramètres de configuration s’appliquent à tous les objets ou uniquement aux nouveaux objets, définissez cette option dans le < fichier project name.deploymentoptions>.

Pour modifier des paramètres de configuration 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 Paramètres de configuration , spécifiez le paramètre de configuration pour les objets déployés.

    -ou-

  • Exécutez l’Assistant Déploiement à l’invite de commandes et définissez l’Assistant pour qu’il s’exécute 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> du < projet.deploymentoptions. 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 de la boîte de dialogue Pages de propriétés du nom>du< projet pour créer le < fichier nom> du projet.deploymentoptions.

Examen des options de traitement

Les paramètres de configuration stockés dans le < fichier nom> du projet.deploymentoptions 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é. Trois options de traitement sont possibles :

    • Le traitement par défaut (par défaut) détecte l’état du processus des objets de base de données et effectue le traitement nécessaire pour remettre les 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 la commande Traiter entièrement est sélectionnée pour un objet qui a déjà été 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. Trois options de table d'écriture différée sont possibles :

    • Par défaut, s'il existe une table d'écriture différée, elle est utilisée. S'il n'existe pas de table d'écriture différée, une nouvelle table d'écriture différée est créée.

    • S'il existe déjà une table d'écriture différée, le déploiement échoue. S'il n'existe pas de table d'écriture différée, une nouvelle table d'écriture différée est créée.

    • Une nouvelle table d'écriture différée est créée dans tous les cas, même s'il en existe déjà une. 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 les commandes de traitement se produisent dans une seule transaction 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 seule transaction 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 nom> du projet.deploymentoptions. Par exemple, vous pouvez souhaiter que tous les objets soient traités entièrement ou traités en utilisant l'option de traitement par défaut, ou encore qu'aucun traitement n'ait lieu. Si les cubes ou les dimensions sont activés en écriture, vous pouvez spécifier si une nouvelle table d'écriture différée ou une table existante doit être utilisée.

Pour modifier les options de traitement utilisées durant le déploiement, vous pouvez soit modifier et régénérer le projet, soit modifier les options de traitement dans le fichier d'entrée en utilisant l'une des méthodes décrites dans la procédure suivante.

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

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

    -ou-

  • Exécutez l’Assistant Déploiement à l’invite de commandes et définissez l’Assistant pour qu’il s’exécute en mode fichier de réponses.

    -ou-

  • Modifiez le < fichier project name.deploymentoptions >à l’aide de 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