客戶
Spanner 支援 SQL 查詢。以下是範例查詢：
SELECT s.SingerId, s.FirstName, s.LastName, s.SingerInfo
FROM Singers AS s
WHERE s.FirstName = @firstName;
@firstName 建構參照到查詢參數。可以使用文字值的地方就可以使用查詢參數。我們強烈建議您在程式輔助的 API 中使用參數。使用查詢參數可協助避免 SQL 植入攻擊，也讓產生的查詢更有可能利用多個伺服器端快取。詳情請參閱「快取」。
執行查詢時，查詢參數必須與值繫結。例如：
Statement statement =
Statement.newBuilder("SELECT s.SingerId...").bind("firstName").to("Jimi").build();
try (ResultSet resultSet = dbClient.singleUse().executeQuery(statement)) {
while (resultSet.next()) {
...
}
}
Spanner 收到 API 呼叫後，會分析查詢和繫結參數，判斷應由哪個 Spanner 伺服器節點處理查詢。伺服器會傳回呼叫 ResultSet.next() 所使用的一連串結果資料列。
查詢執行
查詢執行的開頭是收到某個 Spanner 伺服器的「執行查詢」請求。伺服器會執行以下步驟：
- 驗證要求
- 剖析查詢文字
- 產生初始查詢代數
- 產生最佳化查詢代數
- 產生可執行的查詢計劃
- 執行計劃 (檢查權限、讀取資料、編碼結果等)
剖析
SQL 剖析器會分析查詢文字，並將查詢文字轉換成抽象語法樹。它會擷取基本的查詢結構 (SELECT …
FROM … WHERE …)，然後進行語法檢查。
代數
Spanner 的類型系統可以表示純量、陣列和結構等等。查詢的代數會定義資料表掃描、篩選、排序/分組、各種形式的加入、匯總以及其他等運算子。初始的查詢代數是以剖析器的輸出做為建構基礎。剖析樹的欄位名稱參照是使用資料庫結構定義解析而來。此程式碼也會檢查語意錯誤，例如不正確的參數數量、類型不符等。
下一個步驟 (「查詢最佳化」) 使用初始的代數並產生更佳的代數，這可能較簡單、較有效率，或者更適合執行引擎功能。例如，初始的代數可能僅指定「加入」，而優化的代數則指定「雜湊加入」。
執行
最終可執行的查詢計劃是以重新寫入的代數做為建構基礎。基本上，可執行的計劃是「疊代器」的有向無環圖。每個疊代器都會公開一系列的值。疊代器可能會使用輸入來產生輸出 (例如排序疊代器)。涉及單一分割的查詢可由單一伺服器 (儲存資料的伺服器) 執行。該伺服器會掃描數個資料表的範圍、執行聯結、執行匯總，以及其他由查詢代數定義的所有作業。
涉及多種分割的查詢會列為多個片段。有些查詢會在主要 (根) 伺服器上持續執行，其他部分子查詢則會移交給分葉節點 (擁有正在讀取的分割的節點)。針對複雜的查詢，此移交能夠重複套用，產生伺服器執行的樹狀結構。所有伺服器都有一致的時間戳記，因此查詢結果是資料的一致快照。每個分葉伺服器都會傳回一系列的部分結果。針對涉及匯總的查詢，這些可能是部分匯總的結果。查詢根伺服器會處理來自分葉伺服器的結果，並執行剩餘的查詢計劃。詳情請參閱「查詢執行計畫」。
如果查詢涉及多個分割，Spanner 可以跨分割平行執行查詢。平行處理程度取決於查詢掃描的資料範圍、查詢執行計畫，以及資料在分割之間的分布情形。Spanner 會根據執行個體大小和執行個體設定 (區域或多區域)，自動設定查詢的平行處理程度上限，以達到最佳查詢效能並避免CPU 負載過重。
快取
系統會自動快取查詢處理的許多成果，重新使用在後續的查詢中。這包含查詢代數、可執行的查詢計畫等。系統會根據查詢文字、名稱、繫結參數的類型等進行快取。這也是在查詢文字中使用繫結參數 (例如上方範例中的 @firstName) 比使用文字值來得好的原因。無論實際的繫結值為何，若使用繫結參數，則只能快取一次並重複使用。詳情請參閱最佳化 Spanner 查詢效能。
處理錯誤
executeQuery (或 executeStreamingSql) 和 streamingRead 方法會傳回 PartialResultSet 訊息串流。為提高效率，單一資料列或資料欄值可能會分割成多個 PartialResultSet 訊息，尤其是大型資料。
暫時性網路錯誤、交接分割或伺服器重新啟動，都可能導致這項串流中斷。負載平衡期間可能會發生分割交接，升級期間可能會重新啟動伺服器。
為處理這些中斷情形，Spanner 會在部分 PartialResultSet 訊息中加入不透明的 resume_token 字串。
resume_token 的相關重點：
- 並非每個
PartialResultSet都包含resume_token。 - 通常只會在完整資料列的結尾加入
resume_token，標示安全恢復點。 PartialResultSet(適用於跨多則訊息分割的大型值) 必須等到整個值和資料列都傳送完畢，才會具有resume_token。chunked_value- 如要繼續中斷的串流，請傳送新的要求，並附上上次收到的非空白
resume_token。
Spanner 用戶端程式庫會自動管理這項緩衝和復原作業。這些模型會從 PartialResultSet 訊息中組裝完整資料列，並追蹤最新 resume_token。如果連線中斷，程式庫會使用最後一個有效權杖重新啟動串流，並捨棄該權杖之後收到的任何部分資料。即使發生暫時性故障，這個程序也能確保您看到不重複的完整資料列串流。