Re: misleading ALTER TABLE SET STORAGE

From: Euler Taveira <euler(at)timbira(dot)com(dot)br>
To: vodevsh(at)gmail(dot)com, pgsql-docs(at)postgresql(dot)org
Subject: Re: misleading ALTER TABLE SET STORAGE
Date: 2016-11-10 14:46:34
Message-ID: 271e1212-5159-f939-ed9c-10573a538f69@timbira.com.br
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 08-11-2016 11:27, vodevsh(at)gmail(dot)com wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.6/static/storage-toast.html
> Description:
>
> Hi,
> Was reading
> https://www.postgresql.org/docs/current/static/storage-toast.html and the
> bit with &quot;...table column can be altered with ALTER TABLE SET STORAGE...&quot;
> appeared misleading to me. You don&#39;t set storage per table you set it per
> column, so &quot;ALTER TABLE ... ALTER COLUMN SET STORAGE&quot; would look more
> appropriate. I even checked
> https://www.postgresql.org/docs/9.6/static/sql-altertable.html where it
> looks quite clear &quot;ALTER [ COLUMN ] column_name SET STORAGE { PLAIN |
> EXTERNAL | EXTENDED | MAIN }&quot;...
> Anyway, with all respect to pg documentation and pg in general, I think this
> bit should look different.
>
AFAICS ALTER TABLE SET STORAGE means ALTER TABLE ... ALTER COLUMN SET
STORAGE. There is no ALTER TABLE SET STORAGE per table. It seems you are
confusing with ALTER TABLE SET (storage_parameter = value, ...).

Perhaps, we should use the complete command (ALTER TABLE tablename ALTER
COLUMN colname SET STORAGE storagetype) or link ALTER TABLE to avoid
confusion.

--
Euler Taveira Timbira - http://www.timbira.com.br/
PostgreSQL: Consultoria, Desenvolvimento, Suporte 24x7 e Treinamento

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2016-11-10 15:04:06 Re: misleading ALTER TABLE SET STORAGE
Previous Message Peter Eisentraut 2016-11-10 13:49:55 switching documentation build to XSLT