Descrição

O comando CREATE PUBLICATION define uma nova publicação no banco de dados corrente. O nome da publicação deve ser diferente do nome de qualquer outra publicação existente no banco de dados corrente.

Uma publicação é essencialmente um grupo de tabelas cujas alterações nos dados devem ser replicadas por meio de uma replicação lógica. Veja Publicação para obter detalhes sobre como as publicações se encaixam na configuração de replicação lógica.

Parâmetros

Ao especificar um parâmetro do tipo de dados boolean, a parte = valor pode ser omitida, o que equivale a especificar TRUE.

Notas

Se FOR TABLE, FOR ALL TABLES ou FOR TABLES IN SCHEMA não forem especificados, a publicação começará com um conjunto vazio de tabelas. Isto é útil caso precisem ser adicionadas tabelas ou esquemas posteriormente.

A criação de uma publicação não inicia a replicação. Define apenas uma lógica de agrupamento e filtragem para futuros subscritores.

Para criar uma publicação, o usuário que a cria precisa ter o privilégio CREATE para o banco de dados corrente. (É claro que os superusuários não estão sujeitos esta verificação.)

Para adicionar uma tabela a uma publicação, o usuário que solicita a alteração deve ter direitos de propriedade sobre a tabela. As cláusulas FOR ALL TABLES e FOR TABLES IN SCHEMA requerem que o usuário que invoca o comando seja um superusuário.

As tabelas adicionadas a uma publicação que publica UPDATE e/ou DELETE devem possuir REPLICA IDENTITY definido. Caso contrário, estas operações serão proibidas nessas tabelas.

Qualquer lista de colunas deve incluir as colunas REPLICA IDENTITY para que as operações UPDATE ou DELETE sejam publicadas. Não há restrições de lista de colunas quando a publicação publicar apenas operações INSERT.

Uma expressão de filtro de linha (ou seja, a cláusula WHERE) deve conter apenas colunas abrangidas por REPLICA IDENTITY, para que as operações de UPDATE e DELETE sejam publicadas. Para a publicação de operações de INSERT, qualquer coluna pode ser usada na expressão WHERE. O filtro de linhas permite expressões simples que não possuam funções definidas pelo usuário, operadores definidos pelo usuário, tipos de dados definidos pelo usuário, agrupamentos definidos pelo usuário, funções internas não-imutáveis ​​ou referências a colunas do sistema.

As colunas geradas que fazem parte da REPLICA IDENTITY devem ser publicadas explicitamente, seja listando-as na lista de colunas ou ativando a opção publish_generated_columns, para que as operações UPDATE e DELETE sejam publicadas.

O filtro de linha em uma tabela torna-se redundante se FOR TABLES IN SCHEMA for especificado e a tabela pertencer ao esquema referenciado.

Para tabelas particionadas publicadas, o filtro de linhas para cada partição será obtido da tabela particionada publicada se o parâmetro de publicação publish_via_partition_root for verdade, ou da própria partição se for falso (o padrão). Veja Filtros de linha para obter detalhes sobre os filtros de linha. Da mesma forma, para tabelas particionadas publicadas, a lista de colunas para cada partição será obtida da tabela particionada publicada se o parâmetro de publicação publish_via_partition_root for verdade, ou da própria partição se for falso.

Para um comando INSERT ... ON CONFLICT, a publicação irá publicar a operação resultante do comando. Dependendo do resultado, poderá ser publicado como INSERT ou UPDATE, ou pode não ser publicado de forma alguma.

Para um comando MERGE, a publicação irá mostrar um INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída.

Anexar (ATTACH) uma tabela a uma árvore de partições cuja raiz é publicada usando uma publicação com publish_via_partition_root definido como verdade não resulta na replicação do conteúdo existente da tabela.

Os comandos COPY ... FROM são publicados como operações INSERT.

As operações de DDL não são publicadas.

A expressão da cláusula WHERE é executada com a função de banco de dados (role) usada para a conexão de replicação.

Exemplos

Criar uma publicação que publica todas as alterações em duas tabelas:

CREATE PUBLICATION mypublication
    FOR TABLE users, departments;

Criar uma publicação que publica todas as alterações dos departamentos ativos:

CREATE PUBLICATION active_departments
    FOR TABLE departments
    WHERE (active IS TRUE);

Criar uma publicação que publica todas as alterações em todas as tabelas:

CREATE PUBLICATION alltables
    FOR ALL TABLES;

Criar uma publicação que publica apenas operações de INSERT em uma tabela:

CREATE PUBLICATION insert_only
    FOR TABLE mydata
    WITH (publish = 'insert');

Criar uma publicação que publica todas as alterações nas tabelas. users, departments e todas as alterações para todas as tabelas presentes no esquema production:

CREATE PUBLICATION production_publication
    FOR TABLE users, departments,
    TABLES IN SCHEMA production;

Criar uma publicação que publica todas as alterações para todas as tabelas presentes nos esquemas marketing e sales:

CREATE PUBLICATION sales_publication
    FOR TABLES IN SCHEMA marketing, sales;

Criar uma publicação que publica todas as alterações da tabela users, mas replica apenas as colunas user_id e firstname:

CREATE PUBLICATION users_filtered
    FOR TABLE users (user_id, firstname);

Conformidade

O comando CREATE PUBLICATION é uma extensão do PostgreSQL.

Veja também