# MongoDB の SQL

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

MongoDB​ と Amazon DocumentDB​ では、データの操作やその他の操作を行うために、JavaScript で mongo シェル用のスクリプトを記述します。 主に SQL でデータをクエリする開発者にとって、MongoDB​ または Amazon DocumentDB​ のコレクションでも SQL を使用すると便利な場合があります。 CLion will translate your SQL queries to JavaScript.

* SQL の JavaScript バージョンを表示するには、クエリを右クリックして 変換されたスクリプトの表示 を選択します。

* 現在の実装では、SELECT クエリと次のクエリがサポートされています: `JOIN` 、 `WHERE` 、 `GROUP BY` 、 `HAVING` 、 `ORDER BY` 、 `LIMIT` 、 `OFFSET`

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

* クエリを右クリックして、   変換されたスクリプトの表示   を選択します。 JavaScript コードをクリップボードにコピーするには、   変換されたスクリプトをクリップボードにコピー   をクリックします。

JS スクリプトのプレビュー   からスクリプトを変更して実行できます。

MongoDB​:

![alt_translated_js_code](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_translated_javascript_code.png)

Amazon DocumentDB​:

![alt_translated_js_code](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_translated_javascript_code.png)

## データ型

CLion は次のデータ型をサポートしています:

* 文字列、整数、浮動小数点数、ブール値

* NULL、NAN、INFINITY

* 配列（ `[1, 2, 3]` ）とマップ ( `{a: 1, b: 2, c: 3}` )

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

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

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

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

```SQL
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`  、  `日付`  、  `ISODate`  、  `コード`  、  `DBRef`  、  `RegExp`  、  `NumberInt`  、  `NumberLong`  、  `NumberDecimal`  、  `Timestamp`  、  `MinKey`  、  `MaxKey`

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

If the function name is unknown, CLion searches for the  `new`  keyword before the function name.  `new`  キーワードがある場合、その名前はオブジェクトコンストラクターとして扱われます。 それ以外の場合は、関数呼び出しとして扱われます。 例: 次のクエリ:

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

次のように変換されます:

```JAVASCRIPT
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`  関数の次の例を参照してください。

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

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

### 制限

* 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​ で有効な正規表現に変換されます。 MongoDB​: ![LIKE 演算子のワイルドカード](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_wildcards_for_the_like_operator.png) Amazon DocumentDB​: ![LIKE 演算子のワイルドカード](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_wildcards_for_the_like_operator.png)

## SQL 句

### SELECT

`SELECT`  クエリでは次の機能がサポートされています。

* オプション: `DISTINCT` 、 `ALL`

* 集計関数と非集計関数。

* 点線の名前を使用した埋め込みフィールドへのアクセス。 次の例を考えてみましょう。 MongoDB​: ![埋め込みフィールド](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_embedded_fields.png) Amazon DocumentDB​: ![埋め込みフィールド](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_embedded_fields.png)

#### 制限

* 列にはエイリアスが含まれる場合があります。 エイリアスにピリオド（ `.` ）を含めることはできません。

### FROM

* テーブルにはエイリアスを使用できます。

* ネストされた `SELECT` ステートメントにはエイリアスを使用する必要があります。

* ネストされた `SELECT` クエリを使用できます。 例: 次のクエリは有効です。 MongoDB​: ![ネストされた SELECT クエリ](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_nested_select_queries.png) Amazon DocumentDB​: ![ネストされた SELECT クエリ](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_nested_select_queries.png)

#### 制限

* エイリアスにピリオド（ `.` ）を含めることはできません。

### JOIN

* `JOIN` ( `INNER JOIN` ) と `LEFT JOIN` ( `LEFT OUTER JOIN` ) のみがサポートされます。

* `ON` 条件のみがサポートされます。

* `ON` 部分には条件が 1 つだけあります。 次のクエリはエラーになります。 MongoDB​: ![ON 部分には条件が 1 つだけ](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_one_condition_in_the_on_part.png) Amazon DocumentDB​: ![ON 部分には条件が 1 つだけ](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_one_condition_in_the_on_part.png)

* `ON` 条件では、 `==` または `=` 演算子を使用できます。

* 複数の `JOIN` 句がサポートされています。

#### 制限

* `USING` はサポートされていません。

* `SELECT` ステートメントを `JOIN` 句の 2 番目の引数として使用することはできません。

* `JOIN` 句では、テーブル名とエイリアスが重複してはなりません。

### WHERE

* `LIKE` および `NOT LIKE` には文字列リテラルが必要です。 次のクエリはエラーになります。 MongoDB​: ![LIKE および NOTLIKE には文字列リテラルが必要です](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_like_and_not_like_require_a_string_literal.png) Amazon DocumentDB​: ![LIKE および NOTLIKE には文字列リテラルが必要です](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_like_and_not_like_require_a_string_literal.png)

### GROUP BY

CLion supports the  `GROUP BY`  clause.

`SELECT`  句には、  `GROUP BY`  句の式に機能的に依存する式を含めることができます。 列が  `GROUP BY`  句で使用されている場合は、  `SELECT`  句で列の埋め込みフィールドを使用できます。

MongoDB​:

![GROUP BY](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_group_by.png)

Amazon DocumentDB​:

![GROUP BY](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentddb_group_by.png)

### HAVING

CLion supports the  `HAVING`  clause.

MongoDB​:

![HAVING](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_having.png)

Amazon DocumentDB​:

![HAVING](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_having.png)

### ORDER BY

CLion supports the  `ORDER BY`  clause.  `ORDER BY`  の代わりに  `SORT BY`  を使用できます。

MongoDB​:

![ORDER BY](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_order_by.png)

Amazon DocumentDB​:

![ORDER BY](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_order_by.png)

### LIMIT

CLion supports the  `LIMIT`  clause.

MongoDB​:

![LIMIT](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_limit.png)

Amazon DocumentDB​:

![LIMIT](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_limit.png)

### OFFSET

CLion supports  `OFFSET`  clause.

MongoDB​:

![OFFSET](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_mongodb_offset.png)

Amazon DocumentDB​:

![OFFSET](https://resources.jetbrains.com/help/img/idea/2026.3/db_sql_for_documentdb_offset.png)

