Find Tables and Columns
Learn how to use the source-of-truth schema reference to find DataHawk tables, columns, grains, and field definitions.
The Exhaustive Column Referential is the source of truth for DataHawk schemas, tables, columns, data types, and field descriptions. This page shows you how to navigate that reference instead of relying on a static table catalog that can go stale.
Use the Google Sheet for the complete, current table and column list. Use this documentation for context, workflows, examples, and links to deeper dataset guides.
Open the schema reference
Start from the Exhaustive Column Referential. The Sheet is designed for filtering, sorting, and searching across schemas, tables, columns, data types, and descriptions.
Each row represents a field in a table. The most useful columns are usually:
- Schema: Top-level grouping such as
PRODUCT,FINANCE,ADVERTISING, orREPORTS - Table: Table name within that schema
- Column: Field name as it appears in Snowflake or BigQuery
- Description: What the field represents
- Data type: Expected format for the field
Start from the business question
Before searching, translate the question into a data domain.
| If your question is about... | Start with... |
|---|---|
| Advertising spend, campaigns, keywords, accounts | ADVERTISING |
| Orders, profit, fees, refunds, tax, P&L | FINANCE |
| Product listings, Buy Box, pricing, competitors, LQS | PRODUCT |
| Category-level sales estimates and top 100 products | MARKET |
| Seller/Vendor Central source reports, inventory, returns, replenishment | SELLING_PARTNER |
| Keyword rankings, sponsored ranks, search volume | SEO |
| Curated business-ready tables | REPORTS |
| Currency, marketplaces, tracked products, accounts, tags | REFERENTIAL |
If you are not sure where to start, use Source Systems & Freshness to map data types to source systems and schemas.
Filter by schema or table
Use the Sheet's built-in filters to narrow the rows:
- Filter Schema to the domain you identified.
- Filter or search Table if you already know part of the table name.
- Search Description for business terms such as
buy box,refund,inventory,campaign, orsearch volume.
Filtering first makes search results less noisy, especially for common words like sales, date, or brand.
Search by concept or column name
If you know the business concept but not the column name, search the descriptions. If you know part of the field name, search the Column field directly.
Useful examples:
| Search for | Likely result |
|---|---|
featured offer or buy box | Featured-offer and Buy Box fields in product tables |
trust | Sales estimate confidence fields |
deferred | Profit ledger timing and deferral fields |
currency | Marketplace and exchange-rate reference fields |
sponsored type | Advertising table dimensions |
Check the table grain
Before building a query or dashboard, confirm what one row represents. This is the most common source of mismatched numbers.
Look for clues in the table name, key columns, date fields, and descriptions:
- Product tables may be one row per ASIN, parent ASIN, product key, or snapshot date.
- Advertising tables may be account-level, campaign-level, keyword-level, or product-level.
- Finance tables may be event-level, order-level, ledger-level, or daily aggregation.
- Report tables may already join multiple schemas and hide lower-level grain.
When a page exists for the dataset family, use it to confirm grain and caveats. For example:
Sales Estimates Data
V7 sales estimate tables, grain, aliases, and key columns.
Product Data Reference
Product identifiers, parent/child joins, LQS, competitors, pricing, and offers.
SEO & Keyword Data
Keyword research, search volume, organic rank, and sponsored rank tables.
Check date and freshness fields
Tables may include several date-like fields. Pick the one that matches your analysis:
| Field pattern | Typical meaning |
|---|---|
DATE_DAY / OBSERVATION_DATE | Business date represented by the row |
OBSERVATION_TIME | Timestamp of a collected snapshot |
UPDATED_AT | When DataHawk last updated the row |
TIME_INTERVAL_START_DATE / TIME_INTERVAL_END_DATE | Start and end of an aggregated reporting period |
| Source report date fields | Date assigned by Amazon, Walmart, or the source API |
For source-system delays and freshness guidance, see Source Systems & Freshness.
Watch for preview and deprecated tables
The schema reference may include tables marked as preview, experimental, deprecated, legacy, or aliases. Treat those labels as implementation guidance:
- Preview / experimental: Useful for exploration, but avoid production dashboards unless your DataHawk contact confirms stability.
- Deprecated / legacy: Migrate to the replacement table where documented.
- Alias: Still resolves today, but use the canonical table for new work.
- Raw: Closer to the source API, often more granular and less curated.
Examples
Find the table for Buy Box owner
- Start with the
PRODUCTschema because Buy Box is product-offer data. - Search for
featured offerorbuy box. - Look for
AMZN_PRODUCT_FEATURED_OFFERand fields such asFEATURED_SELLER_ID. - Confirm field meaning in Product Data Reference.
Find sales estimate columns
- Start with
PRODUCT,MARKET, orREPORTS, depending on whether you need product-level, category-level, or curated report data. - Search for
sales estimates,UNITS_CHILD,REVENUE_CHILD, orTRUST_INDEX. - Confirm current V7 tables and deprecated aliases in Sales Estimates Data.
Find advertising campaign metrics
- Start with
ADVERTISING. - Search for
campaign,spend,sales,clicks, orsponsored_type. - Choose the table grain that matches the dashboard or query: account, campaign, keyword, product, or SKU.
- For Walmart-specific tables, use Walmart Advertising Data.
Find currency conversion fields
- Start with
REFERENTIAL. - Search for
currencyorexchange rate. - Use
REFERENTIAL_CURRENCY_RATEfor daily exchange rates andREFERENTIAL_MARKETPLACEwhen you need the currency attached to a marketplace. - For a SQL example, see Convert Currencies.