apiargs-MongoDBCollection-method-aggregate-option.yaml 2.7 KB
Newer Older
1 2 3 4
arg_name: option
name: allowDiskUse
type: boolean
description: |
5
  Enables writing to temporary files. When set to ``true``, aggregation stages
6 7
  can write data to the ``_tmp`` sub-directory in the ``dbPath`` directory. The
  default is ``false``.
8
interface: phpmethod
9
operation: ~
10 11 12 13 14 15
optional: true
---
arg_name: option
name: batchSize
type: integer
description: |
16 17 18
  Specifies the initial batch size for the cursor. A batchSize of ``0`` means an
  empty first batch and is useful for quickly returning a cursor or failure
  message without doing significant server-side work.
19
interface: phpmethod
20
operation: ~
21 22 23
optional: true
---
source:
24
  file: apiargs-MongoDBCollection-common-option.yaml
25
  ref: bypassDocumentValidation
26
post: |
27
  This only applies when using the :ref:`$out <agg-out>` stage.
28 29 30

  Document validation requires MongoDB 3.2 or later: if you are using an earlier
  version of MongoDB, this option will be ignored.
31
---
32
arg_name: option
33 34 35 36 37 38 39 40 41 42 43 44
name: comment
type: string
description: |
  Users can specify an arbitrary string to help trace the operation through the
  database profiler, currentOp, and logs.

  .. versionadded:: 1.3
interface: phpmethod
operation: ~
optional: true
---
arg_name: option
45 46 47 48 49 50 51 52 53 54 55 56
name: explain
type: boolean
description: |
  Specifies whether or not to return the information on the processing of the
  pipeline.

  .. versionadded:: 1.4
interface: phpmethod
operation: ~
optional: true
---
arg_name: option
57 58 59 60 61 62 63 64 65 66 67
name: hint
type: string|array|object
description: |
  The index to use. Specify either the index name as a string or the index key
  pattern as a document. If specified, then the query system will only consider
  plans using the hinted index.

  .. versionadded:: 1.3
interface: phpmethod
operation: ~
optional: true
68
---
69 70
source:
  file: apiargs-common-option.yaml
71
  ref: maxTimeMS
72 73
---
source:
74
  file: apiargs-MongoDBCollection-common-option.yaml
75
  ref: readConcern
76 77
---
source:
78
  file: apiargs-MongoDBCollection-common-option.yaml
79
  ref: readPreference
80 81
post: |
  This option will be ignored when using the :ref:`$out <agg-out>` stage.
82
---
83 84 85
source:
  file: apiargs-common-option.yaml
  ref: session
86 87
post: |
  .. versionadded:: 1.3
88
---
89
source:
90
  file: apiargs-MongoDBCollection-common-option.yaml
91
  ref: typeMap
92
---
93
arg_name: option
94 95 96
name: useCursor
type: boolean
description: |
97 98
  Indicates whether the command will request that the server provide results
  using a cursor. The default is ``true``.
99
interface: phpmethod
100
operation: ~
101
optional: true
102 103 104 105 106
---
source:
  file: apiargs-MongoDBCollection-common-option.yaml
  ref: writeConcern
post: |
107
  This only applies when the :ref:`$out <agg-out>` stage is specified.
108 109 110

  This is not supported for server versions prior to 3.4 and will result in an
  exception at execution time if used.
111
...