配置ポリシーの変更

ALTER PLACEMENT POLICY 、以前に作成された既存の配置ポリシーを変更するために使用されます。配置ポリシーを使用するすべてのテーブルとパーティションは自動的に更新されます。

注記:

この機能はTiDB Cloudサーバーレスクラスターでは使用できません。

ALTER PLACEMENT POLICY 、以前のポリシーを新しい定義に置き換えます。古いポリシーを新しいポリシーとマージしません。次の例では、 ALTER PLACEMENT POLICYが実行されるとFOLLOWERS=4は失われます。

CREATE PLACEMENT POLICY p1 FOLLOWERS=4; ALTER PLACEMENT POLICY p1 PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1";

概要

AlterPolicyStmt
ALTERPLACEMENTPOLICYIfExistsPolicyNamePlacementOptionList
PolicyName
Identifier
PlacementOptionList
PlacementOptionPlacementOptionListPlacementOptionPlacementOptionList,PlacementOption
PlacementOption
CommonPlacementOptionSugarPlacementOptionAdvancedPlacementOption
CommonPlacementOption
FOLLOWERSEqOptLengthNum
SugarPlacementOption
PRIMARY_REGIONEqOptstringLitREGIONSEqOptstringLitSCHEDULEEqOptstringLit
AdvancedPlacementOption
LEARNERSEqOptLengthNumCONSTRAINTSEqOptstringLitLEADER_CONSTRAINTSEqOptstringLitFOLLOWER_CONSTRAINTSEqOptstringLitLEARNER_CONSTRAINTSEqOptstringLitSURVIVAL_PREFERENCESEqOptstringLit

注記:

クラスターで使用可能なリージョンを確認するには、 SHOW PLACEMENT LABELS参照してください。

利用可能なリージョンが表示されない場合は、TiKV インストールでラベルが正しく設定されていない可能性があります。

CREATE PLACEMENT POLICY p1 PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1"; CREATE TABLE t1 (i INT) PLACEMENT POLICY=p1; -- Assign policy p1 to table t1 ALTER PLACEMENT POLICY p1 PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1,us-west-2" FOLLOWERS=4; -- The rules of t1 will be updated automatically. SHOW CREATE PLACEMENT POLICY p1\G
Query OK, 0 rows affected (0.08 sec) Query OK, 0 rows affected (0.10 sec) ***************************[ 1. row ]*************************** Policy | p1 Create Policy | CREATE PLACEMENT POLICY `p1` PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1,us-west-2" FOLLOWERS=4 1 row in set (0.00 sec)

MySQL 互換性

このステートメントは、MySQL 構文に対する TiDB 拡張です。

参照

このページは役に立ちましたか?