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.
Permissões obrigatórias
Para visualizar uma coluna em uma tabela do Amazon Redshift, o usuário atual deve atender a um dos seguintes critérios:
Ser um superusuário.
Ser o proprietário da tabela.
Ter recebido o privilégio USAGE no esquema principal e o privilégio SELECT na tabela ou ter recebido o privilégio SELECT na coluna.
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 sistemadata_catalog_auto_mountesteja definida comotrue. Para obter 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 sample_data_dev que estão no esquema tickit e na tabela event.
SHOW COLUMNS FROM TABLE sample_data_dev.tickit.event;
database_name | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | numeric_scale | remarks
-------------------+-------------+------------+-------------+------------------+----------------+-------------+------------------------------+--------------------------+-------------------+------------------------
sample_data_dev | tickit | event | eventid | 1 | NULL | NO | integer | NULL | 32 | 0 | NULL
sample_data_dev | tickit | event | eventid | 2 | NULL | NO | smallint | NULL | 16 | 0 | NULL
sample_data_dev | tickit | event | eventid | 3 | NULL | NO | smallint | NULL | 16 | 0 | NULL
sample_data_dev | tickit | event | eventid | 4 | NULL | NO | smallint | NULL | 16 | 0 | NULL
sample_data_dev | tickit | event | eventid | 5 | NULL | YES | character varying | 200 | NULL | NULL | NULL
sample_data_dev | tickit | event | eventid | 6 | NULL | YES | timestamp without time zo... | NULL | NULL | NULL | NULL
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 | | |
