Table Assets - Elementary

Table assets represent tables or views in your data warehouse. Register table assets to track metadata, ownership, and descriptions in Elementary Cloud.

TableAsset Object

from elementary_python_sdk import TableAsset

asset = TableAsset(
    name="string",                  # Required: Table name
    database_name="string",         # Required: Database name
    schema_name="string",           # Required: Schema name
    table_name="string",            # Required: Table name
    description="string",           # Optional: Table description
    owners=["string"],              # Optional: List of owners (emails or usernames)
    tags=["string"],               # Optional: List of tags
    depends_on=["string"]           # Optional: List of upstream fully qualified table names
)

Required Fields

Field	Type	Description
`name`	string	Display name for the table
`database_name`	string	Name of the database containing the table
`schema_name`	string	Name of the schema containing the table
`table_name`	string	Name of the table

Optional Fields

Field	Type	Description
`description`	string	Human-readable description of the table
`owners`	list[string]	List of owners (email addresses or usernames)
`tags`	list[string]	List of tags for categorization
`depends_on`	list[string]	List of upstream fully qualified table names (e.g., `["prod.public.customers", "prod.public.orders"]`) for lineage tracking

Example

from elementary_python_sdk import TableAsset

# Create a table asset
asset = TableAsset(
    name="users",
    database_name="prod",
    schema_name="public",
    table_name="users",
    description="Users table",
    owners=["data-team"],
    tags=["pii", "production"],
    depends_on=["prod.public.customers", "prod.public.orders"]
)

Best Practices

Include descriptions - Add meaningful descriptions to help your team understand what each table contains
Set owners - Assign owners to tables so they receive alerts and notifications
Use tags - Tag tables to enable filtering and grouping in the Elementary UI
Define dependencies - Use depends_on to establish lineage connections to upstream assets
Update regularly - Send updated table assets when metadata changes (descriptions, owners, tags, dependencies)

Table assets are updated on each ingest, so include all current metadata in every request.

Test Decorators - Define tests for your table assets
API Reference - Overview of the SDK API

​TableAsset Object

​Required Fields

​Optional Fields

​Example

​Best Practices

​Related Documentation

TableAsset Object

Required Fields

Optional Fields

Example

Best Practices

Related Documentation