Fichier Lisezmoi pour l'exemple du Gestionnaire Agrégation

Le Gestionnaire Agrégation est un exemple d'application qui vous permet d'afficher, de concevoir, de modifier et d'ajouter des agrégations basées sur les informations rassemblées dans le journal de requêtes.

Pour plus d'informations sur les problèmes de performances, consultez la section « Writing Efficient MDX » dans SQL Server 2005 Analysis Services Performance Guide (en anglais). Pour obtenir des informations sur la configuration du journal des requêtes, consultez Configuring the Analysis Services Query Log (en anglais).

Scénario

L'exemple du Gestionnaire Agrégation montre comment tirer parti des diverses fonctionnalités SQL Server 2005 Analysis Services pour gérer la conception d'agrégation.

L'exemple peut se connecter à une instance de Analysis Services et afficher un jeu de conceptions d'agrégation. Il affiche aussi les partitions auxquelles s'appliquent la conception d'agrégation.

Vous pouvez utiliser l'exemple pour afficher un jeu d'agrégations dans une conception d'agrégation particulière et pour modifier chaque agrégation selon vos besoins. Les conceptions d'agrégation peuvent être appliquées à n'importe quelle partition dans le groupe de mesures.

Vous exécutez l'exemple et vous connectez à la table du journal des requêtes pour importer des informations statistiques sur des requêtes MDX (Multidimensional Expressions), pour afficher les requêtes MDX et pour ajouter de nouvelles agrégations basées sur le jeu affiché.

Langages

C# (à l'aide du modèle d'objet AMO)

Fonctionnalités

L'exemple du Gestionnaire Agrégation utilise les nouvelles fonctionnalités suivantes de SQL Server 2005 Analysis Services.

Configuration préalable requise

Avant d'exécuter cet exemple :

1. Vérifiez que les logiciels suivants sont installés sur l'ordinateur du développeur :
   • Visual Studio 2005 avec compilateur C# ou Kit de développement .Net Framework 2.0 SDK
   • Les exemples SQL Server 2005 SP2 sont installés
2. Vérifiez que les services suivants ont démarré et sont disponibles soit sur l'ordinateur local, soit sur un autre ordinateur que vous pouvez administrer :
   • SQL Server Analysis Services
   • Moteur SQL Server
3. Assurez-vous que vous avez un fichier de signature nommé AggManager.snk. Pour créer un fichier de signature, suivez les étapes à la page Web Outil Strong Name Tool (Sn.exe).
4. Configurez Analysis Services pour enregistrer les requêtes, consultez Configuring the Analysis Services Query Log (en anglais). Attribuez la valeur 1 à QueryLogSampling.
5. Vérifiez que vous avez exécuté certaines requêtes par rapport à un cube sur lequel vous souhaitez concevoir des agrégations. Si vous ne disposez pas d'un cube adéquat sur lequel exécuter des requêtes, vous pouvez déployer la base de données Adventure Works DW et utilisez le cube Adventure Works comme scénario de test, consultez Installation des exemples de bases de données AdventureWorks et d'autres exemples via le programme d'installation.

Génération de l'exemple

Option 1 : Pour créer l'exemple à l'aide de Visual Studio

1. Localisez le dossier dans lequel est stocké le fichier de solution AggManager.sln.

2. Déplacez le fichier de signature AggManager.snk vers le dossier de solution.

3. Ouvrez Visual Studio.

4. Sous l'onglet Projets récents, en bas où est affichée la commande Ouvrir, cliquez sur Projet.

5. Ouvrez le dossier où vous avez enregistré le fichier AggManager.sln, sélectionnez le fichier, puis cliquez sur Ouvrir.

6. Appuyez sur F6 pour générer le projet.

Option 2 : Pour créer l'exemple à l'aide de msbuild.exe dans .Net Framework SDK

1. Localisez le dossier dans lequel est stocké le fichier de solution AggManager.sln.

2. Déplacez le fichier de signature AggManager.snk vers le dossier de solution.

3. Ouvrez une invite de commandes et remplacez le répertoire par l'emplacement où est situé le fichier de solution. Configurez l'environnement en fonction des spécifications dans la Comment : compiler à l'invite de commandes.

4. Tapez msbuild.exe AggManager.sln, puis appuyez sur Entrée.

Exécution de l'exemple

Avant d'exécuter l'exemple, vous devez enregistrer des journaux de requête dans une table SQL ; consultez Configuration préalable 4 et 5.

Étape 1 : Pour se connecter à Analysis Services

1. Démarrez l'exemple soit en appuyant sur F5 ou Ctrl+F5 dans Visual Studio en ayant AggManager.sln ouvert, ou en tapant AggManager.exe et en appuyant sur Entrée dans une fenêtre ouverte d'invite de commandes où figure le fichier exécutable.

2. Si vous vous connectez au même serveur sur lequel s'exécute l'exécutable, et l'instance que vous utilisez représente l'instance par défaut, vous pouvez laisser localhost tel quel et cliquer sur bouton Se connecter. Si vous vous connectez à un autre serveur ou une instance nommée, vous devez remplacer localhost par la valeur correcte Server Name ou <Server Name>\<Instance> et cliquer sur le bouton Se connecter.

3. Cliquez sur l'arborescence du serveur et vérifiez que vous pouvez parcourir les bases de données, les cubes et les autres objets disponibles.

Étape 2 : Pour vous connecter au journal des requêtes

1. Connectez-vous à Analysis Services si vous n'êtes pas encore connecté, consultez l'étape 1.

2. Développez l'objet de serveur en cliquant sur + en regard du nom du serveur, puis développez l'objet de dossier Bases de données.

3. Développez l'objet de base de données qui contient les cubes où vous avez exécuté les requêtes enregistrées, puis développez l'objet de dossier Cubes.

4. Développez l'objet de cube où les requêtes ont été exécutées et sont enregistrées, puis développez l'objet de dossier Groupes de mesures.

5. Développez un objet de groupe de mesures où vous souhaitez analyser et concevoir les agrégations.

6. Cliquez avec le bouton droit sur l'objet de dossier No Aggregation Design et sélectionnez Add from query log. Une nouvelle fenêtre s'ouvre.

7. Lisez la chaîne de connexion grisée dans la zone de texte Se connecter à SQL Server.

Étape 3 : Création d'une nouvelle conception d'agrégation, suppression d'une conception d'agrégation, association d'une conception d'agrégation à des partitions

1. Pour démarrer la création de nouvelles conceptions d'agrégation, vous devez être connecté à la base de données du journal des requêtes, consultez l'étape précédente

2. Dans la fenêtre Add Aggregations from Query Log, attribuez un nom à Aggregation Design Name et Préfixe d'agrégation. Aggregation Design Name est le nom de base des jeux de conceptions d'agrégation actuels. Préfixe d'agrégation est le nom spécifique de la nouvelle conception d'agrégation qui sera créée.

3. Si aucun enregistrement n'est disponible dans la grille de données, cliquez sur Exécuter SQL.

4. Cliquez sur OK pour créer la nouvelle conception d'agrégation et retourner à la fenêtre Gestionnaire Agrégation. Cliquer sur Annuler annule l'action en cours, ferme la fenêtre et vous ramène à la fenêtre du Gestionnaire Agrégation.

5. La conception d'agrégation créée récemment s'affiche désormais dans le cadre du nœud développé.

6. Pour supprimer une conception d'agrégation, cliquez avec le bouton droit sur celle-ci et sélectionnez Supprimer dans le menu contextuel.

7. Pour associer une partition à une conception d'agrégation, cliquez avec le bouton droit sur le nœud de conception voulu et sélectionnez Change Partitions.

8. Dans les fenêtres de partitions, sélectionnez les partitions souhaitées et destinées à la conception voulue, puis cliquez sur OK.

9. Développez le nœud et les partitions doivent maintenant s'afficher sous la conception.

Étape 4 : Modification de la conception d'agrégation, affichage de la définition de l'agrégation

1. Sélectionnez la conception d'agrégation que vous souhaitez modifier. Si le volet droit affiche Aggregation count sans valeur, la conception ne possède aucune agrégation ; procédez comme suit pour démarrer une conception d'agrégation. Si des agrégations sont déjà conçues, vous pouvez passer au numéro 8 et continuer les modifications à partir de là.

2. Cliquez avec le bouton droit sur la conception d'agrégation et sélectionnez Add from query log dans le menu contextuel ouvert.

3. Vérifiez la chaîne de connexion et réglez-la en conséquence.

4. Ajoutez un nom et un préfixe à cette conception.

5. Cliquez sur le bouton Exécuter SQL.

6. Si la requête a retourné un seul enregistrement contenant des zéro et des virgules uniquement, copiez cet enregistrement dans le Presse-papiers.

7. Cliquez sur le bouton OK ; le message suivant s'affiche Conception d'agrégation '<Your Aggregation Design Name here**>' mis à jour par les agrégations** n.

8. Sélectionnez la conception d'agrégation que vous souhaitez modifier, cliquez avec le bouton droit sur celle-ci et sélectionnez Modifier dans le menu contextuel.

9. Si une grille de données vide s'affiche, vous aurez besoin de la chaîne stockée dans le Presse-papiers des numéros 2 à 7. Cliquez sur la ligne sous la colonne Nom et entrez le nom de cette conception ; cliquez sur la ligne sous Définition del'agrégation et collez la ligne des zéros et des virgules à partir du Presse-papiers ; cliquez sous Type et entrez Flexible. Appuyez sur la touche TAB pour accéder à une nouvelle ligne. Vous avez créé une conception vide.

10. Séletionnez une ligne à partir de la grille de données. La petite icône qui s'affiche à gauche de la ligne vous indique la ligne sélectionnée. Si un groupe de lignes est sélectionné, seule est mise à jour la ligne comportant l'icône.

11. Dans le volet droit s'affiche la collection de toutes les dimensions définies pour le groupe de mesures actuel comme un ensemble d'arborescences. Chaque nœud supérieur représente une dimension ; l'activation ou la désactivation du nœud de dimension n'a aucun effet sur la conception d'agrégation. Vérifiez que vous avez sélectionné Show Attribute Relationships ; cette option est située exactement sous la barre de titre de la fenêtre. L'arborescence représente la relation d'attributs qui commence à l'attribut clé comme le premier niveau de nœud ; le niveau suivant des attributs concernent les attributs directement dépendants de la clé ou directement lié à la clé ; le niveau suivant contient les attributs directement liés à l'attribut père par une définition de relation d'attributs et semblables aux niveaux descendants. La chaîne des zéros, des uns et des virgules est une représentation graphique de la structure de l'arborescence des dimensions. La virgule est le séparateur des dimensions ; les zéros et les uns représentent chacun un attribut de dimension. La chaîne est représentée de gauche à droite, les nœuds de haut en bas ; chaque nœud d'attribut de dimension sélectionné apparaît dans la chaîne en tant que 1 et ceux qui ne sont pas sélectionnés sont représentés par un 0 dans la chaîne. Les niveaux inférieurs de granularité correspondent aux niveaux s'approchant du haut de l'arborescence.

12. Pour modifier une conception, vous devez sélectionner ou désélectionner des nœuds dans le volet droit, pour une ligne donnée, et les modifications seront aussi reportées dans l'arborescence.

    Remarque :
    Réduire la longueur de la chaîne entraîne le blocage de l'application.

13. Une fois vos modifications achevées, appuyez sur OK pour enregistrer votre travail.

14. Votre travail est enregistré en mémoire mais n'a pas été appliqué sur le serveur. Vous pouvez identifier les conceptions en attente d'application sur les serveurs par le suffixe ** modified** ajouté au nom du groupe des mesures.

15. Pour enregistrer vos modifications sur le serveur, cliquez avec le bouton droit sur le groupe de mesures et sélectionnez Enregistrer sur le serveur.

Étape 5 : Élimination des attributs redondants des agrégations dans la conception d'agrégation

1. Ouvrez une fenêtre Edit Aggregations Aggregation Design en cliquant avec le bouton droit sur le nœud de conception et en sélectionnant Modifier.

2. Pour éliminer des attributs redondants d'une conception d'agrégation, cliquez sur le bouton Eliminate Redundancy. Cette opération supprime tous les attributs qui sont redondants dans la conception actuelle ; elle ne conserve que la conception ayant moins d'attributs mais qui offrent plus de pertinence.

Étape 6 : Elimination des agrégations en double

1. Ouvrez une fenêtre Edit Aggregations Aggregation Design en cliquant avec le bouton droit sur le nœud de conception et en sélectionnant Modifier.

2. Pour éliminer des conceptions redondantes d'une conception d'agrégation, cliquez sur le bouton Eliminate Duplicates. Cette opération supprime toutes les lignes en double dans la conception actuelle ; elle ne conserve que la conception ayant moins d'attributs mais qui offrent plus de pertinence.

Suppression de l'exemple

Pour supprimer l'exemple Gestionnaire Agrégation

• Supprimez le dossier qui contient la solution et tous les dossiers descendants.