Compartir a través de

Readme_ServiceBrokerConfiguration

  • Artículo

Actualizado: 5 de diciembre de 2005

Este ejemplo muestra cómo crear objetos de Service Broker con los objetos de administración de SQL Server (SMO). Este ejemplo se implementa porque se necesitan varios controles de usuario de Windows y clases para crear objetos de Service Broker.

El ejemplo es de utilidad para los programadores de Microsoft .NET Framework que desean aprender a usar SMO de Service Broker y a crear controles de usuario de Windows para administrar objetos de SQL Server 2005. El escenario principal sería un programador de Microsoft .NET Framework que crea una aplicación personalizada de administración de Service Broker.

Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en ningún entorno de este tipo. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema.

Requisitos

Este ejemplo requiere que estén instalados los siguientes componentes.

  • SDK 2.0 de .NET Framework. Puede obtener .NET Framework SDK de forma gratuita. Para obtener más información, vea Instalar .NET Framework SDK.
  • SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005).

Ubicación

Si el ejemplo de código se ha instalado en la ubicación predeterminada, el ejemplo se encuentra en el siguiente directorio:

C:\Archivos de programa\Microsoft SQL Server\90\Samples\Engine\Programmability\SMO\ ServiceBrokerConfiguration

La solución de C# para el ejemplo de código se encuentra en el directorio CS.

Generar el ejemplo

Si aún no ha creado un archivo de clave de nombre seguro, genere este archivo mediante las siguientes instrucciones.

Para generar un archivo de clave de nombre seguro

  1. Abra un símbolo del sistema de Microsoft Visual Studio 2005. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK 2.0 y, a continuación, haga clic en Símbolo del sistema de SDK.

    -- O bien --

    Abra un símbolo del sistema de Microsoft .NET Framework. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK 2.0 y, a continuación, haga clic en Símbolo del sistema de SDK.

  2. Use el comando de cambio de directorio (CD) para cambiar el directorio actual a la carpeta donde están instalados los ejemplos.

    [!NOTA] para determinar la carpeta donde se encuentran los ejemplos, haga clic en el botón Inicio, seleccione Todos los programas, Microsoft SQL Server, Documentación y tutoriales y, a continuación, haga clic en el directorio Ejemplos. Si se usó la ubicación de instalación predeterminada, los ejemplos se encontrarán en <unidadDeSistema>:\Archivos de programa\Microsoft SQL Server\100\Ejemplos.

  3. En el símbolo del sistema, ejecute el comando siguiente para generar el archivo de clave:

    sn -k SampleKey.snk

    ms345273.note(es-es,SQL.90).gifImportante:
    Para obtener más información acerca del par de claves de nombre seguro, vea el apartado sobre informes de seguridad de nombres seguros y seguridad en .NET Framework en el centro de desarrollo de .NET de MSDN.

Generar la solución de Visual Studio

  1. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK v2.0 y, a continuación, haga clic en SDK Command Prompt.

  2. Busque la carpeta raíz del ejemplo. Escriba el siguiente comando para la ubicación predeterminada:

  3. [C#]

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

  1. Escriba lo siguiente para generar la solución de Visual Studio:
    • msbuild

O bien, si usa Visual Studio 2005, haga lo siguiente:

  1. Abra el archivo de solución \CS\ConfigurationComponent.sln.
  2. Presione F6 para generar la solución.

Configure la base de datos de ejemplo de SQL Server y los esquemas XML de ejemplo.

  1. Busque la carpeta \CS\Script.

  2. Abra y ejecute setup.sql desde SQL Server Management Studio.

Configurar las claves maestras de SQL Server (opcional)

  1. Si configura el enlace de servicio remoto:

  2. Busque la carpeta \CS\Script.

  3. Abra masterkey.sql desde SQL Server Management Studio.

  4. Escriba una contraseña para la clave de base de datos maestra en la instrucción CREATE MASTER KEY ENCRYPTION BY PASSWORD =.

  5. Escriba una contraseña para la clave de base de datos ssb_ConfigurationSample en la instrucción CREATE MASTER KEY ENCRYPTION BY PASSWORD =.

  6. Ejecute masterkey.sql.

Ejecutar el ejemplo

Para ejecutar el ejemplo

  1. La ubicación predeterminada de la versión C# es C:\Archivos de programa\Microsoft SQL Server\90\Samples\SMO\ServiceBrokerConfiguration\CS\SampleApplication\bin\Debug\SampleApplication.exe.

Para conectarse a una instancia local de SQL Server

  1. Escriba un nombre de servidor en el campo Server Name, o bien acepte el nombre del servidor predeterminado (local).

  2. Haga clic en Connect.

Para configurar el ejemplo de una nueva base de datos

  1. Haga clic en Options, en la ficha Objects.

  2. Escriba una ruta ScriptPath, o bien acepte la ruta de acceso predeterminada. ScriptPath se utiliza para exportar una secuencia de comandos a un archivo.

  3. Haga clic en Create. El botón Create configura el ejemplo, incluido también BaseUrn.

Para crear elementos MessageType

  1. Haga clic en New y, a continuación, haga clic en MessageType.

  2. Escriba ShippingRequest como nombre de MessageType.

  3. Haga clic en Create para crear el MessageType, seleccione New y haga clic en Message Type.

  4. Escriba ShippingAccept como nombre de MessageType.

  5. Haga clic en Create para crear el MessageType, seleccione New y haga clic en Message Type.

  6. Escriba ShippingComplete como nombre de MessageType.

  7. Haga clic en Create para crear el nuevo MessageType.

Para crear un contrato

  1. Haga clic en New y en Contract.

  2. Seleccione el menú desplegable MessageTypeMappings.

  3. Seleccione todos los elementos MessageType creados anteriormente.

  4. Seleccione Target como ShippingAccept y ShippingComplete MessageSource.

  5. Cierre el menú desplegable MessageTypeMappings.

  6. Escriba Shipping como nombre del contrato.

  7. Haga clic en Create para crear un contrato nuevo.

Para crear colas

  1. Haga clic en la ficha New y, a continuación, haga clic en Queue.

  2. Escriba ClientQueue como nombre de la cola.

  3. Haga clic en Create para crear la cola, seleccione New y haga clic en Queue.

  4. Escriba ServerQueue como nombre de la cola.

  5. Haga clic en Create para crear la cola nueva.

Para crear servicios sin habilitar RemoteServiceBinding

  1. Haga clic en New y, a continuación, en Service.

  2. Escriba ClientService como nombre del servicio.

  3. Seleccione el menú desplegable ContractNames y seleccione el contrato Shipping.

  4. Seleccione el menú desplegable QueueName y seleccione la cola ClientQueue

  5. Escriba o seleccione un ServiceOwnerName.

  6. Haga clic en Create para crear el servicio nuevo y, a continuación, haga clic en New.

  7. Escriba ServerService como nombre del servicio.

  8. Seleccione el menú desplegable ContractNames y seleccione el contrato Shipping.

  9. Seleccione el menú desplegable QueueName y seleccione la cola ServerQueue

  10. Escriba o seleccione un ServiceOwnerName.

  11. Haga clic en Create para crear el servicio nuevo.

Para crear servicios con RemoteServiceBinding habilitado

  1. Haga clic en New y, a continuación, en Service.

  2. Escriba RemoteService como nombre del servicio.

  3. Seleccione el menú desplegable ContractNames y seleccione el contrato Shipping.

  4. Establezca EnableRemoteService en TRUE.

  5. Seleccione el menú desplegable QueueName y seleccione la cola ClientQueue

  6. Escriba o seleccione un ServiceOwnerName.

  7. Haga clic en Create para crear el servicio y haga clic en New.

Para habilitar el acceso anónimo a un servicio remoto

  1. Seleccione RemoteService within the object tree.

  2. Establezca AllowAnonymous en TRUE.

  3. Haga clic en Alter para modificar el servicio.

Para crear un extremo de la instancia de destino

  1. Haga clic en New y, a continuación, en Target Instance Endpoint.

  2. Escriba un nombre, o bien acepte el nombre predeterminado.

  3. Haga clic en Create.

Para establecer una ruta de acceso de exportación de la secuencia de comandos

  1. Haga clic en la ficha Object si aún no está activa.

  2. Haga clic en Options.

  3. Especifique un ScriptPath válido.

  4. Haga clic en Create.

Para exportar un objeto

  1. Seleccione un objeto en el árbol de objetos.

  2. Haga clic en Script y, a continuación, en Export.

  3. El objeto se exporta a la ruta ScriptPath establecida en la configuración de la aplicación.

Para exportar una definición de servicio a un archivo

  1. Seleccione un servicio en el árbol de objetos.

  2. Haga clic en Script y, a continuación, en Export.

  3. La secuencia de comandos del servicio se exporta a la ruta ScriptPath establecida en la configuración de la aplicación.

Para quitar un objeto

  1. Seleccione el objeto en la vista de árbol.

  2. Haga clic en Drop o Edit, Drop {nombreDeObjeto}.

Para modificar un objeto

  1. Haga clic en el objeto del árbol de objetos que desea modificar.

  2. Modifique las propiedades de ese objeto.

  3. Haga clic en Alter para modificar el objeto.

Para consultar datos que describen un objeto

  1. Cada objeto puede generar datos que describen el objeto para TextBox o DataGrid.

  2. Seleccione un objeto en la vista de árbol.

  3. Haga clic en Query.

Quitar el ejemplo

Para quitar servicios

  1. Haga clic en el nodo ClientService.

  2. Quite el objeto.

  3. Haga clic en el nodo ServerService.

  4. Quite el objeto.

Para quitar colas

  1. Haga clic en el nodo ClientQueue.

  2. Quite el objeto.

  3. Haga clic en el nodo ServerQueue.

  4. Quite el objeto.

Para quitar contratos

  1. Haga clic en el nodo del contrato Shipping.

  2. Quite el objeto.

Para quitar elementos MessageType

  1. Haga clic en el nodo MessageType ShippingRequest.

  2. Quite el objeto.

  3. Haga clic en el nodo MessageType ShippingAccept.

  4. Quite el objeto.

  5. Haga clic en el nodo MessageType ShippingComplete.

  6. Quite el objeto.

Para quitar un extremo de la instancia de destino

  1. Haga clic en un nodo Target Instance Endpoint.

  2. Quite el objeto.