クラス QueryOptions.QueryOptionsBuilder

メソッドの詳細

• consistencyLevel

  public QueryOptions.QueryOptionsBuilder consistencyLevel(com.datastax.oss.driver.api.core.ConsistencyLevel consistencyLevel)

  使用する ConsistencyLevel を設定します。

  パラメーター:

  consistencyLevel - null であってはなりません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

• executionProfile

  public QueryOptions.QueryOptionsBuilder executionProfile(StringSE profileName)

  使用する execution profile を設定します。

  パラメーター:

  profileName - null または空であってはなりません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  導入:

  3.0

  関連事項:

  • Statement.setExecutionProfileName(String)

• executionProfile

  public QueryOptions.QueryOptionsBuilder executionProfile(ExecutionProfileResolver executionProfileResolver)

  使用する ExecutionProfileResolver を設定します。

  パラメーター:

  executionProfileResolver - null であってはなりません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  関連事項:

  • Statement.setExecutionProfile(DriverExecutionProfile)

• fetchSize

  @DeprecatedSE public QueryOptions.QueryOptionsBuilder fetchSize(int fetchSize)

  使用すべきではありません。

  3.0 以降、pageSize(int) を使用します。

  ResultSet チャンクのクエリフェッチサイズを設定します。

  フェッチサイズは、同時に取得される結果行の数を制御します (大きな結果を生成するクエリでメモリに過剰な結果をロードしないようにすることが目的です)。1 という低い値も使用できますが、実際にはパフォーマンスが非常に低下するため、このような低い値を使用することは * 強く * お勧めしません。

  パラメーター:

  fetchSize - チャンクリクエストごとにフェッチする行数。結果セットのチャンクを無効にするには、fetchSize == Integer.MAX_VALUE を使用します。負の値は許可されません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

• idempotent

  public QueryOptions.QueryOptionsBuilder idempotent(boolean idempotent)

  クエリ実行の冪等性を設定します。

  パラメーター:

  idempotent - クエリをべき等としてマークするには true にします。

  戻り値:

  this QueryOptions.QueryOptionsBuilder。

  導入:

  3.4

• keyspace

  public QueryOptions.QueryOptionsBuilder keyspace(com.datastax.oss.driver.api.core.CqlIdentifier keyspace)

  使用する keyspace を設定します。未設定のままにすると、ステートメントに設定されたキースペースまたは CqlSession が使用されます。

  パラメーター:

  keyspace - ステートメントを実行するために使用する特定のキースペースは null であってはなりません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder。

  導入:

  3.1

• pageSize

  public QueryOptions.QueryOptionsBuilder pageSize(int pageSize)

  ResultSet チャンクのクエリフェッチサイズを設定します。

  フェッチサイズは、同時に取得される結果行の数を制御します (大きな結果を生成するクエリでメモリに多くの結果がロードされないようにすることが目的です)。1 という低い値も使用できますが、実際にはパフォーマンスが非常に低下するため、このような低い値を使用することは強くお勧めしません。

  パラメーター:

  pageSize - チャンクリクエストごとにフェッチする行数。結果セットのチャンクを無効にするには、pageSize == Integer.MAX_VALUE を使用します。負の値は許可されません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

• readTimeout

  @DeprecatedSE public QueryOptions.QueryOptionsBuilder readTimeout(long readTimeout)

  使用すべきではありません。

  3.0 以降、timeout(Duration) を使用

  読み取りタイムアウトをミリ秒単位で設定します。デフォルトのホストごとの読み取りタイムアウトを上書きします。

  パラメーター:

  readTimeout - 読み取りタイムアウト（ミリ秒単位）。負の値は許可されません。0 の場合、このステートメントの読み取りタイムアウトは無効になります。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  関連事項:

  • Statement.setTimeout(Duration)

• readTimeout

  @DeprecatedSE public QueryOptions.QueryOptionsBuilder readTimeout(long readTimeout, TimeUnitSE timeUnit)

  使用すべきではありません。

  2.0 以降、timeout(Duration) を使用します。

  読み取りタイムアウトを設定します。デフォルトのホストごとの読み取りタイムアウトを上書きします。

  パラメーター:

  readTimeout - 読み取りタイムアウト値。負の値は許可されません。0 の場合、このステートメントの読み取りタイムアウトは無効になります。

  timeUnit - 指定されたタイムアウトの TimeUnitSE。null にすることはできません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  関連事項:

  • Statement.setTimeout(Duration)

• readTimeout

  @DeprecatedSE public QueryOptions.QueryOptionsBuilder readTimeout(DurationSE readTimeout)

  使用すべきではありません。

  3.0 以降、timeout(Duration) を使用

  読み取りタイムアウトを設定します。デフォルトのホストごとの読み取りタイムアウトを上書きします。

  パラメーター:

  readTimeout - 読み取りタイムアウト。負の値は許可されません。0 の場合、このステートメントの読み取りタイムアウトは無効になります。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  導入:

  2.0

  関連事項:

  • Statement.setTimeout(Duration)

• routingKeyspace

  public QueryOptions.QueryOptionsBuilder routingKeyspace(com.datastax.oss.driver.api.core.CqlIdentifier routingKeyspace)

  クエリルーティングキースペースを設定します。

  パラメーター:

  routingKeyspace - トークン対応ルーティングに使用するルーティングキースペース。

  戻り値:

  this QueryOptions.QueryOptionsBuilder。

  導入:

  3.4

• routingKey

  public QueryOptions.QueryOptionsBuilder routingKey(ByteBufferSE routingKey)

  クエリルーティングキーを設定します。

  パラメーター:

  routingKey - トークン対応ルーティングに使用するルーティングキー。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  導入:

  3.4

• serialConsistencyLevel

  public QueryOptions.QueryOptionsBuilder serialConsistencyLevel(com.datastax.oss.driver.api.core.ConsistencyLevel consistencyLevel)

  使用するシリアル ConsistencyLevel を設定します。

  パラメーター:

  consistencyLevel - null であってはなりません。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

• timeout

  public QueryOptions.QueryOptionsBuilder timeout(DurationSE timeout)

  リクエストのタイムアウトを設定します。デフォルトのタイムアウトを上書きします。

  パラメーター:

  timeout - 読み取りタイムアウト。負の値は許可されません。0 の場合、このステートメントの読み取りタイムアウトは無効になります。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

  導入:

  3.0

  関連事項:

  • Statement.setTimeout(Duration)

• tracing

  public QueryOptions.QueryOptionsBuilder tracing(boolean tracing)

  ステートメントのトレースを有効にします。

  パラメーター:

  tracing - 実行されたステートメントへのステートメントトレースを有効にするには true にします。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

• withTracing

  public QueryOptions.QueryOptionsBuilder withTracing()

  ステートメントのトレースを有効にします。

  戻り値:

  this QueryOptions.QueryOptionsBuilder

• build

  public QueryOptions build()

  設定された値で新しい QueryOptions を構築します。

  戻り値:

  設定された値を持つ新しい QueryOptions