

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

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

# ATTACH MASKING POLICY
<a name="r_ATTACH_MASKING_POLICY"></a>

將現有的動態資料遮罩政策附加至資料欄。如需動態資料遮罩的相關資訊，請參閱 [動態資料遮罩](t_ddm.md)。

超級使用者和具有 sys:secadmin 角色的使用者或角色可以附加遮罩政策。

## 語法
<a name="r_ATTACH_MASKING_POLICY-synopsis"></a>

```
ATTACH MASKING POLICY 
{
  policy_name ON relation_name
  | database_name.policy_name ON database_name.schema_name.relation_name
}
( { output_column_names | output_path } )
[ USING ( { input_column_names | input_path } ) ]
TO { user_name | ROLE role_name | PUBLIC }
[ PRIORITY priority ];
```

## Parameters
<a name="r_ATTACH_MASKING_POLICY-parameters"></a>

*policy\$1name*   
欲附加的遮罩政策名稱。

database\$1name  
建立政策和關係的資料庫名稱。政策和關係必須位於相同的資料庫。資料庫可以是連線的資料庫或支援 Amazon Redshift 聯合許可的資料庫。

schema\$1name  
關係所屬的結構描述名稱。

 *relation\$1name*   
欲附加遮罩政策的關係名稱。

*output\$1column\$1names*   
要套用遮罩政策的資料欄名稱。

*output\$1paths*   
套用遮罩政策之 SUPER 物件的完整路徑，包括資料欄名稱。例如，對於具有名為 SUPER 類型欄 `person` 的關係，*output\$1path* 可能是 `person.name.first_name`。

*input\$1column\$1names*   
將作為遮罩政策輸入的資料欄名稱。此為選用參數。如果未指定，遮罩政策會使用 *output\$1column\$1names* 做為輸入。

*input\$1paths*   
遮罩政策會做為輸入之 SUPER 物件的完整路徑。此為選用參數。如果未指定，遮罩政策會使用 *output\$1path* 做為輸入。

*user\$1name*   
要附加遮罩政策的使用者名稱。您無法將兩個政策附加到使用者和欄或角色和欄的相同組合。您可以將一個政策附加至使用者，並將另一個政策附加至使用者的角色。在此情況下，會套用優先順序較高的政策。  
您只能在單一 ATTACH MASKING POLICY 命令中設定 user\$1name、role\$1name 和 PUBLIC 中的其中一個。

*role\$1name*   
要附加遮罩政策的角色名稱。您無法將兩個政策附加至相同的資料欄/角色配對。您可以將一個政策附加至使用者，並將另一個政策附加至使用者的角色。在此情況下，會套用優先順序較高的政策。  
您只能在單一 ATTACH MASKING POLICY 命令中設定 user\$1name、role\$1name 和 PUBLIC 中的其中一個。

*PUBLIC*   
將遮罩政策附加至存取資料表的所有使用者。您必須為附加至特定資料欄/使用者或資料欄/角色配對的其他遮罩政策提供高於 PUBLIC 政策的優先順序，才能套用這些政策。  
您只能在單一 ATTACH MASKING POLICY 命令中設定 user\$1name、role\$1name 和 PUBLIC 中的其中一個。

*priority*   
遮罩政策的優先順序。當多個遮罩政策套用至指定使用者的查詢時，會套用優先順序最高的政策。  
您無法將兩個不同的政策附加到具有相同優先順序的同個資料欄，即使這兩個策略附加到不同的使用者或角色也是如此。只要附加政策的使用者或角色每次都不同，您就可以將相同的政策多次附加至同一組資料表、輸出資料欄、輸入資料欄和優先順序參數。  
您無法對資料欄套用與附加至該資料欄的另一個政策具有相同優先順序的政策，即使用於不同角色也一樣。此欄位為選用欄位。如果未指定優先順序，遮罩政策會預設套用值為 0 的優先順序。

如需在 Amazon Redshift 聯合許可目錄上使用 ATTACH MASKING POLICY，請參閱[使用 Amazon Redshift 聯合許可管理存取控制](https://docs.aws.amazon.com/redshift/latest/dg/federated-permissions-managing-access.html)。