實作端點
適用於:Microsoft Fabric 中的 SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics SQL 資料庫
端點是可原生接聽要求的服務。 SMO 支援 Endpoint 使用 物件的各種端點類型。 您可以建立端點服務,以處理使用特定通訊協定的特定承載類型,方法是建立 對象的實例 Endpoint 並設定其屬性。
EndpointType物件的 屬性Endpoint可用來指定下列承載類型:
資料庫鏡像
SOAP (支援 SOAP 端點存在於 SQL Server 2008 R2 (10.50.x) 和舊版 SQL Server 中)
Service Broker
-
Transact-SQL
此外, ProtocolType 屬性也可以用來指定下列兩個支援的通訊協定:
HTTP 通訊協定
TCP 通訊協定
指定承載類型之後,可以使用 物件屬性來設定 Payload 實際承載。 Payload物件屬性提供指定型別之承載對象的參考,可以修改屬性。
DatabaseMirroringPayload針對物件,您必須指定鏡像角色,以及是否啟用加密。 ServiceBrokerPayload物件需要訊息轉送、允許的連線數目上限和驗證模式的相關信息。 物件 SoapPayloadMethod 需要設定各種屬性,包括 Add 物件屬性,以指定用戶端可用的SOAP承載方法(預存程式和使用者定義函式)。
同樣地,可以使用參考 屬性所ProtocolType指定型別之通訊協定對象屬性,來設定Protocol實際的通訊協定。 HttpProtocol物件需要受限制的IP位址清單,以及埠、網站和驗證資訊。 物件 TcpProtocol 也需要受限制的IP位址和埠資訊清單。
建立並完整定義端點時,可以授與、撤銷和拒絕資料庫使用者、群組、角色和登入的存取權。
範例
針對下列程式代碼範例,您必須選取程式設計環境、程式設計範本和程式設計語言,才能建立您的應用程式。 如需詳細資訊,請參閱 在Visual Studio .NET 中建立Visual C# SMO 專案。
在 Visual Basic 中建立資料庫鏡像端點服務
程式代碼範例示範如何在 SMO 中建立資料庫鏡像端點。 建立資料庫鏡像之前,這是必要的。 IsMirroringEnabled使用物件上的 Database 和其他屬性來建立資料庫鏡像。
'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 中建立資料庫鏡像端點。 建立資料庫鏡像之前,這是必要的。 IsMirroringEnabled使用物件上的 Database 和其他屬性來建立資料庫鏡像。
{
//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 中建立資料庫鏡像端點。 建立資料庫鏡像之前,這是必要的。 IsMirroringEnabled使用物件上的 Database 和其他屬性來建立資料庫鏡像。
# Set the path context to the local, default instance of SQL Server.
CD \sql\localhost\
$srv = get-item default
#Get a new endpoint to configure 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;