时间：2021-07-01 10:21:17 帮助过：18人阅读
|
适用范围：SQL Server（SQL Server 2012 到当前版本）。 |
Transact-SQL 语法约定
语法
ALTER AVAILABILITY GROUP group_name
{
SET ( <set_option_spec> )
| ADD DATABASE database_name
| REMOVE DATABASE database_name
| ADD REPLICA ON <add_replica_spec>
| MODIFY REPLICA ON <modify_replica_spec>
| REMOVE REPLICA ON <server_instance>
| JOIN
| FAILOVER
| FORCE_FAILOVER_ALLOW_DATA_LOSS | ADD LISTENER ‘dns_name’ ( <add_listener_option> )
| MODIFY LISTENER ‘dns_name’ ( <modify_listener_option> )
| RESTART LISTENER ‘dns_name’
| REMOVE LISTENER ‘dns_name’
| OFFLINE
}
[ ; ]
<set_option_spec> ::=
AUTOMATED_BACKUP_PREFERENCE = { PRIMARY | SECONDARY_ONLY| SECONDARY | NONE }
| FAILURE_CONDITION_LEVEL = { 1 | 2 | 3 | 4 | 5 }
| HEALTH_CHECK_TIMEOUT = milliseconds
<server_instance> ::=
{ ‘system_name[\instance_name]‘ | ‘FCI_network_name[\instance_name]‘ }
<add_replica_spec>::=
<server_instance> WITH
(
ENDPOINT_URL = ‘TCP://system-address:port‘,
AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT },
FAILOVER_MODE = { AUTOMATIC | MANUAL }
[ , <add_replica_option> [ ,...n ] ]
)
<add_replica_option>::=
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 }
} )
| SESSION_TIMEOUT = seconds
<modify_replica_spec>::=
<server_instance> WITH
(
ENDPOINT_URL = ‘TCP://system-address:port‘
| AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT }
| FAILOVER_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 }
} )
| SESSION_TIMEOUT = seconds
)
<add_listener_option> ::=
{
WITH DHCP [ ON ( <network_subnet_option> ) ]
| WITH IP ( { ( <ip_address_option> ) } [ , ...n ] ) [ , PORT = listener_port ]
}
<network_subnet_option> ::=
‘four_part_ipv4_address’, ‘four_part_ipv4_mask’
<ip_address_option> ::=
{
‘four_part_ipv4_address’, ‘four_part_ipv4_mask’
| ‘ipv6_address’
}
<modify_listener_option>::=
{
ADD IP ( <ip_address_option> )
| PORT = listener_port
}
参数
指定新可用性组的名称。 group_name 必须是一个有效的 SQL Server 标识符，并且它必须在 WSFC 群集的所有可用性组中保持唯一。
指定在选择执行备份的位置时有关备份作业应该如何评估主副本的首选项。 您可以编写给定备份作业的脚本，以便纳入自动备份首选项。 SQL Server 不会强制执行首选项，因此它对即席备份没有影响，了解这一点很重要。
仅在主副本上支持。
这些值如下所示：
指定备份应该始终在主副本上发生。 如果您需要在对辅助副本运行备份时不支持的备份功能，例如创建差异备份，此选项将很有用。
 重要提示 |
|---|
|
如果您计划使用日志传送为可用性组准备任何辅助数据库，请将自动备份首选项设置为“主要”，直到准备好所有辅助数据库并将其加入可用性组。 |
指定备份应该永远不会在主副本上执行。 如果主副本是唯一的联机副本，则备份应不会发生。
指定备份应在辅助副本上发生，但在主副本是唯一联机的副本时除外。 在该情况下，备份应在主副本上发生。 这是默认行为。
指定您希望在选择要执行备份的副本时备份作业将忽略可用性副本的角色。 请注意，备份作业可能评估其他因素，例如每个可用性副本的备份优先级及其操作状态和已连接状态。
| 重要提示 |
|---|
|
没有强制的 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 在组级别设置，但仅针对为同步-提交可用性模式 (AVAILIBILITY_MODE = SYNCHRONOUS_COMMIT) 配置的可用性副本。 此外，只有在主副本和辅助副本均配置为自动故障转移模式 (FAILOVER_MODE = AUTOMATIC) 并且辅助副本当前与主副本同步的情况下，失败条件才可以触发自动故障转移。
仅在主副本上支持。
失败条件级别的范围 (1–5) 是从最少限制的级别 1 到最多限制的级别 5。 给定的条件级别包含所有限制较少的级别。 因此，最严格的条件级别 5 包含四个限制较少的级别 (1-4)，级别 4 包含级别 1-3，依此类推。 下表介绍了与各级别相对应的失败条件。
|
级别 |
失败条件 |
|---|---|
|
1 |
指定在发生以下任何情况时应启动自动故障转移：
|
|
2 |
指定在发生以下任何情况时应启动自动故障转移：
|
|
3 |
指定在发生了严重的 SQL Server 内部错误（例如孤立的自旋锁、严重的写访问冲突或过多的转储）时应启动自动故障转移。 这是默认行为。 |
|
4 |
指定在发生了中等程度的 SQL Server 内部错误（例如在 SQL Server 内部资源池中出现持久的内存不足情况）时应启动自动故障转移。 |
|
5 |
指定在出现任何符合的失败条件时应启动自动故障转移，这些失败条件包括：
|
| 注意 |
|---|
|
缺少 SQL Server 的实例对客户端请求的响应与可用性组无关。 |
FAILURE_CONDITION_LEVEL 和 HEALTH_CHECK_TIMEOUT 值为给定组定义“灵活的故障转移策略”。 此灵活的故障转移策略向您提供对必须导致自动故障转移的条件的精确控制。 有关详细信息，请参阅针对可用性组的自动故障转移的灵活的故障转移策略 (SQL Server)。
指定在 WSFC 群集假定服务器实例速度较慢或挂起前，等待 sp_server_diagnostics 系统存储过程返回服务器运行状况信息的等待时间（毫秒）。 HEALTH_CHECK_TIMEOUT 在组级别设置，但仅针对为具有自动故障转移的同步-提交可用性模式 (AVAILIBILITY_MODE = SYNCHRONOUS_COMMIT) 配置的可用性副本。 此外，只有在主副本和辅助副本均配置为自动故障转移模式 (FAILOVER_MODE = AUTOMATIC) 并且辅助副本当前与主副本同步的情况下，运行状况检查超时才可以触发自动故障转移。
默认的 HEALTH_CHECK_TIMEOUT 值为 30000 毫秒（30 秒）。 最小值为 15000 毫秒（15 秒），最大值为 4294967295 毫秒。
仅在主副本上支持。
| 重要提示 |
|---|
|
sp_server_diagnostics 在数据库级别不执行运行状况检查。 |
指定要添加到可用性组的一个或多个用户数据库的列表。 这些数据库必须位于承载当前主副本的 SQL Server 实例上。 您可以为一个可用性组指定多个数据库，但每个数据库只能属于一个可用性组。 有关可用性组可支持的数据库类型的信息，请参阅针对 AlwaysOn 可用性组的先决条件、限制和建议 (SQL Server)。 若要找出已属于某个可用性组的本地数据库，请参阅 sys.databases 目录视图中的 replica_id 列。
仅在主副本上支持。
| 注意 |
|---|
|
在创建可用性组后，将需要连接到承载辅助副本的每个服务器实例，然后准备每个辅助数据库并将它们加入可用性组。 有关详细信息，请参阅启动 AlwaysOn 辅助数据库的数据移动 (SQL Server)。 |
从可用性组中删除指定的主数据库和相应的辅助数据库。 仅在主副本上支持。
有关在从可用性组中删除可用性数据库之后推荐执行的后续任务的信息，请参阅从可用性组中删除主数据库 (SQL Server)。
指定一到四个 SQL Server 实例以便在可用性组中承载辅助副本。 通过在每个副本的服务器实例地址后追加 WITH (…) 子句来指定每个副本。
仅在主副本上支持。
您需要将每个新的辅助副本联接到可用性组。 有关详细信息，请参阅本节后面对 JOIN 选项的说明。
指定承载副本的 SQL Server 实例的地址。 地址格式依赖于该实例是默认实例还是命名实例以及它是独立实例还是故障转移群集实例 (FCI)。 语法如下：
{ ‘system_name[\instance_name]‘ |‘FCI_network_name[\instance_name]‘ }
此地址由以下部分组成：
有关 WSFC 节点和服务器实例的先决条件的信息，请参阅 针对 AlwaysOn 可用性组的先决条件、限制和建议 (SQL Server)。
指定 SQL Server 实例（该实例将承载您要添加或修改的可用性副本）的数据库镜像端点的 URL 路径。
ENDPOINT_URL 在 ADD REPLICA ON 子句中是必需的，在 MODIFY REPLICA ON 子句中是可选的。 有关详细信息，请参阅在添加或修改可用性副本时指定端点 URL (SQL Server)。
指定一个 URL，它用于指定端点 URL 或只读路由 URL。 URL 参数如下所示：
指定在主副本可以在给定主数据库上提交事务前，是否必须等待辅助副本确认日志记录硬编码（写入）到磁盘。 针对同一主副本上不同数据库的事务可以单独提交。
AVAILABILITY_MODE 在 ADD REPLICA ON 子句中是必需的，在 MODIFY REPLICA ON 子句中是可选的。 有关详细信息，请参阅可用性模式（AlwaysOn 可用性组）。
指定您要定义的可用性副本的故障转移模式。
启用自动故障转移。 仅在指定 VAILABILITY_MODE = SYNCHRONOUS_COMMIT 的情况下才支持 AUTOMATIC。 您可以为最多两个可用性副本（包括主副本）指定 AUTOMATIC。
| 注意 |
|---|
|
SQL Server 故障转移群集实例 (FCI) 不支持通过可用性组来自动进行故障转移，因此，只能为手动故障转移配置任何由 FCI 承载的可用性副本。 |
允许数据库管理员手动故障转移或强制手动故障转移（“强制故障转移”）。
FAILOVER_MODE 在 ADD REPLICA ON 子句中是必需的，在 MODIFY REPLICA ON 子句中是可选的。 存在在不同条件下支持的两种手动故障转移，没有数据丢失的手动故障转移和强制故障转移（可能存在数据丢失）。 有关详细信息，请参阅故障转移和故障转移模式（AlwaysOn 可用性组）。
指定相对于同一可用性组中的其他副本，在此副本上执行备份的优先级。 该值是范围 0..100 中的整数。 这些值将具有以下含义：
1..100 表示可被选择来执行备份的可用性副本。 1 表示最低优先级，100 表示最高优先级。 如果 BACKUP_PRIORITY = 1，则只有在没有更高的优先级可用性副本当前可用的情况下，才会选择可用性副本来执行备份。
0 表示此可用性副本将永远不会被选择执行备份。 例如，这对于您永远不希望备份故障转移到的远程可用性副本十分有用。
有关详细信息，请参阅活动辅助副本：辅助副本备份（AlwaysOn 可用性组）。
指定在此可用性副本当前拥有辅助角色（即它是辅助副本）时将要生效的角色特有设置。 在括号内指定一个或两个辅助角色选项。 如果指定两个选项，则使用以逗号分隔的列表。
辅助角色选项如下所示：
指定给定的可用性副本（正在执行辅助角色，也就是充当辅助副本）的数据库是否可以接受来自客户端的连接，可以是以下之一：
有关详细信息，请参阅活动辅助副本：可读辅助副本（AlwaysOn 可用性组）。
指定要用于此可用性副本的路由读意向连接请求的 URL。 这是 SQL Server 数据库引擎侦听的 URL。 通常，SQL Server 数据库引擎的默认实例侦听 TCP 端口 1433。
对于命名实例，您可以通过查询 sys.dm_tcp_listener_states 动态管理视图的 port 和 type_desc 列来获取端口号。 服务器实例使用 Transact-SQL 侦听器 (type_desc=‘TSQL‘)。
有关计算可用性副本的只读路由 URL 的详细信息，请参阅计算 AlwaysOn 的 read_only_routing_url。
| 注意 |
|---|
|
对于 SQL Server 的命名实例，应将 Transact-SQL 侦听器配置为使用特定端口。 有关详细信息，请参阅配置服务器以侦听特定 TCP 端口（SQL Server 配置管理器）。 |
指定在此可用性副本当前拥有主角色（即它是主副本）时将要生效的角色特有设置。 在括号内指定一个或两个主角色选项。 如果指定两个选项，则使用以逗号分隔的列表。
主角色选项如下所示：