Compartilhar via


Implementando Endpoints

Um ponto de extremidade é um serviço que pode escutar nativamente solicitações. O SMO dá suporte a vários tipos de pontos de extremidade usando o Endpoint objeto. Você pode criar um serviço de ponto de extremidade que manipula um tipo específico de conteúdo, que usa um protocolo específico, criando uma instância de um Endpoint objeto e definindo suas propriedades.

A EndpointType propriedade do Endpoint objeto pode ser usada para especificar sobre os seguintes tipos de conteúdo:

  • Espelhamento de banco de dados

  • SOAP (o suporte para pontos de extremidade SOAP está presente no SQL Server 2008 R2 e versões anteriores do SQL Server)

  • Corretor de Serviço

  • Transact-SQL

Além disso, a ProtocolType propriedade pode ser usada para especificar os dois protocolos com suporte a seguir:

  • Protocolo HTTP

  • Protocolo TCP

Depois de especificar o tipo de conteúdo, o conteúdo real pode ser definido usando a propriedade do Payload objeto. A Payload propriedade do objeto fornece uma referência a um objeto de conteúdo do tipo especificado, para o qual as propriedades podem ser modificadas.

Para o DatabaseMirroringPayload objeto, você deve especificar a função de espelhamento e se a criptografia está habilitada. O ServiceBrokerPayload objeto requer informações sobre o encaminhamento de mensagens, o número máximo de conexões permitidas e o modo de autenticação. O SoapPayloadMethod objeto requer que várias propriedades sejam definidas, incluindo a propriedade de Add objeto que especifica os métodos de conteúdo SOAP disponíveis para clientes (procedimentos armazenados e funções definidas pelo usuário).

Da mesma forma, o protocolo real pode ser definido usando a propriedade de Protocol objeto que faz referência a um objeto de protocolo do tipo especificado pela ProtocolType propriedade. O HttpProtocol objeto requer uma lista de endereços IP restritos e informações de porta, site e autenticação. O TcpProtocol objeto também requer uma lista de endereços IP restritos e informações de porta.

Quando o ponto de extremidade tiver sido criado e totalmente definido, o acesso poderá ser concedido, revogado e negado a usuários de banco de dados, grupos, funções e logons.

Exemplo

Para o exemplo de código a seguir, você precisará selecionar o ambiente de programação, o modelo de programação e a linguagem de programação para criar seu aplicativo. Para obter mais informações, consulte Criar um projeto de SMO do Visual Basic no Visual Studio .NET e criar um projeto SMO do Visual C# no Visual Studio .NET.

Criando um serviço de ponto de extremidade de espelhamento de banco de dados no Visual Basic

O exemplo de código demonstra como criar um ponto de extremidade de Espelhamento de Banco de Dados no SMO. Isso é necessário antes de criar um espelho de banco de dados. Use as IsMirroringEnabled propriedades e outras no Database objeto para criar um espelho de banco de dados.

Criando um serviço de ponto de extremidade de espelhamento de banco de dados no Visual C#

O exemplo de código demonstra como criar um ponto de extremidade de Espelhamento de Banco de Dados no SMO. Isso é necessário antes de criar um espelho de banco de dados. Use as IsMirroringEnabled propriedades e outras no Database objeto para criar um espelho de banco de dados.

{  
            //Set up a database mirroring endpoint on the server before   
        //setting up a database mirror.   
        //Connect to the local, default instance of SQL Server.   
            Server srv = new Server();  
            //Define an Endpoint object variable for database mirroring.   
            Endpoint ep = default(Endpoint);  
            ep = new Endpoint(srv, "Mirroring_Endpoint");  
            ep.ProtocolType = ProtocolType.Tcp;  
            ep.EndpointType = EndpointType.DatabaseMirroring;  
            //Specify the protocol ports.   
            ep.Protocol.Http.SslPort = 5024;  
            ep.Protocol.Tcp.ListenerPort = 6666;  
            //Specify the role of the payload.   
            ep.Payload.DatabaseMirroring.ServerMirroringRole = ServerMirroringRole.All;  
            //Create the endpoint on the instance of SQL Server.   
            ep.Create();  
            //Start the endpoint.   
            ep.Start();  
            Console.WriteLine(ep.EndpointState);  
        }  

Criando um serviço de ponto de extremidade de espelhamento de banco de dados no PowerShell

O exemplo de código demonstra como criar um ponto de extremidade de Espelhamento de Banco de Dados no SMO. Isso é necessário antes de criar um espelho de banco de dados. Use as IsMirroringEnabled propriedades e outras no Database objeto para criar um espelho de banco de dados.

# Set the path context to the local, default instance of SQL Server.  
CD \sql\localhost\  
$srv = Get-Item default  
  
#Get a new endpoint to congure and add  
$ep = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Endpoint -argumentlist $srv,"Mirroring_Endpoint"  
  
#Set some properties  
$ep.ProtocolType = [Microsoft.SqlServer.Management.SMO.ProtocolType]::Tcp  
$ep.EndpointType = [Microsoft.SqlServer.Management.SMO.EndpointType]::DatabaseMirroring  
$ep.Protocol.Http.SslPort = 5024  
$ep.Protocol.Tcp.ListenerPort = 6666 #inline comment  
$ep.Payload.DatabaseMirroring.ServerMirroringRole = [Microsoft.SqlServer.Management.SMO.ServerMirroringRole]::All  
  
# Create the endpoint on the instance  
$ep.Create()  
  
# Start the endpoint  
$ep.Start()  
  
# Report its state  
$ep.EndpointState;  

Consulte Também

O ponto de extremidade de espelhamento de banco de dados (SQL Server)