SuperAPI AI 工具集

snowflake-docs

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:该技能面向所有 Snowflake 文档查询场景,包括产品与功能问题、SQL 语法、最佳实践、how-to 指南、配置及故障排查。

主要能力:通过 Cortex Knowledge Extension(CKE)的 Cortex Search 服务,在 Snowflake 官方文档中做语义检索并返回相关文档片段。搜索结果的每条记录包含 CHUNK(文档正文)、DOCUMENT_TITLE(页面标题)与 SOURCE_URL(文档规范链接)。回答必须附带 SOURCE_URL,作为参考链接列在答案末尾。

使用方式: 第一步,先做前置检查,在全账户范围内查找 CKE 的 Cortex Search 服务: SHOW CORTEX SEARCH SERVICES LIKE 'CKE_SNOWFLAKE_DOCS_SERVICE' IN ACCOUNT; 若有结果,记下结果行中的 database_name 作为 <CKE_DATABASE>,直接进入第二步。若无结果,则安装 CKE,依次执行: CALL SYSTEM$REQUEST_LISTING_AND_WAIT('GZSTZ67BY9OQ4'); CALL SYSTEM$ACCEPT_LEGAL_TERMS('DATA_EXCHANGE_LISTING', 'GZSTZ67BY9OQ4'); CREATE DATABASE IF NOT EXISTS SNOWFLAKE_DOCUMENTATION FROM LISTING 'GZSTZ67BY9OQ4'; 安装失败时必须停止,并提示用户可从 Marketplace 手动安装(https://app.snowflake.com/marketplace/listing/GZSTZ67BY9OQ4),在用户确认 CKE 可用前不得继续。安装成功后使用 SNOWFLAKE_DOCUMENTATION 作为 <CKE_DATABASE>。 第二步,用 SQL 直接查询 Cortex Search 服务,将 <USER_QUESTION> 替换为用户问题、<CKE_DATABASE> 替换为第一步得到的数据库名: SELECT SNOWFLAKE.CORTEX.SEARCH_PREVIEW( '<CKE_DATABASE>.SHARED.CKE_SNOWFLAKE_DOCS_SERVICE', '{"query": "<USER_QUESTION>", "columns": ["CHUNK", "DOCUMENT_TITLE", "SOURCE_URL"], "limit": 5}' ); 解析返回的 JSON 并据此作答。

适用场景:需要基于官方文档回答的 Snowflake 各类查询与排障。

限制与注意:第一步每个账户只运行一次,安装后后续直接进入第二步;CKE 数据库名因账户而异,必须动态发现,不可硬编码。所有 SQL 步骤使用 sql_execute。SEARCH_PREVIEW 调用必须显式指定 columns,否则只返回相关性分数而非内容。回答中必须包含 SOURCE_URL 链接,遗漏即视为失败。需优雅处理权限不足、数据库已存在等错误。本资料未提供定价、可用平台等信息。