/* * 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 . */ #pragma once #include #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 state; const std::experimental::optional serial_consistency; const api::timestamp_type timestamp; }; private: const db::consistency_level _consistency; const std::experimental::optional> _names; std::vector _values; std::vector _value_views; mutable std::vector> _temporaries; const bool _skip_metadata; const specific_options _options; cql_serialization_format _cql_serialization_format; std::experimental::optional> _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 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 values_ranges); public: query_options(query_options&&) = default; query_options(const query_options&) = delete; explicit query_options(db::consistency_level consistency, std::experimental::optional> names, std::vector values, bool skip_metadata, specific_options options, cql_serialization_format sf); explicit query_options(db::consistency_level consistency, std::experimental::optional> names, std::vector values, std::vector value_views, bool skip_metadata, specific_options options, cql_serialization_format sf); explicit query_options(db::consistency_level consistency, std::experimental::optional> names, std::vector 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 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 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 values); explicit query_options(db::consistency_level, std::vector values, specific_options options = specific_options::DEFAULT); explicit query_options(std::unique_ptr, ::shared_ptr paging_state); 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 get_paging_state() const; /** Serial consistency for conditional updates. */ std::experimental::optional 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>& specs); private: void fill_value_views(); }; template 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 values_ranges) : query_options(std::move(o)) { std::vector 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); } }