

 Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del 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>

Devuelve todos los usuarios y los grupos a los que se ha otorgado un rol de IAM especificado.

## Sintaxis
<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*   
El rol de IAM para el que se devuelven los usuarios y los grupos a los que se ha otorgado este rol.

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

VARCHAR 

## Notas de uso
<a name="PG_GET_GRANTEE_BY_IAMROLE-usage-notes"></a>

La función PG\$1GET\$1GRANTEE\$1BY\$1IAM\$1ROLE devuelve una fila por cada usuario o grupo. Cada fila contiene el nombre del beneficiario, el tipo de beneficiario y el privilegio otorgado. Los valores posibles para el tipo de beneficiario son `p` para público, `u` para usuario y `g` para grupo. 

Debe ser un superusuario para utilizar esta función.

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

En el siguiente ejemplo, se indica que el rol de IAM `Redshift-S3-Write` se otorga a `group1` y `reg_user1`. Los usuarios de `group_1` pueden especificar el rol solo para las operaciones COPY, y el usuario `reg_user1` puede especificar el rol solo para realizar operaciones 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)
```

En el siguiente ejemplo de la función PG\$1GET\$1GRANTEE\$1BY\$1IAM\$1ROLE, el resultado recibe el formato de tabla.

```
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
```