Update dbt and Airflow Spark URLs in profile mapping docstrings

[pankajastro]

Summary

• dbt restructured the docs site: /docs/core/connect-data-platform/<X>-setup and /reference/warehouse-setups/<X>-setup now 404 or redirect to /docs/local/connect-data-platform/<X>-setup. Linkcheck flagged ~20 profile pages as [redirected permanently] and 7 as [broken] (anchors not found).
• Updated the docstrings of every affected profile mapping class under cosmos/profiles/. The docs/reference/profiles/*.rst files are regenerated from these docstrings via docs/generate_mappings.py at build time, so the source-of-truth edit is the docstring (per CLAUDE.md).
• Also fixed the Airflow Apache Spark provider docs URL: connections/spark.html returns 404 now that the provider splits into spark-connect / spark-sql / spark-submit. Pointed at the connections/index.html instead.

Anchor handling

• Trino (certificate / JWT / LDAP): the page kept the sections but renamed the anchors. Updated to #example-profilesyml-for-{certificate,jwt,ldap} (verified via WebFetch).
• Snowflake key-pair, BigQuery oauth-via-gcloud, BigQuery service-account-file, Spark thrift: the dbt page still exists but the anchor couldn't be confirmed via WebFetch (Docusaurus body is JS-rendered). Dropped the anchor and linked to the page top — readers can scroll/Ctrl-F. Picking a wrong anchor would silently land users at the top of the page anyway; explicit is better.

Files changed

25 files under cosmos/profiles/ (one docstring URL each, +2 in spark/thrift.py):

athena/access_key.py, bigquery/{oauth,service_account_file,service_account_keyfile_dict}.py, clickhouse/user_pass.py, databricks/{oauth,token}.py, duckdb/user_pass.py, exasol/user_pass.py, mysql/user_pass.py, oracle/user_pass.py, postgres/user_pass.py, redshift/user_pass.py, snowflake/{user_pass,user_privatekey,user_privatekey_file,user_encrypted_privatekey_file,user_encrypted_privatekey_env_variable}.py, spark/thrift.py, starrocks/user_pass.py, teradata/user_pass.py, trino/{certificate,jwt,ldap}.py, vertica/user_pass.py

Test plan

• hatch run docs:build passes with --fail-on-warning and regenerates docs/reference/profiles/*.rst from updated docstrings
• sphinx-build -b linkcheck docs docs/_build/linkcheck — every previously-flagged dbt and Airflow-Spark link on profile pages is gone from the broken/redirected list
• Reviewer spot-checks one or two of the new URLs in a browser (e.g., https://docs.getdbt.com/docs/local/connect-data-platform/snowflake-setup)

Out of scope (for follow-up PRs)

• VerticaUserPassword GitHub blob #L72 / #L138 anchors — always false positives in linkcheck (GitHub renders line anchors via JS).
• AthenaAccessKey dbt-athena GitHub README #configuring-your-profile anchor — community repo README, unrelated to the dbt docs migration.
• AthenaAccessKey registry.astronomer.io → airflow.apache.org/registry/ redirect — registry consolidation, unrelated.
• Hand-written .rst pages that also reference the old dbt URL roots (docs/getting_started/oss-quickstart.rst, docs/getting_started/dbt-airflow-concepts.rst, docs/guides/connect_database/profile-customise-per-node.rst, docs/reference/glossary.rst) — these will be covered in the PR 3 cleanup of hand-written external links.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR updates profile mapping docstring links so generated profile reference docs point to current dbt and Airflow provider documentation.

Changes:

• Replaced outdated dbt setup URLs with /docs/local/connect-data-platform/... links.
• Updated Trino auth anchors to current section anchors.
• Replaced the obsolete Airflow Spark connection page link with the provider connections index.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.04%. Comparing base (5b8ade7) to head (1a591df).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2695   +/-   ##
=======================================
  Coverage   98.04%   98.04%           
=======================================
  Files         105      105           
  Lines        7867     7867           
=======================================
  Hits         7713     7713           
  Misses        154      154           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.