用途:该技能为通过 CData Connect AI 查询 Stripe 数据提供 Stripe 专属指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与三段式查询命名约定。
前置条件:使用前必须先定位并阅读 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止,告知用户需先安装并启用该技能。该技能取代 Stripe 驱动的 getInstructions,不要再调用它,直接进入 getSchemas 与后续模式发现。
接口面识别:Stripe 连接由 CData Schema 连接属性决定暴露两种接口面之一,且仅暴露所配置的一种,getSchemas 只返回一个 schema。接口面无法从连接名推断,因此对任何 Stripe 连接的第一步工具调用必须是 getSchemas,先于 queryData、getTables、getColumns。返回 Stripe 为经典接口面,返回 StripeV2 为 V2 接口面。
经典接口面:schema 属性默认 Stripe,返回 Stripe,包含约 80 张表/视图(Customers、Invoices、Subscriptions、Charges、PaymentIntent 等)及约 20 个存储过程,是多数连接使用的配置。识别后加载 references/stripe.md。
V2 接口面:schema 属性 StripeV2,返回 StripeV2,仅覆盖 V2 Core/Events 与计费计量 API,包括 EventDestinations、ThinEvents 和 meter-event 过程,不是账单/支付数据模型。识别后加载 references/stripev2.md。若需客户、发票、费用数据,连接须改用经典 Stripe schema。
查询命名:三段式名称始终为 [Catalog].[Schema].[Table],中间段是 schema(Stripe 或 StripeV2),不是连接名或驱动名。示例:SELECT [Id], [Email], [Name] FROM [YourConnection].[Stripe].[Customers] LIMIT 10。
通用约定:金额为最小货币单位的整数(分),美元等需除以 100,日元等零小数货币已是整单位,不可将原始金额当作美元展示;时间戳以 SQL TIMESTAMP 暴露;查询前用 getColumns 确认列名,Stripe 表较宽且将嵌套对象展平为带前缀列;时间过滤优先使用显式日期字面量(如 '2025-01-01')而非 DATEADD()。
限制:资料未提供具体收费、价格、平台支持范围及更多使用步骤。