LOWER_ATTRIBUTE_NAMES 函數 - Amazon Redshift
語法引數傳回類型使用須知範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

LOWER_ATTRIBUTE_NAMES 函數

使用與 相同的案例轉換常式，將SUPER值中所有適用的屬性名稱轉換為小寫LOWER 函數。LOWER_ATTRIBUTE_NAMES 支援 UTF-8 個多位元組字元，每個字元最多四個位元組。

若要將SUPER屬性名稱轉換為大寫，請使用 UPPER_ATTRIBUTE_NAMES 函數。

語法

LOWER_ATTRIBUTE_NAMES(super_expression)

引數

super_expression

SUPER 表達式。

傳回類型

SUPER

使用須知

在 Amazon Redshift 中，資料欄識別碼傳統上不區分大小寫，並轉換為小寫。如果您從區分大小寫的資料格式擷取資料，例如 JSON，則資料可能包含混合大小寫屬性名稱。

請考量下列範例。

CREATE TABLE t1 (s) AS SELECT JSON_PARSE('{"AttributeName": "Value"}');


SELECT s.AttributeName FROM t1;  

attributename
-------------
NULL


SELECT s."AttributeName" FROM t1;

attributename
-------------
NULL

Amazon Redshift NULL 會傳回這兩個查詢。若要查詢 AttributeName，請使用 LOWER_ATTRIBUTE_NAMES 將資料屬性名稱轉換為小寫。請考量下列範例。

CREATE TABLE t2 (s) AS SELECT LOWER_ATTRIBUTE_NAMES(s) FROM t1;


SELECT s.attributename FROM t2;

attributename
-------------
"Value"


SELECT s.AttributeName FROM t2; 

attributename
-------------
"Value"


SELECT s."attributename" FROM t2;

attributename
-------------
"Value"


SELECT s."AttributeName" FROM t2;

attributename
-------------
"Value"

使用混合大小寫物件屬性名稱的相關選項是enable_case_sensitive_super_attribute組態選項，可讓 Amazon Redshift 以SUPER屬性名稱識別大小寫。這可能是使用 LOWER_ATTRIBUTE_ 的替代解決方案NAMES。如需 的詳細資訊enable_case_sensitive_super_attribute，請前往 enable_case_sensitive_super_attribute。

範例

將SUPER屬性名稱轉換為小寫

下列範例使用 LOWER_ATTRIBUTE_NAMES 來轉換資料表中所有SUPER值的屬性名稱。

-- Create a table and insert several SUPER values.
CREATE TABLE t (i INT, s SUPER);

INSERT INTO t VALUES
  (1, NULL), 
  (2, 'A'::SUPER),
  (3, JSON_PARSE('{"AttributeName": "B"}')),
  (4, JSON_PARSE(
     '[{"Subobject": {"C": "C"},
        "Subarray": [{"D": "D"}, "E"]
      }]'));

-- Convert all attribute names to lowercase.
UPDATE t SET s = LOWER_ATTRIBUTE_NAMES(s);

SELECT i, s FROM t ORDER BY i;

 i |                        s
---+--------------------------------------------------
 1 | NULL
 2 | "A"
 3 | {"attributename":"B"}
 4 | [{"subobject":{"c":"C"},"subarray":[{"d":"D"}, "E"]}]

觀察 LOWER_ATTRIBUTE_NAMES 如何運作。

  • NULL 值和純量SUPER值，例如 "A" 保持不變。

  • 在 SUPER 物件中，所有屬性名稱都會變更為小寫，但屬性值，例如 "B" 保持不變。

  • LOWER_ATTRIBUTE_NAMES 會遞迴套用至巢狀於SUPER陣列內部或另一個SUPER物件內部的任何物件。

在具有重複屬性名稱的SUPER物件上使用 LOWER_ATTRIBUTE_NAMES

如果SUPER物件包含的屬性其名稱僅在其情況下不同，LOWER_ATTRIBUTE_NAMES 將引發錯誤。請考量下列範例。

SELECT LOWER_ATTRIBUTE_NAMES(JSON_PARSE('{"A": "A", "a": "a"}'));      

error:   Invalid input
code:    8001
context: SUPER value has duplicate attributes after case conversion.