/ /

`mongotranslate`

説明

mongotranslate は、 MongoDB 集計言語で SQL クエリを表現する方法をユーザーが理解できるように設計された学習ツールです。 BI Connector の SQLから集計への変換エンジンは変換を提供します。これは、特定の BI Connector の変換の問題をトラブルシューティングするためにも使用できます。

mongotranslate は、スタンドアロンプログラムです。によって生成された drdl ファイルが必要ですが、実行時にmongodrdl mongosqldまたはmongod が実行中である必要はありません。

使用法

mongotranslate の構文は次のとおりです。

mongotranslate [--query | --queryFile] <query | queryfile> [options]

コマンドラインオプション

--query: MongoDB 集計パイプラインに変換する SQL クエリを指定します。 --queryまたは--queryFileのいずれかが必要です。

--queryFile: MongoDB 集計パイプラインに変換する SQL クエリを含むファイルへのパスを指定します。 --queryまたは--queryFileのいずれかが必要です。

--schema: 必須。 SQL クエリを集計パイプラインに変換するときに使用するmongodrdlプログラムによって作成された 1 つ以上の.drdl .drdlファイルを含むディレクトリを指定します。

--dbName

デフォルト: test

SQL クエリ内の非修飾テーブル名に使用するデータベース名。

次の例えでは、 fruitという名前のコレクションと--dbNameオプションを使用して、 fruitがgroceriesデータベースにあることを指定します。

mongotranslate "SELECT * FROM fruit WHERE _id > 100;" \
  --schema schema.drdl --dbName groceries

データベースを指定するために--dbNameオプションを使用しない場合、 mongotranslateはfruitがtestデータベースにあると想定します。スキーマにtestという名前のデータベース、またはtestデータベース内のテーブル名fruitが含まれていない場合、 mongotranslateはエラーを返します。

次の例では完全修飾テーブル名を使用しているため、 --dbNameオプションは必要ありません。

mongotranslate "SELECT * FROM groceries.fruit WHERE _id > 100;" \
  --schema schema.drdl

SQL クエリで各テーブル名を持つデータベースを指定する場合、 --dbNameオプションを使用すると無視されます。

--explain: 任意。 変換された集計パイプラインではなくクエリプランのexplain出力を返します。 --explainを使用すると、BI Connector に接続された BI ツールでEXPLAIN <query>を実行するのと同様の出力が返されます。

--format

デフォルト: multiline

任意。 有効なオプションはnoneとmultilineです。デフォルトのmultilineオプションを使用すると、より簡単に読みやすい形式で結果が表示されます。

コマンドタイプ	オプション	説明
`--explain`オプションを指定しない場合	`--format none`	集計パイプラインすべてを 1 行で返します。
`--explain`オプションを指定しない場合	`--format multiline`	1 行につき 1 つのパイプラインステージを持つ集計パイプラインを返します。
`--explain`オプションの場合	`--format none`	すべてのフィールドを 1 行で返します。
`--explain`オプションの場合	`--format multiline`	配列とオブジェクトサブフィールドの追加形式とともに、1 行に 1 つのフィールドを返します。

--mongoversion

デフォルト: latest

任意。 指定された MongoDB バージョンと互換性のある集計パイプラインを返します。受け入れ可能な値は以下の通りです。

3.2
3.4
3.6
4.0
latest

デフォルト値は latest です。

例

次の例では、翻訳用のインラインクエリを指定しています。

mongotranslate --query=“select test.name from restaurants where name like 'Brooklyn%'” \
--schema=schema.drdl

上記のコマンドは、次の結果を返します。

[
  {"$match": {"name": {"$regex": "^Brooklyn.*$","$options": "i"}}},
  {"$project": {"test_DOT_restaurants_DOT_name": "$name","_id": {"$numberInt":"0"}}},
]

注意

--queryパラメータ内で string を引用する必要がある場合は、必ず一重引用符を使用してください。クエリでdouble引用符またはバックグラウンドを使用する必要がある場合は、 --queryFileオプションを使用します。

次の例では、クエリファイルを指定し、1 行の結果を返します。

mongotranslate --queryFile=query.txt --schema=schema.drdl --format=none

次の例では、 --explainオプションを使用しています。

mongotranslate --query="select count(name) from restaurants;" \
--schema=schema.drdl --explain

上記のコマンドは、次の結果を返します。

[
      {
         "ID": 1,
         "StageType": "MongoSourceStage",
         "Columns": "[{name: 'count(name)', type: 'int'}]",
         "Sources": null,
         "Database": {},
         "Tables": {},
         "Aliases": {},
         "Collections": {},
         "Pipeline": {},
         "PipelineExplain": {},
         "PushdownFailures": null
      }
]

戻る

MongoDB BI Connector ODBC ドライバー

説明

使用法

コマンドライン オプション

例

注意

コマンドラインオプション