Key concepts

There are a few interconnected concepts within tap:

Files

Files are the source for data. They can be uploaded individually or as part of folders.

tap currently supports the following file formats:

• CSV
• JSONL
• Parquet
• XLSX
• ODS

Data

Data represents files that form a single dataset with a consistent schema. They are used by models and will ultimately be exposed via APIs.

Models

Models are SQL SELECT queries that allow cleaning, enriching and joining data and other models before publishing APIs.

See the SQL reference for supported functions and syntax.

APIs

APIs are optimised copies of models that can be hosted on domains. This is where you configure the API filters that determine the valid query parameters and access patterns to your data.

Domains

Domains host APIs. Access to a domain is controlled by API keys.

Each tenent comes with a unique subdomain, but get in touch if you'd like to bring your own.

API Keys

API keys grant to access the domains. They form ausername:password key pair that allows you to control access and track usage of your APIs.

Storage

Storage represents the location of your files. They are also where optimised copies (materialisations) of your data and APIs

Each tenant comes with dedicated, isolated storage, but get in touch if you'd like to bring your own. This will ensure your data is never stored at rest in tap infrastructure.