CREATE ENDPOINT (Transact-SQL)

创建端点并定义其属性,包括可用于客户端应用程序的方法。 关于相关权限的信息,请参阅 GRANT 端点权限 (Transact-SQL)

CREATE ENDPOINT 的语法在逻辑上分为两部分:

  • 第一部分从 AS 开始,到 FOR 子句之前结束。

    在此部分中,需要提供传输协议 (TCP) 特定的信息,设置端点的侦听端口号,以及设置端点身份验证的方法和/或要限制访问端点的 IP 地址列表(如果有的话)。

  • 第二部分从 FOR 子句开始。

    在此部分中,需要定义端点上所支持的负载。 负载可以为以下多种支持类型中的一种:Transact-SQL、Service Broker、数据库镜像。 在此部分中,还需要提供语言特定信息。

备注

SQL Server 2012 中已删除了本机 XML Web 服务(SOAP/HTTP 端点)。

主题链接图标 Transact-SQL 语法约定

语法

CREATE ENDPOINT endPointName [ AUTHORIZATION login ]
[ STATE = { STARTED | STOPPED | DISABLED } ]
AS { TCP } (
   <protocol_specific_arguments>
        )
FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
   <language_specific_arguments>
        ) 

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
  LISTENER_PORT = listenerPort
  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]

) 

<FOR SERVICE_BROKER_language_specific_arguments> ::=
FOR SERVICE_BROKER (
   [ AUTHENTICATION = { 
            WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] 
      | CERTIFICATE certificate_name 
      | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name 
      | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] 
    } ]
   [ [ , ] ENCRYPTION = { DISABLED | { { SUPPORTED | REQUIRED } 
       [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] } 
   ]
   [ [ , ] MESSAGE_FORWARDING = { ENABLED | DISABLED } ]
   [ [ , ] MESSAGE_FORWARD_SIZE = forward_size ]
)

<FOR DATABASE_MIRRORING_language_specific_arguments> ::=
FOR DATABASE_MIRRORING (
   [ AUTHENTICATION = { 
            WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] 
      | CERTIFICATE certificate_name 
      | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name 
      | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] 
   [ [ [ , ] ] ENCRYPTION = { DISABLED | { { SUPPORTED | REQUIRED } 
       [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] } 

    ] 
   [ , ] ROLE = { WITNESS | PARTNER | ALL }
)

参数

  • endPointName
    所创建的端点的已分配名称。 在更新或删除端点时使用。

  • AUTHORIZATION login
    指定被分配了新建端点对象的所有权的有效 SQL Server 或 Windows 登录帐户。 如果没有指定 AUTHORIZATION,默认情况下调用方将成为新建对象的所有者。

    若要通过指定 AUTHORIZATION 分配所有权,调用方必须对指定的 login 具有 IMPERSONATE 权限。

    若要重新分配所有权,请参阅 ALTER ENDPOINT (Transact-SQL)

  • STATE = { STARTED | STOPPED | DISABLED }
    端点创建时的状态。 如果在创建端点时未指定状态,则默认值为 STOPPED。

    • STARTED
      端点已启动并在积极地侦听连接。

    • DISABLED
      端点被禁用。 在该状态下,服务器侦听端口请求但向客户端返回错误。

    • STOPPED
      端点被停止。 在该状态下,服务器不侦听端点端口,也不对使用端点的任何尝试请求进行响应。

    若要更改状态,请使用 ALTER ENDPOINT (Transact-SQL)

  • AS { TCP }
    指定要使用的传输协议。

  • FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }
    指定负载类型。

    当前,没有要传入 <language_specific_arguments> 参数 (parameter) 的特定于 Transact-SQL 语言的参数 (argument)。

TCP 协议选项

下列参数仅适用于 TCP 协议选项。

  • LISTENER_PORT **=**listenerPort
    指定 Service Broker TCP/IP 协议在其上侦听连接的端口号。 按照约定,将使用 4022,但 1024 和 32767 之间的任何数字都有效。

  • LISTENER_IP = ALL | **(**4-part-ip ) | ( "ip_address_v6" )
    指定端点将侦听的 IP 地址。 默认值为 ALL。 这表示侦听器将接受任何有效 IP 地址上的连接。

    如果用 IP 地址而不是完全限定域名(ALTER DATABASE SET PARTNER = partner_IP_address 或 ALTER DATABASE SET WITNESS = witness_IP_address)配置数据库镜像,则在创建镜像端点时必须指定 LISTENER_IP =IP_address 而不是 LISTENER_IP=ALL。

SERVICE_BROKER 和 DATABASE_MIRRORING 选项

下列 AUTHENTICATION 和 ENCRYPTION 参数是 SERVICE_BROKER 和 DATABASE_MIRRORING 选项所共有的。

备注

有关特定于 SERVICE_BROKER 的选项,请参阅本节后面的“SERVICE_BROKER 选项”。有关特定于 DATABASE_MIRRORING 的选项,请参阅本节后面的“DATABASE_MIRRORING 选项”。

  • AUTHENTICATION = <authentication_options>
    指定此端点连接需要的 TCP/IP 身份验证。 默认值为 WINDOWS。

    支持的身份验证方法包括 NTLM 或 Kerberos 或这两种方法。

    重要说明重要提示

    服务器实例上所有的镜像连接都只使用一个数据库镜像端点。任何创建其他数据库镜像端点的尝试都将失败。

    <authentication_options> ::=

    • WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
      指定端点使用 Windows 身份验证协议进行连接以验证端点。 这是默认设置。

      如果指定某一授权方法(NTLM 或 KERBEROS),则始终将该方法用作身份验证协议。 默认值 NEGOTIATE 允许端点使用 Windows 协商协议在 NTLM 和 Kerberos 之间进行选择。

    • CERTIFICATE certificate_name
      指定端点使用 certificate_name 指定的证书验证连接以建立授权标识。 远端点必须具有其公钥与指定证书的私钥相匹配的证书。

    • WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name
      指定端点通过使用 Windows 身份验证尝试进行连接;如果该尝试失败,则尝试使用指定的证书。

    • CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
      指定端点通过使用指定的证书尝试进行连接;如果该尝试失败,则尝试使用 Windows 身份验证。

  • ENCRYPTION = { DISABLED | SUPPORTED | REQUIRED } [ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ]
    指定是否在过程中使用加密。 默认值为 REQUIRED。

    • DISABLED
      指定不对通过连接发送的数据加密。

    • SUPPORTED
      指定只有在对方端点指定了 SUPPORTED 或者 REQUIRED 时,才加密数据。

    • REQUIRED
      指定与此端点的连接必须使用加密。 因此,若要连接到此端点,则另一端点必须将 ENCRYPTION 设置为 SUPPORTED 或 REQUIRED。

    也可以使用 ALGORITHM 参数指定端点使用的加密形式,如下所示:

    • RC4
      指定端点必须使用 RC4 算法。 这是默认设置。

      备注

      RC4 算法仅用于支持向后兼容性。仅当数据库兼容级别为 90 或 100 时,才能使用 RC4 或 RC4_128 对新材料进行加密。(建议不要使用。)而是使用一种较新的算法,如 AES 算法之一。在 SQL Server 2012 和更高版本中,可以通过任何兼容级别对使用 RC4 或 RC4_128 加密的材料进行解密。

    • AES
      指定端点必须使用 AES 算法。

    • AES RC4
      指定两个端点将与优先使用 AES 算法的此端点协商加密算法。

    • RC4 AES
      指定两个端点将与优先使用 RC4 算法的此端点协商加密算法。

    备注

    不推荐使用 RC4 算法。后续版本的 Microsoft SQL Server 将删除该功能。请不要在新的开发工作中使用该功能,并尽快修改当前还在使用该功能的应用程序。 我们建议使用 AES。

    如果两个端点都指定了这两种算法,但顺序不同,则接受连接的端点入选。

SERVICE_BROKER 选项

下列参数专用于 SERVICE_BROKER 选项。

  • MESSAGE_FORWARDING = { ENABLED | DISABLED }
    确定是否将转发此端点所收到的位于其他位置的服务的消息。

    • ENABLED
      如果提供了转发地址,则转发消息。

    • DISABLED
      放弃位于其他位置的服务的消息。 这是默认设置。

  • MESSAGE_FORWARD_SIZE **=**forward_size
    指定存储要转发的消息时为要使用的端点分配的最大存储量 (MB)。

DATABASE_MIRRORING 选项

下列参数专用于 DATABASE_MIRRORING 选项。

  • ROLE = { WITNESS | PARTNER | ALL }
    指定端点支持的数据库镜像角色(一个或多个)。

    • WITNESS
      启用要在镜像过程中以见证角色执行的端点。

      备注

      在 SQL Server 2005 Express Edition 中,只提供 WITNESS 选项。

    • PARTNER
      启用要在镜像过程中以伙伴角色执行的端点。

    • ALL
      启用要在镜像过程中以见证角色兼伙伴角色执行的端点。

    有关这些角色的详细信息,请参阅数据库镜像 (SQL Server)

备注

没有用于 DATABASE_MIRRORING 的默认端口。

注释

ENDPOINT DDL 语句不能在用户事务内部执行。 即使活动的快照隔离级别事务正在使用被更改的端点,ENDPOINT DDL 语句也不会失败。

下列用户可以对 ENDPOINT 执行请求:

  • sysadmin 固定服务器角色的成员

  • 端点的所有者

  • 已被授予对端点的 CONNECT 权限的用户或组

权限

要求具有 CREATE ENDPOINT 权限,或者具有 sysadmin 固定服务器角色的成员身份。 有关详细信息,请参阅 GRANT 端点权限 (Transact-SQL)

示例

创建数据库镜像端点

下面的示例创建一个数据库镜像端点。 该端点使用端口号 7022,也可以使用任何可用的端口号。 该端点配置为使用只使用 Kerberos 的 Windows 身份验证。 ENCRYPTION 选项配置为 SUPPORTED 的非默认值以支持加密或未加密数据。 该端点目前配置为同时支持伙伴和见证角色。

CREATE ENDPOINT endpoint_mirroring
    STATE = STARTED
    AS TCP ( LISTENER_PORT = 7022 )
    FOR DATABASE_MIRRORING (
       AUTHENTICATION = WINDOWS KERBEROS,
       ENCRYPTION = SUPPORTED,
       ROLE=ALL);
GO

请参阅

参考

ALTER ENDPOINT (Transact-SQL)

DROP ENDPOINT (Transact-SQL)

EVENTDATA (Transact-SQL)

概念

选择加密算法