SHOW COLUMNS

Returns the list of columns in a table. If the table does not exist, an exception is thrown.

Syntax

SHOW COLUMNS { IN | FROM } table_identifier [ database ]

Note

Keywords IN and FROM are interchangeable.

Parameters

  • table_identifier

    • [database_name.] table_name: A table name, optionally qualified with a database name.
    • delta.`<path-to-table>` : The location of an existing Delta table.
  • database

    An optional database name. The table is resolved from this database when it is specified. When this parameter is specified then table name should not be qualified with a different database name.

    Syntax: { IN | FROM } database_name

    Note

    Keywords IN and FROM are interchangeable.

Examples

-- Create `customer` table in `salesdb` database;
USE salesdb;
CREATE TABLE customer(
    cust_cd INT,
    name VARCHAR(100),
    cust_addr STRING);

-- List the columns of `customer` table in current database.
SHOW COLUMNS IN customer;
+---------+
| col_name|
+---------+
|  cust_cd|
|     name|
|cust_addr|
+---------+

-- List the columns of `customer` table in `salesdb` database.
SHOW COLUMNS IN salesdb.customer;
+---------+
| col_name|
+---------+
|  cust_cd|
|     name|
|cust_addr|
+---------+

-- List the columns of `customer` table in `salesdb` database
SHOW COLUMNS IN customer IN salesdb;
+---------+
| col_name|
+---------+
|  cust_cd|
|     name|
|cust_addr|
+---------+