Esta forma adiciona uma nova coluna à tabela, usando a mesma sintaxe de CREATE TABLE. Se for especificado IF NOT EXISTS, e já existir uma coluna com este nome, não será relatado nenhum erro.

Esta forma exclui uma coluna da tabela sendo alterada. Os índices e restrições de tabela envolvendo a coluna também são excluídos automaticamente. As estatísticas multivariadas que fazem referência à coluna excluída também são removidas, se a exclusão da coluna fizer com que as estatísticas contenham dados para apenas uma única coluna. É necessário especificar CASCADE, se algo fora da tabela depender da coluna, por exemplo, referências de chaves estrangeiras ou visões. Se for especificado IF EXISTS, e a coluna não existir, não será relatado nenhum erro. É emitido um aviso neste caso.

Esta forma altera o tipo de dados de uma coluna da tabela. Os índices e restrições de tabela simples que envolvem a coluna são convertidos automaticamente para usar o novo tipo de dados da coluna, reanalisando a expressão fornecida originalmente. A cláusula opcional COLLATE especifica uma ordenação para a coluna alterada; se omitida, a ordenação será a ordenação padrão para o novo tipo de dados da coluna. A cláusula opcional USING especifica como calcular o novo valor da coluna a partir do valor antigo; se omitida, a conversão padrão é a mesma que a de uma atribuição do tipo de dados antigo para o tipo de dados novo. Deve ser fornecida a cláusula USING, caso não haja conversão ou atribuição implícita do tipo de dados antigo para o tipo de dados novo.

Quando esta forma é usada, as estatísticas da coluna são removidas, portanto, recomenda-se executar posteriormente o comando ANALYZE na tabela. Para uma coluna virtual gerada, o comando ANALYZE não é necessário, porque estas colunas nunca possuem estatísticas.

Estas formas definem ou removem o valor padrão da coluna (onde remover é equivalente a definir o valor padrão como NULL). O novo valor padrão é aplicado apenas nos comandos INSERT e UPDATE posteriores; não causa alterações nas linhas que já estão na tabela.

Estas formas alteram se a coluna está definida para permitir valores nulos, ou para rejeitar valores nulos.

SET NOT NULL só pode ser aplicado a uma coluna se nenhum dos registros na tabela contiver um valor NULL para esta coluna. Normalmente, isto é verificado durante o comando ALTER TABLE, examinando a tabela inteira, a menos que seja especificado NOT VALID; entretanto, se existir uma restrição CHECK válida (e ela não for removida no mesmo comando) que prove que nenhum valor NULL possa existir, a varredura da tabela poderá ser ignorada. Se uma coluna tiver uma restrição de não-nulo inválida, SET NOT NULL a validará.

Se esta tabela for uma partição, não se pode executar DROP NOT NULL em uma coluna se ela estiver definida como NOT NULL na tabela mãe. Para remover a restrição NOT NULL de todas as partições, deve ser executado DROP NOT NULL na tabela mãe. Mesmo não havendo nenhuma restrição NOT NULL na tabela mãe, esta restrição ainda assim pode ser adicionada a partições individuais, se desejado; ou seja, as tabelas filhas podem proibir valores nulos, mesmo que a tabela mãe os permita, mas não o contrário. Também é possível remover a restrição NOT NULL apenas na tabela mãe, o que não a remove das tabelas filhas.

Esta forma substitui a expressão de uma coluna gerada. Os dados existentes em uma coluna gerada e armazenada são reescritos e todas as alterações futuras aplicarão a nova expressão de geração.

Quando esta forma é usada em uma coluna gerada e armazenada, suas estatísticas são removidas; portanto, recomenda-se executar posteriormente o comando ANALYZE na tabela. Para uma coluna virtual gerada, o comando ANALYZE não é necessário, porque estas colunas nunca possuem estatísticas.

Esta forma transforma uma coluna gerada armazenada em uma coluna base normal. Os dados existentes nas colunas são mantidos, mas as alterações futuras não vão mais aplicar a expressão de geração.

Esta forma é atualmente compatível apenas com colunas geradas e armazenadas (não com colunas virtuais).

Se for especificado DROP EXPRESSION IF EXISTS e se a coluna não for uma coluna gerada, nenhum erro será relatado. Neste caso, é emitida uma notificação.

Estas formas alteram se a coluna é uma coluna de identidade, ou alteram o atributo de geração de uma coluna de identidade existente. Veja CREATE TABLE para obter detalhes. Como SET DEFAULT, estas formas afetam apenas o comportamento dos comandos INSERT e UPDATE posteriores; não causam alterações nas linhas já existentes na tabela.

Se for especificado DROP IDENTITY IF EXISTS e se a coluna não for uma coluna de identidade, nenhum erro será relatado. Neste caso, é emitida uma notificação.

Estas formas alteram a sequência subjacente a uma coluna de identidade existente. A opção_de_sequência é uma opção com suporte pelo comando ALTER SEQUENCE, tal como INCREMENT BY.

Esta forma define o quantitativo da coleta de estatísticas por coluna para as operações ANALYZE posteriores. O alvo pode ser definido no intervalo de 0 a 10000. Defina como DEFAULT para voltar a usar o alvo de estatísticas padrão do sistema. (Atribuir o valor -1 é uma forma obsoleta de obter o mesmo resultado.) Para obter mais informações sobre o uso de estatísticas pelo planejador de consultas do PostgreSQL veja Estatísticas usadas pelo planejador.

SET STATISTICS adquire um bloqueio SHARE UPDATE EXCLUSIVE.

Esta forma define ou redefine as opções por atributo. Atualmente, as únicas opções definidas por atributo são n_distinct e n_distinct_inherited, que sobrescrevem as estimativas do número de valores distintos feitas por operações posteriores do comando ANALYZE. n_distinct afeta as estatísticas da própria tabela, enquanto n_distinct_inherited afeta as estatísticas coletadas para a tabela mais suas filhas de herança, e para as estatísticas coletadas para tabelas particionadas. Quando o valor especificado for positivo, o planejador de consultas irá assumir que a coluna contém exatamente o número especificado de valores distintos não nulos. Também podem ser especificados valores fracionários usando valores menores que 0 e maiores ou iguais a -1. Isto instrui o planejador de consultas a estimar o número de valores distintos multiplicando o valor absoluto do número especificado pelo número estimado de linhas na tabela. Por exemplo, um valor de -1 implica que todos os valores na coluna são distintos, enquanto um valor de -0,5 implica que cada valor aparece duas vezes em média. Isto pode ser útil quando o tamanho da tabela muda ao longo do tempo. Para obter mais informações sobre o uso de estatísticas pelo planejador de consultas do PostgreSQL, veja Estatísticas usadas pelo planejador.

A alteração das opções por atributo adquire um bloqueio SHARE UPDATE EXCLUSIVE.

Esta forma define o modo de armazenamento para uma coluna. Controla se esta coluna é mantida em linha ou em uma tabela TOAST secundária, e se os dados devem ser comprimidos ou não. PLAIN deve ser usado para valores de comprimento fixo, tal como integer, e é mantido em linha, sem compressão. MAIN é para dados em linha e comprimíveis. EXTERNAL é para dados externos e não comprimidos, e EXTENDED é para dados externos e comprimidos. Escrever DEFAULT define o modo de armazenamento para o modo padrão do tipo de dados da coluna. EXTENDED é o padrão para a maioria dos tipos de dados que suportam armazenamento não-PLAIN. O uso de EXTERNAL fará com que as operações de sub-cadeias de caracteres em valores muito grandes dos tipos de dados text e bytea sejam executadas mais rapidamente. Note que ALTER TABLE ... SET STORAGE não muda nada na tabela; apenas define a estratégia a ser perseguida durante as futuras atualizações da tabela. Veja TOAST para obter mais informações.

Esta forma define o método de compressão para a coluna, determinando como os valores inseridos no futuro serão comprimidos (se o modo de armazenamento permitir compressão). Não faz com que a tabela seja reescrita, portanto, os dados existentes ainda podem estar comprimidos com outros métodos de compressão. Se a tabela for recuperada usando pg_restore, então todos os valores serão reescritos com o método de compressão configurado. Entretanto, quando os dados são inseridos a partir de outra relação (por exemplo, por INSERT ... SELECT), os valores da tabela de origem não são necessariamente expandidos, portanto, quaisquer dados comprimidos anteriormente podem manter seu método de compressão existente, em vez de serem comprimidos novamente com o método de compressão da coluna de destino. Os métodos de compressão com suporte são pglz e lz4. (lz4 está disponível apenas se foi usada a opção --with-lz4 ao construir o PostgreSQL.) Além desses, o método_de_compressão pode ser default, que seleciona o comportamento padrão de consultar a configuração default_toast_compression no momento da inserção de dados, para determinar o método a ser usado.

Esta forma adiciona uma nova restrição à tabela usando a mesma sintaxe de restrição de CREATE TABLE, mais a opção NOT VALID, que é atualmente permitida apenas para chaves estrangeiras e restrições de não-nulo.

Normalmente, esta forma faz uma verificação da tabela para verificar se todas as linhas existentes atendem à nova restrição. Mas se for usada a opção NOT VALID, esta verificação potencialmente demorada será ignorada. A restrição ainda assim será aplicada em inserções ou atualizações posteriores (ou seja, vão falhar a menos que haja uma linha correspondente na tabela referenciada, no caso de chaves estrangeiras, ou a menos que a nova linha corresponda à condição verificação especificada). Mas o banco de dados não vai assumir que a restrição vale para todas as linhas da tabela, até que seja validada usando a opção VALIDATE CONSTRAINT. Veja Notes abaixo para obter mais informações sobre como usar a opção NOT VALID.

Embora a maioria das formas de ADD restrição_de_tabela requeira um bloqueio ACCESS EXCLUSIVE, ADD FOREIGN KEY requer apenas um bloqueio SHARE ROW EXCLUSIVE. Note que ADD FOREIGN KEY também adquire um bloqueio SHARE ROW EXCLUSIVE na tabela referenciada, além do bloqueio na tabela onde a restrição é declarada.

Condições suplementares são aplicadas quando são adicionadas restrições de unicidade, ou de chave primária, a tabelas particionadas; veja CREATE TABLE.

Esta forma adiciona uma nova restrição PRIMARY KEY ou UNIQUE a uma tabela, baseada em um índice de unicidade existente. Todas as colunas do índice são incluídas na restrição.

O índice não pode ter colunas de expressão nem ser um índice parcial e, além disso, deve ser um índice de Árvore-B com ordem de classificação padrão. Estas restrições garantem que o índice seja equivalente ao que seria construído por um comando ADD PRIMARY KEY ou ADD UNIQUE regular.

Se for especificado PRIMARY KEY, e as colunas do índice não estiverem definidas como NOT NULL, então este comando tentará executar ALTER COLUMN SET NOT NULL em todas estas colunas. Isto requer a varredura de toda a tabela para verificar se as colunas não contêm nulos. Em todos os outros casos, esta é uma operação rápida.

Se for fornecido um nome de restrição, o índice será renomeado para corresponder ao nome da restrição. Caso contrário, a restrição terá o mesmo nome do índice.

Após este comando ser executado, o índice passará a pertencer à restrição, da mesma maneira que se o índice tivesse sido construído por um comando ADD PRIMARY KEY ou ADD UNIQUE regular. Em particular, excluir a restrição fará com que o índice também desapareça.

No momento, esta forma não tem suporte em tabelas particionadas.

Esta forma altera os atributos de uma restrição criada anteriormente. No momento, apenas as restrições de chave estrangeira podem ser alteradas desta maneira, mas veja abaixo.

Estas formas modificam uma restrição herdável, de modo que ela deixe de ser herdável, ou vice-versa. Atualmente, apenas as restrições de não nulo podem ser alteradas desta forma. Além de alterar a herdabilidade da restrição, no caso de uma restrição não herdável ser marcada como herdável, se a tabela tiver tabelas filhas, uma restrição equivalente será adicionada a elas. Se uma restrição herdável for marcada como não herdável em uma tabela com filhas, a restrição correspondente nas filhas será marcada como não herdável, mas não será removida.

Esta forma valida uma restrição de chave estrangeira, de verificação ou de não-nulo que foi previamente criada como NOT VALID, varrendo a tabela para garantir que não haja linhas para as quais a restrição não seja satisfeita. Se a restrição foi definida como NOT ENFORCED, será lançado um erro. Nada acontecerá se a restrição já estiver marcada como válida. (Veja Notes abaixo, para obter uma explicação da utilidade deste comando.)

Este comando adquire um bloqueio SHARE UPDATE EXCLUSIVE.

Esta forma exclui da tabela a restrição especificada, e também qualquer índice subjacente à restrição. Se for especificado IF EXISTS, e a restrição não existir, não será relatado nenhum erro. É emitido um aviso neste caso.

Estas formas configuram o disparo do(s) gatilhos(s) pertencente(s) à tabela. Um gatilho desativado ainda é reconhecido pelo sistema, mas não é executado quando o evento que o aciona ocorre. (Para um gatilho postergado, o status de ativo é verificado quando o evento ocorre, e não quando a função do gatilho é efetivamente executada.) É possível desativar ou ativar um único gatilho especificado pelo seu nome, todos os gatilhos da tabela ou apenas os gatilhos do usuário (esta opção exclui os gatilhos de restrição gerados internamente, como aqueles usados ​​para implementar restrições de chave estrangeira ou restrições de unicidade e exclusão postergáveis). Desativar ou ativar gatilhos de restrição gerados internamente requer privilégios de superusuário; isto deve ser feito com cautela, porque, obviamente, a integridade da restrição não poderá ser garantida se os gatilhos não forem executados.

O mecanismo de disparo do gatilho também é afetado pela variável de configuração session_replication_role. Gatilhos simplesmente ativados (o padrão) serão acionados quando a função de replicação for “origem” (o padrão) ou “local”. Os gatilhos configurados como ENABLE REPLICA só serão disparados se a sessão estiver no modo “replica”, e os gatilhos configurados como ENABLE ALWAYS serão disparados independentemente da função de replicação corrente.

O efeito deste mecanismo é que, na configuração padrão, os gatilhos não são disparados nas réplicas. Isto é útil, porque se um gatilho for usado na origem para propagar dados entre tabelas, o sistema de replicação também replicará os dados propagados; então o gatilho não deve disparar uma segunda vez na réplica, porque isto levaria à duplicação. Entretanto, se o gatilho for usado para outra finalidade, tal como criar alertas externos, pode ser apropriado configurá-lo como ENABLE ALWAYS, para que também seja disparado nas réplicas.

Quando este comando é aplicado a uma tabela particionada, os estados dos gatilhos de clonagem correspondentes nas partições também são atualizados, a menos que seja especificado ONLY.

Este comando adquire um bloqueio SHARE ROW EXCLUSIVE.

Estas formas configuram o disparo de regras de reescrita pertencentes à tabela. Uma regra desativada ainda é reconhecida pelo sistema, mas não é aplicada durante a reescrita da consulta. A semântica é como para gatilhos desativados/ativados. Esta configuração é ignorada para as regras ON SELECT, que são sempre aplicadas para manter as visões funcionando, mesmo se a sessão corrente estiver em uma função de replicação não padrão.

O mecanismo de disparo da regra também é afetado pela variável de configuração session_replication_role, semelhante aos gatilhos descritos acima.

Estas formas controlam a aplicação de políticas de segurança de linha pertencentes à tabela. Se ativado, e não existir nenhuma política para a tabela, a política de negação padrão será aplicada. Note que podem existir políticas para uma tabela, mesmo se a segurança no nível de linha estiver desativada. Neste caso, as políticas não serão aplicadas, sendo ignoradas. Veja também CREATE POLICY.

Estas formas controlam a aplicação de políticas de segurança de linha pertencentes à tabela, quando o usuário é o dono da tabela. Se ativado, as políticas de segurança no nível de linha serão aplicadas quando o usuário for o dono da tabela. Se desativado (o padrão), a segurança no nível de linha não será aplicada quando o usuário for o dono da tabela. Veja também CREATE POLICY.

Esta forma seleciona o índice padrão para futuras operações de CLUSTER. Na verdade, não reorganiza a tabela.

Mudar as opções de reorganização adquire um bloqueio SHARE UPDATE EXCLUSIVE.

Esta forma remove da tabela a especificação de índice de CLUSTER usada mais recentemente. Afeta futuras operações de reorganização que não especificam índice.

Mudar as opções de reorganização adquire um bloqueio SHARE UPDATE EXCLUSIVE na tabela.

Sintaxe compatível com versões anteriores para remover a coluna do sistema oid. Como as colunas do sistema oid não podem mais ser adicionadas, nunca terá efeito.

Esta forma altera o método de acesso da tabela, reescrevendo-a usando o método de acesso indicado; especificar DEFAULT seleciona o método de acesso definido pelo parâmetro de configuração default_table_access_method. Veja Definição da interface do método de acesso à tabela para obter mais informações.

Quando aplicado a uma tabela particionada, não há dados para reescrever, mas as partições criadas posteriormente usarão por padrão o método de acesso especificado, a menos que seja substituído por uma cláusula USING. Especificar DEFAULT remove o valor anterior, fazendo com que as partições futuras tenham como valor padrão default_table_access_method.

Esta forma altera o espaço de tabelas da tabela, para o espaço de tabelas especificado, e move o(s) arquivo(s) de dados associado(s) à tabela para o novo espaço de tabelas. Os índices na tabela, se houver, não são movidos; mas podem ser movidos separadamente com comandos SET TABLESPACE adicionais. Quando aplicado a uma tabela particionada, nada é movido, mas quaisquer partições criadas posteriormente usando CREATE TABLE PARTITION OF usará este espaço de tabelas, a menos que seja substituído por uma cláusula TABLESPACE.

Todas as tabelas em um espaço de tabelas do banco de dados corrente podem ser movidas usando a forma ALL IN TABLESPACE, que primeiro bloqueia todas as tabelas a serem movidas, e depois move cada uma delas. Esta forma também oferece suporte a OWNED BY, que move apenas as tabelas pertencentes às funções de banco de dados (roles) especificadas. Se for especificada a opção NOWAIT, o comando falhará se não conseguir obter todos os bloqueios necessários imediatamente. Note que os catálogos do sistema não são movidos por este comando; deve ser usado ALTER DATABASE, ou chamadas explícitas de ALTER TABLE se desejado. As relações do information_schema não são consideradas parte dos catálogos do sistema, e serão movidas. Veja também CREATE TABLESPACE.

Esta forma altera a tabela de “com registro de transações” (LOGGED) para “sem registro de transações” (UNLOGGED), e vice-versa (veja UNLOGGED e Unlogged). Não se aplica a tabelas temporárias.

Isto também altera a persistência de quaisquer sequências vinculadas à tabela (para colunas de identidade ou seriais). Entretanto, também é possível alterar a persistência destas sequências separadamente.

Esta forma não dá suporte para tabelas particionadas.

Esta forma altera um ou mais parâmetros de armazenamento da tabela. Veja Parâmetros de armazenamento na documentação de CREATE TABLE para obter detalhes sobre os parâmetros disponíveis. Note que o conteúdo da tabela não será modificado imediatamente por este comando; dependendo do parâmetro, pode ser necessário reescrever a tabela para obter os efeitos desejados. Isto pode ser feito usando VACUUM (FULL), CLUSTER, ou uma das formas de ALTER TABLE que força a reescrita da tabela. Para parâmetros relacionados ao planejador, as alterações entrarão em vigor na próxima vez que a tabela for bloqueada, portanto, as consultas em execução no momento não serão afetadas.

Será adquirido o bloqueio SHARE UPDATE EXCLUSIVE para os parâmetros de armazenamento fillfactor, toast e autovacuum, bem como para o parâmetro do planejador parallel_workers.

Esta forma redefine um ou mais parâmetros de armazenamento para seus valores padrão. Como acontece com SET, pode ser necessária a reescrita da tabela para atualizá-la completamente.

Esta forma adiciona a tabela como nova filha da tabela mãe especificada. Em seguida, as consultas à tabela mãe incluirão os registros dessa tabela. Para ser adicionada como filha, a tabela já deve conter todas as mesmas colunas que a tabela mãe (pode ter colunas adicionais também). As colunas devem ter tipos de dados correspondentes

Além disso, todas as restrições CHECK e NOT NULL na tabela mãe também devem existir na tabela filha, exceto aquelas marcadas como não herdáveis ​​ (ou seja, criadas com ALTER TABLE ... ADD CONSTRAINT ... NO INHERIT), que são ignoradas. Todas as restrições de tabelas filhas que corresponderem não devem estar marcadas como não herdáveis. No momento, as restrições UNIQUE, PRIMARY KEY e FOREIGN KEY não são consideradas, mas isto poderá mudar no futuro.

Esta forma remove a tabela da lista de filhas da tabela mãe especificada. As consultas na tabela mãe não incluirão mais os registros extraídos dessa tabela.

Esta forma liga a tabela a um tipo composto como se tivesse sido criada por CREATE TABLE OF. A lista de nomes e tipos de dados das colunas da tabela deve corresponder precisamente à do tipo composto. A tabela não deve herdar de nenhuma outra tabela. Estas restrições garantem que CREATE TABLE OF permitiria uma definição de tabela equivalente.

Esta forma dissocia uma tabela tipada de seu tipo.

Esta forma altera o dono da tabela, sequência, visão, visão materializada, ou tabela estrangeira, para o usuário especificado.

Esta forma altera as informações escritas no registro de transações para identificar as linhas atualizadas ou excluídas. Geralmente, o valor antigo de cada coluna só é registrado se for diferente do novo valor; entretanto, se o valor antigo for armazenado externamente, este sempre será registrado, independentemente de ter sido alterado ou não. Esta opção não tem efeito, exceto quando está em uso a replicação lógica.

A forma RENAME altera o nome da tabela (ou índice, sequência, visão, visão materializada, ou tabela estrangeira), o nome de uma coluna individual na tabela, ou o nome de uma restrição da tabela. Ao renomear uma restrição que possui um índice subjacente, o índice também é renomeado. Não há efeito sobre os dados armazenados.

Esta forma move a tabela para outro esquema. Os índices associados, restrições e sequências pertencentes às colunas da tabela também são movidos.

Esta forma anexa uma tabela existente (que pode ser particionada) como partição da tabela e destino. A tabela pode ser anexada como uma partição para valores específicos usando FOR VALUES, ou como uma partição padrão usando DEFAULT. Para cada índice da tabela de destino, será criado um índice correspondente na tabela anexada; ou, se já existir um índice equivalente, este será anexado ao índice da tabela de destino, como tivesse sido executado ALTER INDEX ATTACH PARTITION. Note que se a tabela existente for uma tabela externa, atualmente não é permitido anexar a tabela como uma partição da tabela de destino se houver índices UNIQUE na tabela de destino. (Veja também CREATE FOREIGN TABLE.) Para cada gatilho no nível de linha definido pelo usuário existente na tabela de destino, é criado um gatilho correspondente na tabela anexada.

Uma partição que usa FOR VALUES usa a mesma sintaxe para especificação_de_limite_de_partição que o comando CREATE TABLE. A especificação de limite de partição deve corresponder à estratégia de particionamento e à chave de partição da tabela alvo. A tabela a ser anexada deve ter exatamente as mesmas colunas que a tabela de alvo, sem nenhuma outra; além disso, os tipos de dados das colunas também devem ser iguais. Além disso, deve conter todas as restrições NOT NULL e CHECK da tabela alvo, e não estar marcada como NO INHERIT. No momento, as restrições FOREIGN KEY não são consideradas. As restrições UNIQUE e PRIMARY KEY da tabela mãe serão criadas na partição, caso ainda não existam.

Se a nova partição for uma tabela regular, uma varredura completa da tabela será executada para verificar se as linhas existentes na tabela não violam a restrição de partição. É possível evitar esta verificação adicionando uma restrição CHECK válida à tabela, aceitando apenas as linhas que satisfaçam a restrição de partição desejada, antes de executar este comando. A restrição CHECK será usada para determinar que a tabela não precisa ser varrida para validar a restrição de partição. Entretanto, isto não irá funcionar se qualquer uma das chaves de partição for uma expressão, e a partição não aceitar valores NULL. Se for anexada uma partição de lista que não aceita valores NULL, deverá ser adicionada também a restrição NOT NULL à coluna de chave de partição, a menos que seja uma expressão.

Se a nova partição for uma tabela estrangeira, nada será feito para verificar se todas as linhas na tabela estrangeira obedecem à restrição de partição. (Veja a discussão sobre restrições em tabela estrangeira em CREATE FOREIGN TABLE.)

Quando a tabela tem uma partição padrão, a definição de uma nova partição altera a restrição de partição para a partição padrão. A partição padrão não pode conter nenhuma linha que precise ser movida para a nova partição, e será varrida para verificar se nenhuma está presente. Esta varredura, como a varredura da nova partição, pode ser evitada se estiver presente uma restrição CHECK apropriada. Assim como a varredura da nova partição, ela será sempre ignorada quando a partição padrão for uma tabela estrangeira.

Anexar uma partição adquire um bloqueio SHARE UPDATE EXCLUSIVE na tabela mãe, além dos bloqueios ACCESS EXCLUSIVE na tabela que está sendo anexada e na partição padrão (se houver).

Também deverão ser mantidos bloqueios adicionais em todas as subpartições, se a tabela que está sendo anexada for uma tabela particionada. Igualmente, se a própria partição padrão for uma tabela particionada. O bloqueio das subpartições pode ser evitado adicionando uma restrição CHECK, conforme descrito na Manutenção de partição.

Esta forma desanexa a partição especificada da tabela de destino. A partição desanexada continua a existir como uma tabela autônoma, mas não tem mais nenhum vínculo com a tabela da qual foi desanexada. Quaisquer índices que foram anexados aos índices da tabela de destino são desanexados. Quaisquer gatilhos que foram criados como clones daqueles na tabela de destino são removidos. É obtido o bloqueio SHARE em quaisquer tabelas que façam referência a esta tabela particionada em restrições de chave estrangeira.

Se for especificado CONCURRENTLY, será executado usando um nível de bloqueio reduzido para evitar o bloqueio de outras sessões que possam estar acessando a tabela particionada. Neste modo, são usadas internamente duas transações. Durante a primeira transação, é obtido um bloqueio SHARE UPDATE EXCLUSIVE na tabela-mãe e na partição, e a partição é marcada como sendo desanexada; neste ponto, a transação é efetivada, e aguardado que todas as outras transações que usam a tabela particionada terminem. Após a conclusão de todas estas transações, a segunda transação adquire um bloqueio SHARE UPDATE EXCLUSIVE na tabela particionada, e ACCESS EXCLUSIVE na partição, e o processo de desanexação é concluído. É incluída na partição uma restrição CHECK que duplica a restrição de partição. CONCURRENTLY não pode ser executado em um bloco de transação, e não é permitido se a tabela particionada tiver uma partição padrão.

Se for especificado FINALIZE, uma chamada a DETACH CONCURRENTLY anterior que foi cancelada ou interrompida é completada. Pode estar pendente de desanexação no máximo uma partição de uma tabela particionada por vez.

Não será relatado nenhum erro se a tabela não existir. É emitido um aviso neste caso.

O nome (opcionalmente qualificado pelo esquema) da tabela existente a ser alterada. Se for especificado ONLY antes do nome da tabela, somente esta tabela será alterada. Se não for especificado ONLY, a tabela e todas as suas tabelas descendentes (se houver) serão alteradas. Opcionalmente, pode ser especificado um * após o nome da tabela para indicar explicitamente que as tabelas descendentes estão incluídas.

O nome da coluna nova ou existente.

O novo nome para a coluna existente.

O novo nome para a tabela.

O tipo de dados da nova coluna, ou o novo tipo de dados para a coluna existente.

A nova restrição de tabela para a tabela.

O nome da restrição nova ou existente.

Exclui automaticamente os objetos que dependem da coluna ou restrição sendo excluída (por exemplo, visões que fazem referência à coluna) e, por sua vez, todos os objetos que dependem desses objetos (veja Acompanhamento de dependência).

Recusa remover a coluna ou restrição se houver algum objeto dependente. Este é o comportamento padrão.

O nome de um único gatilho para desativar ou ativar.

Desativa ou ativa todos os gatilhos pertencentes à tabela. (Requer privilégio de superusuário, se algum dos gatilhos for gatilho de restrição gerado internamente, como os que são usados para implementar restrições de chave estrangeira ou de unicidade postergável, e restrições de exclusão.)

Desativa ou ativa todos os gatilhos pertencentes à tabela, exceto os gatilhos de restrição gerados internamente, como aqueles usados para implementar restrições de chave estrangeira ou de unicidade postergável, e restrições de exclusão.

O nome de um índice existente.

O nome de um parâmetro de armazenamento da tabela.

O novo valor para o parâmetro de armazenamento da tabela. Pode ser um número ou uma palavra, dependendo do parâmetro.

A tabela mãe para associar ou desassociar a esta tabela.

O nome de usuário do novo dono da tabela.

O nome do método de acesso para o qual a tabela será convertida.

O nome do espaço de tabelas para o qual a tabela será movida.

O nome do esquema para o qual a tabela será movida.

O nome da tabela a ser anexada como uma nova partição, ou desanexada dessa tabela.

Especificação dos limites da partição para a nova partição. Consulte CREATE TABLE para obter mais detalhes sobre esta sintaxe.