PolarDB:Use Elastic Parallel Query to accelerate index creation

Comportamento de polar_bt_write_page_buffer_size

• 0 (padrão): Grava as entradas do índice em disco bloco a bloco conforme cada página do índice é preenchida.

• Valor diferente de zero: Armazena as entradas do índice em um buffer do kernel com o tamanho especificado e as grava todas de uma vez quando o buffer está cheio. Isso reduz a sobrecarga frequente de agendamento de E/S.

Pré-requisitos

Antes de começar, verifique se você possui:

• Um cluster PolarDB for PostgreSQL (Compatible with Oracle).

• Permissão para executar instruções DDL na tabela de destino.

Procedimento

O exemplo a seguir cria uma tabela chamada test e constrói um índice usando o EPQ.

1. Crie a tabela de teste.

CREATE TABLE test(id int, id2 int);

Verifique o esquema da tabela:

\d test

Saída esperada:

               Table "public.test"
 Column |  Type   | Collation | Nullable | Default
--------+---------+-----------+----------+---------
 id     | integer |           |          |
 id2    | integer |           |          |

2. Ative a criação de índices acelerada por EPQ.

SET polar_px_enable_btbuild=on;

Verifique a configuração:

SHOW polar_px_enable_btbuild;

Saída esperada:

 polar_px_enable_btbuild
-------------------------
 on
(1 row)

3. Crie o índice.

Adicione WITH (px_build=on) à instrução CREATE INDEX para usar o EPQ nesta construção:

CREATE INDEX t ON test(id) WITH(px_build=on);

Apenas defina polar_px_enable_btbuild=on não ativa o EPQ para uma construção de índice específica. Inclua obrigatoriamente WITH (px_build=on) na instrução CREATE INDEX. Sem isso, o PolarDB usa o método nativo (serial) de criação de índice, e o índice resultante não exibirá a anotação px_build.

4. Verifique se o índice foi criado com EPQ.

\d test

Saída esperada:

               Table "public.test"
 Column |  Type   | Collation | Nullable | Default
--------+---------+-----------+----------+---------
 id     | integer |           |          |
 id2    | integer |           |          |
Indexes:
    "t" btree (id) WITH (px_build=finish)

O campo (px_build=finish) confirma o uso do EPQ.