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/). 

# PG\$1GET\$1GRANTEE\$1BY\$1IAM\$1ROLE
<a name="PG_GET_GRANTEE_BY_IAMROLE"></a>

Retorna todos os usuários e grupos que receberam uma função do IAM especificada.

## Sintaxe
<a name="PG_GET_GRANTEE_BY_IAMROLE-synopsis"></a>

```
pg_get_grantee_by_iam_role('iam_role_arn')
```

## Argumentos
<a name="PG_GET_GRANTEE_BY_IAMROLE-arguments"></a>

 *iam\$1role\$1arn*   
A função do IAM para a qual retornar os usuários e grupos que receberam essa função.

## Tipo de retorno
<a name="PG_GET_GRANTEE_BY_IAMROLE-return-type"></a>

VARCHAR 

## Observações de uso
<a name="PG_GET_GRANTEE_BY_IAMROLE-usage-notes"></a>

A função PG\$1GET\$1GRANTEE\$1BY\$1BY\$1IAM\$1ROLE retorna uma linha para cada usuário ou grupo. Cada linha contém o nome do favorecido, o tipo de favorecido e o privilégio concedido. Os valores possíveis para o tipo de favorecido são `p` para público, `u` para o usuário, e `g` para o grupo. 

É preciso ser um superusuário para usar esta função.

## Exemplo
<a name="PG_GET_GRANTEE_BY_IAMROLE-example"></a>

O exemplo a seguir indica que a função do IAM `Redshift-S3-Write` é concedida a `group1` e `reg_user1`. Usuários no `group_1` pode especificar a função somente para operações COPY, e o usuário `reg_user1` pode especificar a função somente para executar operações UNLOAD.

```
select pg_get_grantee_by_iam_role('arn:aws:iam::123456789012:role/Redshift-S3-Write');
```

```
  pg_get_grantee_by_iam_role
-----------------------------
 (group_1,g,COPY)
 (reg_user1,u,UNLOAD)
```

O exemplo a seguir da função PG\$1GET\$1GRANTEE\$1BY\$1IAM\$1ROLE formata o resultado como uma tabela.

```
select grantee, grantee_type, cmd_type FROM pg_get_grantee_by_iam_role('arn:aws:iam::123456789012:role/Redshift-S3-Write') res_grantee(grantee text, grantee_type text, cmd_type text) ORDER BY 1,2,3;
```

```
  grantee  | grantee_type | cmd_type
-----------+--------------+----------
 group_1   | g            | COPY
 reg_user1 | u            | UNLOAD
```