クラス: Mongo::Collection::View

継承:
オブジェクト
  • オブジェクト
すべて表示
次による拡張機能。
転送可能
次のことが含まれます。
列挙 可能、 説明可能 、 不変 、 イテラブル 、 読み取り可能 、 書込み 可能
定義:
build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb 、
build/ruby-Driver-v 2.19 /lib/mongo/collection/view/iterable.rb,
build/ruby-Driver-v 2.19 /lib/mongo/collection/view/readable.rb,
build/ruby-Driver-v 2.19 /lib/mongo/collection/view/writetable.rb,
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/imutable.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/map_reduce.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/aggregation.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/explainable.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/change_stream.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/Builder/map_reduce.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/Builder/aggregation.rb、
build/ruby-Driver-v 2 . 19 /lib/mongo/collection/view/change_stream/retryable.rb

Overview

注：

View API は半パブリックです。

結果セットのドキュメントを生成するクエリとオプションの表現。

ヘルパーを使用してViewを変更できます。 ヘルパーは連鎖させることができ、引数が指定されている場合はそれぞれがViewを返すためです。

ターミネーターが呼び出されるときに、クエリ メッセージはサーバーに送信されます。 たとえば、#each がViewで呼び出されるとカーソル オブジェクトが作成され、クエリがサーバーに送信されます。

Viewはユーザーによって直接作成されることはありません。 代わりに、CRUD 操作が呼び出されたときにViewはViewを作成し、それを操作ユーザーに返します。

以来

  • 2.0.0

名前空間で定義済み

Modules: ビルダ、説明可能、不変、イテラブル、読み取り可能、 書込み可能クラス:集計、 ChangeStream 、 MapReduce

定数の概要

Writeableから含まれる定数

Writeable::ARray_Filters

Explainableに含まれる定数

説明可能::ALL_PLANS_EXECUTION 、説明可能:EXECUTION_STATS 、説明可能::QUERY_PLANNER

インスタンス属性の概要を折りたたむ

イテラブルに含まれる属性

#cursor

不変に含まれる属性

#options

インスタンス メソッドの概要を折りたたむ

Writeableに含まれるメソッド

#delete_many, #delete_one, #find_one_and_delete, #find_one_and_replace, #find_one_and_update, #replace_one, #update_many, #update_one

Explainableに含まれるメソッド

#explain

読み取り可能なに含まれるメソッド

、 、 、 、 、 、 、 、 、 、 、 、 、 、 、および​、 、 、 、 、 、 、 、 、および​​​

イテラブルに含まれるメソッド

#close_query 、各

コンストラクターの詳細

初期化多数（コレクション、フィルター = {}、オプション = {}） =表示

新しいViewを作成します。

例:

emily という名前のユーザーをすべて検索します。

View.new(collection, {:name => 'Emily'})

5をスキップし、 を返す10 という名前のすべてのユーザーを見つけます。

View.new(collection, {:name => 'Emily'}, :skip => 5, :limit => 10)

特定の読み込み設定（read preference）を使用して、Emitter という名前のすべてのユーザーを検索します。

View.new(collection, {:name => 'Emily'}, :read => :secondary_preferred)

パラメーター:

  • コレクション （コレクション） —

    クエリするCollection 。

  • フィルター （ハッシュ） （デフォルトは{}です） —

    クエリフィルター。

  • options （ハッシュ） （デフォルトは{}です） —

    追加のクエリオプション。

オプション ハッシュ（ options ）:

  • :allow_disk_use （ true 、 false ） —

    true に設定されている場合、サーバーは検索操作の実行中に一時データをディスクに書込むことができます。 このオプションは、MongoDB サーバー バージョン 4.4 以降でのみ使用できます。

  • :batch_size （整数） —

    MongoDB からの各応答で返すドキュメントの数。

  • :collation （ハッシュ） —

    使用する照合。

  • :comment （ string ） —

    クエリにコメントを関連付けます。

  • :explain （ハッシュ） —

    find ではなく、指定された explain オプション（既知のオプションは :冗長 と :冗長性）を使用して explain を実行します。

  • :hint （ハッシュ） —

    デフォルトのインデックス選択を上書きし、MongoDB がクエリに特定のインデックスを使用するように強制します。

  • :limit （整数） —

    返されるドキュメントの最大数。

  • :max_scan （整数） —

    指定された数のドキュメントのみをスキャンするようにクエリを制限します。 を使用して、クエリが長時間実行されすぎるのを防ぎます。 MongoDB サーバー バージョン4.0以降、非推奨 。

  • :プロジェクション （ハッシュ） —

    返されるドキュメントに含めるフィールドまたは除外するフィールド。

  • :read （ハッシュ） —

    クエリに使用する 読み込み設定（read preference） 。 何も指定されていない場合は、コレクションのデフォルトの読み込み設定が使用されます。

  • :read_concern （ハッシュ） —

    クエリに使用する読み取り保証 (read concern) です。

  • :show_disk_loc （ true | false ） —

    各ドキュメントのフィールドとしてディスクのロケーション情報を返します。

  • :skip （整数） —

    スキップするドキュメントの数。

  • :snapshot （ true | false ） —

    ドキュメントが複数回返されるのを防ぎます。 MongoDB サーバー バージョン4.0以降、非推奨 。

  • :sort （ハッシュ） —

    結果をソートするために使用されるキーと方向のペア。

以来

  • 2.0.0



155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行155

デフォルト 初期化(コレクション, フィルター = {}, options = {})
  validate_doc!(フィルター)
  @collection = コレクション

  フィルター = BSON::ドキュメント.新着情報(フィルター)
  options = BSON::ドキュメント.新着情報(options)

  #これは、ユーザーが フィルター やその他の修飾子で $query を渡す場合です
  と合わせて使用する場合
  クエリ = フィルター.削除(:$query)
  # これにより、フィルターが次ではなかった場合、修飾子にフィルターが含まれるようになります:
  $query 経由で提供されますが、最上位キーとして
  # downstream code ignores non-modifier keys in the modifiers?
  modifiers = フィルター.merge(options.削除(:modifiers) || {})
  @filter = (クエリ || フィルター).freeze
  @options = 操作::find::ビルダ::Modifiers.map_Driver_options(modifiers).mergeします。(options).freeze
end

インスタンス属性の詳細

#コレクション=コレクション（読み取り専用）

クエリするCollectionを返します。

次の値を返します。

以来

  • 2.0.0



56
57
58
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行56

デフォルト コレクション
  @collection
end

#フィルター=ハッシュ（読み取り専用） 。別名:セレクター

クエリフィルターを返します。

次の値を返します。

  • （ハッシュ） —

    クエリフィルター。

以来

  • 2.0.0



59
60
61
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行59

デフォルト フィルター
  @filter
end

インスタンス メソッドの詳細

# == (その他) === (その他 ) ==================================================

2 つのViewオブジェクトを比較します。

例:

ビューを別のオブジェクトと比較します。

view == other

次の値を返します。

  • （ true 、 false ） —

    2 つのViewのコレクション、フィルタ、オプションが一致する場合は と等しくなります。

以来

  • 2.0.0



86
87
88
89
90
91
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行86

デフォルト ==(その他)
  return false ただし、 その他.is_a?(ビュー)
  コレクション == その他.コレクション & &
      フィルター == その他.フィルター & &
      options == その他.options
end

#ハッシュ=整数

コレクション名前空間、オプションのハッシュ、フィルターのハッシュで構成されるViewのハッシュ値。

例:

ハッシュ値を取得します。

view.hash

次の値を返します。

  • (整数) —

    Viewオブジェクトのハッシュ値。

以来

  • 2.0.0



103
104
105
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行103

デフォルト ハッシュ
  [ コレクション.namespace, options.ハッシュ, フィルター.ハッシュ ].ハッシュ
end

詳しくは、 を 検査しstring ます

View の人間が判読可能なstring表現を取得します。

例:

検査を受けます。

view.inspect

次の値を返します。

  • ( string ) —

    Viewインスタンスの string 表現。

以来

  • 2.0.0



181
182
183
184
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行181

デフォルト 検査する
  " #< Mongo::Collection::View: 0 x #{ object_id } namespace=' #{ collection . namespace } ' " +
      " @filter= #{ filter . to_s } @options= #{ options .to_s } } > "
end

#write_concern = Mongo::WriteConcern

このViewの書込み保証 (write concern) を取得します。

例:

書込み保証 (write concern) を取得します。

view.write_concern

次の値を返します。

以来

  • 2.0.0



194
195
196
 
ファイル 'Build/ruby-Driver-v 2.19 /lib/mongo/collection/view.rb', 行194

デフォルト write_concern
  WriteConcern.得る(options[:write_concern] || options[:write] || コレクション.write_concern)
end