Перейти к содержимому
Последнее обновление

SHOW REPLICA DISTRIBUTION

Описание​

Эта инструкция используется для отображения информации о состоянии реплик таблицы или раздела.

Синтаксис​

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>

Идентификатор (то есть имя) таблицы, который должен быть уникальным в пределах базы данных (Database).

Идентификатор должен начинаться с буквы (или любого символа одного из поддерживаемых языков, если включена поддержка имён Unicode) и не может содержать пробелы или специальные символы, если только вся строка идентификатора не заключена в обратные кавычки (например, My Object).

В качестве идентификаторов нельзя использовать зарезервированные ключевые слова.

Подробнее см. требования к идентификаторам и список зарезервированных ключевых слов.

Необязательные параметры​

1. <db_name>

Идентификатор (то есть имя) базы данных, который должен быть уникальным в пределах кластера (Cluster).

Идентификатор должен начинаться с буквы (или любого символа одного из поддерживаемых языков, если включена поддержка имён Unicode) и не может содержать пробелы или специальные символы, если только вся строка идентификатора не заключена в обратные кавычки (например, My Object).

В качестве идентификаторов нельзя использовать зарезервированные ключевые слова.

Подробнее см. требования к идентификаторам и список зарезервированных ключевых слов.

2. <partition_list>

Разделённый запятыми список идентификаторов (то есть имён) разделов, которые должны быть уникальными в пределах таблицы (Table).

Идентификатор должен начинаться с буквы (или любого символа одного из поддерживаемых языков, если включена поддержка имён Unicode) и не может содержать пробелы или специальные символы, если только вся строка идентификатора не заключена в обратные кавычки (например, My Object).

В качестве идентификаторов нельзя использовать зарезервированные ключевые слова.

Подробнее см. требования к идентификаторам и список зарезервированных ключевых слов.

Возвращаемое значение​

СтолбецТип данныхОписание
BackendIdIntИдентификатор узла BE (Backend), на котором расположена реплика.
ReplicaNumIntКоличество реплик на этом узле BE.
ReplicaSizeIntОбщий объём хранилища, занимаемый всеми репликами на этом узле BE (в байтах).
NumGraphStringНаглядное представление доли реплик по количеству (с помощью символов >).
NumPercentStringДоля реплик по количеству в процентах, например 100.00%.
SizeGraphStringНаглядное представление доли реплик по занимаемому объёму (с помощью символов >).
SizePercentStringДоля реплик по занимаемому объёму в процентах, например 100.00%.

Требования к правам доступа​

Пользователь, выполняющий эту SQL-команду, должен иметь как минимум следующие права:

ПравоОбъектПримечания
Admin_privDatabaseТребуется для выполнения административных операций с базой данных, включая управление таблицами, разделами и выполнение команд системного уровня.

Примеры​

  • Просмотр распределения реплик таблицы

    SHOW REPLICA DISTRIBUTION FROM sell_user;
    *************************** 1. row ***************************
    BackendId: 10009
     ReplicaNum: 4
    ReplicaSize: 8857
       NumGraph: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
     NumPercent: 100.00%
      SizeGraph: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
    SizePercent: 100.00%

  • Просмотр распределения реплик разделов таблицы

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