For convenience, callers may wrap instances in a StreamOf<std::tuple<...>> object, which will automatically parse each Row into a std::tuple with the specified types.
Example:
namespace spanner = ::google::cloud::spanner;
spanner::SqlStatement select(
"SELECT AlbumId, AlbumTitle, MarketingBudget"
" FROM Albums"
" WHERE AlbumTitle >= 'Aardvark' AND AlbumTitle < 'Goo'");
auto profile_query_result = client.ProfileQuery(std::move(select));
for (auto& row : profile_query_result) {
if (!row) throw std::move(row).status();
// Discard rows for brevity in this example.
}
// Stats are only available after all rows from the result have been read.
auto execution_stats = profile_query_result.ExecutionStats();
if (execution_stats) {
for (auto const& stat : *execution_stats) {
std::cout << stat.first << ":\t" << stat.second << "\n";
}
}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-14 UTC."],[[["This document outlines the `ProfileQueryResult` class, which represents the stream of `Rows` and profile statistics from a `spanner::Client::ProfileQuery()`."],["The `ProfileQueryResult` class allows iteration over results using `begin()` and `end()`, returning a sequence of `StatusOr\u003cRow\u003e` objects, which may be wrapped for convenience into a `StreamOf\u003cstd::tuple\u003c...\u003e\u003e` object."],["After reading all rows, `ExecutionStats()` can be used to retrieve key-value pair statistics, and `ExecutionPlan()` can be called to access the SQL statement's execution plan, while the `ReadTimestamp()` function is used to get the timestamp at which the read happened, but only when used with a read-only transaction."],["There are many versions of this class, from 2.11.0 to 2.37.0-rc (the latest)."]]],[]]
