#include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace ProfileEvents { extern const Event EngineFileLikeReadFiles; } namespace DB { namespace ErrorCodes { extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH; extern const int NETWORK_ERROR; extern const int BAD_ARGUMENTS; extern const int CANNOT_EXTRACT_TABLE_STRUCTURE; } static constexpr auto bad_arguments_error_message = "Storage URL requires 1-4 arguments: " "url, name of used format (taken from file extension by default), " "optional compression method, optional headers (specified as `headers('name'='value', 'name2'='value2')`)"; static const std::unordered_set required_configuration_keys = { "url", }; static const std::unordered_set optional_configuration_keys = { "format", "compression", "compression_method", "structure", "filename", "method", "http_method", "description", "headers.header.name", "headers.header.value", }; /// Headers in config file will have structure "headers.header.name" and "headers.header.value". /// But Poco::AbstractConfiguration converts them into "header", "header[1]", "header[2]". static const std::vector optional_regex_keys = { std::regex(R"(headers.header\[[\d]*\].name)"), std::regex(R"(headers.header\[[\d]*\].value)"), }; static bool urlWithGlobs(const String & uri) { return (uri.find('{') != std::string::npos && uri.find('}') != std::string::npos) || uri.find('|') != std::string::npos; } static ConnectionTimeouts getHTTPTimeouts(ContextPtr context) { return ConnectionTimeouts::getHTTPTimeouts(context->getSettingsRef(), {context->getConfigRef().getUInt("keep_alive_timeout", DEFAULT_HTTP_KEEP_ALIVE_TIMEOUT), 0}); } IStorageURLBase::IStorageURLBase( const String & uri_, ContextPtr context_, const StorageID & table_id_, const String & format_name_, const std::optional & format_settings_, const ColumnsDescription & columns_, const ConstraintsDescription & constraints_, const String & comment, const String & compression_method_, const HTTPHeaderEntries & headers_, const String & http_method_, ASTPtr partition_by_, bool distributed_processing_) : IStorage(table_id_) , uri(uri_) , compression_method(chooseCompressionMethod(Poco::URI(uri_).getPath(), compression_method_)) , format_name(format_name_) , format_settings(format_settings_) , headers(headers_) , http_method(http_method_) , partition_by(partition_by_) , distributed_processing(distributed_processing_) { FormatFactory::instance().checkFormatName(format_name); StorageInMemoryMetadata storage_metadata; if (columns_.empty()) { auto columns = getTableStructureFromData(format_name, uri, compression_method, headers, format_settings, context_); storage_metadata.setColumns(columns); } else { /// We don't allow special columns in URL storage. if (!columns_.hasOnlyOrdinary()) throw Exception(ErrorCodes::BAD_ARGUMENTS, "Table engine URL doesn't support special columns like MATERIALIZED, ALIAS or EPHEMERAL"); storage_metadata.setColumns(columns_); } storage_metadata.setConstraints(constraints_); storage_metadata.setComment(comment); setInMemoryMetadata(storage_metadata); virtual_columns = VirtualColumnUtils::getPathAndFileVirtualsForStorage(storage_metadata.getSampleBlock().getNamesAndTypesList()); } namespace { HTTPHeaderEntries getHeaders(const HTTPHeaderEntries & headers_) { HTTPHeaderEntries headers(headers_.begin(), headers_.end()); // Propagate OpenTelemetry trace context, if any, downstream. const auto & current_trace_context = OpenTelemetry::CurrentContext(); if (current_trace_context.isTraceEnabled()) { headers.emplace_back("traceparent", current_trace_context.composeTraceparentHeader()); if (!current_trace_context.tracestate.empty()) { headers.emplace_back("tracestate", current_trace_context.tracestate); } } return headers; } StorageURLSource::FailoverOptions getFailoverOptions(const String & uri, size_t max_addresses) { return parseRemoteDescription(uri, 0, uri.size(), '|', max_addresses); } auto getProxyConfiguration(const std::string & protocol_string) { auto protocol = protocol_string == "https" ? ProxyConfigurationResolver::Protocol::HTTPS : ProxyConfigurationResolver::Protocol::HTTP; return ProxyConfigurationResolverProvider::get(protocol, Context::getGlobalContextInstance()->getConfigRef())->resolve(); } } class StorageURLSource::DisclosedGlobIterator::Impl { public: Impl(const String & uri_, size_t max_addresses, const ASTPtr & query, const NamesAndTypesList & virtual_columns, const ContextPtr & context) { uris = parseRemoteDescription(uri_, 0, uri_.size(), ',', max_addresses); ASTPtr filter_ast; if (!uris.empty()) filter_ast = VirtualColumnUtils::createPathAndFileFilterAst(query, virtual_columns, Poco::URI(uris[0]).getPath(), context); if (filter_ast) { std::vector paths; paths.reserve(uris.size()); for (const auto & uri : uris) paths.push_back(Poco::URI(uri).getPath()); VirtualColumnUtils::filterByPathOrFile(uris, paths, query, virtual_columns, context, filter_ast); } } String next() { size_t current_index = index.fetch_add(1, std::memory_order_relaxed); if (current_index >= uris.size()) return {}; return uris[current_index]; } size_t size() { return uris.size(); } private: Strings uris; std::atomic_size_t index = 0; }; StorageURLSource::DisclosedGlobIterator::DisclosedGlobIterator(const String & uri, size_t max_addresses, const ASTPtr & query, const NamesAndTypesList & virtual_columns, const ContextPtr & context) : pimpl(std::make_shared(uri, max_addresses, query, virtual_columns, context)) {} String StorageURLSource::DisclosedGlobIterator::next() { return pimpl->next(); } size_t StorageURLSource::DisclosedGlobIterator::size() { return pimpl->size(); } void StorageURLSource::setCredentials(Poco::Net::HTTPBasicCredentials & credentials, const Poco::URI & request_uri) { const auto & user_info = request_uri.getUserInfo(); if (!user_info.empty()) { std::size_t n = user_info.find(':'); if (n != std::string::npos) { credentials.setUsername(user_info.substr(0, n)); credentials.setPassword(user_info.substr(n + 1)); } } } StorageURLSource::StorageURLSource( const ReadFromFormatInfo & info, std::shared_ptr uri_iterator_, const std::string & http_method, std::function callback, const String & format_, const std::optional & format_settings_, String name_, ContextPtr context_, UInt64 max_block_size, const ConnectionTimeouts & timeouts, CompressionMethod compression_method, size_t max_parsing_threads, const SelectQueryInfo &, const HTTPHeaderEntries & headers_, const URIParams & params, bool glob_url, bool need_only_count_) : SourceWithKeyCondition(info.source_header, false), WithContext(context_) , name(std::move(name_)) , columns_description(info.columns_description) , requested_columns(info.requested_columns) , requested_virtual_columns(info.requested_virtual_columns) , block_for_format(info.format_header) , uri_iterator(uri_iterator_) , format(format_) , format_settings(format_settings_) , headers(getHeaders(headers_)) , need_only_count(need_only_count_) { /// Lazy initialization. We should not perform requests in constructor, because we need to do it in query pipeline. initialize = [=, this]() { std::vector current_uri_options; std::pair> uri_and_buf; do { current_uri_options = (*uri_iterator)(); if (current_uri_options.empty()) return false; auto first_option = current_uri_options.cbegin(); uri_and_buf = getFirstAvailableURIAndReadBuffer( first_option, current_uri_options.end(), getContext(), params, http_method, callback, timeouts, credentials, headers, glob_url, current_uri_options.size() == 1); /// If file is empty and engine_url_skip_empty_files=1, skip it and go to the next file. } while (getContext()->getSettingsRef().engine_url_skip_empty_files && uri_and_buf.second->eof()); curr_uri = uri_and_buf.first; auto last_mod_time = uri_and_buf.second->tryGetLastModificationTime(); read_buf = std::move(uri_and_buf.second); if (auto file_progress_callback = getContext()->getFileProgressCallback()) { size_t file_size = tryGetFileSizeFromReadBuffer(*read_buf).value_or(0); file_progress_callback(FileProgress(0, file_size)); } QueryPipelineBuilder builder; std::optional num_rows_from_cache = std::nullopt; if (need_only_count && getContext()->getSettingsRef().use_cache_for_count_from_files) num_rows_from_cache = tryGetNumRowsFromCache(curr_uri.toString(), last_mod_time); if (num_rows_from_cache) { /// We should not return single chunk with all number of rows, /// because there is a chance that this chunk will be materialized later /// (it can cause memory problems even with default values in columns or when virtual columns are requested). /// Instead, we use special ConstChunkGenerator that will generate chunks /// with max_block_size rows until total number of rows is reached. auto source = std::make_shared(block_for_format, *num_rows_from_cache, max_block_size); builder.init(Pipe(source)); } else { // TODO: Pass max_parsing_threads and max_download_threads adjusted for num_streams. input_format = FormatFactory::instance().getInput( format, *read_buf, block_for_format, getContext(), max_block_size, format_settings, max_parsing_threads, /*max_download_threads*/ std::nullopt, /* is_remote_ fs */ true, compression_method, need_only_count); if (key_condition) input_format->setKeyCondition(key_condition); if (need_only_count) input_format->needOnlyCount(); builder.init(Pipe(input_format)); if (columns_description.hasDefaults()) { builder.addSimpleTransform([&](const Block & cur_header) { return std::make_shared(cur_header, columns_description, *input_format, getContext()); }); } } /// Add ExtractColumnsTransform to extract requested columns/subcolumns /// from chunk read by IInputFormat. builder.addSimpleTransform([&](const Block & header) { return std::make_shared(header, requested_columns); }); pipeline = std::make_unique(QueryPipelineBuilder::getPipeline(std::move(builder))); reader = std::make_unique(*pipeline); ProfileEvents::increment(ProfileEvents::EngineFileLikeReadFiles); return true; }; } Chunk StorageURLSource::generate() { while (true) { if (isCancelled()) { if (reader) reader->cancel(); break; } if (!reader && !initialize()) return {}; Chunk chunk; if (reader->pull(chunk)) { UInt64 num_rows = chunk.getNumRows(); total_rows_in_file += num_rows; size_t chunk_size = 0; if (input_format) chunk_size = input_format->getApproxBytesReadForChunk(); progress(num_rows, chunk_size ? chunk_size : chunk.bytes()); VirtualColumnUtils::addRequestedPathAndFileVirtualsToChunk(chunk, requested_virtual_columns, curr_uri.getPath()); return chunk; } if (input_format && getContext()->getSettingsRef().use_cache_for_count_from_files) addNumRowsToCache(curr_uri.toString(), total_rows_in_file); pipeline->reset(); reader.reset(); input_format.reset(); read_buf.reset(); total_rows_in_file = 0; } return {}; } std::pair> StorageURLSource::getFirstAvailableURIAndReadBuffer( std::vector::const_iterator & option, const std::vector::const_iterator & end, ContextPtr context_, const URIParams & params, const String & http_method, std::function callback, const ConnectionTimeouts & timeouts, Poco::Net::HTTPBasicCredentials & credentials, const HTTPHeaderEntries & headers, bool glob_url, bool delay_initialization) { String first_exception_message; ReadSettings read_settings = context_->getReadSettings(); size_t options = std::distance(option, end); std::pair> last_skipped_empty_res; for (; option != end; ++option) { bool skip_url_not_found_error = glob_url && read_settings.http_skip_not_found_url_for_globs && option == std::prev(end); auto request_uri = Poco::URI(*option, context_->getSettingsRef().enable_url_encoding); for (const auto & [param, value] : params) request_uri.addQueryParameter(param, value); setCredentials(credentials, request_uri); const auto settings = context_->getSettings(); auto proxy_config = getProxyConfiguration(http_method); try { auto res = std::make_unique( request_uri, http_method, callback, timeouts, credentials, settings.max_http_get_redirects, settings.max_read_buffer_size, read_settings, headers, &context_->getRemoteHostFilter(), delay_initialization, /* use_external_buffer */ false, /* skip_url_not_found_error */ skip_url_not_found_error, /* file_info */ std::nullopt, proxy_config); if (context_->getSettingsRef().engine_url_skip_empty_files && res->eof() && option != std::prev(end)) { last_skipped_empty_res = {request_uri, std::move(res)}; continue; } return std::make_tuple(request_uri, std::move(res)); } catch (...) { if (options == 1) throw; if (first_exception_message.empty()) first_exception_message = getCurrentExceptionMessage(false); tryLogCurrentException(__PRETTY_FUNCTION__); continue; } } /// If all options are unreachable except empty ones that we skipped, /// return last empty result. It will be skipped later. if (last_skipped_empty_res.second) return last_skipped_empty_res; throw Exception(ErrorCodes::NETWORK_ERROR, "All uri ({}) options are unreachable: {}", options, first_exception_message); } void StorageURLSource::addNumRowsToCache(const DB::String & uri, size_t num_rows) { auto cache_key = getKeyForSchemaCache(uri, format, format_settings, getContext()); StorageURL::getSchemaCache(getContext()).addNumRows(cache_key, num_rows); } std::optional StorageURLSource::tryGetNumRowsFromCache(const DB::String & uri, std::optional last_mod_time) { auto cache_key = getKeyForSchemaCache(uri, format, format_settings, getContext()); auto get_last_mod_time = [&]() -> std::optional { /// Some URLs could not have Last-Modified header, in this case we cannot be sure that /// data wasn't changed after adding it's schema to cache. Use schema from cache only if /// special setting for this case is enabled. if (!last_mod_time && !getContext()->getSettingsRef().schema_inference_cache_require_modification_time_for_url) return 0; return last_mod_time; }; return StorageURL::getSchemaCache(getContext()).tryGetNumRows(cache_key, get_last_mod_time); } StorageURLSink::StorageURLSink( const String & uri, const String & format, const std::optional & format_settings, const Block & sample_block, ContextPtr context, const ConnectionTimeouts & timeouts, const CompressionMethod compression_method, const HTTPHeaderEntries & headers, const String & http_method) : SinkToStorage(sample_block) { std::string content_type = FormatFactory::instance().getContentType(format, context, format_settings); std::string content_encoding = toContentEncodingName(compression_method); auto proxy_config = getProxyConfiguration(http_method); auto write_buffer = std::make_unique( Poco::URI(uri), http_method, content_type, content_encoding, headers, timeouts, DBMS_DEFAULT_BUFFER_SIZE, proxy_config ); write_buf = wrapWriteBufferWithCompressionMethod( std::move(write_buffer), compression_method, 3 ); writer = FormatFactory::instance().getOutputFormat(format, *write_buf, sample_block, context, format_settings); } void StorageURLSink::consume(Chunk chunk) { std::lock_guard lock(cancel_mutex); if (cancelled) return; writer->write(getHeader().cloneWithColumns(chunk.detachColumns())); } void StorageURLSink::onCancel() { std::lock_guard lock(cancel_mutex); finalize(); cancelled = true; } void StorageURLSink::onException(std::exception_ptr exception) { std::lock_guard lock(cancel_mutex); try { std::rethrow_exception(exception); } catch (...) { /// An exception context is needed to proper delete write buffers without finalization release(); } } void StorageURLSink::onFinish() { std::lock_guard lock(cancel_mutex); finalize(); } void StorageURLSink::finalize() { if (!writer) return; try { writer->finalize(); writer->flush(); write_buf->finalize(); } catch (...) { /// Stop ParallelFormattingOutputFormat correctly. release(); throw; } } void StorageURLSink::release() { writer.reset(); write_buf->finalize(); } class PartitionedStorageURLSink : public PartitionedSink { public: PartitionedStorageURLSink( const ASTPtr & partition_by, const String & uri_, const String & format_, const std::optional & format_settings_, const Block & sample_block_, ContextPtr context_, const ConnectionTimeouts & timeouts_, const CompressionMethod compression_method_, const HTTPHeaderEntries & headers_, const String & http_method_) : PartitionedSink(partition_by, context_, sample_block_) , uri(uri_) , format(format_) , format_settings(format_settings_) , sample_block(sample_block_) , context(context_) , timeouts(timeouts_) , compression_method(compression_method_) , headers(headers_) , http_method(http_method_) { } SinkPtr createSinkForPartition(const String & partition_id) override { auto partition_path = PartitionedSink::replaceWildcards(uri, partition_id); context->getRemoteHostFilter().checkURL(Poco::URI(partition_path)); return std::make_shared( partition_path, format, format_settings, sample_block, context, timeouts, compression_method, headers, http_method); } private: const String uri; const String format; const std::optional format_settings; const Block sample_block; ContextPtr context; const ConnectionTimeouts timeouts; const CompressionMethod compression_method; const HTTPHeaderEntries headers; const String http_method; }; std::string IStorageURLBase::getReadMethod() const { return Poco::Net::HTTPRequest::HTTP_GET; } std::vector> IStorageURLBase::getReadURIParams( const Names & /*column_names*/, const StorageSnapshotPtr & /*storage_snapshot*/, const SelectQueryInfo & /*query_info*/, ContextPtr /*context*/, QueryProcessingStage::Enum & /*processed_stage*/, size_t /*max_block_size*/) const { return {}; } std::function IStorageURLBase::getReadPOSTDataCallback( const Names & /*column_names*/, const ColumnsDescription & /* columns_description */, const SelectQueryInfo & /*query_info*/, ContextPtr /*context*/, QueryProcessingStage::Enum & /*processed_stage*/, size_t /*max_block_size*/) const { return nullptr; } namespace { class ReadBufferIterator : public IReadBufferIterator, WithContext { public: ReadBufferIterator( const std::vector & urls_to_check_, const String & format_, const CompressionMethod & compression_method_, const HTTPHeaderEntries & headers_, const std::optional & format_settings_, const ContextPtr & context_) : WithContext(context_), urls_to_check(urls_to_check_), format(format_), compression_method(compression_method_), headers(headers_), format_settings(format_settings_) { it = urls_to_check.cbegin(); } std::unique_ptr next() override { std::pair> uri_and_buf; do { if (it == urls_to_check.cend()) { if (first) throw Exception( ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE, "Cannot extract table structure from {} format file, because all files are empty. " "You must specify table structure manually", format); return nullptr; } uri_and_buf = StorageURLSource::getFirstAvailableURIAndReadBuffer( it, urls_to_check.cend(), getContext(), {}, Poco::Net::HTTPRequest::HTTP_GET, {}, getHTTPTimeouts(getContext()), credentials, headers, false, false); ++it; } while (getContext()->getSettingsRef().engine_url_skip_empty_files && uri_and_buf.second->eof()); first = false; return wrapReadBufferWithCompressionMethod( std::move(uri_and_buf.second), compression_method, static_cast(getContext()->getSettingsRef().zstd_window_log_max)); } void setNumRowsToLastFile(size_t num_rows) override { if (!getContext()->getSettingsRef().schema_inference_use_cache_for_s3) return; String source = *std::prev(it); auto key = getKeyForSchemaCache(source, format, format_settings, getContext()); StorageURL::getSchemaCache(getContext()).addNumRows(key, num_rows); } private: const std::vector & urls_to_check; std::vector::const_iterator it; const String & format; const CompressionMethod & compression_method; const HTTPHeaderEntries & headers; Poco::Net::HTTPBasicCredentials credentials; const std::optional & format_settings; bool first = true; }; } ColumnsDescription IStorageURLBase::getTableStructureFromData( const String & format, const String & uri, CompressionMethod compression_method, const HTTPHeaderEntries & headers, const std::optional & format_settings, ContextPtr context) { context->getRemoteHostFilter().checkURL(Poco::URI(uri)); Poco::Net::HTTPBasicCredentials credentials; std::vector urls_to_check; if (urlWithGlobs(uri)) { size_t max_addresses = context->getSettingsRef().glob_expansion_max_elements; auto uri_descriptions = parseRemoteDescription(uri, 0, uri.size(), ',', max_addresses, "url"); for (const auto & description : uri_descriptions) { auto options = parseRemoteDescription(description, 0, description.size(), '|', max_addresses, "url"); urls_to_check.insert(urls_to_check.end(), options.begin(), options.end()); } } else { urls_to_check = {uri}; } std::optional columns_from_cache; if (context->getSettingsRef().schema_inference_use_cache_for_url) columns_from_cache = tryGetColumnsFromCache(urls_to_check, headers, credentials, format, format_settings, context); ColumnsDescription columns; if (columns_from_cache) { columns = *columns_from_cache; } else { ReadBufferIterator read_buffer_iterator(urls_to_check, format, compression_method, headers, format_settings, context); columns = readSchemaFromFormat(format, format_settings, read_buffer_iterator, urls_to_check.size() > 1, context); } if (context->getSettingsRef().schema_inference_use_cache_for_url) addColumnsToCache(urls_to_check, columns, format, format_settings, context); return columns; } bool IStorageURLBase::supportsSubsetOfColumns(const ContextPtr & context) const { return FormatFactory::instance().checkIfFormatSupportsSubsetOfColumns(format_name, context, format_settings); } bool IStorageURLBase::prefersLargeBlocks() const { return FormatFactory::instance().checkIfOutputFormatPrefersLargeBlocks(format_name); } bool IStorageURLBase::parallelizeOutputAfterReading(ContextPtr context) const { return FormatFactory::instance().checkParallelizeOutputAfterReading(format_name, context); } Pipe IStorageURLBase::read( const Names & column_names, const StorageSnapshotPtr & storage_snapshot, SelectQueryInfo & query_info, ContextPtr local_context, QueryProcessingStage::Enum processed_stage, size_t max_block_size, size_t num_streams) { auto params = getReadURIParams(column_names, storage_snapshot, query_info, local_context, processed_stage, max_block_size); std::shared_ptr iterator_wrapper{nullptr}; bool is_url_with_globs = urlWithGlobs(uri); size_t max_addresses = local_context->getSettingsRef().glob_expansion_max_elements; auto read_from_format_info = prepareReadingFromFormat(column_names, storage_snapshot, supportsSubsetOfColumns(local_context), getVirtuals()); if (distributed_processing) { iterator_wrapper = std::make_shared( [callback = local_context->getReadTaskCallback(), max_addresses]() { String next_uri = callback(); if (next_uri.empty()) return StorageURLSource::FailoverOptions{}; return getFailoverOptions(next_uri, max_addresses); }); } else if (is_url_with_globs) { /// Iterate through disclosed globs and make a source for each file auto glob_iterator = std::make_shared(uri, max_addresses, query_info.query, virtual_columns, local_context); /// check if we filtered out all the paths if (glob_iterator->size() == 0) return Pipe(std::make_shared(read_from_format_info.source_header)); iterator_wrapper = std::make_shared([glob_iterator, max_addresses]() { String next_uri = glob_iterator->next(); if (next_uri.empty()) return StorageURLSource::FailoverOptions{}; return getFailoverOptions(next_uri, max_addresses); }); if (num_streams > glob_iterator->size()) num_streams = glob_iterator->size(); } else { iterator_wrapper = std::make_shared([&, max_addresses, done = false]() mutable { if (done) return StorageURLSource::FailoverOptions{}; done = true; return getFailoverOptions(uri, max_addresses); }); num_streams = 1; } bool need_only_count = (query_info.optimize_trivial_count || read_from_format_info.requested_columns.empty()) && local_context->getSettingsRef().optimize_count_from_files; Pipes pipes; pipes.reserve(num_streams); const size_t max_threads = local_context->getSettingsRef().max_threads; const size_t max_parsing_threads = num_streams >= max_threads ? 1 : (max_threads / num_streams); for (size_t i = 0; i < num_streams; ++i) { pipes.emplace_back(std::make_shared( read_from_format_info, iterator_wrapper, getReadMethod(), getReadPOSTDataCallback( read_from_format_info.columns_description.getNamesOfPhysical(), read_from_format_info.columns_description, query_info, local_context, processed_stage, max_block_size), format_name, format_settings, getName(), local_context, max_block_size, getHTTPTimeouts(local_context), compression_method, max_parsing_threads, query_info, headers, params, is_url_with_globs, need_only_count)); } return Pipe::unitePipes(std::move(pipes)); } Pipe StorageURLWithFailover::read( const Names & column_names, const StorageSnapshotPtr & storage_snapshot, SelectQueryInfo & query_info, ContextPtr local_context, QueryProcessingStage::Enum processed_stage, size_t max_block_size, size_t num_streams) { auto params = getReadURIParams(column_names, storage_snapshot, query_info, local_context, processed_stage, max_block_size); auto iterator_wrapper = std::make_shared([&, done = false]() mutable { if (done) return StorageURLSource::FailoverOptions{}; done = true; return uri_options; }); auto read_from_format_info = prepareReadingFromFormat(column_names, storage_snapshot, supportsSubsetOfColumns(local_context), getVirtuals()); const size_t max_threads = local_context->getSettingsRef().max_threads; const size_t max_parsing_threads = num_streams >= max_threads ? 1 : (max_threads / num_streams); auto pipe = Pipe(std::make_shared( read_from_format_info, iterator_wrapper, getReadMethod(), getReadPOSTDataCallback(read_from_format_info.columns_description.getNamesOfPhysical(), read_from_format_info.columns_description, query_info, local_context, processed_stage, max_block_size), format_name, format_settings, getName(), local_context, max_block_size, getHTTPTimeouts(local_context), compression_method, max_parsing_threads, query_info, headers, params)); std::shuffle(uri_options.begin(), uri_options.end(), thread_local_rng); return pipe; } SinkToStoragePtr IStorageURLBase::write(const ASTPtr & query, const StorageMetadataPtr & metadata_snapshot, ContextPtr context, bool /*async_insert*/) { if (http_method.empty()) http_method = Poco::Net::HTTPRequest::HTTP_POST; bool has_wildcards = uri.find(PartitionedSink::PARTITION_ID_WILDCARD) != String::npos; const auto * insert_query = dynamic_cast(query.get()); auto partition_by_ast = insert_query ? (insert_query->partition_by ? insert_query->partition_by : partition_by) : nullptr; bool is_partitioned_implementation = partition_by_ast && has_wildcards; if (is_partitioned_implementation) { return std::make_shared( partition_by_ast, uri, format_name, format_settings, metadata_snapshot->getSampleBlock(), context, getHTTPTimeouts(context), compression_method, headers, http_method); } else { return std::make_shared( uri, format_name, format_settings, metadata_snapshot->getSampleBlock(), context, getHTTPTimeouts(context), compression_method, headers, http_method); } } NamesAndTypesList IStorageURLBase::getVirtuals() const { return virtual_columns; } SchemaCache & IStorageURLBase::getSchemaCache(const ContextPtr & context) { static SchemaCache schema_cache(context->getConfigRef().getUInt("schema_inference_cache_max_elements_for_url", DEFAULT_SCHEMA_CACHE_ELEMENTS)); return schema_cache; } std::optional IStorageURLBase::tryGetColumnsFromCache( const Strings & urls, const HTTPHeaderEntries & headers, const Poco::Net::HTTPBasicCredentials & credentials, const String & format_name, const std::optional & format_settings, const ContextPtr & context) { auto & schema_cache = getSchemaCache(context); for (const auto & url : urls) { auto get_last_mod_time = [&]() -> std::optional { auto last_mod_time = tryGetLastModificationTime(url, headers, credentials, context); /// Some URLs could not have Last-Modified header, in this case we cannot be sure that /// data wasn't changed after adding it's schema to cache. Use schema from cache only if /// special setting for this case is enabled. if (!last_mod_time && !context->getSettingsRef().schema_inference_cache_require_modification_time_for_url) return 0; return last_mod_time; }; auto cache_key = getKeyForSchemaCache(url, format_name, format_settings, context); auto columns = schema_cache.tryGetColumns(cache_key, get_last_mod_time); if (columns) return columns; } return std::nullopt; } void IStorageURLBase::addColumnsToCache( const Strings & urls, const ColumnsDescription & columns, const String & format_name, const std::optional & format_settings, const ContextPtr & context) { auto & schema_cache = getSchemaCache(context); auto cache_keys = getKeysForSchemaCache(urls, format_name, format_settings, context); schema_cache.addManyColumns(cache_keys, columns); } std::optional IStorageURLBase::tryGetLastModificationTime( const String & url, const HTTPHeaderEntries & headers, const Poco::Net::HTTPBasicCredentials & credentials, const ContextPtr & context) { auto settings = context->getSettingsRef(); auto uri = Poco::URI(url); auto proxy_config = getProxyConfiguration(uri.getScheme()); ReadWriteBufferFromHTTP buf( uri, Poco::Net::HTTPRequest::HTTP_GET, {}, getHTTPTimeouts(context), credentials, settings.max_http_get_redirects, settings.max_read_buffer_size, context->getReadSettings(), headers, &context->getRemoteHostFilter(), true, false, false, std::nullopt, proxy_config); return buf.tryGetLastModificationTime(); } StorageURL::StorageURL( const String & uri_, const StorageID & table_id_, const String & format_name_, const std::optional & format_settings_, const ColumnsDescription & columns_, const ConstraintsDescription & constraints_, const String & comment, ContextPtr context_, const String & compression_method_, const HTTPHeaderEntries & headers_, const String & http_method_, ASTPtr partition_by_, bool distributed_processing_) : IStorageURLBase( uri_, context_, table_id_, format_name_, format_settings_, columns_, constraints_, comment, compression_method_, headers_, http_method_, partition_by_, distributed_processing_) { context_->getRemoteHostFilter().checkURL(Poco::URI(uri)); context_->getHTTPHeaderFilter().checkHeaders(headers); } StorageURLWithFailover::StorageURLWithFailover( const std::vector & uri_options_, const StorageID & table_id_, const String & format_name_, const std::optional & format_settings_, const ColumnsDescription & columns_, const ConstraintsDescription & constraints_, ContextPtr context_, const String & compression_method_) : StorageURL("", table_id_, format_name_, format_settings_, columns_, constraints_, String{}, context_, compression_method_) { for (const auto & uri_option : uri_options_) { Poco::URI poco_uri(uri_option); context_->getRemoteHostFilter().checkURL(poco_uri); LOG_DEBUG(&Poco::Logger::get("StorageURLDistributed"), "Adding URL option: {}", uri_option); uri_options.emplace_back(uri_option); } } FormatSettings StorageURL::getFormatSettingsFromArgs(const StorageFactory::Arguments & args) { // Use format settings from global server context + settings from // the SETTINGS clause of the create query. Settings from current // session and user are ignored. FormatSettings format_settings; if (args.storage_def->settings) { FormatFactorySettings user_format_settings; // Apply changed settings from global context, but ignore the // unknown ones, because we only have the format settings here. const auto & changes = args.getContext()->getSettingsRef().changes(); for (const auto & change : changes) { if (user_format_settings.has(change.name)) { user_format_settings.set(change.name, change.value); } } // Apply changes from SETTINGS clause, with validation. user_format_settings.applyChanges(args.storage_def->settings->changes); format_settings = getFormatSettings(args.getContext(), user_format_settings); } else { format_settings = getFormatSettings(args.getContext()); } return format_settings; } ASTs::iterator StorageURL::collectHeaders( ASTs & url_function_args, HTTPHeaderEntries & header_entries, ContextPtr context) { ASTs::iterator headers_it = url_function_args.end(); for (auto * arg_it = url_function_args.begin(); arg_it != url_function_args.end(); ++arg_it) { const auto * headers_ast_function = (*arg_it)->as(); if (headers_ast_function && headers_ast_function->name == "headers") { if (headers_it != url_function_args.end()) throw Exception( ErrorCodes::BAD_ARGUMENTS, "URL table function can have only one key-value argument: headers=(). {}", bad_arguments_error_message); const auto * headers_function_args_expr = assert_cast(headers_ast_function->arguments.get()); auto headers_function_args = headers_function_args_expr->children; for (auto & header_arg : headers_function_args) { const auto * header_ast = header_arg->as(); if (!header_ast || header_ast->name != "equals") throw Exception(ErrorCodes::BAD_ARGUMENTS, "Headers argument is incorrect. {}", bad_arguments_error_message); const auto * header_args_expr = assert_cast(header_ast->arguments.get()); auto header_args = header_args_expr->children; if (header_args.size() != 2) throw Exception( ErrorCodes::BAD_ARGUMENTS, "Headers argument is incorrect: expected 2 arguments, got {}", header_args.size()); auto ast_literal = evaluateConstantExpressionOrIdentifierAsLiteral(header_args[0], context); auto arg_name_value = ast_literal->as()->value; if (arg_name_value.getType() != Field::Types::Which::String) throw Exception(ErrorCodes::BAD_ARGUMENTS, "Expected string as header name"); auto arg_name = arg_name_value.safeGet(); ast_literal = evaluateConstantExpressionOrIdentifierAsLiteral(header_args[1], context); auto arg_value = ast_literal->as()->value; if (arg_value.getType() != Field::Types::Which::String) throw Exception(ErrorCodes::BAD_ARGUMENTS, "Expected string as header value"); header_entries.emplace_back(arg_name, arg_value.safeGet()); } headers_it = arg_it; continue; } if (headers_ast_function && headers_ast_function->name == "equals") continue; (*arg_it) = evaluateConstantExpressionOrIdentifierAsLiteral((*arg_it), context); } return headers_it; } void StorageURL::processNamedCollectionResult(Configuration & configuration, const NamedCollection & collection) { validateNamedCollection(collection, required_configuration_keys, optional_configuration_keys, optional_regex_keys); configuration.url = collection.get("url"); configuration.headers = getHeadersFromNamedCollection(collection); configuration.http_method = collection.getOrDefault("http_method", collection.getOrDefault("method", "")); if (!configuration.http_method.empty() && configuration.http_method != Poco::Net::HTTPRequest::HTTP_POST && configuration.http_method != Poco::Net::HTTPRequest::HTTP_PUT) throw Exception( ErrorCodes::BAD_ARGUMENTS, "Http method can be POST or PUT (current: {}). For insert default is POST, for select GET", configuration.http_method); configuration.format = collection.getOrDefault("format", "auto"); configuration.compression_method = collection.getOrDefault("compression_method", collection.getOrDefault("compression", "auto")); configuration.structure = collection.getOrDefault("structure", "auto"); } StorageURL::Configuration StorageURL::getConfiguration(ASTs & args, ContextPtr local_context) { StorageURL::Configuration configuration; if (auto named_collection = tryGetNamedCollectionWithOverrides(args, local_context)) { StorageURL::processNamedCollectionResult(configuration, *named_collection); collectHeaders(args, configuration.headers, local_context); } else { if (args.empty() || args.size() > 3) throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, bad_arguments_error_message); auto * header_it = collectHeaders(args, configuration.headers, local_context); if (header_it != args.end()) args.erase(header_it); configuration.url = checkAndGetLiteralArgument(args[0], "url"); if (args.size() > 1) configuration.format = checkAndGetLiteralArgument(args[1], "format"); if (args.size() == 3) configuration.compression_method = checkAndGetLiteralArgument(args[2], "compression_method"); } if (configuration.format == "auto") configuration.format = FormatFactory::instance().getFormatFromFileName(Poco::URI(configuration.url).getPath(), true); for (const auto & [header, value] : configuration.headers) { if (header == "Range") throw Exception(ErrorCodes::BAD_ARGUMENTS, "Range headers are not allowed"); } return configuration; } void registerStorageURL(StorageFactory & factory) { factory.registerStorage( "URL", [](const StorageFactory::Arguments & args) { ASTs & engine_args = args.engine_args; auto configuration = StorageURL::getConfiguration(engine_args, args.getLocalContext()); auto format_settings = StorageURL::getFormatSettingsFromArgs(args); ASTPtr partition_by; if (args.storage_def->partition_by) partition_by = args.storage_def->partition_by->clone(); return std::make_shared( configuration.url, args.table_id, configuration.format, format_settings, args.columns, args.constraints, args.comment, args.getContext(), configuration.compression_method, configuration.headers, configuration.http_method, partition_by); }, { .supports_settings = true, .supports_schema_inference = true, .source_access_type = AccessType::URL, }); } }