Partager via


Readme_ServiceBrokerConfiguration

Mis à jour : 5 décembre 2005

Cet exemple illustre la création d'objets Service Broker à l'aide de SMO (SQL Server Management Objects). Il est implémenté car plusieurs classes et contrôles utilisateur Windows sont nécessaires pour créer des objets Service Broker.

Cet exemple est destiné à un développeur Microsoft .NET Framework qui souhaite se familiariser avec SMO et créer des contrôles utilisateur Windows pour gérer des objets SQL Server 2005. Le scénario de base concrétise la création d'une application de gestion Service Broker personnalisée par un développeur Microsoft .NET Framework.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Configuration requise

Cet exemple nécessite l'installation des composants suivants.

  • .NET Framework SDK 2.0. Vous pouvez vous procurer gratuitement le Kit de développement .NET Framework SDK. Pour plus d'informations, consultez Installation du SDK .NET Framework.
  • Moteur de base de données SQL Server 2005.

Région

Si l'exemple de code a été installé à l'emplacement par défaut, l'exemple se trouve dans le répertoire suivant :

C:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\SMO\ ServiceBrokerConfiguration

La solution C# de l'exemple de code se trouve dans le répertoire CS.

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

  1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

    -- Ou --

    Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

  2. Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

    ms345273.note(fr-fr,SQL.90).gifRemarque :
    Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.
  3. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

    sn -k SampleKey.snk

    ms345273.note(fr-fr,SQL.90).gifImportant :
    Pour plus d'informations sur la paire de clés de nom fort, consultez l'article de sécurité concernant les noms forts et la sécurité dans .NET Framework, dans le Centre de développement .NET sur MSDN.

Générer la solution Visual Studio

  1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Kit de développement Microsoft .NET Framework SDK v2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

  2. Recherchez le dossier racine de l'exemple. Tapez la commande suivante pour l'emplacement par défaut :

  3. [C#]

cd \Program Files\Microsoft SQL Server\90\``\Samples\Engine\Programmability\SMO\ServiceBrokerConfiguration\CS\

  1. Tapez la commande suivante pour générer la solution Visual Studio :
    • msbuild

Ou bien, si vous utilisez Visual Studio 2005, procédez comme suit :

  1. Ouvrez le fichier \CS\ConfigurationComponent.sln.
  2. Appuyez sur F6 pour générer la solution.

Installation de l'exemple de base de données SQL Server et des exemples de schémas XML

  1. Recherchez le dossier \CS\Script.

  2. Ouvrez et exécutez le fichier setup.sql dans SQL Server Management Studio.

Configuration des clés principales SQL Server (en option)

  1. Si vous configurez la liaison de service distant :

  2. Recherchez le dossier \CS\Script.

  3. Ouvrez le fichier masterkey.sql dans SQL Server Management Studio.

  4. Spécifiez un mot de passe pour la clé de base de données master dans l'instruction CREATE MASTER KEY ENCRYPTION BY PASSWORD.

  5. Spécifiez un mot de passe pour la clé de base de données ssb_ConfigurationSample dans l'instruction CREATE MASTER KEY ENCRYPTION BY PASSWORD.

  6. Exécutez masterkey.sql.

Exécution de l'exemple

Pour exécuter l'exemple

  1. L'emplacement par défaut pour la version C# est C:\Program Files\Microsoft SQL Server\90\Samples\SMO\ServiceBrokerConfiguration\CS\SampleApplication\bin\Debug\SampleApplication.exe.

Pour se connecter à un serveur SQL Server local

  1. Spécifiez un nom de serveur dans le champ Nom de serveur ou acceptez le nom de serveur (local) par défaut.

  2. Cliquez sur Se connecter.

Pour configurer l'exemple pour une nouvelle base de données

  1. Dans l'onglet Objets, cliquez sur Options.

  2. Spécifiez un ScriptPath ou acceptez le chemin d'accès par défaut. Le ScriptPath permet d'exporter un script vers un fichier.

  3. Cliquez sur Créer. Le bouton Créer configure l'exemple, ainsi que le BaseUrn.

Pour créer des MessageTypes

  1. Cliquez sur Nouveau, puis sur MessageType.

  2. Entrez ShippingRequest comme nom de MessageType.

  3. Cliquez sur Créer pour créer le MessageType, cliquez sur Nouveau, puis sur Type de message.

  4. Entrez ShippingAccept comme nom de MessageType.

  5. Cliquez sur Créer pour créer le MessageType, cliquez sur Nouveau, puis sur Type de message.

  6. Entrez ShippingComplete comme nom de MessageType.

  7. Cliquez sur Créer pour créer le MessageType.

Pour créer un contrat

  1. Cliquez sur Nouveau, puis sur Contrat.

  2. Sélectionnez le menu déroulant MessageTypeMappings.

  3. Sélectionnez tous les MessageTypes créés.

  4. Sélectionnez Cible pour ShippingAccept et ShippingComplete MessageSource.

  5. Fermez le menu déroulant MessageTypeMappings.

  6. Entrez Shipping comme nom de contrat.

  7. Cliquez sur Créer pour créer un contrat.

Pour créer des files d'attente

  1. Cliquez sur Nouveau, puis sur File d'attente.

  2. Entrez ClientQueue comme nom de file d'attente.

  3. Cliquez sur Créer pour créer la file d'attente, cliquez sur Nouveau, puis sur File d'attente.

  4. Entrez ServerQueue comme nom de file d'attente.

  5. Cliquez sur Créer pour créer la file d'attente.

Pour créer des services sans activer RemoteServiceBinding

  1. Cliquez sur Nouveau, puis sur Service.

  2. Entrez ClientService comme nom de service.

  3. Sélectionnez le menu déroulant ContractNames et sélectionnez le contrat Shipping.

  4. Sélectionnez le menu déroulant QueueName et sélectionnez la file d'attente ClientQueue.

  5. Spécifiez ou sélectionnez un ServiceOwnerName.

  6. Cliquez sur Créer pour créer le service, puis sur Nouveau.

  7. Entrez ServerService comme nom de service.

  8. Sélectionnez le menu déroulant ContractNames et sélectionnez le contrat Shipping.

  9. Sélectionnez le menu déroulant QueueName et sélectionnez la file d'attente ServerQueue.

  10. Spécifiez ou sélectionnez un ServiceOwnerName.

  11. Cliquez sur Créer pour créer le service.

Pour créer des services avec activation de RemoteServiceBinding

  1. Cliquez sur Nouveau, puis sur Service.

  2. Entrez RemoteService comme nom de service.

  3. Sélectionnez le menu déroulant ContractNames et sélectionnez le contrat Shipping.

  4. Affectez la valeur True à EnableRemoteService.

  5. Sélectionnez le menu déroulant QueueName et sélectionnez la file d'attente ClientQueue.

  6. Spécifiez ou sélectionnez un ServiceOwnerName.

  7. Cliquez sur Créer pour créer le service, puis sur Nouveau.

Pour autoriser l'accès anonyme à un service distant

  1. Sélectionnez RemoteService dans l'arborescence des objets.

  2. Affectez la valeur True à AllowAnonymous.

  3. Cliquez sur Modifier pour apporter des modifications à ce service.

Pour créer le point de terminaison d'une instance cible

  1. Cliquez sur Nouveau, puis sur Point de terminaison de l'instance cible.

  2. Spécifiez un nom ou acceptez le nom par défaut.

  3. Cliquez sur Créer.

Pour définir un chemin d'exportation de script

  1. Cliquez sur l'onglet Objet, si ce dernier n'est pas encore sélectionné.

  2. Cliquez sur Options.

  3. Spécifiez un ScriptPath valide.

  4. Cliquez sur Créer.

Pour exporter un objet

  1. Sélectionnez un objet dans l'arborescence des objets.

  2. Cliquez sur Script, puis sur Exporter.

  3. L'objet est exporté vers le ScriptPath défini dans la configuration de l'application.

Pour exporter une définition de service vers un fichier

  1. Sélectionnez un service dans l'arborescence des objets.

  2. Cliquez sur Script, puis sur Exporter.

  3. Le script de service est exporté vers le ScriptPath défini dans la configuration de l'application.

Pour supprimer un objet

  1. Sélectionnez l'objet dans l'arborescence.

  2. Cliquez sur Supprimer ou Modifier, Supprimer {ObjectName}.

Pour modifier un objet

  1. Dans l'arborescence d'objets, cliquez sur l'objet à modifier.

  2. Modifiez les propriétés de cet objet.

  3. Cliquez sur Modifier pour apporter des modifications à cet objet.

Pour interroger des données qui décrivent un objet

  1. Chaque objet peut produire des données qui le décrivent dans une zone de texte et/ou un DataGrid.

  2. Sélectionnez un objet dans l'arborescence.

  3. Cliquez sur Requête.

Suppression de l'exemple

Pour supprimer des services

  1. Cliquez sur le nœud ClientService.

  2. Supprimez l'objet.

  3. Cliquez sur le nœud ServerService.

  4. Supprimez l'objet.

Pour supprimer des files d'attente

  1. Cliquez sur le nœud ClientQueue.

  2. Supprimez l'objet.

  3. Cliquez sur le nœud ServerQueue.

  4. Supprimez l'objet.

Pour supprimer des contrats

  1. Cliquez sur le nœud du contrat Shipping.

  2. Supprimez l'objet.

Pour supprimer des MessageTypes

  1. Cliquez sur le nœud du MessageType ShippingRequest.

  2. Supprimez l'objet.

  3. Cliquez sur le nœud du MessageType ShippingAccept.

  4. Supprimez l'objet.

  5. Cliquez sur le nœud du MessageType ShippingComplete.

  6. Supprimez l'objet.

Pour supprimer le point de terminaison d'une instance cible

  1. Cliquez sur le nœud d'un point de terminaison d'instance cible.

  2. Supprimez l'objet.