共用方式為


實作端點

端點是可以透過原生方式接聽要求的服務。 SMO 藉由使用 Endpoint 物件來支援各種端點類型。 您可以藉由建立 Endpoint 物件的執行個體和設定其屬性,建立處理特定裝載類型的端點服務 (此類服務使用特定的通訊協定)。

Endpoint 物件的 EndpointType 屬性可用於指定下列其中一個裝載類型:

  • 資料庫鏡像

  • SOAP (SQL Server 2008 R2 及更早的 SQL Server 版本中存在 SOAP 端點的支援)

  • Service Broker

  • Transact-SQL

此外,ProtocolType 屬性也可用於指定下列兩種支援的通訊協定:

  • HTTP 通訊協定

  • TCP 通訊協定

在指定裝載類型之後,就可以使用 Payload 物件屬性設定實際的裝載。 Payload 物件屬性針對可修改其屬性的指定類型,提供裝載物件的參考。

如果是 DatabaseMirroringPayload 物件,則您必須指定鏡像角色以及是否啟用加密。 ServiceBrokerPayload 物件需要訊息轉送、允許的最大連接數目以及驗證模式的相關資訊。 SoapPayloadMethod 物件需要設定多個屬性,包括 Add 物件屬性,此屬性會指定用戶端可用的 SOAP 裝載方法 (預存程序和使用者定義函數)。

同樣地,實際的通訊協定也可使用 Protocol 物件屬性來設定,此屬性會參考 ProtocolType 屬性所指定類型的通訊協定物件。 HttpProtocol 物件需要受限 IP 位址的清單,以及通訊埠、網站和驗證資訊。 TcpProtocol 物件也需要受限 IP 位址的清單和通訊埠資訊。

在建立和完整地定義端點後,就可以對資料庫使用者、群組、角色和登入等授與、撤銷和拒絕存取權限。

範例

在下列的程式碼範例中,您必須選取用於建立應用程式的程式設計環境、程式設計範本和程式設計語言。 如需詳細資訊,請參閱<在 Visual Studio .NET 中建立 Visual Basic SMO 專案>和<在 Visual Studio .NET 中建立 Visual C# SMO 專案>。

在 Visual Basic 中建立資料庫鏡像端點服務

此程式碼範例示範如何在 SMO 中建立資料庫鏡像端點。 您必須先進行這項作業,才能建立資料庫鏡像。 請使用 Database 物件上的 IsMirroringEnabled 和其他屬性建立資料庫鏡像。

'Set up a database mirroring endpoint on the server before setting up a database mirror.
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Define an Endpoint object variable for database mirroring.
Dim ep As 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)

在 Visual C# 中建立資料庫鏡像端點服務

此程式碼範例示範如何在 SMO 中建立資料庫鏡像端點。 您必須先進行這項作業,才能建立資料庫鏡像。 請使用 Database 物件上的 IsMirroringEnabled 和其他屬性建立資料庫鏡像。

{
            //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);
        }

在 PowerShell 中建立資料庫鏡像端點服務

此程式碼範例示範如何在 SMO 中建立資料庫鏡像端點。 您必須先進行這項作業,才能建立資料庫鏡像。 請使用 Database 物件上的 IsMirroringEnabled 和其他屬性建立資料庫鏡像。

# 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;

請參閱

概念

資料庫鏡像端點 (SQL Server)