技能介绍

这些坑你可能已经踩过

在 Snowflake 上写存储过程，变量忘了加冒号前缀，运行时抛 invalid identifier；Dynamic Table 里用了 SELECT *，上游改字段后静默失败；Cortex AI 还照着老文档写 CLASSIFY_TEXT，函数早已弃用。这些错误分散在 SQL、管道、AI 集成和 Python 四个层面，每处都有特定的修正模式，靠查文档逐条比对成本很高。

技能覆盖的核心能力

这个技能把 Snowflake 开发分成四条主线：

SQL 与存储过程规范：统一使用 snake_case 标识符，避免双引号导致的强制大小写敏感；存储过程内变量、参数在 SQL 语句中必须以 :name 形式引用，否则 Snowflake 会当作列名解析；生产环境禁用 SELECT *，显式列名只扫描所需列，降低列式存储的 I/O 开销。

数据管道编排：Dynamic Tables 承担声明式转换，TARGET_LAG 按 DAG 层级逐级放宽；Streams + Tasks 处理需要过程逻辑或分支判断的 CDC 场景；Snowpipe 负责云端存储的持续文件加载。三种方式按需求选择，而不是全部堆叠。

Cortex AI 与 Agent：统一使用 AI_COMPLETE、AI_CLASSIFY、AI_FILTER、AI_EXTRACT、AI_SENTIMENT、AI_PARSE_DOCUMENT、AI_REDACT 这组当前函数，替代已弃用的 COMPLETE、SUMMARIZE、TRANSLATE 等旧名。Agent spec 使用 $spec$ 分隔符，models 必须是对象而非数组，tool_resources 是独立顶层键。TO_FILE 的 stage 路径与文件名是两个独立参数。

Snowpark Python 与 dbt：凭证通过环境变量或密钥对认证，不要硬编码；DataFrame 惰性执行，服务端处理避免 collect() 拉取全量数据；批量和 ML 场景用向量化 UDF；dbt 中 {{ this }} 必须配合 {% if is_incremental() %} 守卫。

适用边界与注意点

技能提供的是 Snowflake 原生开发范式的约束与修复方案，不涉及通用 SQL 数据库的细节；跨数据库场景应配合通用 SQL 技能使用。安全基线包括最小权限 RBAC、PII 列的掩码策略、多租户隔离的行级策略，以及定期审计 ACCOUNTADMIN 授权。性能调优建议 X-Small 起步、按负载拆分独立仓库，而非追求一开始就上大规模配置。