2.3 KiB
toc_priority | toc_title |
---|---|
30 | MaterializedPostgreSQL |
MaterializedPostgreSQL
Creating a Database
CREATE DATABASE test_database
ENGINE = MaterializedPostgreSQL('postgres1:5432', 'postgres_database', 'postgres_user', 'postgres_password'
SELECT * FROM test_database.postgres_table;
Settings
-
materialized_postgresql_max_block_size
- Number of rows collected before flushing data into table. Default:65536
. -
materialized_postgresql_tables_list
- List of tables for MaterializedPostgreSQL database engine. Default:whole database
. -
materialized_postgresql_allow_automatic_update
- Allow to reload table in the background, when schema changes are detected. Default:0
(false
).
CREATE DATABASE test_database
ENGINE = MaterializedPostgreSQL('postgres1:5432', 'postgres_database', 'postgres_user', 'postgres_password'
SETTINGS materialized_postgresql_max_block_size = 65536,
materialized_postgresql_tables_list = 'table1,table2,table3';
SELECT * FROM test_database.table1;
Requirements
-
Setting
wal_level
tological
andmax_replication_slots
to at least2
in the postgresql config file. -
Each replicated table must have one of the following replica identity:
-
default (primary key)
-
index
postgres# CREATE TABLE postgres_table (a Integer NOT NULL, b Integer, c Integer NOT NULL, d Integer, e Integer NOT NULL);
postgres# CREATE unique INDEX postgres_table_index on postgres_table(a, c, e);
postgres# ALTER TABLE postgres_table REPLICA IDENTITY USING INDEX postgres_table_index;
Primary key is always checked first. If it is absent, then index, defined as replica identity index, is checked. If index is used as replica identity, there has to be only one such index in a table. You can check what type is used for a specific table with the following command:
postgres# SELECT CASE relreplident
WHEN 'd' THEN 'default'
WHEN 'n' THEN 'nothing'
WHEN 'f' THEN 'full'
WHEN 'i' THEN 'index'
END AS replica_identity
FROM pg_class
WHERE oid = 'postgres_table'::regclass;
Warning
- TOAST values convertion is not supported. Default value for the data type will be used.