vastdb.schema

VAST Database schema (a container of tables).

VAST S3 buckets can be used to create Database schemas and tables. It is possible to list and access VAST snapshots generated over a bucket.

class vastdb.schema.Schema(name: str, bucket: Bucket)

Bases: object

VAST Schema.

bucket: Bucket

create_schema(name: str, fail_if_exists=True) → Schema

Create a new schema (a container of tables) under this schema.

create_table(table_name: str, columns: pyarrow.Schema, fail_if_exists=True, use_external_row_ids_allocation=False) → Table

Create a new table under this schema.

A virtual vastdb_rowid column (of int64 type) can be created to access and filter by internal VAST row IDs. See https://support.vastdata.com/s/article/UUID-48d0a8cf-5786-5ef3-3fa3-9c64e63a0967 for more details.

drop() → None

Delete this schema.

name: str

rename(new_name) → None

Rename this schema.

schema(name: str, fail_if_missing=True) → Schema | None

Get a specific schema (a container of tables) under this schema.

schemas(batch_size=None) → Iterable[Schema]

List child schemas.

table(name: str, fail_if_missing=True) → Table | None

Get a specific table under this schema.

tablenames() → List[str]

List all table names under this schema.

tables(table_name: str = '') → List[Table]

List all tables under this schema if table_name is empty.

Otherwise, list only the specific table (if exists).

property tx

VAST transaction used for this schema.