---
title: "table create"
slug: "table-create"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
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]  
```

## Required Parameters

| `--name TABLE` | Enter a name for the table being created. The name must meet the requirements for S3 object names. |
| --- | --- |
| `--schema-name SCHEMA` | Enter the name of the schema where the table is to be created. |
| `--arrow-schema COLUMNS` | Enter a comma-separated list of columns for the new table. 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](/docs-5-3/docs/en/managing-table-columns#managing-table-columns-invast-web-ui) VAST Web UI. |
| `--database-name DATABASE` | Enter 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. |
| --- | --- |

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