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/)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon Redshift RSQL 進行連線
Amazon Redshift RSQL 是用於與 Amazon Redshift 叢集和資料庫互動的命令列用戶端。您可以連線到 Amazon Redshift 叢集、描述資料庫物件、查詢資料，以及檢視各種輸出格式的查詢結果。
Amazon Redshift RSQL 支援 PostgreSQL psql 命令列工具的功能，以及一組專屬於 Amazon Redshift 的額外功能。這些索引標籤包括以下項目：
+ 您可以使用 AD FS、PingIdentity、Okta、Azure ADm 或其他 SAML/JWT 型身分提供者，來使用單一登入身分驗證。您也可以使用以瀏覽器為基礎的 SAML 身分供應商來進行多重要素驗證 (MFA)。
+ 您可以描述 Amazon Redshift 物件的屬性，例如資料表分佈索引鍵、資料表排序索引鍵、晚期繫結視觀表 (LBV) 和具體化視觀表。您也可以描述 AWS Glue 目錄或 Apache Hive 中繼存放區中外部資料表的屬性或屬性、Amazon RDS for PostgreSQL、Amazon Aurora PostgreSQL 相容版本、RDS for MySQL （預覽） 和 Amazon Aurora MySQL 相容版本 （預覽） 中的外部資料庫，以及使用 Amazon Redshift 資料共用的資料表。
+ 您也可以使用增強的控制流程命令，例如 `IF` (`\ELSEIF`、`\ELSE,`、`\ENDIF`)、`\GOTO` 和 `\LABEL`。
透過 Amazon Redshift RSQL 批次模式 (該模式會執行以輸入參數形式傳遞的指令碼)，您可以執行同時包含 SQL 和複雜商業邏輯的指令碼。如果您有現有的自我管理內部部署資料倉儲，則可以使用 Amazon Redshift RSQL 取代現有的擷取、轉換、載入 (ETL) 和自動化指令碼，例如 Teradata BTEQ 指令碼。使用 RSQL 可以幫助您避免在程序語言中手動重新實作指令碼。
Amazon Redshift RSQL 適用於 Linux、Windows 和 macOS X 作業系統。
若要報告 Amazon Redshift RSQL 的問題，請寫信至 redshift-rsql-support@amazon.com。
**Topics**
+ [開始使用 Amazon Redshift RSQL](rsql-query-tool-getting-started.md)
+ [Amazon Redshift RSQL 變更日誌](rsql-query-tool-changelog.md)
# 開始使用 Amazon Redshift RSQL
在搭載 Linux、macOS 或 Microsoft Windows 作業系統的電腦上安裝 Amazon Redshift RSQL。
## 下載 RSQL
+ Linux 64 位元 RPM：[RSQL 1.1.2 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.2/AmazonRedshiftRsql-1.1.2.rhel.x86_64.rpm)
+ Linux 成品簽章金鑰：[金鑰](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.2/AmazonRedshiftRsql-1.1.2-certificate.pem)
+ Linux 成品簽署雜湊：[雜湊](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.2/AmazonRedshiftRsql-1.1.2-signature.bin)
+ Mac OS 64 位元 PKG：[RSQL 1.1.2 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.2/AmazonRedshiftRsql-1.1.2.universal.pkg)
+ Windows 64 位元 MSI：[RSQL 1.1.2 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.2/AmazonRedshiftRsql-1.1.2.x86_64.msi)
若要查看舊版的變更日誌和下載，請瀏覽 [Amazon Redshift RSQL 變更日誌](rsql-query-tool-changelog.md)。
## 安裝適用於 Linux 的 RSQL
請遵循下列步驟以安裝適用於 Linux 的 RSQL。
1. 使用以下命令安裝驅動程式管理員：
```
sudo yum install unixODBC
```
1. 安裝 ODBC 驅動程式：[下載並安裝 Amazon Redshift ODBC 驅動器下載並安裝 ODBC 驅動器](odbc20-install-linux.md)。
1. 將 ini 檔案複製到主目錄：
```
cp /opt/amazon/redshiftodbcx64/odbc.ini ~/.odbc.ini
```
1. 將環境變數設定為指向檔案的位置：
```
export ODBCINI=~/.odbc.ini
export ODBCSYSINI=/opt/amazon/redshiftodbcx64/
export AMAZONREDSHIFTODBCINI=/opt/amazon/redshiftodbcx64/amazon.redshiftodbc.ini
```
1. 您現在可以執行下列命令來安裝 RSQL。
```
sudo rpm -i AmazonRedshiftRsql-.rhel.x86_64.rpm
```
## 安裝適用於 Mac 的 RSQL
請依照下列步驟安裝 RSQL for Mac OSX。
1. 使用以下命令安裝驅動程式管理員：
```
brew install unixodbc --build-from-source
```
1. 安裝 ODBC 驅動程式：[下載並安裝 Amazon Redshift ODBC 驅動器下載並安裝 ODBC 驅動器](odbc-driver-mac-how-to-install.md)。
1. 將 ini 檔案複製到主目錄：
```
cp /opt/amazon/redshift/Setup/odbc.ini ~/.odbc.ini
```
1. 將環境變數設定為指向檔案的位置：
```
export ODBCINI=~/.odbc.ini
export ODBCSYSINI=/opt/amazon/redshift/Setup
export AMAZONREDSHIFTODBCINI=/opt/amazon/redshift/lib/amazon.redshiftodbc.ini
```
1. 將 `DYLD_LIBRARY_PATH` 設定為 libodbc.dylib 的位置 (如果它不在 `/usr/local/lib` 的話)。
```
export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/usr/local/lib
```
1. 按兩下 pkg 檔案來執行安裝程式。
1. 依照安裝程式中的步驟完成安裝。同意授權合約中的條款。
## 安裝適用於 Windows 的 RSQL
請依照下列步驟安裝 RSQL for Windows。
1. 安裝 ODBC 驅動程式：[下載並安裝 Amazon Redshift ODBC 驅動器下載並安裝 ODBC 驅動器](odbc-driver-windows-how-to-install.md)。
1. 按兩下 RSQL 下載檔案以執行安裝程式，然後遵循提示以完成安裝。
# Amazon Redshift RSQL 變更日誌
*1.1.2 (2025-12-11)*
錯誤修正
+ 修正使用 \$1goto 和 \$1label 命令導致失敗的錯誤。
+ 修正當變數以引號括住時，導致 RSQL 無法列印變數值的錯誤。
+ 修正在啟用 UseDeclareFetch 時，查詢結果超過 ODBC DSN Fetch 參數大小時，導致 RSQL 損毀的錯誤。
+ 修正即使開啟分頁器，仍會一次傳回多頁結果的問題。
+ 修正在交易區塊內查詢失敗時觸發 RSQL 損毀的錯誤。
*1.1.1 (2025-11-20)*
錯誤修正
+ 修正 RSQL 在使用 -c 旗標時錯誤剖析查詢的問題。此修正適用於所有平台。
+ 修正 Mac 上導致使用者無法在 RSQL 中使用 \$1s 命令的錯誤。
*1.1.0 (2025-11-11)*
錯誤修正
+ 已解決導致 rSQL 中意外當機的記憶體流失問題。
+ 從 RSQL 移除 OpenSSL 相依性。
+ 修正連結與相同環境中 libpq/psql 安裝的衝突。
+ 已改善 Amazon Linux 2023、Windows 和 macOS 的平台相容性。
+ 修正輸出在超過目前顯示大小時會遭到截斷的問題。
*1.0.8 (2023-06-19)*
錯誤修正
+ 修正了使用 SHOW 命令會截斷輸出的問題。
+ 已新增對用於描述外部 Kinesis 串流和 Kafka 主題之 \$1de 的支援。
*1.0.7 (2023-03-22)*
錯誤修正
+ 修正了 RSQL 無法描述具體化視觀表的問題。
+ 修正了使用 Amazon Redshift Serverless 時，stl\$1connection\$1log 上的許可遭拒錯誤。
+ 修正了 RSQL 可能無法正確處理 \$1GOTO 標籤的問題。
+ 修正了 SSL 訊息會以靜音模式列印的問題。
+ 修正了描述預存程序時會顯示隨機字元的問題。
+ 修正了會列印重複 ERROR/INFO 訊息的問題。
新增
+ RSQL 現在會直接從 ODBC 驅動程式取得 SSL 資訊。
*1.0.6 (2023-02-21)*
錯誤修正
+ 在 Redshift 修補程式 1.0.46086 (P173) 上修正了 \$1d 會擲出錯誤 (整數的輸入語法無效: "xid") 的問題。
新增
+ 已重新命名安裝檔案以反映支援的架構。
*1.0.5 (2022-06-27)*
錯誤修正
+ 將 SQL 錯誤訊息傳送到標準錯誤 (stderr)。
+ 修正了使用 ON\$1ERROR\$1STOP 時結束代碼所發生的問題。指令碼現在會在遇到錯誤後結束，並返回正確的結束代碼。
+ Maxerror 現在不區分大小寫。
新增
+ 已新增對 ODBC 2.x 驅動程式的支援。
*1.0.4 (2022-03-19)*
+ 新增對 RSPASSWORD 環境變數的支援。設定密碼以連線到 Amazon Redshift。例如 `export RSPASSWORD=TestPassw0rd`。
*1.0.3 (2021-12-08)*
錯誤修正
+ 修正了在 Windows 作業系統中使用 `\c` 或 `\logon` 在資料庫之間進行切換時的快顯對話方塊。
+ 修正了檢查 ssl 資訊時的損毀問題。
## Amazon Redshift RSQL 的先前版本
請根據您的作業系統選擇其中一個連結，以下載您需要的 Amazon Redshift RSQL 版本。
**Linux 64 位元 RPM**
+ [RSQL 1.1.1 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.1/AmazonRedshiftRsql-1.1.1.rhel.x86_64.rpm)
+ [RSQL 1.1.0 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.0/AmazonRedshiftRsql-1.1.0.rhel.x86_64.rpm)
+ [RSQL 1.0.8 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.8/AmazonRedshiftRsql-1.0.8.x86_64.rpm)
+ [RSQL 1.0.7 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.7/AmazonRedshiftRsql-1.0.7.x86_64.rpm)
+ [RSQL 1.0.6 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.6/AmazonRedshiftRsql-1.0.6.x86_64.rpm)
+ [RSQL 1.0.5 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5-1.x86_64.rpm)
+ [RSQL 1.0.4 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4-1.x86_64.rpm)
+ [RSQL 1.0.3 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3-1.x86_64.rpm)
+ [RSQL 1.0.1 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1-1.x86_64.rpm)
**Mac OS 64 位元 DMG/PKG**
+ [RSQL 1.1.1 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.1/AmazonRedshiftRsql-1.1.1.universal.pkg)
+ [RSQL 1.1.0 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.0/AmazonRedshiftRsql-1.1.0.universal.pkg)
+ [RSQL 1.0.8 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.8/AmazonRedshiftRsql-1.0.8.x86_64.dmg)
+ [RSQL 1.0.7 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.7/AmazonRedshiftRsql-1.0.7.x86_64.dmg)
+ [RSQL 1.0.6 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.6/AmazonRedshiftRsql-1.0.6.x86_64.dmg)
+ [RSQL 1.0.5 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5.dmg)
+ [RSQL 1.0.4 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4.dmg)
+ [RSQL 1.0.3 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3.dmg)
+ [RSQL 1.0.1 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1.dmg)
**Windows 64 位元 MSI**
+ [RSQL 1.1.1 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.1/AmazonRedshiftRsql-1.1.1.x86_64.msi)
+ [RSQL 1.1.0 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.0/AmazonRedshiftRsql-1.1.0.x86_64.msi)
+ [RSQL 1.0.8 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.8/AmazonRedshiftRsql-1.0.8.x86_64.msi)
+ [RSQL 1.0.7 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.7/AmazonRedshiftRsql-1.0.7.x86_64.msi)
+ [RSQL 1.0.6 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.6/AmazonRedshiftRsql-1.0.6.x86_64.msi)
+ [RSQL 1.0.5 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5.msi)
+ [RSQL 1.0.4 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4.msi)
+ [RSQL 1.0.3 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3.msi)
+ [RSQL 1.0.1 版](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1.msi)