SHOW_COLUMNS - Amazon Redshift
Erforderliche BerechtigungenSyntaxParameterBeispiele

Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting.

SHOW_COLUMNS

Zeigt eine Liste der Spalten in einer Tabelle zusammen mit einigen Spaltenattributen an.

Jede Ausgabezeile besteht aus einer durch Kommas getrennten Liste mit Datenbanknamen, Schemanamen, Tabellennamen, Spaltennamen, Ordinalposition, Spaltenstandard, Nullwert, Datentyp, maximaler Zeichenlänge, numerischer Genauigkeit und Anmerkungen. Weitere Informationen zu diesen Attributen finden Sie unter SVV_ALL_COLUMNS.

Wenn der Befehl SHOW COLUMNS mehr als 10 000 Spalten ergeben würde, wird ein Fehler zurückgegeben.

Erforderliche Berechtigungen

Um eine Spalte in einer Amazon-Redshift-Tabelle anzuzeigen, müssen die aktuellen Benutzer eines der folgenden Kriterien erfüllen:

  • Sie müssen Superuser sein.

  • Sie müssen die Besitzer der Tabelle sein.

  • Ihnen müssen die Berechtigung USAGE für das übergeordnete Schema und die Berechtigung SELECT für die Tabelle oder die Berechtigung SELECT für die Spalte erteilt worden sein.

Syntax

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

Parameter

database_name

Der Name der Datenbanktabelle, welche die aufzulistenden Tabellen enthält.

Wenn Sie Tabellen in einem AWS Glue Data Catalog anzeigen möchten, geben Sie (awsdatacatalog) als Datenbankname an und stellen Sie sicher, dass die Systemkonfiguration data_catalog_auto_mount auf true eingestellt ist. Weitere Informationen finden Sie unter ALTER SYSTEM.

schema_name

Der Name des Schemas, das die aufzulistenden Tabellen enthält.

Wenn Sie Tabellen von AWS Glue Data Catalog anzeigen möchten, geben Sie den AWS Glue-Datenbanknamen als Schemaname an.

table_name

Der Name der Tabelle, welche die aufzulistenden Spalten enthält.

filter_pattern

Ein gültiger UTF-8-Zeichenfolgenausdruck mit einem Muster zum Abgleich der Tabellennamen. Die Option LIKE führt eine Suche durch, bei der zwischen Groß- und Kleinschreibung unterschieden wird und welche die folgenden Metazeichen für den Mustervergleich unterstützt:

Metazeichen Beschreibung
% Entspricht einer Folge von 0 oder mehr Zeichen.
_ Entspricht einem beliebigen Zeichen.

Wenn filter-pattern keine Metazeichen enthält, repräsentiert das Muster die Zeichenfolge selbst. In diesem Fall liefert LIKE dasselbe Ergebnis wie der Gleichheitsoperator.

row_limit

Die maximale Anzahl der zurückzugebenden Zeilen. Der Wert row_limit kann 0–10 000 betragen.

Beispiele

Das folgende Beispiel zeigt die Spalten in der Amazon-Redshift-Datenbank mit dem Namen sample_data_dev, die sich im Schema tickit und in der Tabelle event befinden.

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

Das folgende Beispiel zeigt die Spalten in der AWS Glue Data Catalog-Datenbank mit dem Namen awsdatacatalog, die sich im Schema batman und in der Tabelle nation befinden. Die Ausgabe ist auf 2 Zeilen begrenzt.

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 |                          |                   |