[comment]: # ({c4cea8a3-5b27abf6})
# 4. Подготовка таблицы журнала аудита для партиционирования

[comment]: # ({/c4cea8a3-5b27abf6})

[comment]: # ({f697fbbd-9f4e8194})
#### Обзор

Некоторые базы данных (например, MySQL) требуют, чтобы столбец партиционирования был частью уникального ограничения таблицы (table's unique constraint).
Поэтому для партиционирования таблицы `auditlog` по времени первичный ключ необходимо изменить с `auditid` на составной ключ `auditid` + `clock`.

В этом разделе приведены инструкции по изменению первичного ключа таблицы `auditlog`.

[comment]: # ({/f697fbbd-9f4e8194})

[comment]: # ({496f4662-399f6b3f})

::: noteimportant
Инструкции, представленные на этой странице, предназначены для опытных пользователей.
Обратите внимание, что эти инструкции, возможно, придется скорректировать для вашей конкретной конфигурации.
Изменение первичного ключа также может быть несовместимо с будущими обновлениями, поэтому может потребоваться ручная обработка будущих обновлений.
<br><br>
Изменение первичного ключа может быть ресурсоёмкой операцией, которая занимает много времени в зависимости от размера таблицы `auditlog`.
Рекомендуется остановить сервер Zabbix и переключить веб-интерфейс Zabbix в [режим обслуживания](/manual/web_interface/maintenance_mode) на время изменения.
Однако, если это абсолютно необходимо, есть способ изменить первичный ключ без простоя (смотрите ниже).
:::

[comment]: # ({/496f4662-399f6b3f})

[comment]: # ({388a49dd-762f2fc8})

Партиционирование таблицы `auditlog` может улучшить, например, процедуру очистки истории в больших инсталляциях.

Хотя [очистка истории](/manual/web_interface/frontend_sections/administration/housekeeping) Zabbix в настоящее время не может использовать преимущества партиционированных таблиц (за исключением TimescaleDB), вы можете отключить очистку истории Zabbix и удалять партиции с помощью скриптов.

Начиная с версии Zabbix 7.0, таблица `auditlog` для TimescaleDB была преобразована в гипертаблицу, что позволяет администратору удалять данные по частям.
Чтобы обновить существующую таблицу `auditlog` до гипертаблицы, смотрите [Обновление схемы TimescaleDB](/manual/appendix/install/timescaledb#обновление-схемы-timescaledb).

[comment]: # ({/388a49dd-762f2fc8})

[comment]: # ({073b5bd5-271b9416})
#### MySQL

[comment]: # ({/073b5bd5-271b9416})

[comment]: # ({f576f708-e752da32})
##### Важные замечания по перестроению индексов

MySQL автоматически перестраивает индексы для первичного ключа во время операции `ALTER TABLE`.
Однако, чтобы обеспечить оптимальную производительность базы данных, настоятельно рекомендуется также вручную перестроить индексы с помощью оператора `OPTIMIZE TABLE`.

Перестроение индексов может временно потребовать столько же дополнительного дискового пространства, сколько использует сама таблица.
Чтобы получить текущий размер данных и индексов, можно выполнить следующие операторы:

```sql
ANALYZE TABLE auditlog;
SHOW TABLE STATUS LIKE 'auditlog';
```

Если доступное дисковое пространство вызывает беспокойство, следуйте инструкциям [Изменение первичного ключа без простоя](#изменение-первичного-ключа-без-простоя).
Также доступны другие варианты:

-   Увеличение параметра MySQL [`sort_buffer_size` \[en\]](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html) может помочь сократить использование дискового пространства при ручном перестроении индексов.
    Однако изменение этой переменной может повлиять на общее использование памяти базы данных.
-   Рассмотрите возможность освобождения места путем удаления потенциально ненужных данных.
-   Рассмотрите возможность уменьшения параметра [очистки истории](/manual/web_interface/frontend_sections/administration/housekeeping#обзор) *Период хранения данных (Data storage period)* перед выполнением очистки истории.

[comment]: # ({/f576f708-e752da32})

[comment]: # ({de2a0c3b-e0cfde87})
##### Изменение первичного ключа с простоем

1\. Удалите текущий первичный ключ таблицы `auditlog` и добавьте новый первичный ключ.

```sql
ALTER TABLE auditlog DROP PRIMARY KEY, ADD PRIMARY KEY (auditid, clock);
```

2\. Перестройте индексы (необязательно, но настоятельно рекомендуется, смотрите [Важные примечания по перестроению индексов](#важные-замечания-по-перестроению-индексов)).

```sql
OPTIMIZE TABLE auditlog;
```

[comment]: # ({/de2a0c3b-e0cfde87})

[comment]: # ({19b5a6ba-9fb9cdb0})
##### Изменение первичного ключа без простоя

Здесь описан ручной метод изменения первичного ключа.
В качестве альтернативы вы можете использовать набор инструментов [pt-online-schema-change \[en\]](https://docs.percona.com/percona-toolkit/pt-online-schema-change.html) от Percona.
Этот набор инструментов автоматически выполняет следующие действия, а также минимизирует пространство, используемое для изменения таблицы `auditlog`.

1\. Создайте новую таблицу с новым первичным ключом и создайте индексы.

```sql
CREATE TABLE `auditlog_new` (
  `auditid`            varchar(25)                               NOT NULL,
  `userid`             bigint unsigned                           NULL,
  `username`           varchar(100)    DEFAULT ''                NOT NULL,
  `clock`              integer         DEFAULT '0'               NOT NULL,
  `ip`                 varchar(39)     DEFAULT ''                NOT NULL,
  `action`             integer         DEFAULT '0'               NOT NULL,
  `resourcetype`       integer         DEFAULT '0'               NOT NULL,
  `resourceid`         bigint unsigned                           NULL,
  `resource_cuid`      varchar(25)                               NULL,
  `resourcename`       varchar(255)    DEFAULT ''                NOT NULL,
  `recordsetid`        varchar(25)                               NOT NULL,
  `details`            longtext                                  NOT NULL,
  PRIMARY KEY (auditid,clock)
) ENGINE=InnoDB;
CREATE INDEX `auditlog_1` ON `auditlog_new` (`userid`,`clock`);
CREATE INDEX `auditlog_2` ON `auditlog_new` (`clock`);
CREATE INDEX `auditlog_3` ON `auditlog_new` (`resourcetype`,`resourceid`);
```

2\. Поменяйте таблицы местами.

```sql
RENAME TABLE auditlog TO auditlog_old, auditlog_new TO auditlog;
```

3\. Скопируйте данные из старой таблицы в новую.

```sql
INSERT INTO auditlog SELECT * FROM auditlog_old;
```

Это можно сделать частями (несколько операторов `INSERT INTO` с условиями `WHERE clock` по мере необходимости), чтобы избежать чрезмерного использования ресурсов.

4\. Удалите старую таблицу.

```sql
DROP TABLE auditlog_old;
```

[comment]: # ({/19b5a6ba-9fb9cdb0})

[comment]: # ({dc8ac96e-381b1eee})
#### PostgreSQL

[comment]: # ({/dc8ac96e-381b1eee})

[comment]: # ({64d2938a-30f863e9})
##### Важные замечания по перестроению индексов {#important-notes-on-rebuilding-indexes-2}

PostgreSQL автоматически перестраивает индексы для первичного ключа во время операции `ALTER TABLE`.
Однако настоятельно рекомендуется также вручную перестроить индексы с помощью оператора `REINDEX TABLE CONCURRENTLY`, чтобы обеспечить оптимальную производительность базы данных.

Перестроение индексов может временно потребовать до трех раз больше дискового пространства, чем сейчас занимают индексы.
Чтобы узнать текущий размер индексов, можно выполнить следующий запрос:

```sql
SELECT pg_size_pretty(pg_indexes_size('auditlog'));
```

Если доступное дисковое пространство вызывает беспокойство, следуйте инструкциям в разделе [Изменение первичного ключа без простоя](#altering-primary-key-without-downtime-2).
Также доступны и другие варианты:

-   Увеличение параметра PostgreSQL [`maintenance_work_mem`](https://www.postgresql.org/docs/current/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM) может помочь снизить использование дискового пространства при ручном перестроении индексов.
    Однако изменение этой переменной может повлиять на общее использование памяти базой данных.
-   Если у вас есть другой диск или табличное пространство с большим объемом свободного места, можно изменить расположение временного хранилища для перестроения индекса.
    Вы можете задать параметр PostgreSQL [`temp_tablespaces`](https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-TEMP-TABLESPACES), чтобы указать другое табличное пространство для временных объектов.
-   Рассмотрите возможность освобождения места путем удаления потенциально ненужных данных.
-   Рассмотрите возможность уменьшения параметра *Период хранения данных* [housekeeper](/manual/web_interface/frontend_sections/administration/housekeeping#overview) перед запуском housekeeper.

[comment]: # ({/64d2938a-30f863e9})

[comment]: # ({18dc0642-915b5f5f})
##### Изменение первичного ключа с простоем {#altering-primary-key-with-downtime-2}

1\. Удалите текущий первичный ключ таблицы `auditlog` и добавьте новый первичный ключ.

```sql
ALTER TABLE auditlog DROP CONSTRAINT auditlog_pkey;
ALTER TABLE auditlog ADD PRIMARY KEY (auditid,clock);
```

2\. Перестройте индексы (необязательно, но настоятельно рекомендуется; см. [Важные замечания по перестройке индексов](#important-notes-on-rebuilding-indexes-2)).

```sql
REINDEX TABLE CONCURRENTLY auditlog;
```

[comment]: # ({/18dc0642-915b5f5f})

[comment]: # ({ab7f639c-998c6861})
##### Изменение первичного ключа без простоя

Здесь описан ручной метод изменения первичного ключа.
В качестве альтернативы можно рассмотреть расширение `pg_repack` для создания новой таблицы, копирования данных и замены таблиц.

1\. Создайте новую таблицу с новым первичным ключом и создайте индексы.

```sql
CREATE TABLE auditlog_new (
  auditid              varchar(25)                               NOT NULL,
  userid               bigint                                    NULL,
  username             varchar(100)    DEFAULT ''                NOT NULL,
  clock                integer         DEFAULT '0'               NOT NULL,
  ip                   varchar(39)     DEFAULT ''                NOT NULL,
  action               integer         DEFAULT '0'               NOT NULL,
  resourcetype         integer         DEFAULT '0'               NOT NULL,
  resourceid           bigint                                    NULL,
  resource_cuid        varchar(25)                               NULL,
  resourcename         varchar(255)    DEFAULT ''                NOT NULL,
  recordsetid          varchar(25)                               NOT NULL,
  details              text            DEFAULT ''                NOT NULL,
  PRIMARY KEY (auditid,clock)
);
CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock);
CREATE INDEX auditlog_new_2 ON auditlog_new (clock);
CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid);
```

2\. Поменяйте таблицы местами.

```sql
ALTER TABLE auditlog RENAME TO auditlog_old;
ALTER TABLE auditlog_new RENAME TO auditlog;
```

3\. Скопируйте данные из старой таблицы в новую.

```sql
INSERT INTO auditlog SELECT * FROM auditlog_old;
```

Это можно сделать частями (несколько операторов `INSERT INTO` с условиями `WHERE clock` по мере необходимости), чтобы избежать чрезмерного использования ресурсов.

4\. Удалите старую таблицу.

```sql
DROP TABLE auditlog_old;
```

[comment]: # ({/ab7f639c-998c6861})

[comment]: # ({33200567-31083cb3})
#### Смотрите также

-   [Обновление базы данных для использования первичных ключей](/manual/appendix/install/db_primary_keys)

[comment]: # ({/33200567-31083cb3})