Snowflake 技能用于通过 Snowflake SQL API 查询 Snowflake 数据仓库,可执行 SQL 语句、管理仓库以及查询元数据。
用途 该技能面向需要以编程方式访问 Snowflake 数据仓库的场景,通过 HTTP 调用 SQL API 完成数据查询与仓库管理操作。
主要能力
- 执行 SQL 查询:向 SQL API 的 statements 端点发送 POST 请求,可指定 warehouse、database、schema 等参数。
- 列出数据库:通过执行 SHOW DATABASES 语句获取数据库列表。
- 查询元数据:资料说明可通过 SQL API 查询元数据。
使用方式 需要配置以下环境变量:
- SNOWFLAKE_ACCOUNT:账户标识符,例如 abc12345.us-east-1
- SNOWFLAKE_USER:用户名
- SNOWFLAKE_PASSWORD:密码
执行 SQL 的示例命令:
curl -s -X POST
"https://$SNOWFLAKE_ACCOUNT.snowflakecomputing.com/api/v2/statements"
-H "Content-Type: application/json"
-H "Authorization: Bearer $SNOWFLAKE_PASSWORD"
-d '{"statement":"SELECT * FROM my_table LIMIT 10","warehouse":"COMPUTE_WH","database":"MY_DB","schema":"PUBLIC"}' | jq '{statementHandle, data: .data[:5]}'
列出数据库的示例命令:
curl -s -X POST
"https://$SNOWFLAKE_ACCOUNT.snowflakecomputing.com/api/v2/statements"
-H "Content-Type: application/json"
-H "Authorization: Bearer $SNOWFLAKE_PASSWORD"
-d '{"statement":"SHOW DATABASES","warehouse":"COMPUTE_WH"}' | jq '.data[]'
适用场景 适用于需要通过 SQL API 对 Snowflake 数据仓库执行查询、查看数据库列表或获取元数据的自动化与集成场景。
限制与注意事项
- 资料指出,SQL API 在生产环境中需要密钥对或 OAuth 认证。
- 运行 DDL 或 DML 语句前应始终进行确认。
- 关于收费、价格、平台支持范围、性能效果等,资料暂未提供。