VSCode不支持直接执行Snowflake的PUT/GET命令，因官方驱动仅限SQL查询与DML/DDL，不提供文件传输协议；报错“unsupported_requested_format:snowflake”源于插件误将PUT当SQL解析，而JDBC驱动本身不识别该语法。
VSCode 无法直接连接 Snowflake 执行 PUT 或 GET 命令，这是设计限制，不是配置错误。 Snowflake 官方驱动（包括 VSCode 插件）只支持标准 SQL 查询和 DML/DDL，不暴露客户端文件传输协议。你看到的 unsupported_requested_format:snowflake 错误，本质是插件把 PUT 当作 SQL 语句解析，但底层 JDBC 驱动根本不认这个语法。
为什么 Snowflake 插件在 VSCode 里连不上或报 Protocol error
常见现象是点击连接后卡在 Connecting...，或弹出 Protocol error: unrecognized message type。根本原因不是密码错、网络不通，而是：
• 你装了泛用型插件（比如 “Database Client” 或旧版 vscode-sqltools），它们没适配 Snowflake 的 JDBC 协议握手流程；
• 正确插件（如 SQLTools + snowflake 驱动）未启用，或驱动版本太低（snowflake-jdbc • 连接 URL 格式不对：Snowflake 要求 host 字段填完整账户 URL（如 xy12345.us-east-1.snowflakecomputing.com），不能只写 xy12345 或 localhost；
• SSL 配置被忽略：Snowflake 强制 ssl=true，插件若没暴露该选项（很多轻量插件不提供），就会静默失败。
如何配置真正可用的 Snowflake 连接（以 SQLTools 为例）
必须同时满足三个条件：插件支持 + 驱动就位 + URL 精确。
• 安装 SQLTools 主体扩展，并在它的驱动管理界面中手动启用 Snowflake 驱动（不是默认勾选，要主动点开“Drivers”页并 toggle on）；
• 不要用“测试连接”按钮依赖视觉反馈——它常假阳性。连接保存后，打开任意 .sql 文件，右上角数据库下拉框出现你的 Snowflake 条目，且图标为绿色，才算真连上；
• host 字段必须是完整 URL，端口留空（走默认 443），database/schema/warehouse 全部显式填写，不要依赖插件自动补全；
• 密码含 @、/、: 等字符时，必须用 encodeURIComponent() 编码后再填入，否则连接串解析直接中断。
哪些 SQL 能跑，哪些一定不行
VSCode 插件对 Snowflake 的支持是“查询层”，不是“客户端层”。这意味着：
• ✅ 支持：所有标准 SELECT、INSERT、CREATE TABLE、COPY INTO（带 FROM @stage）、SHOW WAREHOUSES；
• ❌ 不支持：PUT、GET、LIST @stage、REMOVE @stage —— 这些命令必须走 snowsql CLI 或 Snowsight；
• ⚠️ 半支持：ALTER WAREHOUSE ... RESUME 类 DDL 有时能执行但不返回状态，建议用 SHOW WAREHOUSES 二次确认；
• 参数化查询（SELECT * FROM t WHERE id = ?）在 SQLTools 中可用，但变量绑定逻辑由插件实现，不是 Snowflake 原生预编译，敏感场景慎用于生产参数拼接。
真正容易被忽略的是：Snowflake 连接成功后，VSCode 里执行的每条语句都默认走你指定的 warehouse，但 warehouse 可能被其他会话 suspend。如果某次查询突然变慢或超时，先检查 SHOW WAREHOUSES，别急着调优 SQL —— 很可能只是 warehouse 没 resume。
