189 lines
7.9 KiB
C++
189 lines
7.9 KiB
C++
/*
|
|
* Licensed to the Apache Software Foundation (ASF) under one
|
|
* or more contributor license agreements. See the NOTICE file
|
|
* distributed with this work for additional information
|
|
* regarding copyright ownership. The ASF licenses this file
|
|
* to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2014 ScyllaDB
|
|
*
|
|
* Modified by ScyllaDB
|
|
*/
|
|
|
|
/*
|
|
* This file is part of Scylla.
|
|
*
|
|
* Scylla is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* Scylla is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with Scylla. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <seastar/util/gcc6-concepts.hh>
|
|
#include "timestamp.hh"
|
|
#include "bytes.hh"
|
|
#include "db/consistency_level.hh"
|
|
#include "service/query_state.hh"
|
|
#include "service/pager/paging_state.hh"
|
|
#include "cql3/column_specification.hh"
|
|
#include "cql3/column_identifier.hh"
|
|
#include "cql3/values.hh"
|
|
#include "cql_serialization_format.hh"
|
|
|
|
namespace cql3 {
|
|
|
|
/**
|
|
* Options for a query.
|
|
*/
|
|
class query_options {
|
|
public:
|
|
// Options that are likely to not be present in most queries
|
|
struct specific_options final {
|
|
static thread_local const specific_options DEFAULT;
|
|
|
|
const int32_t page_size;
|
|
const ::shared_ptr<service::pager::paging_state> state;
|
|
const std::experimental::optional<db::consistency_level> serial_consistency;
|
|
const api::timestamp_type timestamp;
|
|
};
|
|
private:
|
|
const db::consistency_level _consistency;
|
|
const std::experimental::optional<std::vector<sstring_view>> _names;
|
|
std::vector<cql3::raw_value> _values;
|
|
std::vector<cql3::raw_value_view> _value_views;
|
|
mutable std::vector<std::vector<int8_t>> _temporaries;
|
|
const bool _skip_metadata;
|
|
const specific_options _options;
|
|
cql_serialization_format _cql_serialization_format;
|
|
std::experimental::optional<std::vector<query_options>> _batch_options;
|
|
|
|
private:
|
|
/**
|
|
* @brief Batch query_options constructor.
|
|
*
|
|
* Requirements:
|
|
* - @tparam OneMutationDataRange has a begin() and end() iterators.
|
|
* - The values of @tparam OneMutationDataRange are of either raw_value_view or raw_value types.
|
|
*
|
|
* @param o Base query_options object. query_options objects for each statement in the batch will derive the values from it.
|
|
* @param values_ranges a vector of values ranges for each statement in the batch.
|
|
*/
|
|
template<typename OneMutationDataRange>
|
|
GCC6_CONCEPT( requires requires (OneMutationDataRange range) {
|
|
std::begin(range);
|
|
std::end(range);
|
|
} && ( requires (OneMutationDataRange range) { { *range.begin() } -> raw_value_view; } ||
|
|
requires (OneMutationDataRange range) { { *range.begin() } -> raw_value; } ) )
|
|
explicit query_options(query_options&& o, std::vector<OneMutationDataRange> values_ranges);
|
|
|
|
public:
|
|
query_options(query_options&&) = default;
|
|
query_options(const query_options&) = delete;
|
|
|
|
explicit query_options(db::consistency_level consistency,
|
|
std::experimental::optional<std::vector<sstring_view>> names,
|
|
std::vector<cql3::raw_value> values,
|
|
bool skip_metadata,
|
|
specific_options options,
|
|
cql_serialization_format sf);
|
|
explicit query_options(db::consistency_level consistency,
|
|
std::experimental::optional<std::vector<sstring_view>> names,
|
|
std::vector<cql3::raw_value_view> value_views,
|
|
bool skip_metadata,
|
|
specific_options options,
|
|
cql_serialization_format sf);
|
|
|
|
/**
|
|
* @brief Batch query_options factory.
|
|
*
|
|
* Requirements:
|
|
* - @tparam OneMutationDataRange has a begin() and end() iterators.
|
|
* - The values of @tparam OneMutationDataRange are of either raw_value_view or raw_value types.
|
|
*
|
|
* @param o Base query_options object. query_options objects for each statement in the batch will derive the values from it.
|
|
* @param values_ranges a vector of values ranges for each statement in the batch.
|
|
*/
|
|
template<typename OneMutationDataRange>
|
|
GCC6_CONCEPT( requires requires (OneMutationDataRange range) {
|
|
std::begin(range);
|
|
std::end(range);
|
|
} && ( requires (OneMutationDataRange range) { { *range.begin() } -> raw_value_view; } ||
|
|
requires (OneMutationDataRange range) { { *range.begin() } -> raw_value; } ) )
|
|
static query_options make_batch_options(query_options&& o, std::vector<OneMutationDataRange> values_ranges) {
|
|
return query_options(std::move(o), std::move(values_ranges));
|
|
}
|
|
|
|
// It can't be const because of prepare()
|
|
static thread_local query_options DEFAULT;
|
|
|
|
// forInternalUse
|
|
explicit query_options(std::vector<cql3::raw_value> values);
|
|
explicit query_options(db::consistency_level, std::vector<cql3::raw_value> values);
|
|
|
|
db::consistency_level get_consistency() const;
|
|
cql3::raw_value_view get_value_at(size_t idx) const;
|
|
cql3::raw_value_view make_temporary(cql3::raw_value value) const;
|
|
size_t get_values_count() const;
|
|
bool skip_metadata() const;
|
|
/** The pageSize for this query. Will be <= 0 if not relevant for the query. */
|
|
int32_t get_page_size() const;
|
|
/** The paging state for this query, or null if not relevant. */
|
|
::shared_ptr<service::pager::paging_state> get_paging_state() const;
|
|
/** Serial consistency for conditional updates. */
|
|
std::experimental::optional<db::consistency_level> get_serial_consistency() const;
|
|
api::timestamp_type get_timestamp(service::query_state& state) const;
|
|
/**
|
|
* The protocol version for the query. Will be 3 if the object don't come from
|
|
* a native protocol request (i.e. it's been allocated locally or by CQL-over-thrift).
|
|
*/
|
|
int get_protocol_version() const;
|
|
cql_serialization_format get_cql_serialization_format() const;
|
|
// Mainly for the sake of BatchQueryOptions
|
|
const specific_options& get_specific_options() const;
|
|
const query_options& for_statement(size_t i) const;
|
|
void prepare(const std::vector<::shared_ptr<column_specification>>& specs);
|
|
private:
|
|
void fill_value_views();
|
|
};
|
|
|
|
template<typename OneMutationDataRange>
|
|
GCC6_CONCEPT( requires requires (OneMutationDataRange range) {
|
|
std::begin(range);
|
|
std::end(range);
|
|
} && ( requires (OneMutationDataRange range) { { *range.begin() } -> raw_value_view; } ||
|
|
requires (OneMutationDataRange range) { { *range.begin() } -> raw_value; } ) )
|
|
query_options::query_options(query_options&& o, std::vector<OneMutationDataRange> values_ranges)
|
|
: query_options(std::move(o))
|
|
{
|
|
std::vector<query_options> tmp;
|
|
tmp.reserve(values_ranges.size());
|
|
std::transform(values_ranges.begin(), values_ranges.end(), std::back_inserter(tmp), [this](auto& values_range) {
|
|
return query_options(_consistency, {}, std::move(values_range), _skip_metadata, _options, _cql_serialization_format);
|
|
});
|
|
_batch_options = std::move(tmp);
|
|
}
|
|
|
|
}
|