导出 (0) 打印
全部展开
展开 最小化
此文章由人工翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

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_addressALTER 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
本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈

社区附加资源

添加
显示:
© 2014 Microsoft