dbt-labs / dbt-labs/agents_schema

Canonical names should be uppercase AGENTS.*; BigQuery and Databricks deliver lowercase

Closed
#42 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
59
Forks
5
Avg merge
2d 10h
Merged PRs (30d)
4

Description

#40 surfaced this: the package constant is AGENTS_SCHEMA = "agents", and
the BigQuery and Databricks writers pass it straight through, so they create
physically lowercase objects (project.agents.dbt_model) on case-preserving
engines. SPEC.md has named the schema AGENTS since the original AGENTS.sql
specification commit, Snowflake stores the objects uppercase no matter what
the constant says, and Fivetran's internal implementation of the convention
is uppercase on BigQuery as well.

The lowercase constant predates the multi-destination writers. On Snowflake,
then the only destination, unquoted lowercase folds to uppercase, so it had
no visible effect.

Plan: flip the constant to "AGENTS", and update SPEC.md section 1 to state
the canonical spelling and Snowflake's folding behavior. On BigQuery,
dataset names are case-sensitive, so existing lowercase agents datasets
stay behind while new syncs create AGENTS. That behavior change needs a
release note and probably a migration note.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the package constant and the BigQuery and Databricks writers that pass it through. Read SPEC.md section 1, then update the canonical spelling and document Snowflake folding, the BigQuery behavior for existing lowercase datasets, and the migration implications. Done means new syncs use AGENTS and the release and migration notes cover the behavior change.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
data-engineering, databases, documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.