salesforce - How to add comments in SOQL

Question

Is it possible to put comments in SOQL?

The Force.com explorer doesn't support basic operations like undo/redo and I can't find any way to enter comments so experimenting with queries is painful.

I've tried all the usual suspects --, #, /*, //

Answer 1

不，我认为没有办法在 SOQL 中使用注释。不过，您可以注释掉您在 Apex 中发出的查询。

除了基于 Flash 的官方资源管理器和 Eclipse IDE 中缓慢的查询实用程序之外，您可能更喜欢一些工具。

我最喜欢的是Real Force Explorer - 具有 SOQL 和 Apex 片段的可搜索历史记录，如果您有多个查询（例如在 Oracle 的 SQLDeveloper 中），您可以选择要运行的片段...

我也听说过一些关于BrainEngine的好东西，还没有尝试过（基本版是免费的，多花点钱）。截图看起来很诱人；）

您可能还喜欢官方Workbench等基于 Web 的工具- 如果您不喜欢在官方托管的工具中提供凭据，您可以下载它并将其托管在您自己的机器上。

最后但并非最不重要的一点 - JitterBit 数据加载器前段时间被提升为在设置页面中列出。也没有玩过它（可能它只是一个数据加载器，不太适合查询编辑器任务）。

如果您是 SQL Server 人员 - 请查看DBAmp（再次 $$$）。我怀疑它是 Salesforce 的唯一连接器，必须进行更多类似 ODBC 的翻译尝试。所以你也许可以为你最喜欢的 SQL 编辑器找到一个插件。

（不，我与这些链接背后的任何公司或项目都没有关系）

Answer 2

如果您在 Apex 内编写内联 SOQL，您可以添加 Apex 注释。块注释和单行注释都有效。

您可以在 Developer Console 的 Execute Anonymous 窗口中验证这一点：

List<Account> accounts = [
    SELECT ID From Account
    // single line comment
    WHERE Name = 'Test' /* block comment */
];

执行日志显示注释已从实际查询中删除：

SOQL_EXECUTE_BEGIN [1]|Aggregations:0|SELECT ID FROM Account WHERE Name = 'Test'

Answer 3

我使用 VisualSoftwareSystems.net 的 SOQL Studio。它支持行注释和块注释以及完整的语法突出显示。

Answer 4

好的，在 SOQL 中你没有通常的评论机制。所以现在是布尔幻象的时候了：附加一个永远不会为真但包含注释信息的 OR 子句。像这样的东西：

SELECT id FROM Account WHERE Name = 'IBM' OR Name = '这是解释此查询用途的注释文本'

这一点hackery会稍微减慢查询速度......但是如果您只是必须将注释放在SOQL中（而不是在调用它的行尾），它确实有效。