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\$1IAM\$1ROLE\$1BY\$1USER
<a name="PG_GET_IAM_ROLE_BY_USER"></a>

Retorna todas as funções do IAM e privilégios de comando concedidos a um usuário.

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

```
pg_get_iam_role_by_user('name')
```

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

 *name*   
O nome do usuário para o qual retornar funções do IAM.

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

VARCHAR 

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

A função PG\$1GET\$1IAM\$1ROLE\$1BY\$1USER retorna uma linha para cada conjunto de funções e privilégios de comando. A linha contém uma lista separada por vírgulas com nome de usuário, função do IAM e comando. 

Um valor de `default` no resultado indica que o usuário pode especificar qualquer função disponível para executar o comando exibido.

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

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

O exemplo a seguir indica que o usuário `reg_user1` pode especificar qualquer função do IAM disponível para executar operações COPY. O usuário também pode especificar a função `Redshift-S3-Write` para operações UNLOAD.

```
select pg_get_iam_role_by_user('reg_user1');
```

```
                             pg_get_iam_role_by_user
---------------------------------------------------------------------------------
 (reg_user1,default,COPY)
 (reg_user1,arn:aws:iam::123456789012:role/Redshift-S3-Write,COPY|UNLOAD)
```

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

```
select username, iam_role, cmd FROM pg_get_iam_role_by_user('reg_user1') res_iam_role(username text, iam_role text, cmd text);
```

```
 username  |                    iam_role                     | cmd
-----------+-------------------------------------------------+------
 reg_user1 | default                                         | None
 reg_user1 | arn:aws:iam::123456789012:role/Redshift-S3-Read | COPY
```