MongoDB の SQL

MongoDB と Amazon DocumentDB では、データの操作やその他の操作を行うために、JavaScript で mongo シェル用のスクリプトを記述します。主に SQL でデータクエリを行う開発者は、MongoDB または Amazon DocumentDB のコレクションでも SQL を使用すると便利です。WebStorm は SQL クエリを JavaScript に変換します。

SQL の JavaScript バージョンを表示するには、クエリを右クリックして JS スクリプトの表示を選択します。
現在の実装では、SELECT クエリと次のクエリがサポートされています: JOIN、WHERE、GROUP BY、HAVING、ORDER BY、LIMIT、OFFSET

SQL クエリの JavaScript 翻訳を参照する

クエリを右クリックして、JS スクリプトの表示を選択します。JavaScript コードをクリップボードにコピーするには、JS スクリプトをクリップボードにコピーをクリックします。
JS スクリプトのプレビューからスクリプトを変更して実行できます。

データ型

WebStorm は、次のデータ型をサポートしています。

文字列、整数、浮動小数点数、ブール値
NULL、NAN、INFINITY
配列（[1, 2, 3]）とマップ ({a: 1, b: 2, c: 3})

配列とマップには任意の式を含めることができます。

SELECT [1, 3 + 1 - 2, price] AS elements FROM sales;
SELECT {a: 1 + 2, b: NULL, c: FALSE, d: [1, 2]} FROM sales;

文字列リテラルは、一重引用符または二重引用符で使用できます。

引用符なしで列名を記述するか、アクサングラーブ（`）を使用します。

SELECT  _id,
        `acquisitions`,
        `category_code`,
        `description`,
        email_address,
        phone_number
FROM companies WHERE category_code = 'social'
AND description = "Mobile Dating";

オブジェクトコンストラクター

次のオブジェクトコンストラクターを使用できます: BinData、HexData、UUID、MD5、ObjectID、Date、ISODate、Code、DBRef、RegExp、NumberInt、NumberLong、NumberDecimal、Timestamp、MinKey、MaxKey

new キーワードは使用しても省略しても構いません。WebStorm は、MongoDB または Amazon DocumentDB クエリに new キーワードを自動的に追加します。この機能は、Date() と new Date() の違いにより、Date オブジェクトコンストラクターには適用されません。Date() は現在の日付を文字列として返し、new Date() は Date オブジェクトとして返します。

関数名が不明な場合、WebStorm は関数名の前に new キーワードがあるかどうかを検索します。new キーワードがある場合、その名前はオブジェクトコンストラクターとして扱われます。それ以外の場合は、関数呼び出しとして扱われます。例: 次のクエリ:

SELECT  new UnknownTypeConstructor() AS A,
        new NumberInt() AS B,
        NumberInt(1) AS C FROM companies;

次のように翻訳されます:

db.getSiblingDB("admin").getCollection("companies").aggregate([
  {
    $project: {"A": {$literal: new UnknownTypeConstructor()},
               "B": {$literal: new NumberInt()},
               "C": {$literal: new NumberInt(1)},
               "_id": 0}
  }
])

関数

MongoDB および Amazon DocumentDB の集計パイプライン演算子（map、reduce、filter、let を除く）はすべて使用できます。また、COUNT(*) は使用できますが、COUNT (expression) はまだサポートされていません。

MongoDB および Amazon DocumentDB では、一部の関数で名前付き引数が必要です。名前付き引数を使用するには、名前付きパラメーターに PostgreSQL のような構文（例: => または :=）を使用してください。パラメーター化された関数に名前を指定しないとエラーが発生します。dateToString 関数の次の例を参照してください。

SELECT dateToString(date => ISODate(),
                    format := '%H:%M:%S:%L%z',
                    timezone => 'Europe/London') AS 'Date'
FROM companies;

docs.mongodb.com の集約パイプラインオペレーター(英語)で名前付きパラメーターをサポートするすべてのパイプライン演算子のリストを確認できます。

制限

SQL と MongoDB および Amazon DocumentDB では集計関数に対するアプローチが異なるため、AVG、SUM、MIN、MAX などの集計関数を非集計として使用することはできません。例: SELECT MAX(1,2,3) は機能しません。
MongoDB および Amazon 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 または Amazon DocumentDB で有効な正規表現に変換されます。