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"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-22 UTC."],[[["\u003cp\u003eThis document outlines the \u003ccode\u003eProfileQueryResult\u003c/code\u003e class in the Google Cloud Spanner C++ library, focusing on versions ranging from 2.11.0 to the latest release candidate 2.37.0-rc.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProfileQueryResult\u003c/code\u003e represents the stream of \u003ccode\u003eRows\u003c/code\u003e and profile statistics returned from \u003ccode\u003espanner::Client::ProfileQuery()\u003c/code\u003e, allowing for direct iteration or parsing into \u003ccode\u003estd::tuple\u003c/code\u003e objects.\u003c/p\u003e\n"],["\u003cp\u003eThe class includes functions such as \u003ccode\u003ebegin()\u003c/code\u003e and \u003ccode\u003eend()\u003c/code\u003e to define the result set's range, as well as methods to retrieve the read timestamp (\u003ccode\u003eReadTimestamp()\u003c/code\u003e), execution statistics (\u003ccode\u003eExecutionStats()\u003c/code\u003e), and execution plan (\u003ccode\u003eExecutionPlan()\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eConstructors and operators for \u003ccode\u003eProfileQueryResult\u003c/code\u003e handle object creation and movement, with a parameter \u003ccode\u003esource\u003c/code\u003e that is of type \u003ccode\u003estd::unique_ptr< ResultSourceInterface >\u003c/code\u003e and a parameter for moving \u003ccode\u003eProfileQueryResult\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation provides examples on how to utilize the class, specifically in retrieving and iterating over query results, including handling their status, and accessing execution statistics.\u003c/p\u003e\n"]]],[],null,[]]
