Class: Couchbase::Options::Scan

Inherits:
Base
  • Object
show all
Defined in:
lib/couchbase/options.rb

Overview

Options for Collection#scan

Constant Summary collapse

DEFAULT = 
Scan.new.freeze

Instance Attribute Summary collapse

Attributes inherited from Base

#client_context, #parent_span, #retry_strategy, #timeout

Instance Method Summary collapse

Constructor Details

#initialize(ids_only: false, transcoder: JsonTranscoder.new, mutation_state: nil, batch_byte_limit: nil, batch_item_limit: nil, concurrency: nil, timeout: nil, retry_strategy: nil, client_context: nil, parent_span: nil) {|self| ... } ⇒ Scan

Creates an instance of options for Collection#scan

Parameters:

  • ids_only (Boolean) (defaults to: false) —

    if set to true, the content of the documents is not included in the results

  • transcoder (JsonTranscoder, #decode(String)) (defaults to: JsonTranscoder.new) —

    used for decoding

  • mutation_state (MutationState, nil) (defaults to: nil) —

    sets the mutation tokens this scan should be consistent with

  • batch_byte_limit (Integer, nil) (defaults to: nil) —

    allows to limit the maximum amount of bytes that are sent from the server to the client on each partition batch, defaults to 15,000

  • batch_item_limit (Integer, nil) (defaults to: nil) —

    allows to limit the maximum amount of items that are sent from the server to the client on each partition batch, defaults to 50

  • concurrency (Integer, nil) (defaults to: nil) —

    specifies the maximum number of partitions that can be scanned concurrently, defaults to 1

  • timeout (Integer, #in_milliseconds, nil) (defaults to: nil)
  • retry_strategy (Proc, nil) (defaults to: nil) —

    the custom retry strategy, if set

  • client_context (Hash, nil) (defaults to: nil) —

    the client context data, if set

  • parent_span (Span, nil) (defaults to: nil) —

    if set holds the parent span, that should be used for this request

Yield Parameters:

[View source]

1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
 
# File 'lib/couchbase/options.rb', line 1161

def initialize(ids_only: false,
               transcoder: JsonTranscoder.new,
               mutation_state: nil,
               batch_byte_limit: nil,
               batch_item_limit: nil,
               concurrency: nil,
               timeout: nil,
               retry_strategy: nil,
               client_context: nil,
               parent_span: nil)
  super(timeout: timeout, retry_strategy: retry_strategy, client_context: client_context, parent_span: parent_span)
  @ids_only = ids_only
  @transcoder = transcoder
  @mutation_state = mutation_state
  @batch_byte_limit = batch_byte_limit
  @batch_item_limit = batch_item_limit
  @concurrency = concurrency
  yield self if block_given?
end

Instance Attribute Details

#batch_byte_limit ⇒ Integer?

Returns:

  • (Integer, nil) 

1139
1140
1141
 
# File 'lib/couchbase/options.rb', line 1139

def batch_byte_limit
  @batch_byte_limit
end

#batch_item_limit ⇒ Integer?

Returns:

  • (Integer, nil) 

1140
1141
1142
 
# File 'lib/couchbase/options.rb', line 1140

def batch_item_limit
  @batch_item_limit
end

#concurrency ⇒ Integer?

Returns:

  • (Integer, nil) 

1141
1142
1143
 
# File 'lib/couchbase/options.rb', line 1141

def concurrency
  @concurrency
end

#ids_only ⇒ Boolean

Returns:

  • (Boolean) 

1136
1137
1138
 
# File 'lib/couchbase/options.rb', line 1136

def ids_only
  @ids_only
end

#mutation_state ⇒ MutationState?

Returns:


1138
1139
1140
 
# File 'lib/couchbase/options.rb', line 1138

def mutation_state
  @mutation_state
end

#transcoder ⇒ JsonTranscoder, #decode(String)

Returns:


1137
1138
1139
 
# File 'lib/couchbase/options.rb', line 1137

def transcoder
  @transcoder
end

Instance Method Details

#consistent_with(mutation_state) ⇒ Object

Note:

overrides consistency level set by #scan_consistency=

Sets the mutation tokens this query should be consistent with

Parameters:

  • mutation_state (MutationState) —

    the mutation state containing the mutation tokens

[View source]

1186
1187
1188
 
# File 'lib/couchbase/options.rb', line 1186

def consistent_with(mutation_state)
  @mutation_state = mutation_state
end