改进流程

功能的

当补全结果不理想时按 F2;你的报告可以成为保持修复有效的测试。

补全在真实工作中会越来越好。如果建议不对、缺失或太吵,请按 F2 ,在列表打开时即可记录当时的情况。一份有用的报告会变成一个 回归检验,让修复长久保持的可能性大得多。

何时按 F2

每当建议列表出现在屏幕上,它下方都会有一行小提示,写着 要改进它,请按 F2。你也可以点击提示本身。使用它的好时机包括:

  • 右侧的项缺失 - 例如,你知道存在的列,或应该出现的表 JOIN.
  • 顺序错误 - 让显而易见的选项埋在一堆不太可能的选项底下。
  • 列表成了噪音 - 例如在只该出现列的地方提供了表。
  • 没有提供任何内容。 空列表会显示为 暂无建议——按 F2 可帮助改进。这往往是最有用的报告。按 Ctrl+空格 可以手动打开这个列表,然后 F2.

F2 是默认设置。你可以在 键绑定,其中动作为 改进智能感知(捕获反馈).

反馈对话框

SQLly
SQLly IntelliSense 反馈捕获对话框SQLly IntelliSense 反馈捕获对话框
F2 反馈对话框:你输入的内容、给出的建议以及你期望的结果——随时可以提交。

对话框会显示你的查询及光标位置、当时提供的建议,以及你的数据模型树。你的查询放在只读文本框里,可以选中并复制其中任何部分。它的光标起始位置就是你编辑器中光标所在的位置,标题栏以 行:列 的形式显示该位置。唯一必填的是一条说明它本应给出什么建议的备注。 它本应提供什么? 框在对话框打开时就会显示闪烁的光标,你可以立即开始输入。一条好的备注会写明你期望的项目和期望它出现的位置,例如 在 FROM dbo.Orders o JOIN 我预期 dbo.Customers 首先.

  • 数据模型名称。 你的语句所引用的对象默认已勾选。你可以随意勾选或取消勾选表、视图和存储过程,也可以搜索这棵树。为你呈现过的建议所依赖的对象会保持勾选,因为根据你的报告构建的测试需要它们。只发送名称,绝不发送数据。
  • 全部包含。 发送整个连接的数据模型(仅名称)。默认关闭,除非你开启 默认情况下,在 IntelliSense 反馈中包含完整的数据模型 in 设置 › 编辑器 › 常规.
  • 关系链。 可选。为你包含的表添加多跳外键链,例如 Orders → Customers → Regions。
  • 掩码字面值。 默认关闭,查询会按输入原样发送。开启后可将字符串字面量和注释替换为 <redacted> ,先做这一步。详见 隐私.

报告会发生什么

  1. 捕获 (F2)。 SQLly 会保存你的查询、光标位置、当时的建议列表(含高亮项)、列表的打开方式、你的 IntelliSense 规则以及应用配置设置。如果列表里有建议,还会附上一张截图。绝不包含任何连接凭据或 API 密钥。
  2. 审查。 你可以选择要随之发送的数据模型名称,以及是否掩码字面量。对话框会显示将要发送的内容。
  3. 签名并发送。 提交时,报告会先保存到本地文件,然后再上传。如果上传失败,SQLly 会在下次启动时以及之后每五分钟尝试一次,并且永不放弃。每份报告都有自己的 ID,因此重试不会重复提交。
  4. 分拣。 提交会进入管理员队列以供审核。
  5. 把它定下来。 被接受的报告会变成专用验证套件中的用例:一个真正的测试,在补全行为变正确之前会一直失败。
  6. 已发布。 修复发布后,你在网站“反馈”页面提交的报告会显示 在 vX.Y.Z 版本中实现 显示修复它的发布版本。当该发布被标记时,报告会自动标记。

想看看 IntelliSense 反馈报告在开发团队中是什么样子吗? 点击这里查看一个真实的只读示例,其中的 id 已被隐去。

隐私为先。 反馈只包含重现该补全所需的信息:数据模型仅限于你选择的名称,你可以遮盖字面量,连接凭据和 API 密钥则绝不会包含在内。