Fichier Lisezmoi pour la bibliothèque « Data Mining Web Controls »

Cet exemple fonctionne uniquement avec SQL Server 2005 et SQL Server 2008. Il ne fonctionnera pas avec les versions de SQL Server antérieures à SQL Server 2005.

La bibliothèque « Data Mining Web Controls » est une bibliothèque de contrôles Web d'exploration de données destinée à étendre les fonctionnalités d'exploration de données de Microsoft SQL Server Analysis Services au Web. Cette bibliothèque fournit une version légère des visionneuses de modèles d'exploration de données. À l'aide des contrôles Web d'exploration de données, vous pouvez parcourir des modèles d'exploration de données complexes à partir de n'importe quel ordinateur disposant de Microsoft Internet Explorer.

Ces contrôles sont des composants côté serveur, ce qui signifie qu'ils résident dans l'espace mémoire d'un serveur Web. Le serveur Web peut être l'ordinateur sur lequel Analysis Services est installé, mais ce n'est pas obligatoire. Par contre, Internet Information Services (IIS) et ASP.NET 2.0 (et versions ultérieures) doivent être installés et exécutés sur l'ordinateur où seront installés les contrôles Web d'exploration de données.

Les documents et le code source associés à chacun de ces exemples se trouvent dans le dossier C:\Program Files\Microsoft SQL Server\100\Samples\Analysis Services\DataMining\Data Mining Web Controls.

Langages

Transact-SQL et C#

Fonctionnalités

L'exemple « Data Mining Web Controls » utilise les fonctionnalités de SQL Server Analysis Services répertoriées dans le tableau suivant.

Configuration requise

Avant d'exécuter cet exemple, assurez-vous que les logiciels suivants sont installés :

• Microsoft SQL Server avec les composants suivants :
  • Moteur de base de données SQL Server
  • SQL Server Management Studio
  • Business Intelligence Development Studio
• Analysis Services
• Deux exemples de bases de données : Adventure Works DW (entrepôt de données) et AdventureWorks (OLTP)
• Exemples Analysis Services
• Projet Analysis Services Adventure Works DW, déployé sur une instance d'Analysis Services
• Kit de développement logiciel .NET Framework 2.0 (SDK) ou Microsoft Visual Studio 2005. Vous pouvez obtenir gratuitement le Kit de développement .NET Framework SDK. Pour plus d'informations, consultez Installation de la documentation .NET Framework. dans la documentation en ligne de SQL Server.

Une version mise à jour de la base de données AdventureWorks est également disponible pour téléchargement sur la page Web du Centre pour les développeurs Microsoft SQL Server.

Une version mise à jour des exemples du Moteur de base de données SQL Server est également disponible pour téléchargement sur la page Web SQL Server Developer Center (Centre des développeurs SQL Server).

Remarque :

SQL Server Business Intelligence Development Studio n'est pas pris en charge sur les ordinateurs équipés de la plateforme Itanium ; l'environnement de développement 64 bits est pris en charge sur les plateformes x64. Vous pouvez modifier les exemples SQL Server et les exécuter sur des ordinateurs dotés de plateformes x86 ou x64 lorsque les bases de données employées par les exemples sont déployées sur une plateforme Itanium.

Génération de l'exemple

Avant de générer l'exemple, veillez à installer Analysis Services sur l'ordinateur exécutant le serveur Web. Si vous ne pouvez pas installer complètement Analysis Services, vous devez au minimum installer MSOLAP, qui est le fournisseur OLE DB pour Analysis Services. MSOLAP fournit la connectivité du client pour le serveur et les contrôles Web d'exploration de données ont besoin de ce fournisseur pour se connecter au serveur qui exécute Analysis Services et les modèles d'exploration de données.

Pour générer l'exemple, vous devez effectuer les tâches suivantes :

• Installer et déployer l'exemple de projet Analysis Services Adventure Works DW. Ce projet contient le modèle d'exploration de données qui sera utilisé dans le projet.
• Générer et installer les contrôles Web d'exploration de données.

Les procédures suivantes montrent comment effectuer chacune de ces tâches pour l'installation.

Pour déployer le modèle d'exploration de données

1. Dans l'Explorateur Windows, recherchez C:\Program Files\Microsoft SQL Server\100\Tools\Samples\AdventureWorks Analysis Services Project, ouvrez le dossier correspondant à l'édition de SQL Server installée sur votre ordinateur, puis double-cliquez sur le fichier Adventure Works.sln.

   Le projet Adventure Works DW s'ouvre dans Business Intelligence Development Studio.

2. Appuyez sur F5 pour générer et déployer le projet.

   Remarque :
   Le fait de générer et de déployer le projet AdventureWorksAS entraîne le déploiement du modèle d'exploration de données sur le serveur.

Pour générer et installer les contrôles Web d'exploration de données

1. Dans l'Explorateur Windows, recherchez C:\Program Files\Microsoft SQL Server\100\Samples\Analysis Services\DataMining\Data Mining Web Controls, puis double-cliquez sur le fichier WebControls.sln.

   La solution WebControls s'ouvre dans Visual Studio.

2. Dans le menu Générer, cliquez sur Gestionnaire de configuration.

3. Dans la boîte de dialogue Gestionnaire de configuration, activez les cases à cocher Générer pour les projets DMHTMLViewersSetup et WebControls (si elles ne le sont pas déjà).

4. Dans le menu Générer, cliquez sur Régénérer la solution.

5. Dans l'Explorateur Windows, recherchez C:\Program Files\Microsoft SQL Server\100\Samples\Analysis Services\DataMining\Data Mining Web Controls\WebControlsSetup\Debug, puis double-cliquez sur le fichier setup.exe.

6. Dans l'Assistant Installation des contrôles HTML d'exploration de données de Microsoft SQL Server, cliquez deux fois sur Suivant pour lancer l'installation des contrôles.

7. Une fois que les contrôles sont installés, cliquez sur Suivant, puis sur Terminer pour fermer l'Assistant.

   À la fin de l'Assistant, les dossiers suivants auront été ajoutés au serveur :

   • Dossier C:\Program Files\Microsoft.AnalysisServices.DataMiningHtmlViewers qui contient la bibliothèque, le code source des contrôles et ce document.
   • Dossier C:\Inetpub\wwwroot\aspnet_client\microsoft_analysisservices_datamininghtmlviewers qui contient les scripts et images côté client utilisés par les contrôles Web d'exploration de données. Ce dossier est également partagé sur le Web.

Ajout des contrôles à une application

Après avoir généré l'exemple, vous pouvez utiliser les contrôles d'exploration de données. Pour pouvoir utiliser ces contrôles, vous devez d'abord créer une application Web ASP.NET, ajouter les contrôles de votre choix à l'application, puis configurer les contrôles que vous venez d'ajouter.

Pour ajouter les contrôles d'exploration de données à une application Web

1. Dans le menu Fichier de Microsoft Visual Studio .NET, cliquez sur Nouveau site Web.

2. Dans la boîte de dialogue Nouveau site Web, sélectionnez Site Web ASP.NET, sélectionnez Microsoft Visual Basic ou Microsoft C# en tant que langage, puis cliquez sur OK.

3. Si la boîte à outils n'est actuellement pas visible, dans le menu Affichage, cliquez sur Boîte à outils.

4. Dans la boîte à outils, développez la catégorie à laquelle vous voulez ajouter les contrôles d'exploration de données (par exemple, développez Standard), cliquez avec le bouton droit à l'intérieur de cette catégorie, puis cliquez sur Choisir les éléments.

5. Dans la boîte de dialogue Choisir des éléments de boîte à outils, recherchez et ouvrez le fichier C:\Program Files\Microsoft.AnalysisServices.DataMiningHtmlViewers\Microsoft.AnalysisServices.DataMiningHTMLViewers.dll.

   Les trois contrôles d'exploration de données apparaissent dans la liste des composants ; leurs cases à cocher ont été automatiquement activées.

6. Cliquez sur OK.

   Les trois contrôles d'exploration de données doivent maintenant être visibles dans la catégorie sélectionnée dans la boîte à outils.

7. Pour ajouter un contrôle d'exploration de données à l'application, faites-le glisser de la boîte à outils vers la page de création de formulaire Web.

   Une fois que vous avez placé un contrôle d'exploration de données sur la page de formulaire Web, certaines propriétés du contrôle doivent être obligatoirement définies, tandis que d'autres sont facultatives. La section suivante explique comment définir ces propriétés.

Définition des propriétés du contrôle

Un contrôle Web d'exploration de données possède deux catégories de propriétés :

• La catégorie Data Mining Content contient les propriétés qui définissent le modèle à afficher. Parmi ces propriétés, certaines doivent être obligatoirement définies pour pouvoir utiliser le contrôle. Le tableau suivant répertorie les propriétés communes à tous les contrôles Web et indique quelles propriétés doivent être définies pour tous les contrôles.

  Propriété	Type	Valeur par défaut	Modifications requises
  Server	chaîne	Localhost	Oui
  Database	chaîne	<vide>	Oui
  Model	chaîne	<vide>	Oui
  Connection	System.Data.OleDb.OleDbConnection	(aucune)	Non

  En plus de ces contrôles communs, le contrôle DMDecisionTreeViewer possède des propriétés Data Mining Content supplémentaires qui doivent être définies. Pour plus d'informations sur ces propriétés supplémentaires, consultez la section qui explique comment définir les propriétés du contrôle DMDecisionTreeViewer.

• La catégorie Data Mining Layout contient les propriétés graphiques des contrôles. Étant donné que la représentation graphique de chacun des contrôles Web d'exploration de données est différente, les propriétés graphiques associées aux contrôles varient d'un contrôle à l'autre. Vous pouvez utiliser tels quels les paramètres par défaut de ces propriétés.

Pour définir les propriétés d'un contrôle, vous pouvez utiliser la fenêtre Propriétés dans Visual Studio. Si la fenêtre Propriétés ne s'affiche pas, cliquez avec le bouton droit sur le contrôle, puis cliquez sur Propriétés. Pour accéder facilement aux propriétés du contrôle, vous pouvez aussi sélectionner l'affichage par catégories dans Propriétés.

Remarque :
Vous pouvez également définir ces valeurs par programme dans le code figurant sous l'onglet Source.

Définition des propriétés du contrôle DMClusterView

Le contrôle DMClusterViewer vous permet d'afficher le contenu des modèles créés à l'aide de l'algorithme de gestion de clusters Microsoft. Moins riche que le composant Cluster Viewer fourni dans Business Intelligence Development Studio, le composant Cluster Viewer de ce contrôle ne prend en charge que les caractéristiques et la discrimination de cluster.

Le contrôle DMClusterViewer possède des propriétés dans la catégorie Data Mining Content qui doivent être définies et des propriétés dans la catégorie Data Mining Layout facultatives dont les paramètres par défaut peuvent être utilisés tels quels.

Définition des propriétés Data Mining Content du contrôle DMClusterView

Les propriétés de la catégorie Data Mining Content qui doivent être définies pour le contrôle DMClusterView sont celles qui sont communes à tous les contrôles Web : Server, Database et Model. Si vous le souhaitez, vous pouvez également modifier la propriété Connection de ce contrôle.

Pour définir les propriétés requises par le contrôle DMClusterView

1. Dans Visual Studio, affichez le formulaire Web en mode Conception et sélectionnez le contrôle DMClusterView.

2. Dans la fenêtre Propriétés, dans la catégorie Data Mining Content, définissez les propriétés suivantes :

   • Affectez à la propriété Server le nom de l'ordinateur sur lequel est installé Analysis Services.
   • Affectez à la propriété Database le nom du catalogue contenant le modèle à afficher. Pour cet exemple, le nom de la base de données contenant le modèle d'exploration de données est Adventure Works DW.
   • Affectez à la propriété Model le modèle d'exploration de données à charger dans la visionneuse.
   • (Facultatif) Affectez à la propriété Connection une connexion OLE DB existante (c'est-à-dire un objet System.Data.OleDb.OleDbConnection). Ceci permet au contrôle de partager une connexion avec l'application au lieu d'en créer une nouvelle.

Définition des propriétés Data Mining Layout du contrôle DMClusterView

Le tableau suivant répertorie les propriétés graphiques associées au contrôle DMClusterView. Vous n'êtes pas obligé de modifier les paramètres par défaut de ces propriétés graphiques.

Pour définir les propriétés graphiques du contrôle DMClusterView

1. Dans Visual Studio, affichez le formulaire Web en mode Conception et sélectionnez le contrôle DMClusterView.

2. Dans la fenêtre Propriétés, dans la catégorie Data Mining Layout, définissez les propriétés suivantes :

Définition des propriétés du contrôle DMNaiveBayesViewer

Le contrôle DMNaiveBayesViewer vous permet d'afficher le contenu des modèles d'exploration de données créés à l'aide de l'algorithme MNB (Microsoft Naive Bayes). Le contrôle DMNaiveBayesViewer ne prend en charge que les caractéristiques d'attribut et la discrimination entre les valeurs d'attribut.

Définition des propriétés Data Mining Content du contrôle DMNaiveBayesViewer

Les propriétés de la catégorie Data Mining Content qui doivent être définies pour le contrôle DMNaiveBayesViewer sont celles qui sont communes à tous les contrôles Web : Server, Database et Model. Si vous le souhaitez, vous pouvez également modifier la propriété Connection de ce contrôle.

Pour définir les propriétés requises par le contrôle DMNaiveBayesViewer

1. Dans Visual Studio, affichez le formulaire Web en mode Conception et sélectionnez le contrôle DMNaiveBayesViewer.

2. Dans la fenêtre Propriétés, dans la catégorie Data Mining Content, définissez les propriétés suivantes :

   • Affectez à la propriété Server le nom de l'ordinateur sur lequel est installé Analysis Services.
   • Affectez à la propriété Database le nom du catalogue contenant le modèle à afficher. Pour cet exemple, le nom de la base de données contenant le modèle d'exploration de données est Adventure Works DW.
   • Affectez à la propriété Model le modèle d'exploration de données à charger dans la visionneuse.
   • (Facultatif) Affectez à la propriété Connection une connexion OLE DB existante (c'est-à-dire un objet System.Data.OleDb.OleDbConnection). Ceci permet au contrôle de partager une connexion avec l'application au lieu d'en créer une nouvelle.

Définition des propriétés Data Mining Layout du contrôle DMNaiveBayesViewer

Le tableau suivant répertorie les propriétés graphiques associées au contrôle DMNaiveBayesViewer. Vous n'êtes pas obligé de modifier les paramètres par défaut de ces propriétés graphiques.

Pour définir les propriétés propres au contrôle DMNaiveBayesViewer

1. Dans Visual Studio, affichez le formulaire Web en mode Conception et sélectionnez le contrôle DMNaiveBayesViewer.

2. Dans la fenêtre Propriétés, dans la catégorie Data Mining Layout, définissez les propriétés suivantes :

Définition des propriétés du contrôle DMDecisionTreeViewer

Le contrôle DMDecisionTreeViewer vous permet d'afficher le contenu des modèles créés à l'aide de l'algorithme MDT (Microsoft Decision Trees). Le contrôle DMDecisionTreesViewer peut fonctionner dans les deux modes suivants :

• Arborescence
  Affiche un arbre de décision complet et permet les opérations suivantes :

  • Développement et réduction des nœuds.
  • Suivi des fractionnements dans les arbres de décision.
  • Ombrage basé sur la prise en charge d'un état de l'attribut prédit.
  • Inspection, par le biais d'une info-bulle, des distributions pour un nœud spécifique.

• Détails du nœud
  Fournit des détails sur un nœud spécifique de l'arborescence, identifié par le champ NODE_UNIQUE_NAME du schéma MINING_MODEL_CONTENT. Le mode Détails du nœud varie selon que l'attribut est discret/discrétisé (classification) ou continu (régression).

Définition des propriétés Data Mining Content du contrôle DMDecisionTreeViewer

En plus des propriétés de la catégorie Data Mining Content qui sont communes à tous les contrôles Web (Server, Database et Model), vous devez définir pour le contrôle DMDecisionTreeViewer les propriétés répertoriées dans le tableau suivant.

Remarque   Vous devez définir soit la propriété TargetTree, soit la propriété TargetNode. Ces propriétés ne peuvent pas avoir toutes les deux la valeur <vide>.

Pour définir les propriétés requises par le contrôle DMDecisionTreeViewer

1. Dans Visual Studio, affichez le formulaire Web en mode Conception et sélectionnez le contrôle DMDecisionTreeViewer.

2. Dans la fenêtre Propriétés, dans la catégorie Data Mining Content, définissez les propriétés suivantes :

   • Affectez à la propriété Server le nom de l'ordinateur sur lequel est installé Analysis Services.

   • Affectez à la propriété Database le nom du catalogue contenant le modèle à afficher. Pour cet exemple, le nom de la base de données contenant le modèle d'exploration de données est Adventure Works DW.

   • Affectez à la propriété Model le modèle d'exploration de données à charger dans la visionneuse.

   • (Facultatif) Affectez à la propriété Connection une connexion OLE DB existante (c'est-à-dire un objet System.Data.OleDb.OleDbConnection). Ceci permet au contrôle de partager une connexion avec l'application au lieu d'en créer une nouvelle.

   • Affectez à la propriété TargetTree l'arborescence à afficher dans le contrôle. Cette arborescence est identifiée par le nom de l'attribut prévisible. Pour récupérer les noms des attributs prévisibles d'un modèle, utilisez une requête semblable à celle-ci :

     "SELECT ATTRIBUTE_NAME FROM [Model].CONTENT WHERE NODE_TYPE=2"
     

     Remarque :
     Si vous utilisez le contrôle DMDecisionTreeViewer en mode Arborescence, vous devez définir la propriété TargetTree.

   • Affectez à la propriété TargetNode la valeur NODE_UNIQUE_NAME du nœud à afficher. Pour obtenir une liste des nœuds figurant dans l'arborescence, utilisez une requête semblable à celle-ci :

     "SELECT NODE_UNIQUE_NAME, ATTRIBUTE_NAME FROM [Model].CONTENT WHERE NODE_TYPE=3 OR NODE_TYPE=4"
     

     Remarque :
     Si vous utilisez le contrôle DMDecisionTreeViewer en mode Détails du nœud, vous devez définir la propriété TargetNode.

Définition des propriétés Data Mining Layout du contrôle DMDecisionTreeViewer

Le tableau suivant répertorie les propriétés graphiques associées au contrôle DMDecisionTreeViewer. Vous n'êtes pas obligé de modifier les paramètres par défaut de ces propriétés graphiques.

Pour définir les propriétés propres au contrôle DMDecisionTreeViewer

1. Dans Visual Studio, affichez le formulaire Web en mode Conception et sélectionnez le contrôle DMDecisionTreeViewer.

2. Dans la fenêtre Propriétés, dans la catégorie Data Mining Layout, définissez les propriétés suivantes :

Application de l'emprunt d'identité

Lorsqu'un utilisateur ouvre votre page, les contrôles sont instanciés. Les contrôles utilisent une connexion OLE DB pour accéder au serveur exécutant Analysis Services et les modèles d'exploration de données. Par défaut, les applications ASP.NET s'exécutent sous les informations d'identification d'un utilisateur spécifique, <MACHINE\ASPNET>, qui dispose d'autorisations limitées. Cet ensemble d'autorisations n'est pas suffisant pour accéder aux modèles d'exploration de données.

Pour résoudre facilement et sans risques le problème des autorisations limitées de l'utilisateur <MACHINE\ASPNET>, il suffit d'appliquer l'emprunt d'identité de l'utilisateur Web dans l'application ASP.NET. Pour appliquer l'emprunt d'identité, vous devez désactiver l'accès anonyme pour l'application que vous êtes en train de développer. Une fois que vous avez désactivé l'accès anonyme, votre application Web empruntera l'identité de l'utilisateur du client Web et accèdera à l'instance d'Analysis Services en utilisant les informations d'identification de cet utilisateur. Pour plus d'informations sur la désactivation de l'accès anonyme dans les applications ASP.NET, consultez la documentation fournie avec Visual Studio et IIS.

Il existe d'autres méthodes permettant de résoudre le problème d'accès dû à l'utilisateur <MACHINE\ASPNET> :

• Emprunter l'identité d'un utilisateur spécifique pour toutes les demandes (pour plus d'informations, consultez l'article sur l'<identité> dans web.config dans la bibliothèque MSDN fournie avec Visual Studio .NET).

• Ajouter des autorisations d'exploration de données à l'utilisateur <MACHINE\ASPNET> dans l'instance d'Analysis Services. Les autorisations Accès en lecture et ReadDefinition sont requises pour pouvoir afficher la base de données, la structure d'exploration de données et le modèle d'exploration de données dans les contrôles Web.

  Remarque :
  Les contrôles ne pourront pas accéder à l'instance d'Analysis Services si les autorisations de sécurité ne sont pas correctement configurées à l'aide de l'une des méthodes décrites ci-dessus.

Commentaires

Si une erreur se produit lors du rendu d'un contrôle, le message d'erreur s'affiche en rouge sur la page.

Voir aussi

Tâches

Fichier Lisezmoi pour les algorithmes de plug-in SQL Server

Autres ressources

Algorithmes de plug-in

Aide et informations

Assistance sur SQL Server 2008