

 O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](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>

Anexa uma política de mascaramento dinâmico de dados existente a uma coluna. Para obter mais informações sobre mascaramento dinâmico de dados, consulte [Mascaramento dinâmico de dados](t_ddm.md).

Superusuários e usuários ou perfis que têm a função sys:secadmin podem anexar uma política de mascaramento.

## Sintaxe
<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 ];
```

## Parâmetros
<a name="r_ATTACH_MASKING_POLICY-parameters"></a>

*policy\$1name*   
O nome da política de mascaramento a ser anexada.

database\$1name  
O nome do banco de dados no qual a política e a relação são criadas. A política e a relação precisam estar no mesmo banco de dados. O banco de dados pode ser o conectado ou um banco de dados que comporte as permissões federadas do Amazon Redshift.

schema\$1name  
O nome do esquema ao qual pertence a relação.

 *relation\$1name*   
O nome da relação à qual a política de mascaramento deve ser anexada.

*output\$1column\$1names*   
Os nomes das colunas às quais a política de mascaramento se aplicará.

*output\$1paths*   
O caminho completo do objeto SUPER ao qual a política de mascaramento será aplicada, inclusive o nome da coluna. Por exemplo, para uma relação com uma coluna do tipo SUPER chamada `person`, *output\$1path* pode ser `person.name.first_name`. 

*input\$1column\$1names*   
Os nomes das colunas que a política de mascaramento vai receber como entrada. Esse parâmetro é opcional. Se não for especificado, a política de mascaramento usará *output\$1column\$1names* como entradas.

*input\$1paths*   
O caminho completo do objeto SUPER que a política de mascaramento vai utilizar como entrada. Esse parâmetro é opcional. Se não for especificado, a política de mascaramento usará *output\$1path* como entradas.

*user\$1name*   
O nome do usuário ao qual a política de mascaramento será anexada. Você não pode anexar duas políticas à mesma combinação de usuário e coluna ou função e coluna. Você pode anexar uma política a um usuário e outra política ao perfil do usuário. Nesse caso, a política com maior prioridade se aplicará.  
Só é possível definir uma opção entre user\$1name, role\$1name e PUBLIC em um comando ATTACH MASKING POLICY. 

*role\$1name*   
O nome do perfil ao qual a política de mascaramento será anexada. Não é possível anexar duas políticas ao mesmo par de coluna/perfil. Você pode anexar uma política a um usuário e outra política ao perfil do usuário. Nesse caso, a política com maior prioridade se aplicará.  
Só é possível definir uma opção entre user\$1name, role\$1name e PUBLIC em um comando ATTACH MASKING POLICY. 

*PUBLIC*   
Anexa a política de mascaramento a todos os usuários que acessam a tabela. Você deve dar a outras políticas de mascaramento associadas a pares específicos de coluna/usuário ou coluna/perfil uma prioridade maior do que a política PUBLIC para que elas sejam aplicadas.  
Só é possível definir uma opção entre user\$1name, role\$1name e PUBLIC em um comando ATTACH MASKING POLICY. 

*priority*   
A prioridade da política de mascaramento. Quando várias políticas de mascaramento se aplicam à consulta de um determinado usuário, a política de maior prioridade se aplica.  
Você não pode anexar duas políticas diferentes à mesma coluna com prioridade igual, mesmo se as duas políticas estiverem anexadas a usuários ou funções diferentes. Você pode anexar a mesma política várias vezes ao mesmo conjunto de parâmetros de tabela, coluna de saída, coluna de entrada e prioridade, desde que o usuário ou a função à qual a política esteja anexada seja sempre diferente.   
Você não pode aplicar uma política a uma coluna com a mesma prioridade de outra política anexada a essa coluna, mesmo que ela seja para perfis diferentes. Esse campo é opcional. Se você não especificar uma prioridade, a política de mascaramento será anexada com prioridade 0 por padrão.

Para o uso da ATTACH MASKING POLICY no Catálogo de Permissões Federadas do Amazon Redshift, consulte [Gerenciar o controle de acesso com permissões federadas do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/federated-permissions-managing-access.html).