您好，我是小DAI，专注于数据库管理员相关的技术问答，请问有什么可以帮您？

返回首页 | 小DAI,小DAI，你在么？

sp_cluster

语法

要将连接迁移到另一个逻辑集群或实例：


sp_cluster connection, migrate, <lc_name>, <instance_name>, "<spid_list>"

要确定之前迁移到新实例的连接迁移是否处于挂起状态，如果是则终止迁移：


sp_cluster connection, ["migrate_status" | "migrate_cancel'"][, "<spid_list>"]

要修改未完成的操作，例如取消操作或更改操作的计时：


sp_cluster logical, "action", <lc_name>, { 
	cancel, <action_handle> |
	modify_time, <action_handle>, <wait_option>[, <timeout> ] |
	release, <action_handle }>

要将资源或一个或多个路由添加到逻辑集群中：


sp_cluster logical, "add", <lc_name>, {
route, <route_type>, <key_list> |
instance, <instance_list> | failover, <instance_list |>
database, <database_name> [, with nowait] }

要将路由从一个逻辑集群移到另一个逻辑集群：


sp_cluster logical, "alter", <lc_name>, route, <route_type>, <key_list>

要新建逻辑集群：


sp_cluster logical, "create", <lc_name> [, for single instance access]

要停止一个或多个实例上的逻辑集群或停止整个逻辑集群，并将这些实例或该集群置于非活动状态：


sp_cluster logical, "deactivate", <lc_name>, { 
	"cluster" | "instance", <instance_list> }
   [, <wait_option>[, <timeout>,[, @handle output ]]]

要删除一个逻辑集群或从该逻辑集群中删除一个或多个资源：


sp_cluster logical, "drop", <lc_name>, 
	{cluster | instance, <instance_list> |
failover, <instance_list> | route, <route_type>, <key_list> | 
database, <database_name> }

要逆向执行手动故障切换，恢复原始基本实例：


sp_cluster logical, "failback", <lc_name>, {
	cluster<[, wait_option>[, <timeout>[, @handle output ]]] |
	instance, <from_instance_list>, <to_instance_list>[, <wait_option>[,
<timeout>[, @handle output ]]] }

要启动从基本实例到故障切换实例的手动故障切换。


sp_cluster logical, "failover", <lc_name>, {cluster
	[, <to_instance_list[, wait_option>[, <timeout>[, @handle output ]]] 
	| instance, <from_instance_list>, <to_instance_list>[, <wait_option>[,
<timeout>[, "sync" [, @handle output ]]]] }

要手动收集一组连接并将其迁移到其它逻辑集群：


sp_cluster logical, "gather", <lc_name>

要显示 sp_cluster logical 的完整语法：


sp_cluster logical, "help"

要停止一个或多个实例上的逻辑集群或停止整个逻辑集群：


sp_cluster logical, "offline", <lc_name>, 
	{cluster | instance, <instance_list>}
	[, <wait_option>[, <timeout>[, @handle output ]]]

要启动一个或多个实例上的缺省逻辑集群：


sp_cluster logical, "online", {<lc_name>[, <instance_list>]}

要设置逻辑集群规则：开放式逻辑集群、故障切换模式、系统视图、启动模式和负载配置文件：


sp_cluster logical, "set", <lc_name>, { open 
		| failover, <failover_mode> | system_view, <view_mode> 
		| startup, { automatic | manual } | load_profile, <profile_name> }
 login_distribution, { affinity | "round-robin" }

要显示有关逻辑集群的信息：


sp_cluster logical, "show"
[, <lc_name>[, {<action>[, <state>] | route[, <type>[, <key>]]}]]

要设置和管理逻辑集群的负荷配置文件：


sp_cluster profile, ["show"[, <profile_name> ]
	| "create", <profile_name> | "drop", <profile_name> 
	| "set", <profile_name>[, weight[, <wt_metric>[, <wt_value> ] 
	| threshold[, <thr_metric>[, <thr_value> ] ] ]

要设置和管理逻辑集群的负荷配置文件：


sp_cluster profile, [ "show"[, <profile_name>] | "create", <profile_name> | "drop", <profile_name> | "set", <profile_name> [, weight [, <wt_metric> [, <wt_value> ] | threshold [, <thr_metric> [, <thr_value> ] ] ]

参数


sp_cluster connection, migrate, <lc_name>, <instance_name>, "<spid_list>"

<lc_name> – 逻辑集群的名称。

<instance_name> – 实例的名称。

<spid_list> – 要迁移的 spid 列表。如果存在多个 spid，则以分号分隔。


sp_cluster connection, ['migrate_status' | 'migrate_cancel' ][, '<spid_list>']

<spid_list> – 要调查的 spid 列表。

migrate_cancel – 指示要终止连接迁移。

migrate_status – 指示要调查连接迁移的状态。


sp_cluster logical, "action", <lc_name>, {cancel, <action_handle> | modify_time, <action_handle>, <wait_option>[, <timeout> ] | release, <action_handle>}

cancel – 指定要取消的操作。

<action_handle> – 操作标识符。

modify_time – 指定要修改的操作时间。

<wait_option> – 如何修改操作时间。其值包括：

wait – 指示提供指定的时间量（如果未提供 <timeout>，则不限时间）来迁移或断开现有连接。

nowait – 指示立即迁移或断开现有连接。

until – 指示提供某一天的特定时间，以在该时间之前迁移或断开现有连接。

<timeout> – 特定的时间量（与 wait 一起使用时）或特定时间（与 until 一起使用时）。格式为“hh:mm:ss”（按照 24 小时制）。例如，<timeout> 会将“11:30 p.m”（或“11:30pm”）记录为“23:30:00”。

release – 指定操作完成后释放由其占有的所有资源。


sp_cluster logical, "add", <lc_name>, { route, <route_type>, <key_list> | instance, <instance_list> | failover, <instance_list> | database <database_name> [, with nowait]}

<lc_name> – 逻辑集群的名称。

route – 指定要将一个或多个路由添加到逻辑集群中

<route_type> – 要添加的路由的类型。其值包括：

application – 为应用程序名指定到逻辑集群的路由。

login – 为登录名指定到逻辑集群的路由。

alias – 为服务器名别名指定到逻辑集群的路由。

<key_list> – 应用程序、登录名或别名的列表（具体取决于路由类型）。键列表中的元素以分号分隔。

instance – 指定要将一个或多个基本实例添加到逻辑集群中。

<instance_list> – 要添加的实例列表。如果存在多个实例，则以分号分隔。

failover – 指定要将一个或多个故障切换实例添加到逻辑集群中。

database – 指定将要添加到逻辑集群的数据库。

<database_name> – 是数据库的名称。

with nowait – 指示立即迁移或断开现有连接。


sp_cluster logical, "alter", <lc_name>, route, <route_type>, <key_list>

<lc_name> – 逻辑集群的名称。

route – 指定要更改的路由。

<route_type> – 要更改的路由的类型。其值包括：

application – 为应用程序名指定到逻辑集群的路由。 login– 为登录名指定到逻辑集群的路由。 alias– 为服务器名别名指定到逻辑集群的路由。 – 应用程序、登录名或别名的列表（具体取决于路由类型）。键列表中的元素以分号分隔。 <div class="code-block"><pre><code> sp_cluster logical, "create", <lc_name>[, for single instance access]

– 逻辑集群的名称。 for single instance access– 创建单个实例逻辑集群。缺省情况下，创建逻辑集群要设置以下参数： down_routing– "disconnect” failover– "instance” fail_to_any– "off" <div class="code-block"><pre><code> sp_cluster logical, "deactivate", <lc_name>, { "cluster" | "instance", <instance_list> } [, <wait_option>[, <timeout>,[, @handle output ]]]

– 逻辑集群的名称。 cluster– 指定整个集群。 instance– 指定仅将逻辑集群中的某些实例置于非活动状态。 – 逻辑集群中所选实例的列表。 – 有效选项包括： wait– 指示提供指定的时间量（如果未提供 <timeout>，则不限时间）来迁移或断开现有连接。 nowait– 指示立即迁移或断开现有连接。 until– 指示提供某一天的特定时间，以在该时间之前迁移或断开现有连接。  – 特定的时间量（与 wait 一起使用时）或特定时间（与 until 一起使用时）。格式为“hh:mm:ss”（按照 24 小时制）。例如，会将 11:30 p.m. 记录为 23:30:00。 @handle output– 指定要检索操作的操作句柄。 <div class="code-block"><pre><code> sp_cluster logical, "drop", <lc_name>, { cluster | instance, <instance_list> | failover, <instance_list> | route, <route_type>, <key_list> | database <database_name>}

 – 逻辑集群的名称。</p>

<p>

cluster

 – 指定整个集群。</p>

<p>

instance

 – 指定仅将逻辑集群中的某些实例置于非活动状态。</p>

<p>

 – 逻辑集群中所选实例的列表。</p>

<p>

database

 – 指定将要添加到逻辑集群的数据库。</p>

<p>

 – 是数据库的名称。</p>

<div class="code-block"><pre><code>
sp_cluster logical, "failback", <lc_name>, { cluster[, <wait_option>[, <timeout>[, @handle output ]]] | instance, <from_instance_list>, <to_instance_list>[, <wait_option>[, <timeout>[, @handle output ]]] }

 – 逻辑集群的名称。</p>

<p>

cluster

 – 指定整个集群。</p>

<p>

 – 预定义故障切换实例的列表。值 NULL 会激活第一个故障切换组。</p>

<p>

 – 要使其脱机的实例的列表。</p>

<p>

 – 有效选项包括：</p>

<p>

wait

 – 指示提供指定的时间量（如果未提供 <timeout>，则不限时间）来迁移或断开现有连接。</p>

<p>

nowait

 – 指示立即迁移或断开现有连接。</p>

<p>

until

 – 指示提供某一天的特定时间，以在该时间之前迁移或断开现有连接。</p>

<p>

 – 特定的时间量（与 wait 一起使用时）或特定时间（与 until 一起使用时）。格式为“hh:mm:ss”（按照 24 小时制）。例如，

 会将 11:30 p.m. 记录为 23:30:00。</p>

<p>

@handle output

 – 指定要检索操作的操作句柄。</p>

<div class="code-block"><pre><code>
sp_cluster logical, "failover", <lc_name>, {cluster[, <to_instance_list[, wait_option>[, <timeout>[, @handle output ]]] | instance, <from_instance_list>, <to_instance_list>[, <wait_option>[,<timeout>[, "sync"[, @handle output ] ] ] ] }

 – 逻辑集群的名称。</p>

<p>

cluster

 – 指定对整个逻辑集群进行故障切换。</p>

<p>

 – 预定义故障切换实例的列表。值 NULL 会激活第一个故障切换组。</p>

<p>

 – 如何记录操作时间。其值包括：</p>

<p>

wait – 指示提供指定的时间量（如果未提供

，则不限时间）来迁移或断开现有连接。</p>

<p>

nowait

 – 指示立即迁移或断开现有连接。</p>

<p>

until

 – 指示提供某一天的特定时间，以在该时间之前迁移或断开现有连接。</p>

<p>

 – 特定的时间量（与 wait 一起使用时）或特定时间（与 until 一起使用时）。格式为“hh:mm:ss”（按照 24 小时制）。例如，

 会将 11:30 p.m. 记录为 23:30:00。</p>

<p>

@handle output

 – 指定要检索故障切换的操作句柄。</p>

<p>

instance

 – 指定仅对逻辑集群中的选定实例进行故障切换。</p>

<p>

 – 要使其脱机的实例的列表</p>

<div class="code-block"><pre><code>
sp_cluster logical, "gather", <lc_name>

gather

 – 指示要收集一组限定连接以将其一起迁移到另一个逻辑集群。</p>

<p>

 – 要将连接迁移到的逻辑集群的名称。</p>

<div class="code-block"><pre><code>
sp_cluster logical, "offline", <lc_name>, { cluster | instance, <instance_list> } [, <wait_option>[, <timeout>[, @handle output ]]]

 – 逻辑集群的名称。</p>

<p>

cluster

 – 指定整个集群。</p>

<p>

instance

 – 指定仅使逻辑集群中的选定实例脱机。</p>

<p>

 – 逻辑集群中所选实例的列表。</p>

<p>

 – 如何指定操作时间。其值包括：</p>

<p>

wait – 指示提供指定的时间量（如果未提供

，则不限时间）来迁移或断开现有连接。</p>

<p>

nowait

 – 指示立即迁移或断开现有连接。</p>

<p>

until

 – 指示提供某一天的特定时间，以在该时间之前迁移或断开现有连接。</p>

<p>

 – 特定的时间量（与 wait 一起使用时）或特定时间（与 until 一起使用时）。格式为“hh:mm:ss”（按照 24 小时制）。例如，

 会将 11:30 p.m. 记录为 23:30:00。</p>

<p>

@handle output

 – 指定要检索操作的操作句柄。</p>

<p>

 – 要使其脱机的实例的列表</p>

<div class="code-block"><pre><code>
sp_cluster logical, "online", { <lc_name>[, <instance_list>]}

 – 逻辑集群的名称。</p>

<p>

 – 逻辑集群中所选实例的列表。</p>

<div class="code-block"><pre><code>
sp_cluster logical, "set", <lc_name>, {open | failover, <failover_mode> | system_view, <view_mode> | startup, { automatic | manual } | load_profile, <profile_name> | action_release, { automatic | manual } | gather, { automatic | manual } | login_distribution, { affinity | "round-robin" }

 – 逻辑集群的名称。</p>

<p>

open

 – 设置打开的逻辑集群。未路由的连接将发送至打开的逻辑集群。</p>

<p>

failover – 设置逻辑集群的故障切换模式。

 的值包括：</p>

<p>

instance

 – 指定 1:1 故障切换策略；每当基本实例失败时，都使一项故障切换资源联机。</p>

<p>

group

 – 指定仅在集群中的所有基本实例失败时才使故障切换资源联机。</p>

<p>

system_view

 – 为逻辑集群中运行的任务设置缺省系统视图。<view_mode> 的值包括：</p>

<p>

instance

 – 指定监控和信息性工具，例如 sp_who、sp_lock 以及描述实例的监控表。</p>

<p>

cluster

 – 指定监控和信息性工具，例如 sp_who、sp_lock 以及描述整个集群的监控表。</p>

<p>

startup { automatic | manual}

 – 设置逻辑集群的启动模式。</p>

<p>

automatic

 – 指定集群启动时自动启动逻辑集群。</p>

<p>

manual

 – 指定必须手动启动逻辑集群。</p>

<p>

login_distribution

 – 指定 Cluster Edition 在逻辑集群跨多个实例时如何分配连接。</p>

<p>

action_release

 – 启用或禁用在完成或取消 online、offline、failover 和 failback 逻辑集群操作之后自动释放和清除这些操作。</p>

<p>

automatic

 – 指定自动清除逻辑集群操作。</p>

<p>

manual

 – 指定完成或取消逻辑集群操作后不将其清除。这是缺省设置。</p>

<p>

gather

 – 启用或禁用以下功能：在执行 online、add route、alter route 或 drop route 其中一项预定义操作时，将连接组移动到其它逻辑集群。</p>

<p>

automatic

 – 指定自动移动连接。</p>

<p>

manual

 – 指定不自动移动连接。这是缺省设置。</p>

<p>

@handle output

 – 指定要检索操作的操作句柄。</p>

<p>

 – 要使其脱机的实例的列表</p>

<div class="code-block"><pre><code>
sp_cluster logical, "show"[, <lc_name>[, {<action>[, <state>] | route[, <type>[, <key>]]}]]

 – 逻辑集群的名称。如果输入 NULL，则显示所有逻辑集群的摘要信息。</p>

<p>

action

 – 指定有关管理操作的信息：failover、failback、online、offline、deactivate。</p>

<p>

 – 以下值之一：cancelled、complete 或 active。</p>

<p>

route

 – 指定有关路由的信息。</p>

<p>

 – 以下值之一：application、alias 或 login。</p>

<p>

 – 特定登录名、别名或应用程序名。</p>

<div class="code-block"><pre><code>
sp_cluster profile, [ "show" [, <profile_name> ] | "create", <profile_name> | "drop", <profile_name> | "set", <profile_name>[, weight[, <wt_metric>[, <wt_value> ] | threshold[, <thr_metric> [, <thr_value> ] ] ]

show

 – 显示配置的负载配置文件及其设置。</p>

<p>

 – 负载配置文件的名称。</p>

<p>

creates

 – 创建新的负载配置文件。</p>

<p>

drop

 – 删除负载配置文件。</p>

<p>

set

 – 指定负载配置文件的属性。必须单独设置各个属性。</p>

<p>

weight

 – 指定权值属性。</p>

<p>

 – 指定单个权值指标。其值包括：</p>

<p>

user connections

 – 一个实例接受新连接的容量（基于资源可用性）。</p>

<p>

cpu utilization

 – 一个实例接受新连接的容量（基于资源可用性）。</p>

<p>

run queue

 – 一个实例接受新连接的容量（基于资源可用性）。</p>

<p>

io load

 – 未完成的异步 I/O。</p>

<p>

engine deficit

 – 集群内各实例之间的联机引擎数差异。</p>

<p><b>注意</p>

<p>仅当集群中的实例具有数量不等的引擎时，才能测量 engine deficit。engine deficit 会在负载得分中添加一个衡量最大相对容量的指标。</p>
<p></b></p>

<p>

user metric

 – 用户提供的可选指标。</p>

<p>

 – 指定权值。有效值为 0 到 255。如果权值为零（0），则在计算中排除指标。</p>

<p>

threshold

 – 指定阈值属性。</p>

<p>

 – 指定特定的阈值属性。其值包括：</p>

<p>

dynamic

 – 指定动态负载分配的阈值。</p>

<p>

 – 指定登录重定向的阈值</p>

<p>

hysteresis

 – 为任意连接重定向指定最小负载得分。</p>

<p>

– 取决于 的值。当

 为：</p>

<p>

dynamic 或 login –

 是两个实例负载分值的百分比差。有效值为 0 到 100。如果权值为零（0），则禁用这种负载分配。</p>

<p>

hysteresis

 – <thr_value> 是实现动态负载分配或登录重定向而要求目标实例必须达到的最小负载分值。</p>

<h3>示例</h3>

<h4>示例 1</h4>

<p>将 spid 为 73 的连接移到 SalesLC 集群：</p>

<div class="code-block"><pre><code>
sp_cluster connection, migrate, SalesLC, NULL, '73'

示例 2

示例 3

示例 4

确定是否正在对 spid 73 进行连接迁移；如果是，Cluster Edition 将取消迁移：

示例 5

示例 6

示例 7

示例 8

示例 9

示例 10

示例 11

示例 12

将登录名“tom”、“dick”和“harry”传送到“SalesLC”逻辑集群

示例 13

示例 14

创建一个到逻辑集群“lc1”（别名为“SalesLC”）的别名类型的路由。随后将路由的逻辑集群关联从“lc1”更改为“lc2”。路由用路由类型（别名）及其键（SalesLC）标识。

示例 15

示例 16

立即停止“SalesLC”逻辑集群中的所有实例，并将“SalesLC”置于非活动状态：

示例 17

停止“ase1”和“ase2”实例，并将“SalesLC”置于非活动状态：

示例 18

示例 19

示例 20

删除“SalesLC”逻辑集群中应用程序 field_sales 和 web_sales 的路由。

示例 21

示例 22

“SalesLC”在“ase3”和“ase1”上运行。在此示例中，“ase3”故障恢复到“ase1”，而“SalesLC”继续在“ase2”上运行。此操作在两分钟后执行：

示例 23

将“SalesLC”逻辑集群故障切换到第一个预定义故障切换资源组。故障切换在等待 2 分钟后终止连接。

示例 24

“SalesLC”在“ase1”和“ase2”上运行。在此示例中，“ase1”故障恢复到“ase3”，而“SalesLC”继续在“ase2”上运行。不指定 wait 选项，以采用缺省设置（即不限等待时间）。

示例 25

示例 26

示例 27

立即停止“SalesLC”中的所有实例，并将“SalesLC”置于脱机状态。

示例 28

停止“SalesLC”中的“ase1”和“ase2”实例，并将“SalesLC”置于脱机状态。

示例 29

启动“SalesLC”逻辑集群中的所有基本实例，并使该集群联机。

示例 30

示例 31

将“SalesLC”逻辑集群的负载配置文件设置为 Sybase 配置文件 sybase_profile_oltp：

示例 32

示例 33

示例 34

示例 35

示例 36

示例 37

指定“my_profile”的指标权值。“user connections”设置为零，这会将该指标从配置文件中排除：

示例 38

对于“my_profile”，将登录重定向阈值设置为 80 并将停滞值设置为 10：

示例 39

示例 40

示例 41

删除名为“automotive”的单个实例数据库和名为“tech”的单个实例逻辑集群之间的绑定：

sp_cluster

语法

参数

示例 2

示例 3

示例 4

示例 5

示例 6

示例 7

示例 8

示例 9

示例 10

示例 11

示例 12

示例 13

示例 14

示例 15

示例 16

示例 17

示例 18

示例 19

示例 20

示例 21

示例 22

示例 23

示例 24

示例 25

示例 26

示例 27

示例 28

示例 29

示例 30

示例 31

示例 32

示例 33

示例 34

示例 35

示例 36

示例 37

示例 38

示例 39

示例 40

示例 41

用法