ALTER TABLESPACE

ALTER TABLESPACE — modifica a definição de um espaço de tabelas

Sinopse

ALTER TABLESPACE nome_do_espaço_de_tabelas​
    RENAME TO novo_nome
ALTER TABLESPACE nome_do_espaço_de_tabelas​
    OWNER TO {
        novo_dono
      | CURRENT_ROLE
      | CURRENT_USER
      | SESSION_USER
    }
ALTER TABLESPACE nome_do_espaço_de_tabelas​
    SET ( opção_de_espaço_de_tabelas = valor [, ... ] )
ALTER TABLESPACE nome_do_espaço_de_tabelas​
    RESET ( opção_de_espaço_de_tabelas [, ... ] )

Descrição

O comando ALTER TABLESPACE altera a definição de um espaço de tabelas.

É necessário ser o dono do espaço de tabelas para alterar a definição do espaço de tabelas. Para alterar o dono, é necessário ser capaz de executar o comando SET ROLE para a função de banco de dados (role) que será a nova dona. (Note que os superusuários têm estes privilégios automaticamente.)

Parâmetros

nome_do_espaço_de_tabelas

O nome de um espaço de tabelas existente.

novo_nome

O novo nome do espaço de tabelas. O novo nome não pode começar com pg_, porque estes nomes são reservados para os espaços de tabelas do sistema.

novo_dono

O novo dono do espaço de tabelas.

opção_de_espaço_de_tabelas

Um parâmetro de espaço de tabelas a ser definido ou redefinido. No momento, os únicos parâmetros disponíveis são seq_page_cost, random_page_cost, effective_io_concurrency, e maintenance_io_concurrency. Definir estes valores para um espaço de tabelas específico substitui a estimativa usual do planejador do custo de leitura de páginas de tabelas neste espaço de tabelas, e quantas operações de entrada/saída concorrentes são emitidas, conforme estabelecido pelos parâmetros de configuração de mesmo nome (veja seq_page_cost, random_page_cost, effective_io_concurrency, maintenance_io_concurrency). Pode ser útil se o espaço de tabelas estiver localizado em um disco mais rápido, ou mais lento, que o restante do subsistema de E/S.

Exemplos

Mudar o nome do espaço de tabelas index_space para fast_raid:

ALTER TABLESPACE index_space RENAME TO fast_raid;

Alterar o dono do espaço de tabelas index_space:

ALTER TABLESPACE index_space OWNER TO mary;

Conformidade

Não existe o comando ALTER TABLESPACE no padrão SQL.

Veja também

CREATE TABLESPACE, DROP TABLESPACE