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

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

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

傳回授與使用者的所有 IAM 角色和命令權限。

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

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

## 引數
<a name="PG_GET_IAM_ROLE_BY_USER-arguments"></a>

 *name*   
要傳回 IAM 角色的使用者名稱。

## 傳回類型
<a name="PG_GET_IAM_ROLE_BY_USER-return-type"></a>

VARCHAR 

## 使用須知
<a name="PG_GET_IAM_ROLE_BY_USER-usage-notes"></a>

PG\$1GET\$1IAM\$1ROLE\$1BY\$1USER 函數會針對每組角色和命令權限傳回一行。此資料列包含以逗號分隔清單，其中包含使用者名稱、IAM 角色和命令。

結果中的 `default` 值表示使用者可以指定任何可用的角色來執行顯示的命令。

您必須是超級使用者才能使用此函數。

## 範例
<a name="PG_GET_IAM_ROLE_BY_USER-example"></a>

下列範例指出使用者 `reg_user1` 可以指定任何可用的 IAM 角色來執行 COPY 作業。使用者也可以指定 UNLOAD 作業的 `Redshift-S3-Write` 角色。

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

下列 PG\$1GET\$1IAM\$1ROLE\$1BY\$1USER 函數範例將結果格式化為表格。

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