db.createView()（mongoshメソッド）

db.createView()

注意

曖昧さ回避

このページでは標準ビューについて説明します。オンデマンドのマテリアライズドビューについて詳しくは、「オンデマンドのマテリアライズドビュー」を参照してください。

ビュータイプの違いを理解するには、「オンデマンドのマテリアライズドビューとの比較」を参照してください。

指定された集計パイプラインをソースコレクションまたはビューに適用して、ビューを作成します。ビューは読み取り専用のコレクションとして機能し、読み取り操作中にオンデマンドで計算されます。ソースコレクションと同じデータベースにビューを作成する必要があります。MongoDB では、基礎となる集計パイプラインの一部としてビューに対して読み取り操作が実行されます。

ビュー定義pipelineには、$outまたは$mergeステージを含めることはできません。この制限は、$lookupステージまたは$facetステージで使用されるパイプラインなどの埋め込みパイプラインにも適用されます。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

注意

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

db.createView の構文は次のとおりです。

db.createView(<view>, <source>, <pipeline>, <collation>)

このメソッドには、次のパラメーターがあります。

Parameter

タイプ

説明

view

string

作成するビューの名前。

source

string

ビューの作成元となるソースコレクションまたはビューの名前。この名前にはデータベース名は含まれず、作成するビューと同じデータベースを意味します。これは、コレクションまたはビューの完全な名前空間ではありません。ソースコレクションと同じデータベースにビューを作成する必要があります。

pipeline

配列

An array that consists of the aggregation pipeline stage(s). db.createView() creates the view by applying the specified pipeline to the source collection or view.

ビュー定義はパブリックです。つまり、ビューに対する db.getCollectionInfos() および explain操作には、ビューを定義するパイプラインが含まれます。そのため、ビュー定義で機密性の高いフィールドと値を直接参照することは避けてください。

collation

ドキュメント

任意: ビューのデフォルトの照合設定を指定します。

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

基になる source がコレクションの場合、ビューはコレクションの照合設定を継承しません。

照合方法が指定されていない場合、ビューのデフォルトの照合には「単純な」バイナリ比較照合子が使用されます。

基になる source が別のビューである場合、そのビューで同じ照合設定を指定する必要があります。

照合オプションの構文は次のとおりです。

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

照合を指定する場合、locale フィールドは必須ですが、その他の照合フィールドはすべて任意です。フィールドの説明については、照合ドキュメントを参照してください。

db.createView() メソッドは次の create コマンド操作をラップします。

db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline>, collation: <collation> } )

重要

ビュー名はコレクションリスト出力に含まれます

db.getCollectionInfos() や db.getCollectionNames() などのコレクションを一覧表示する操作では、出力にビューが含まれます。

例

ビューの作成例については、次のページを参照してください。

動作

ビューの動作の詳細を確認するには、「動作」を参照してください。

戻る

db.createEncryptedCollection

db.currentOp