本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
IDENTIFIER
將字串值(通常是工作階段變數)解析為資料行名稱。在單獨的 $variable 原本會被讀取為純量值的位置,請使用此函式。適用於 StackQL v1.0 及更新版本。
另請參閱:
[SET] [ 工作階段變數 ]
語法
SELECT IDENTIFIER($variable) FROM <multipartIdentifier> ORDER BY IDENTIFIER($variable);
引數
variable
存放資料行名稱的工作階段變數或字串常值。可接受 t.name 這類限定名稱。只接受一個引數,且必須是單一字串值;'t.' || $column_name 這類串連、第二個引數或數值都會遭到拒絕,錯誤訊息為 IDENTIFIER requires one string value。空的值或包含陳述式的值會遭到拒絕,錯誤訊息為 invalid identifier value;未定義的變數則會以「未定義」錯誤失敗。這些檢查全都在向 Provider 發出任何要求之前進行。
傳回值
在剖析後的陳述式中,此函式會被取代為所指名資料行的參考,因此會傳回該資料行的值。名稱會轉換為識別碼,絕不會直接插入 SQL 文字中。產生的資料行參考可用於任何能使用資料行的位置:選取清單、WHERE、GROUP BY 與 ORDER BY 子句、函式引數,以及 CTE 與子查詢內部。
範例
依變數指定的資料行進行投影與排序
要傳回的資料行與排序依據的資料行都取自 column_name,輸出資料行則依 output_name 重新命名。選取清單與 ORDER BY 中需要 IDENTIFIER,因為在這些位置單獨使用 $column_name 會得到字串 'name',而不是資料行。別名則改用雙引號形式。變數解析之後,此陳述式等同於 SELECT name AS bucket FROM aws.s3.buckets WHERE region = 'ap-southeast-2' ORDER BY name。
SET column_name = 'name';
SET output_name = 'bucket';
SELECT IDENTIFIER($column_name) AS "$output_name"
FROM aws.s3.buckets
WHERE region = 'ap-southeast-2'
ORDER BY IDENTIFIER($column_name);
依變數指定的資料行進行篩選
解析後的參考可用於投影,也可用於述詞。此處要篩選的欄位與要比對的值都來自變數:IDENTIFIER($filter_column) 會成為資料行 status,而 $filter_value 則以字串常值 'RUNNING' 傳遞。這兩種形式刻意不同,因為前者指名資料行,後者提供值。
SET filter_column = 'status';
SET filter_value = 'RUNNING';
SELECT name, zone
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a'
AND IDENTIFIER($filter_column) = $filter_value;
以資料表別名限定資料行
含點號的值會解析為限定的資料行參考。資料表的別名為 w,別名本身取自變數,而 IDENTIFIER($column_name) 會成為 w.name。當聯結的兩側都有相同的資料行名稱,參考會因此模稜兩可時,應使用此形式。
SET table_alias = 'w';
SET column_name = 'w.name';
SELECT IDENTIFIER($column_name) AS bucket
FROM aws.s3.buckets AS "$table_alias"
WHERE w.region = 'ap-southeast-2';
遭拒絕的值
由於值會成為名稱而非查詢文字,任何無法作為名稱的內容都會在規劃陳述式之前遭到拒絕,且不會有任何要求送達 Provider。下方前兩個陳述式會以 invalid identifier value 失敗,第三個則以 IDENTIFIER requires one string value 失敗。
/*
SET column_name = '';
SELECT IDENTIFIER($column_name) FROM aws.s3.buckets;
-- FAILS with invalid identifier value
SET column_name = 'name; DROP TABLE imaginary';
SELECT IDENTIFIER($column_name) FROM aws.s3.buckets;
-- FAILS with invalid identifier value
SET column_name = 17;
SELECT IDENTIFIER($column_name) FROM aws.s3.buckets;
-- FAILS with IDENTIFIER requires one string value
*/
FROM子句中的$variable不需IDENTIFIER即可解析為關聯;別名、DDL 資料行名稱、INSERT資料行清單與UPDATE目標則使用加上雙引號的"$variable"。