SQL for MongoDB
在 MongoDB 和 DocumentDB 中,为了操作数据或执行其他操作,您需要使用 JavaScript 为 mongo shell 编写脚本。 对于主要使用 SQL 查询数据的开发者来说,将 SQL 用于 MongoDB 或 DocumentDB 集合可能会有所帮助。 PhpStorm 将把您的 SQL 查询转换为 JavaScript。
要查看 SQL 的 JavaScript 版本,请右键点击查询并选择 显示JS 脚本。
当前实现支持 SELECT 查询及以下子句:
JOIN、WHERE、GROUP BY、HAVING、ORDER BY、LIMIT、OFFSET。
查看 SQL 查询的 JavaScript 翻译
右键点击查询并选择 显示JS 脚本。 要将 JavaScript 代码复制到剪贴板,请点击 将JS 脚本复制到剪贴板。
您可以从 JS 脚本预览 修改并运行脚本。


数据类型
PhpStorm 支持以下数据类型:
String,Integer,Float,Boolean
NULL、NAN、INFINITY
数组(
[1, 2, 3])和映射({a: 1, b: 2, c: 3})
数组和映射可以包含任何表达式。
您可以使用单引号或双引号中的字符串字面量。
请写列名时不要使用引号或使用重音符号(`)。
对象构造函数
您可以使用以下对象构造函数: BinData、 HexData、 UUID、 MD5、 ObjectID、 日期、 ISODate、 代码、 DBRef、 RegExp、 NumberInt、 NumberLong、 NumberDecimal、 Timestamp、 MinKey、 MaxKey。
您可以使用或跳过 new 关键字。 PhpStorm 将自动向 MongoDB 或 DocumentDB 查询中添加 new 关键字。 此功能不适用于 日期 对象构造函数,因为 Date()new Date() 之间存在差异。 Date() 返回当前日期字符串,并且 new Date() 作为日期对象。
如果函数名称未知,PhpStorm 会在函数名称之前搜索 new 关键字。 如果 new 关键字存在,则名称被视为对象构造函数。 否则,作为函数调用。 例如,以下查询:
将被翻译为: """
函数
您可以使用所有可用的 MongoDB 和 DocumentDB 聚合管道运算符,但以下除外: map、 reduce、 过滤器 和 let。 此外,您可以使用 COUNT(*),但不支持 COUNT (expression)。
在 MongoDB 和 DocumentDB 中,某些函数需要命名参数。 要使用命名参数,请使用 PostgreSQL 的语法来表示命名参数(例如, => 或 :=)。 如果您未为参数化函数指定名称,您将会收到错误。 请考虑以下关于 dateToString 函数的示例:
您可以在 docs.mongodb.com 的聚合管道操作符中查看所有支持命名参数的管道操作符列表。
限制
由于 SQL 和 MongoDB 及 DocumentDB 中对聚合函数的处理方式不同,您无法将聚合函数(如 AVG、SUM、MIN 和 MAX)用作非聚合函数。 例如,
SELECT MAX(1,2,3)将不起作用。在 MongoDB 和 DocumentDB 中,像
AVG、SUM、MIN和MAX这样的函数可能既是聚合函数,也可以是非聚合函数。 如果它们被放置在group块中,它们是聚合的。 否则,它们是非聚合的。在 SQL 中,没有这样的依赖关系,您可以在不使用 GROUP BY 子句的情况下使用聚合函数(例如,
SELECT AVG(x) FROM t)。您不能在其他聚合函数中调用聚合函数。
运算符
当前支持以下功能:
操作数:
=、==、>=、<=、>、<、<>、!=、+、-、/、*、%、AND、OR、NOT、LIKE、NOT LIKE、IS、IS NOT、IN、NOT IN、BETWEEN、NOT BETWEEN。您可以为
LIKE运算符使用通配符。 这些通配符会被转换为 MongoDB 或 DocumentDB 的有效正则表达式。

SQL 语句
SELECT
对于 SELECT 查询,支持以下功能。
选项:
DISTINCT、ALL。聚合函数和非聚合函数。
通过使用点符号名称访问嵌入字段。 请参考以下示例。


限制
列可以有别名。 别名不得包含句点 (
。)。
FROM
您可以为表使用别名。
对于嵌套的
SELECT语句,您必须使用别名。您可以使用嵌套的
SELECT查询。 例如,以下查询是有效的:

限制
别名不得包含句点 (
。)。
JOIN
仅支持
JOIN(INNER JOIN)和LEFT JOIN(LEFT OUTER JOIN)。仅支持
ON条件。在
ON部分中仅支持一个条件。 以下查询将导致错误:

您可以在
ON条件中使用==或=运算符。支持多个
JOIN子句。
限制
USING不受支持。您不能在
JOIN子句中将SELECT语句用作第二个参数。表名和别名在
JOIN子句中不能重复。
WHERE
LIKE和NOT LIKE需要字符串字面量。 以下查询导致错误:

GROUP BY
PhpStorm 支持 GROUP BY 子句。
SELECT 子句可以包含功能上依赖于 GROUP BY 子句中表达式的表达式。 如果列在 GROUP BY 子句中使用,您可以在 SELECT 子句中使用列的嵌入字段。


HAVING
PhpStorm 支持 HAVING 子句。


ORDER BY
PhpStorm 支持 ORDER BY 子句。 您可以使用 SORT BY 替代 ORDER BY。


LIMIT
PhpStorm 支持 LIMIT 子句。


OFFSET
PhpStorm 支持 OFFSET 子句。

