SHOW REPLICA DISTRIBUTION

デスクリプション

このステートメントは、Tableまたはパーティションのレプリカステータス情報を表示するために使用されます。

Syntax

SHOW REPLICA DISTRIBUTION FROM [ <database_name>.]<table_name> [<partition_list>] 
[where_clause]

ここで：

partition_list
  : PARTITION (<partition_name>[ , ... ])

ここで：

where_clause
: WHERE <output_column_name> = <value>

必須パラメータ

1. <table_name>

Tableの識別子（つまり名前）で、データベース（Database）内で一意である必要があります。

識別子は文字で始まる必要があり（Unicode名前サポートが有効な場合はサポートされている言語の任意の文字）、識別子文字列全体がバッククォート（例：My Object）で囲まれていない限り、スペースや特殊文字を含むことはできません。

識別子は予約キーワードを使用することはできません。

詳細については、識別子要件と予約キーワードを参照してください。

オプションパラメータ

1. <db_name>

データベースの識別子（つまり名前）で、クラスター（Cluster）内で一意である必要があります。

識別子は文字で始まる必要があり（Unicode名前サポートが有効な場合はサポートされている言語の任意の文字）、識別子文字列全体がバッククォート（例：My Object）で囲まれていない限り、スペースや特殊文字を含むことはできません。

識別子は予約キーワードを使用することはできません。

詳細については、識別子要件と予約キーワードを参照してください。

2. <partition_list>

パーティション識別子（つまり名前）のカンマ区切りリストで、Table（Table）内で一意である必要があります。

識別子は文字で始まる必要があり（Unicode名前サポートが有効な場合はサポートされている言語の任意の文字）、識別子文字列全体がバッククォート（例：My Object）で囲まれていない限り、スペースや特殊文字を含むことはできません。

識別子は予約キーワードを使用することはできません。

詳細については、識別子要件と予約キーワードを参照してください。

戻り値

Column	DataType	Note
BackendId	Int	レプリカが配置されているBE（Backend）ノードのID。
ReplicaNum	Int	このBEノード上のレプリカ数。
ReplicaSize	Int	このBEノード上のすべてのレプリカが占める総ストレージサイズ（バイト単位）。
NumGraph	String	レプリカ数の割合を視覚的に表現したもの（>記号を使用）。
NumPercent	String	レプリカ数のパーセンテージ表現（例：100.00%）。
SizeGraph	String	レプリカストレージサイズの割合を視覚的に表現したもの（>記号を使用）。
SizePercent	String	レプリカストレージサイズのパーセンテージ表現（例：100.00%）。

アクセス制御要件

このSQLコマンドを実行するユーザーは、最低でも以下の権限を持つ必要があります：

Privilege	Object	注釈
Admin_priv	Database	データベース上で管理操作を実行するために必要。Table、パーティション、システムレベルのコマンドの管理を含みます。

例

• 查看表的副本分布

  SHOW REPLICA DISTRIBUTION FROM sell_user;

  *************************** 1. row ***************************
  BackendId: 10009
   ReplicaNum: 4
  ReplicaSize: 8857
     NumGraph: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
   NumPercent: 100.00%
    SizeGraph: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  SizePercent: 100.00%

• Tableのパーティションのレプリカ分散を確認する

  SHOW REPLICA DISTRIBUTION FROM db1.tbl1 PARTITION(p1, p2);