欄位來源

功能性的

SQLly 記得每個結果欄位實際來自哪個資料表和欄位,工具因此能針對來源、而不是標籤採取行動。

結果欄位的標題只是顯示用途,不代表欄位的身分。 SELECT p.Name AS PermissionName 為該欄位加上標籤 PermissionName,但這個名稱在你的資料庫中並不存在作為欄位——而 T-SQL 也不會允許你在任何 SELECT 別名出現在一個 WHERE 子句。所以 SQLly 在執行陳述式時也會一併解讀它:為網格中的每一欄推導 是由哪個資料表別名與底層欄位產生該值,並將這個答案附加到結果集中。

這就是讓網格真正能操作、而不只是好看的原因。在儲存格上按右鍵,然後要求 WHERE = 此值,而 SQLly 不會把標題原樣貼回給你;它會針對真正的來源欄位撰寫條件,並用結果來源引擎的正確限定與引號寫法。

兩個問題,兩個答案

來源說明回答兩個不同的問題,將它們混為一談會產生無法編譯的 SQL。SQLly 特意將它們分開:

來源欄位
「在附加到這個語句的述詞裡,我該寫什麼?」 一律是外部查詢範圍內有效的參照,因此透過衍生資料表或 CTE 傳入的值會保留該衍生資料表的別名。
來源
「這個值最終是從哪裡來的?」 已向下追蹤一層,從衍生資料表或 CTE 本體追到基底資料表與欄位。這個結果只供顯示——工具提示與狀態列——絕不用於述詞。

實例演練:別名

日常情況。兩個聯結的資料表,每個都有一個 Name 欄位,兩者在 SELECT 清單中都取了別名:

SELECT
    rm.Name AS ModelName,
    p.Name  AS PermissionName
FROM Shared.ReferenceModelPermissions rmp
    INNER JOIN Shared.Permission p ON p.PermissionId = rmp.PermissionId
    INNER JOIN Shared.ReferenceModel rm ON rm.ReferenceModelId = rmp.ReferenceModelId

將滑鼠游標懸停在 PermissionName 標頭,SQLly 就會告訴你 Source: p.Name from Shared.Permission p。在其中一個儲存格上按右鍵,然後選擇 WHERE = 此值,你得到的就是實際會執行的條件:

-- what a label-based tool would write (and SQL Server would reject)
WHERE PermissionName = 'Export'

-- what SQLly writes
WHERE p.[Name] = 'Export'

注意引號的處理方式:別名維持不加引號,因為它不需要引號;欄位會使用引擎自己的分隔符;字面值則以該引擎的方言呈現。選單中每個運算子都套用相同的解析規則 - <>, >=, LIKE,starts-with 和 ends-with, IN 在多儲存格選取範圍上, IS NULL - 以及對於 比對資料列,它會把點選資料列的每個欄位都對照同一份解析,並串接起來,用的是 AND.

實例演練:衍生欄位

透過子查詢取得的值需要同時取得兩個答案。述詞必須寫在外層範圍,而那裡只有 sub 存在;工具提示仍然應該告訴你資料實際所在的位置:

SELECT sub.y AS Z FROM (SELECT x AS y FROM T) sub

predicate  → sub.y = …      (valid outside; T.x would not be)
tooltip    → Source: T.x

追蹤也能處理那些麻煩的寫法。當子查詢的主體只讀取一個資料表時,裡面的星號可以透過它解析;衍生資料表的欄位清單則會按位置為投影重新命名:

SELECT sub.Name AS N FROM (SELECT * FROM Shared.Permission p) sub
  → Source: p.Name from Shared.Permission p

SELECT d.b AS Out FROM (SELECT p.Name, p.Id FROM P p) d (a, b)
  → b is the second projection: Source: p.Id from P p

實例演練:CTE

CTE 也是一樣:外層陳述式看到的是一個具名關聯,述詞就針對這個名稱來寫,而溯源時則沿著主體一路追到基底資料表。CTE 上明確列出的欄位清單會依位置重新命名,跟衍生資料表完全一樣:

WITH x AS (SELECT p.Name AS a FROM Shared.Permission p)
SELECT x.a AS Alpha FROM x

predicate  → x.a = …
tooltip    → Source: p.Name from Shared.Permission p

WITH x (u, v) AS (SELECT p.Name, p.Id FROM P p) SELECT v FROM x
  → Source: p.Id from P p

一個陳述式中的多個 CTE 會各自獨立解析,因此兩個 CTE 的聯結會將每個欄位歸屬於它自己的基底資料表。

景觀,以及小徑延伸的距離

來源說明讀取 它前面的陳述式 - 而不是你編輯器裡的那一份。在 FROM 因此,子句會依其實際的物件來解析:述詞是針對檢視撰寫的(這是正確的,檢視確實有那些欄位),而工具提示會顯示檢視和欄位名稱。若要再往下追蹤,就必須閱讀檢視的定義,而該定義位於伺服器上,而不是你的查詢中。

現在這一步是刻意的,而且只要一個按鍵:使用 DDL 原始碼導覽 就會開啟檢視的定義,而來源解析會在 那 陳述式——包括別名、衍生資料表與 CTE。自動串起整條鏈,讓 view-over-view 結果中的欄位直接回報最終的基底資料表,不必你自己開啟任何東西——這是同一套機制的自然延伸,也正是要持續維護快取架構模型的原因。

當 SQLly 沒有輸出時

解析刻意保守,原則是 錯誤的條件比沒有條件更糟。當無法確定來源時,來源追溯不會傳回任何內容,欄位標題不會顯示工具提示,表格操作也會退回一般的結果標籤。情況如下:

  • 計算運算式。 COUNT(*) AS Total 或 p.First + p.Last AS FullName 沒有單一來源欄位,因此無法追溯來源。
  • 聯集與多陳述式腳本。 有一個以上的頂層 SELECT,就沒有單一語句可以歸屬。
  • 模糊的星號。 SELECT * 在聯結上,沒有目錄資料就無法判定歸屬; p.* 在聯結上就可以,因為限定詞會指出是哪一張資料表。星號與同名的明確投影混用也會被拒絕——點選的欄位可能是其中任何一個。
  • 聯結查詢中未限定的欄位。 SELECT Name FROM A a JOIN B b … 保留欄位名稱但不獲得限定詞。在單一資料表上則會獲得:別名,或在沒有別名時獲得以結構描述限定的資料表名稱。
  • 超過一層的任何巢狀結構。 衍生表裡再套衍生表、CTE 讀取另一個 CTE,或衍生表主體讀取 CTE:外部參照對述詞仍然有效,但來源會回報為未知,而不是用猜的。
  • 遞迴或 UNION CTE 主體。 對來源判定而言是不透明的;但外部參照在謂詞中仍然可用。

重複的表頭是根據位置而不是名稱處理的:使用 p.Name, rm.Name 第一個網格欄位歸屬於 p 而第二個屬於 rm。有引號的識別碼比對時會去掉引號、不分大小寫,所以 [Name], "Name",而且 `Name` 指的都是同一個欄位;而含標點符號或以數字開頭、用分隔符括住的名稱,會整體讀取而不重新斷詞。

它驅動什麼

每個語句只解析一次,解析結果會提供給所有需要以 SQL 術語描述結果欄位的介面:

  • 標題工具提示。 將滑鼠懸停在任一欄位標題上,即可看到來源欄位;當追溯有額外發現時,也會顯示背後的基礎資料表。
  • 從網格使用 WHERE。 每個比較, LIKE, IN,以及儲存格右鍵選單中的 NULL 檢查——針對來源欄位、以結果引擎的方言撰寫,預覽也用實際會採用的同一套解析來呈現,因此預覽與插入的 SQL 不可能不一致。
  • 比對資料列。 一個 AND 等值條件,涵蓋整個被點選的資料列,每一欄各自解析。
  • 篩選條件,升級成 SQL。 以互動方式篩選資料格,然後 套用到查詢 / 將啟用的篩選器加入 WHERE:同一個解析器也會把你的欄位篩選轉成真正的述詞,而不是標籤比對。
SQLly
結果網格標題工具提示會顯示欄位的來源資料表與欄位結果網格標題工具提示會顯示欄位的來源資料表與欄位
將滑鼠懸停在有別名的結果欄位標題上:SQLly 會指出來源欄位,以及它背後的基礎資料表。

為什麼模型裡要保留這個

因為一個知道自身來源(lineage)的結果集是可以拿來操作的,不只是能看。把額外的中繼資料跟著資料列一起帶著走,網格才能從你恰好注意到的一個儲存格建立出正確的篩選器,不必先在腦中重寫整個查詢;這也是從某個值向下追到產生它的物件、以及在跨聯結與衍生資料表產生多欄位述詞(predicate)的基礎——那些條件手寫起來很繁瑣。中繼資料是地基;上述每個工具都是蓋在上頭的小而實在的一步,而不是猜測。