CREATE AVAILABILITY GROUP (Transact-SQL)

项目
03/25/2023

如果为 SQL Server功能启用了 Always On 可用性组的实例，将创建新的可用性组。

重要

在要用作新可用性组的初始主副本的 SQL Server 实例上执行 CREATE AVAILABILITY GROUP。此服务器实例必须驻留在 Windows Server 故障转移群集 (WSFC) 节点上。

语法

  
CREATE AVAILABILITY GROUP group_name  
   WITH (<with_option_spec> [ ,...n ] )  
   FOR [ DATABASE database_name [ ,...n ] ]  
   REPLICA ON <add_replica_spec> [ ,...n ]  
   AVAILABILITY GROUP ON <add_availability_group_spec> [ ,...2 ]  
   [ LISTENER 'dns_name' ( <listener_option> ) ]  
[ ; ]  
  
<with_option_spec>::=   
    AUTOMATED_BACKUP_PREFERENCE = { PRIMARY | SECONDARY_ONLY| SECONDARY | NONE }  
  | FAILURE_CONDITION_LEVEL  = { 1 | 2 | 3 | 4 | 5 }   
  | HEALTH_CHECK_TIMEOUT = milliseconds  
  | DB_FAILOVER  = { ON | OFF }   
  | DTC_SUPPORT  = { PER_DB | NONE }  
  | [ BASIC | DISTRIBUTED | CONTAINED [ REUSE_SYSTEM_DATABASES ] ]
  | REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT = { integer }
  | CLUSTER_TYPE = { WSFC | EXTERNAL | NONE }
 
  
<add_replica_spec>::=  
  <server_instance> WITH  
    (  
       ENDPOINT_URL = 'TCP://system-address:port',  
       AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT | CONFIGURATION_ONLY },  
       FAILOVER_MODE = { AUTOMATIC | MANUAL | EXTERNAL }  
       [ , <add_replica_option> [ ,...n ] ]  
    )   
  
  <add_replica_option>::=  
       SEEDING_MODE = { AUTOMATIC | MANUAL }  
     | BACKUP_PRIORITY = n  
     | SECONDARY_ROLE ( {   
            [ ALLOW_CONNECTIONS = { NO | READ_ONLY | ALL } ]   
        [,] [ READ_ONLY_ROUTING_URL = 'TCP://system-address:port' ]  
     } )  
     | PRIMARY_ROLE ( {   
            [ ALLOW_CONNECTIONS = { READ_WRITE | ALL } ]   
        [,] [ READ_ONLY_ROUTING_LIST = { ( '<server_instance>' [ ,...n ] ) | NONE } ]  
        [,] [ READ_WRITE_ROUTING_URL = { ( '<server_instance>' ) ] 
     } )  
     | SESSION_TIMEOUT = integer  
  
<add_availability_group_spec>::=  
 <ag_name> WITH  
    (  
       LISTENER_URL = 'TCP://system-address:port',  
       AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT },  
       FAILOVER_MODE = MANUAL,  
       SEEDING_MODE = { AUTOMATIC | MANUAL }  
    )  
  
<listener_option> ::=  
   {  
      WITH DHCP [ ON ( <network_subnet_option> ) ]  
    | WITH IP ( { ( <ip_address_option> ) } [ , ...n ] ) [ , PORT = listener_port ]  
   }  
  
  <network_subnet_option> ::=  
     'ip4_address', 'four_part_ipv4_mask'    
  
  <ip_address_option> ::=  
     {   
        'ip4_address', 'pv4_mask'  
      | 'ipv6_address'  
     }

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

自变量

group_name

指定新可用性组的名称。 group_name 必须是一个有效的SQL Server标识符，并且它在 WSFC 群集的所有可用性组中必须是唯一的。可用性组名称的最大长度为 128 个字符。

AUTOMATED_BACKUP_PREFERENCE = { PRIMARY | SECONDARY_ONLY | SECONDARY | NONE }

指定在选择执行备份的位置时有关备份作业应该如何评估主副本的首选项。您可以编写给定备份作业的脚本，以便纳入自动备份首选项。理解 SQL Server 不强制使用首选备份位置十分重要，因为它对即席备份没有影响。

支持的值如下：

PRIMARY

指定备份应该始终在主副本上发生。如果您需要在对辅助副本运行备份时不支持的备份功能，例如创建差异备份，此选项将很有用。

重要

如果你计划使用日志传送为可用性组准备任何辅助数据库，请将自动备份首选项设置为“主要”，直到准备好所有辅助数据库并将其联接到可用性组。

SECONDARY_ONLY

指定备份应该永远不会在主副本上执行。如果主副本是唯一的联机副本，则备份应不会发生。

SECONDARY

指定备份应在辅助副本上发生，但在主副本是唯一联机的副本时除外。在该情况下，备份应在主副本上发生。此选项为默认行为。

无

指定您希望在选择要执行备份的副本时备份作业将忽略可用性副本的角色。请注意，备份作业可能评估其他因素，例如每个可用性副本的备份优先级及其操作状态和已连接状态。

重要

不会强制实施 AUTOMATED_BACKUP_PREFERENCE 设置。对此首选项的解释依赖于您为给定可用性组中的数据库撰写作业脚本的逻辑（如果有）。自动备份首选项设置对即席备份没有影响。有关详细信息，请参阅配置可用性副本备份 (SQL Server)。

注意

若要查看现有可用性组的自动备份首选项，请选择 sys.availability_groups 目录视图的 automated_backup_preference 或 automated_backup_preference_desc 列。此外，sys.fn_hadr_backup_is_preferred_replica (Transact-SQL) 可用于确定首选备份副本。此函数对至少一个副本返回 1（即使 AUTOMATED_BACKUP_PREFERENCE = NONE）。

FAILURE_CONDITION_LEVEL = { 1 | 2 | 3 | 4 | 5 }

指定为此可用性组触发自动故障转移的失败条件。 FAILURE_CONDITION_LEVEL 在组级别设置，但仅针对为同步-提交可用性模式 (AVAILABILITY_MODE = SYNCHRONOUS_COMMIT) 配置的可用性副本。此外，只有在主要副本和次要副本均配置为自动故障转移模式 (FAILOVER_MODE = AUTOMATIC) 并且次要副本当前与主要副本同步的情况下，失败条件才可以触发自动故障转移。

失败条件级别的范围 (1-5) 是从最少限制的级别 1 到最多限制的级别 5。给定的条件级别包含所有限制较少的级别。因此，最严格的条件级别 5 包含四个限制较少的级别 (1-4)，级别 4 包含级别 1-3，依此类推。下表介绍了与各级别相对应的失败条件。

级别	失败条件
1	指定在发生以下任何情况时应启动自动故障转移： -SQL Server 服务停止。 -由于没有从服务器实例接收到 ACK，连接到 WSFC 群集的可用性组的租用时间到期。有关详细信息，请参阅工作原理：SQL Server Always On 租约超时。
2	指定在发生以下任何情况时应启动自动故障转移： -SQL Server 的实例未连接到群集，并且超出了可用性组的用户指定的 HEALTH_CHECK_TIMEOUT 阈值。 -可用性副本处于失败状态。
3	指定在发生了严重的 SQL Server 内部错误（例如孤立的自旋锁、严重的写访问冲突或过多的转储）时应启动自动故障转移。此选项为默认行为。
4	指定在发生了中等程度的 SQL Server 内部错误（例如在 SQL Server 内部资源池中出现持久的内存不足情况）时应启动自动故障转移。
5	指定在出现任何符合的失败条件时应启动自动故障转移，这些失败条件包括： -SQL 引擎的工作线程耗尽。 -检测到无法解决的死锁。

注意

缺少 SQL Server 的实例对客户端请求的响应与可用性组无关。

FAILURE_CONDITION_LEVEL 和 HEALTH_CHECK_TIMEOUT 值为给定组定义“灵活的故障转移策略”。此灵活的故障转移策略向您提供对必须导致自动故障转移的条件的精确控制。有关详细信息，请参阅针对可用性组的自动故障转移的灵活的故障转移策略 (SQL Server)。

HEALTH_CHECK_TIMEOUT = milliseconds

指定在 WSFC 群集假定服务器实例速度较慢或无响应前，等待 sp_server_diagnostics 系统存储过程返回服务器运行状况信息的等待时间（毫秒）。 HEALTH_CHECK_TIMEOUT 在组级别设置，但仅针对为具有自动故障转移的同步-提交可用性模式 (AVAILABILITY_MODE = SYNCHRONOUS_COMMIT) 配置的可用性副本。此外，只有在主要副本和次要副本均配置为自动故障转移模式 (FAILOVER_MODE = AUTOMATIC) 并且次要副本当前与主要副本同步的情况下，运行状况检查超时才可以触发自动故障转移。

默认的 HEALTH_CHECK_TIMEOUT 值为 30000 毫秒（30 秒）。最小值为 15000 毫秒（15 秒），最大值为 4294967295 毫秒。

重要

sp_server_diagnostics 在数据库级别不执行运行状况检查。

DB_FAILOVER = { ON | OFF }

指定主要副本上的数据库脱机时要执行的响应。设置为 ON 时，可用性组中数据库 ONLINE 以外的任何状态都会触发自动故障转移。当此选项设置为 OFF 时，仅使用实例的运行状况来触发自动故障转移。

有关此设置的详细信息，请参阅数据库级别运行状况检测选项

DTC_SUPPORT = { PER_DB | NONE }

适用于： SQL Server（从 SQL Server 2016 (13.x) 开始）

指定是否通过分布式事务处理协调器 (DTC) 支持跨数据库事务。仅从 SQL Server 2016 (13.x) 开始支持跨数据库事务。 PER_DB 创建支持这些事务的可用性组。有关详细信息，请参阅用于 Always On 可用性组和数据库镜像的跨数据库事务和分布式事务 (SQL Server)。

BASIC

适用于： SQL Server（从 SQL Server 2016 (13.x) 开始）

用于创建基本可用性组。基本可用性组限于一个数据库和两个副本：主要副本和次要副本。此选项替换 SQL Server Standard Edition 上弃用的数据库镜像功能。有关详细信息，请参阅基本可用性组（Always On 可用性组）。从 SQL Server 2016 (13.x) 开始支持基本可用性组。

DISTRIBUTED

适用于： SQL Server（从 SQL Server 2016 (13.x) 开始）

用于创建分布式可用性组。此选项与 AVAILABILITY GROUP ON 参数一起使用，可连接不同 Windows Server 故障转移群集中的两个可用性组。有关详细信息，请参阅分布式可用性组（Always On 可用性组）。从 SQL Server 2016 (13.x) 开始，支持分布式可用性组。

CONTAINED [REUSE_SYSTEM_DATABASES]

在 SQL Server 2022 (16.x) 中引入。

创建包含的可用性组。此选项用于创建具有其自身 master 和 msdb 数据库的可用性组，这些数据库在可用性组中的副本集中保持同步。
REUSE_SYSTEM_DATABASES 选项会导致在创建这个新可用性组时使用旧版可用性组的包含的 master 和 msdb 数据库。有关包含的可用性组的详细信息，请参阅包含的可用性组概述（Always On 可用性组）。

REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT

适用于：：SQL Server（从 SQL Server 2017 (14.x) 开始）

REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT

在 SQL Server 2017 (14.x) 中引入。设置需要在主要副本提交事务之前提交的最小数量的同步次要副本。保证 SQL Server 事务等待至事务日志在最小数量的次要副本上更新为止。

默认值：0。提供与 SQL Server 2016 (13.x) 相同的行为。
最小值：0。
最大值：副本数减去 1。

REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT 与同步提交模式下的副本有关。当副本处于同步提交模式时，对主要副本的写入操作会等待至将同步副本上的写入提交到副本数据库事务日志为止。如果托管次要同步副本的 SQL Server 停止响应，则托管主要副本的 SQL Server 将此次要副本标记为 NOT SYNCHRONIZED（未同步）并继续执行操作。当无响应的数据库恢复联机状态时，它将处于“未同步”状态，副本将标记为不正常，直到主要副本可再次对其执行同步。此设置可确保主要副本会等待至最少数量的副本已提交每个事务。如果最少数量的副本不可用，则主要副本上的提交会失败。对于群集类型 EXTERNAL，可用性组添加到群集资源时，设置会更改。请参阅可用性组配置的高可用性和数据保护。

不支持 CREATE AVAILABILITY GROUP。从 SQL Server 2022 (16.x) 开始，可以在分布式可用性组上使用 ALTER AVAILABILITY GROUP 设置 REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT。请参阅 ALTER AVAILABILITY GROUP (Transact-SQL)。

CLUSTER_TYPE

适用于：SQL Server（SQL Server 2017 (14.x) 及更高版本）

可用于确定可用性组是否位于 Windows Server 故障转移群集 (WSFC) 上。当可用性组位于 Windows Server 故障转移群集上的故障转移群集实例上时，设置为 WSFC。如果管理群集的群集管理器不是一个 Windows Server 故障转移群集（如 Linux Pacemaker），设置为 EXTERNAL（外部）。可用性组未使用 WSFC 进行群集协调时，设置为 NONE。例如，可用性组包含没有群集管理器的 Linux 服务器时。

DATABASE database_name

指定本地 SQL Server 实例（也就是您正在其上创建可用性组的服务器实例）上的一个或多个用户数据库的列表。您可以为一个可用性组指定多个数据库，但每个数据库只能属于一个可用性组。有关可用性组可支持的数据库类型的详细信息，请参阅针对 Always On 可用性组的先决条件、限制和建议 (SQL Server)。若要找出已属于某个可用性组的本地数据库，请参阅 sys.databases 目录视图中的 replica_id 列。

DATABASE 子句是可选的。如果省略此参数，新的可用性组为空。

在创建可用性组后，连接到托管次要副本的每个服务器实例，然后准备每个辅助数据库并将它们加入可用性组。有关详细信息，请参阅启动 Always On 辅助数据库的数据移动 (SQL Server)。

注意

然后，您可以将承载当前主副本的服务器实例上的合格数据库添加到可用性组。还可以从可用性组中删除数据库。有关详细信息，请参阅 ALTER AVAILABILITY GROUP (Transact-SQL)。

REPLICA ON

指定一到五个 SQL Server 实例，以承载新的可用性组中的可用性副本。通过在每个副本的服务器实例地址后追加 WITH (…) 子句来指定每个副本。必须至少指定本地服务器实例，该实例将成为初始主要副本。还可以选择指定最多四个辅助副本。

您需要将每个辅助副本联接到可用性组。有关详细信息，请参阅 ALTER AVAILABILITY GROUP (Transact-SQL)。

注意

如果在创建可用性组时指定少于四个次要副本，则随时可以使用 ALTER AVAILABILITY GROUPTransact-SQL 语句添加其他的次要副本。还可以使用此语句从现有的可用性组中删除任何次要副本。

server_instance

指定承载副本的 SQL Server 实例的地址。地址格式依赖于该实例是默认实例还是命名实例以及它是独立实例还是故障转移群集实例 (FCI)，如下所示：

{ '*system_name*[\\*instance_name*]' | '*FCI_network_name*[\\*instance_name*]' }

此地址由以下部分组成：

system_name

SQL Server 的目标实例所在的计算机系统的 NetBIOS 名称。此计算机必须是一个 WSFC 节点。

FCI_network_name

用于访问 SQL Server 故障转移群集的网络名称。如果服务器实例作为 SQL Server 故障转移伙伴参与，则使用此名称。对 FCI 服务器实例执行 SELECT @@SERVERNAME 会返回其完整的 'FCI_network_name[\instance_name]' 字符串（即完整的副本名称）。

instance_name

由 system_name 或 FCI_network_name 托管且已启用 HADR 服务的 SQL Server 实例的名称。对于默认服务器实例， instance_name 是可选的。此实例名不区分大小写。在命名实例上，此值名称与执行 select ServerProperty(N'InstanceName'); 所返回的值相同。

\

仅在指定 instance_name 时使用的分隔符，以便将其与 system_name 或 FCI_network_name 分隔。

有关 WSFC 节点和服务器实例的先决条件的信息，请参阅针对 Always On 可用性组的先决条件、限制和建议 (SQL Server)。

ENDPOINT_URL ='TCP://system-address:port'

指定 SQL Server 实例上数据库镜像终结点的 URL 路径，该实例将托管当前 REPLICA ON 子句中定义的可用性副本。

ENDPOINT_URL 子句是必需的。有关详细信息，请参阅在添加或修改可用性副本时指定终结点 URL (SQL Server)。

'TCP://system-address:port'

指定一个 URL，它用于指定端点 URL 或只读路由 URL。 URL 参数如下所示：

system-address

一个字符串，例如系统名称、完全限定的域名或 IP 地址，它们明确标识了目标计算机系统。

port

是与伙伴服务器实例的镜像端点关联的端口号（对于 ENDPOINT_URL 选项）或服务器实例的数据库引擎使用的端口号（对于 READ_ONLY_ROUTING_URL 选项）。

AVAILABILITY_MODE = {SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT | CONFIGURATION_ONLY }

SYNCHRONOUS_COMMIT or ASYNCHRONOUS_COMMIT 指定在主要副本可以在给定主数据库上提交事务前，是否必须等待次要副本确认日志记录硬编码（写入）到磁盘。针对同一主副本上不同数据库的事务可以单独提交。 SQL Server 2017 (14.x) CU1 引入了 CONFIGURATION_ONLY。 CONFIGURATION_ONLY 副本仅适用于 CLUSTER_TYPE = EXTERNAL 或 CLUSTER_TYPE = NONE 的可用性组。

SYNCHRONOUS_COMMIT

指定主要副本将等待提交事务，一直等待至已在此次要副本上进行硬编码（同步提交模式）为止。您可以为最多三个副本（包括主副本）指定 SYNCHRONOUS_COMMIT。

ASYNCHRONOUS_COMMIT

指定主副本无需等待此辅助副本对日志进行硬编码（同步提交可用性模式）即可提交事务。您可以为最多五个可用性副本（包括主副本）指定 ASYNCHRONOUS_COMMIT。

CONFIGURATION_ONLY

指定主副本将可用性组配置元数据同步提交到此副本上的主数据库。副本将不包含用户数据。此选项：

可以在任何版本的 SQL Server 上承载，包括 Express Edition。
要求 CONFIGURATION_ONLY 副本的数据镜像终结点为 WITNESS 类型。
无法更改。
当 CLUSTER_TYPE = WSFC 时无效。
如果副本的 availability_mode 设置为 configuration_only，则不支持 failover_mode 和 seeding_mode 选项。有关示例，请单击此处。

有关详细信息，请参阅仅配置副本。

AVAILABILITY_MODE 子句是必需的。有关详细信息，请参阅可用性模式（Always On 可用性组）。

FAILOVER_MODE = { AUTOMATIC | MANUAL }

指定您要定义的可用性副本的故障转移模式。

AUTOMATIC

启用自动故障转移。仅在您还指定了 AVAILABILITY_MODE = SYNCHRONOUS_COMMIT 的情况下，才支持此选项。您可以为最多两个可用性副本（包括主副本）指定 AUTOMATIC。

注意

SQL Server 故障转移群集实例 (FCI) 不支持通过可用性组来自动进行故障转移，因此，只能为手动故障转移配置任何由 FCI 承载的可用性副本。

MANUAL

允许数据库管理员执行的手动故障转移或强制手动故障转移（通常称为“强制故障转移”）。

FAILOVER_MODE 子句是必需的。在不同条件下支持两种手动故障转移：没有数据丢失的手动故障转移和强制故障转移（可能丢失数据）。有关详细信息，请参阅故障转移和故障转移模式（Always On 可用性组）。

SEEDING_MODE = { AUTOMATIC | MANUAL }

指定最初设定次要副本种子的方式。

AUTOMATIC

启用直接种子设定。此方法通过网络设定次要副本的种子。此方法不要求在副本上备份和还原主数据库的副本。

注意

为实现直接种子设定，必须通过使用 GRANT CREATE ANY DATABASE 选项调用 ALTER AVAILABILITY GROUP 来允许在每个次要副本上创建数据库。

MANUAL

指定手动种子设定（默认）。此方法要求在主要副本上创建数据库的备份，并在次要副本上手动还原该备份。

BACKUP_PRIORITY = n

指定相对于同一可用性组中的其他副本，在此副本上执行备份的优先级。该值是范围 0..100 中的整数。这些值将具有以下含义：

1..100 表示可被选择来执行备份的可用性副本。 1 表示最低优先级，100 表示最高优先级。如果 BACKUP_PRIORITY = 1，则只有在没有更高的优先级可用性副本当前可用的情况下，才会选择可用性副本来执行备份。
0 表示此可用性副本不用于执行备份。例如，这对于您永远不希望备份故障转移到的远程可用性副本十分有用。

有关详细信息，请参阅活动次要副本：次要副本备份（Always On 可用性组）。

SECONDARY_ROLE ( ... )

指定在此可用性副本当前拥有辅助角色（即它是次要副本）时要生效的角色特有设置。在括号内指定一个或两个辅助角色选项。如果指定两个选项，则使用以逗号分隔的列表。

辅助角色选项如下所示：

ALLOW_CONNECTIONS = { NO | READ_ONLY | ALL }

指定给定的可用性副本（正在执行辅助角色，也就是充当辅助副本）的数据库是否可以接受来自客户端的连接，可以是以下之一：

是

不允许与此副本的辅助数据库的用户连接。它们不可用于读访问。此选项为默认行为。

READ_ONLY

只允许连接应用程序意向属性设置为 ReadOnly 的次要副本中的数据库。有关此属性的详细信息，请参阅在 SQL Server Native Client 中使用连接字符串关键字。

ALL

允许针对辅助副本中的数据库的所有连接进行只读访问。

有关详细信息，请参阅活动次要副本：可读次要副本（Alway On 可用性组）。

READ_ONLY_ROUTING_URL ='TCP://system-address:port'

指定要用于此可用性副本的路由读意向连接请求的 URL。这是数据库引擎侦听的 URL。通常，SQL Server 的默认实例侦听 TCP 端口 1433。

对于命名实例，可以通过查询 sys.dm_tcp_listener_states 动态管理视图的 port 和 type_desc 列来获取端口号。服务器实例使用 Transact-SQL 侦听器 (type_desc='TSQL')。

有关计算副本的只读路由 URL 的详细信息，请参阅计算 Always On 的 read_only_routing_url。

注意

对于 SQL Server 的命名实例，应将 Transact-SQL 侦听器配置为使用特定端口。有关详细信息，请参阅将服务器配置为侦听特定 TCP 端口（SQL Sever 配置管理器）。

PRIMARY_ROLE ( ... )

指定在此可用性副本当前拥有主角色（即它是主要副本）时要生效的角色特有设置。在括号内指定一个或两个主角色选项。如果指定两个选项，则使用以逗号分隔的列表。

主角色选项如下所示：

ALLOW_CONNECTIONS = { READ_WRITE | ALL }

指定给定的可用性副本（正在执行主要角色，也就是充当主副本）的数据库可以接受的来自客户端的连接类型，可以是以下之一：

READ_WRITE

不允许 Application Intent 连接属性设置为 ReadOnly 的连接。在 Application Intent 属性设置为 ReadWrite 或者未设置 Application Intent 连接属性时，将允许连接。有关应用程序意向连接属性的详细信息，请参阅在 SQL Server Native Client 中使用连接字符串关键字。

ALL

主副本中的数据库允许所有连接。此选项为默认行为。

READ_ONLY_ROUTING_LIST = { ('_server_instance_' [ , ... n ] ) | NONE }

指定一个以逗号分隔的服务器实例列表，这些实例承载在以辅助角色运行时满足以下要求的此可用性组的可用性副本：

被配置为允许所有连接或只读连接（参阅上文 SECONDARY_ROLE 选项的 ALLOW_CONNECTIONS 参数）。
定义了只读路由 URL（参阅上文 SECONDARY_ROLE 选项的 READ_ONLY_ROUTING_URL 参数）。

READ_ONLY_ROUTING_LIST 的值如下：

server_instance

指定托管副本的 SQL Server 实例的地址，该副本在以辅助角色运行时是可读次要副本。

使用以逗号分隔的列表指定可能托管可读次要副本的所有服务器实例。只读路由遵循在列表中指定服务器实例的顺序。如果在副本的只读路由列表中包含副本的宿主服务器实例，通常将此服务器实例放在列表末尾比较好，这样在一个辅助副本可用时读意向连接将访问它。

从 SQL Server 2016 (13.x) 开始，可在可读次要副本间实现读意向请求的负载均衡。可通过将副本放入只读路由列表中的一组嵌套括号中来指定。有关详细信息和示例，请参阅在只读副本间配置负载均衡。

无

指定此可用性副本为主要副本时不支持只读路由。此选项为默认行为。

READ_WRITE_ROUTING_URL = { ('server_instance') }

适用于：：SQL Server（从 SQL Server 2019 (15.x) 开始）

指定服务器实例，这些实例承载在以主角色运行时满足以下要求的此可用性组的可用性副本：

副本规范 PRIMARY_ROLE 包括 READ_WRITE_ROUTING_URL。
连接字符串为 ReadWrite，通过将 ApplicationIntent 定义为 ReadWrite 或不设置 ApplicationIntent 并使默认值 (ReadWrite) 生效来实现。

有关详细信息，请参阅次要副本到主要副本读/写连接重定向（AlwaysOn 可用性组）。

SESSION_TIMEOUT = integer

以秒为单位指定会话超时期限。如果不指定此选项，则在默认情况下，超时期限为 10 秒。最小值为 5 秒。

重要

我们建议您将超时期限保持为 10 秒或更长。

有关会话超时期限的详细信息，请参阅 Always On 可用性组概述 (SQL Server)。

AVAILABILITY GROUP ON

指定构成分布式可用性组的两个可用性组。每个可用性组是其 Windows Server 故障转移群集 (WSFC) 的一部分。创建分布式可用性组后，当前 SQL Server 实例上的可用性组成为主要可用性组。第二个可用性组成为次要可用性组。

需要将次要可用性组联接到分布式可用性组。有关详细信息，请参阅 ALTER AVAILABILITY GROUP (Transact-SQL)。

ag_name

指定构成一半分布式可用性组的可用性组名称。

LISTENER_URL ='TCP://system-address:port'

指定与可用性组关联的侦听器的 URL 路径。

必须有 LISTENER_URL 子句。

'TCP://system-address:port'

指定与可用性组关联的侦听器的 URL。 URL 参数如下所示：

system-address

一个字符串，例如系统名称、完全限定的域名或 IP 地址，它们明确标识了侦听器。

port

是与可用性组的镜像终结点关联的端口号。请注意，这不是侦听器的端口。

AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT | CONFIGURATION_ONLY }

指定在主要副本可以在给定主数据库上提交事务前，是否必须等待次要可用性组确认日志记录硬编码（写入）到磁盘。

SYNCHRONOUS_COMMIT

指定主要副本将等待提交事务，一直等待至这些事务已在次要可用性组上进行了硬编码为止。可以为最多两个可用性组（包括主要可用性组）指定 SYNCHRONOUS_COMMIT。

ASYNCHRONOUS_COMMIT

指定主要副本无需等待该次要可用性组对日志进行硬编码即可提交事务。可以为最多两个可用性组（包括主要可用性组）指定 ASYNCHRONOUS_COMMIT。

AVAILABILITY_MODE 子句是必需的。

FAILOVER_MODE = { MANUAL }

指定分布式可用性组的故障转移模式。

MANUAL

允许数据库管理员执行的手动故障转移或强制手动故障转移（通常称为“强制故障转移”）。

需要 FAILOVER_MODE 子句，且 MANUAL 是唯一选项。不支持自动故障转移到次要可用性组。

SEEDING_MODE = { AUTOMATIC | MANUAL }

指定最初设定次要可用性组种子的方式。

AUTOMATIC

启用直接种子设定。此方法通过网络设定次要可用性组种子。此方法不要求在次要可用性组的副本上备份和还原主数据库的副本。

MANUAL

指定手动种子设定（默认）。此方法要求在主要副本上创建数据库的备份，并在次要可用性组的副本上手动还原该备份。

LISTENER 'dns_name'( listener_option )

为此可用性组定义新的可用性组侦听器。 LISTENER 是一个可选参数。

重要

创建第一个侦听器之前，强烈建议阅读创建或配置可用性组侦听器 (SQL Server)。

为给定可用性组创建侦听器后，我们强烈建议您执行以下操作：

请求您的网络管理员将该侦听器的 IP 地址保留为专用。
将该侦听器的 DNS 主机名提供给应用程序开发人员，以便在请求与此可用性组的客户端连接时用于连接字符串中。

dns_name

指定可用性组侦听器的 DNS 主机名。在域和 NetBIOS 中，侦听器的 DNS 名称必须唯一。

dns_name 为字符串值。该名称只能包含字母数字字符、破折号 (-) 和连字符 (_)，顺序不分先后。 DNS 主机名不区分大小写。最大长度为 63 个字符。

我们建议您指定一个有意义的字符串。例如，对于名为 AG1的可用性组，有意义的 DNS 主机名将是 ag1-listener。

重要

NetBIOS 只识别 dns_name 中的前 15 个字符。如果您的两个 WSFC 群集均由同一 Active Directory 控制，而您试图使用超过 15 个字符的名称（具有相同的 15 个字符前缀）在这两个群集中创建可用性组侦听器，将收到错误，报告无法使虚拟网络名称资源联机。有关 DNS 名称的前缀命名规则的信息，请参阅分配域名。

listener_option

侦听器采用以下 listener_option 选项之一<>：

WITH DHCP [ ON { ('four_part_ipv4_address','four_part_ipv4_mask') } ]

指定可用性组侦听器使用动态主机配置协议 (DHCP)。或者，使用 ON 子句标识在其上创建此侦听器的网络。 DHCP 限制为单个子网，该子网用于在可用性组中托管副本的每个服务器实例。

重要

不建议在生产环境中使用 DHCP。如果停止工作且 DHCP IP 租期已到，则需要额外的时间来注册与侦听器 DNS 名称相关联且影响客户端连接的新 DHCP 网络 IP 地址。但是，DHCP 适合用于设置开发和测试环境以验证可用性组的基本功能并适合与应用程序集成。

例如：

WITH DHCP ON ('10.120.19.0','255.255.254.0')

WITH IP ( { ('four_part_ipv4_address','four_part_ipv4_mask') | ('ipv6_address') } [ , ...n ] ) [ , PORT =listener_port ]

指定可用性组侦听器使用一个或多个静态 IP 地址，而不使用 DHCP。若要跨多个子网创建一个可用性组，每个子网均需要一个侦听器配置中的静态 IP 地址。对于某一给定子网，静态 IP 地址可以是 IPv4 地址或 IPv6 地址。请联系网络管理员，以获取每个托管新可用性组副本的子网的静态 IP 地址。

例如：

WITH IP ( ('10.120.19.155','255.255.254.0') )

ip4_address

指定可用性组侦听器的由四部分组成的 IPv4 地址。例如，10.120.19.155。

ipv4_mask

指定可用性组侦听器的由四部分组成的 IPv4 掩码。例如，255.255.254.0。

ipv6_address

指定可用性组侦听器的 IPv6 地址。例如，2001::4898:23:1002:20f:1fff:feff:b3a3。

PORT = listener_port

指定端口号 listener_port，以供由 WITH IP 子句指定的可用组侦听器使用。 PORT 是可选的。

支持默认端口号 1433。但出于安全考虑，我们建议使用其他端口号。

例如： WITH IP ( ('2001::4898:23:1002:20f:1fff:feff:b3a3') ) , PORT = 7777

先决条件和限制

有关创建可用性组的先决条件的信息，请参阅 Always On 可用性组的先决条件、限制和建议 (SQL Server)。

有关可用性组 Transact-SQL 语句的限制的信息，请参阅 Always On 可用性组的 Transact-SQL 语句的概述 (SQL Server)。

安全性

权限

需要 sysadmin 固定服务器角色的成员资格，以及 CREATE AVAILABILITY GROUP 服务器权限、ALTER ANY AVAILABILITY GROUP 权限或 CONTROL SERVER 权限。

示例

A. 针对辅助副本、灵活的故障转移策略和连接访问配置备份

下面的示例为两个用户数据库 MyAg 和 ThisDatabase 创建了名为 ThatDatabase 的可用性组。下表总结了为作为一个整体为可用性组设置的选项指定的值。

组选项	设置	说明
AUTOMATED_BACKUP_PREFERENCE	SECONDARY	此自动备份首选项指示应在辅助副本上发生备份，但在主副本是唯一联机的副本时（这是默认行为）除外。为使 AUTOMATED_BACKUP_PREFERENCE 设置生效，您需要编写可用性数据库上备份作业的脚本，以便考虑自动备份首选项。
FAILURE_CONDITION_LEVEL	3	此失败条件级别设置指定在发生了严重的 SQL Server 内部错误（例如孤立的自旋锁、严重的写访问冲突或过多的转储）时应启动自动故障转移。
HEALTH_CHECK_TIMEOUT	600000	此运行状况检查超时值（60 秒）指定 WSFC 群集为 sp_server_diagnostics 系统存储过程等待 60000 毫秒，以便自动返回与托管同步提交副本的服务器实例有关的服务器运行状况信息，之后，群集将认为该主机服务器实例速度慢或未响应。（默认值为 30000 毫秒。）

三个可用性副本将由名为 COMPUTER01、COMPUTER02 和 COMPUTER03 的计算机上的默认服务器实例承载。下表总结了为每个副本的副本选项指定的值。

副本选项	`COMPUTER01` 上的设置	`COMPUTER02` 上的设置	`COMPUTER03` 上的设置	说明
ENDPOINT_URL	TCP://COMPUTER01:5022	TCP://COMPUTER02:5022	TCP://COMPUTER03:5022	在这个示例中，系统处于相同的域中，因此，端点 URL 可以使用计算机的名称作为系统地址。
AVAILABILITY_MODE	SYNCHRONOUS_COMMIT	SYNCHRONOUS_COMMIT	ASYNCHRONOUS_COMMIT	两个副本使用同步提交模式。同步时，它们支持故障转移而不会丢失数据。第三个副本，将使用异步提交可用性模式。
FAILOVER_MODE	AUTOMATIC	AUTOMATIC	MANUAL	同步提交副本支持自动故障转移和计划的手动故障转移。同步提交可用性模式副本支持仅限强制的手动故障转移。
BACKUP_PRIORITY	30	30	90	与同步提交副本相比，将更高的优先级 90 分配给异步提交副本。备份往往发生在将托管异步提交副本的服务器实例上。
SECONDARY_ROLE	( ALLOW_CONNECTIONS = NO, READ_ONLY_ROUTING_URL = 'TCP://COMPUTER01:1433' )	( ALLOW_CONNECTIONS = NO, READ_ONLY_ROUTING_URL = 'TCP://COMPUTER02:1433' )	( ALLOW_CONNECTIONS = READ_ONLY, READ_ONLY_ROUTING_URL = 'TCP://COMPUTER03:1433' )	只有异步提交副本作为可读的辅助副本。指定计算机名称和默认数据库引擎端口号 (1433)。该参数可选。
PRIMARY_ROLE	( ALLOW_CONNECTIONS = READ_WRITE, READ_ONLY_ROUTING_LIST = (COMPUTER03) )	( ALLOW_CONNECTIONS = READ_WRITE, READ_ONLY_ROUTING_LIST = (COMPUTER03) )	( ALLOW_CONNECTIONS = READ_WRITE, READ_ONLY_ROUTING_LIST = NONE )	在主角色中，所有副本都拒绝读取意向连接尝试。如果本地副本正在辅助角色下运行，会读取意向连接请求路由到 COMPUTER03。当该副本在主角色下运行时，禁用只读路由。该参数可选。
SESSION_TIMEOUT	10	10	10	此示例指定默认会话超时值 (10)。该参数可选。

最后，该示例指定可选的 LISTENER 子句，以便为新的可用性组创建可用性组侦听器。将为此侦听器指定唯一的 DNS 名称 MyAgListenerIvP6。两个副本位于不同的子网，因此侦听器必须使用静态 IP 地址。对于这两个可用性副本中的每一个，WITH IP 子句都指定一个将使用 IPv6 格式的静态 IP 地址 2001:4898:f0:f00f::cf3c 和 2001:4898:e0:f213::4ce2。此示例还指定使用可选的 PORT 参数来将端口 60173 指定为侦听器端口。

CREATE AVAILABILITY GROUP MyAg   
   WITH (  
      AUTOMATED_BACKUP_PREFERENCE = SECONDARY,  
      FAILURE_CONDITION_LEVEL  =  3,   
      HEALTH_CHECK_TIMEOUT = 600000  
       )  
  
   FOR   
      DATABASE  ThisDatabase, ThatDatabase   
   REPLICA ON   
      'COMPUTER01' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER01:5022',  
         AVAILABILITY_MODE = SYNCHRONOUS_COMMIT,  
         FAILOVER_MODE = AUTOMATIC,  
         BACKUP_PRIORITY = 30,  
         SECONDARY_ROLE (ALLOW_CONNECTIONS = NO,   
            READ_ONLY_ROUTING_URL = 'TCP://COMPUTER01:1433' ),
         PRIMARY_ROLE (ALLOW_CONNECTIONS = READ_WRITE,   
            READ_ONLY_ROUTING_LIST = (COMPUTER03) ),  
         SESSION_TIMEOUT = 10  
         ),   
  
      'COMPUTER02' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER02:5022',  
         AVAILABILITY_MODE = SYNCHRONOUS_COMMIT,  
         FAILOVER_MODE = AUTOMATIC,  
         BACKUP_PRIORITY = 30,  
         SECONDARY_ROLE (ALLOW_CONNECTIONS = NO,   
            READ_ONLY_ROUTING_URL = 'TCP://COMPUTER02:1433' ),  
         PRIMARY_ROLE (ALLOW_CONNECTIONS = READ_WRITE,   
            READ_ONLY_ROUTING_LIST = (COMPUTER03) ),  
         SESSION_TIMEOUT = 10  
         ),   
  
      'COMPUTER03' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER03:5022',  
         AVAILABILITY_MODE = ASYNCHRONOUS_COMMIT,  
         FAILOVER_MODE =  MANUAL,  
         BACKUP_PRIORITY = 90,  
         SECONDARY_ROLE (ALLOW_CONNECTIONS = READ_ONLY,   
            READ_ONLY_ROUTING_URL = 'TCP://COMPUTER03:1433' ),  
         PRIMARY_ROLE (ALLOW_CONNECTIONS = READ_WRITE,   
            READ_ONLY_ROUTING_LIST = NONE ),  
         SESSION_TIMEOUT = 10  
         );
GO  
ALTER AVAILABILITY GROUP [MyAg]
  ADD LISTENER 'MyAgListenerIvP6' ( WITH IP ( ('2001:db88:f0:f00f::cf3c'),('2001:4898:e0:f213::4ce2') ) , PORT = 60173 );   
GO

另请参阅

更改可用性组 (Transact-SQL)
ALTER DATABASE SET HADR (Transact-SQL)
DROP AVAILABILITY GROUP (Transact-SQL)
Always On 可用性组配置疑难解答 (SQL Server)
Always On 可用性组概述 (SQL Server)
可用性组侦听器、客户端连接和应用程序故障转移 (SQL Server)