---
title: "table create"
slug: "table-create"
tags: ["5.4"]
updated: 2026-10-28T01:52:11Z
published: 2026-10-28T01:52:11Z
canonical: "docs.vastdata.com/table-create"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# table create

This command creates a VAST database table.

## Usage

```plaintext
table create --name TABLE
             --schema-name SCHEMA
             --arrow-schema COLUMNS
             --database-name DATABASE 
            [--tenant-id TENANT]   
            [--sorted-column-names SORT_COLUMNS]
```

## Required Parameters

| `--name TABLE` | Specifies the name for the table being created. The name must meet the requirements for S3 object names. |
| --- | --- |
| `--schema-name SCHEMA` | Speciies the name of the schema where the table is to be created. |
| `--arrow-schema COLUMNS` | Specifies the columns columns for the new table, as a comma-separated list. The columns are specified using the Arrow format, for example: `col1-int8,col2-string,col3-int8` > [!NOTE] > **Note** > > Complex data types are not supported on this command. To add a column with a complex data type, use VAST Web UI.Managing Table Columns |
| `--database-name DATABASE` | Specifies the name of the database where the table's schema is created. |

## Options

| `--tenant-id TENANT` | Specifies the ID of the tenant where the database resides If omitted, the default tenant is assumed. |
| --- | --- |
| `--sorted-column-names SORT_COLUMNS` | Specifies a comma-separated list of up to four columns, that are used to sort the table. Sorting is done according to the order of the names as they appear in the list. Example `--sorted-column-names col1,col2, col3, col4` |

## Example

This example shows adding a table named `cats` to schema `schema1` in database `vastdb`:

```plaintext
vcli: admin> table create --name cats --schema-name schema1 --arrow-schema name-string,age-int8 --database_name vastdb
```