SHOW COLUMNS

Mostra uma lista de colunas em uma tabela, bem como alguns atributos da coluna.

Cada linha de saída é composta dos seguintes elementos: lista separada por vírgula do nome do banco de dados, nome do esquema, nome da tabela, nome da coluna, posição ordinal, padrão da coluna, se anulável, tipo de dados, extensão máxima de caracteres, precisão numérica e comentários. Para obter mais informações sobre esses atributos, consulte SVV_ALL_COLUMNS.

Se mais de 10.000 colunas resultarem do comando SHOW COLUMNS, será retornado um erro.

Sintaxe

SHOW COLUMNS FROM TABLE database_name.schema_name.table_name [LIKE 'filter_pattern'] [LIMIT row_limit ]

Parâmetros

database_name

O nome do banco de dados que contém as tabelas a serem listadas.

Para mostrar tabelas em um AWS Glue Data Catalog, especifique (awsdatacatalog) como o nome do banco de dados e assegure que a configuração do sistema data_catalog_auto_mount esteja definida como true. Para ter mais informações, consulte ALTER SYSTEM.

schema_name

O nome do esquema que contém as tabelas a serem listadas.

Para mostrar tabelas do AWS Glue Data Catalog, forneça o nome do banco de dados do AWS Glue como nome do esquema.

table_name

O nome da tabela que contém as colunas a listar.

filter_pattern

Uma expressão de caractere UTF-8 válida com o padrão para estabelecer correspondência com os nomes da tabela. A opção LIKE executa uma correspondência com distinção entre letras maiúsculas e minúsculas compatível com os seguintes metacaracteres de correspondência de padrões:

Metacaractere	Descrição
%	Corresponde a qualquer sequência de zero ou mais caracteres.
_	Corresponde a qualquer caractere único.

Se filter_pattern não contiver metacaracteres, o padrão representará somente a própria string. Nesse caso, LIKE age da mesma forma que o operador de igualdade.

row_limit

O número máximo de linhas a serem retornadas. O row_limit pode ser de 0 a 10.000.

Exemplos

O exemplo a seguir mostra as colunas no banco de dados do Amazon Redshift chamado dev que estão no esquema public e na tabela tb.

SHOW COLUMNS FROM TABLE dev.public.tb;

 database_name | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | remarks 
---------------+-------------+------------+-------------+------------------+----------------+-------------+-----------+--------------------------+-------------------+---------
 dev           | public      | tb         | col         |                1 |                | YES         | integer   |                          |                32 |

O exemplo a seguir mostra as tabelas no banco de dados do AWS Glue Data Catalog chamado awsdatacatalog que estão no esquema batman e na tabela nation. A saída é limitada a 2 linhas.

SHOW COLUMNS FROM TABLE awsdatacatalog.batman.nation LIMIT 2;

 database_name  | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | remarks 
----------------+-------------+------------+-------------+------------------+----------------+-------------+-----------+--------------------------+-------------------+---------
 awsdatacatalog | batman      | nation     | n_nationkey |                1 |                |             | integer   |                          |                   | 
 awsdatacatalog | batman      | nation     | n_name      |                2 |                |             | character |                          |                   |