Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 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은 Amazon Redshift에 특정한 추가 기능 집합과 함께 PostgreSQL psql 명령줄 도구의 기능을 지원합니다. 여기에는 다음이 포함됩니다.
+ AD FS, PingIdentity, Okta, Azure ADm 또는 기타 SAML/JWT 기반 ID 제공업체를 통한 Single Sign-On을 사용할 수 있습니다. 멀티 팩터 인증(MFA)에 브라우저 기반 SAML 자격 증명 공급자를 사용할 수도 있습니다.
+ 테이블 배포 키, 테이블 정렬 키, 후기 바인딩 보기(LBV) 및 구체화된 보기와 같은 Amazon Redshift 객체의 속성을 설명할 수 있습니다. AWS Glue 카탈로그 또는 Apache Hive Metastore, 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을 사용하여 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)
+ macOS 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 설치
아래 단계에 따라 macOS X용 RSQL을 설치합니다.
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. `/usr/local/lib`에 없으면 `DYLD_LIBRARY_PATH`를 libodbc.dylib의 위치로 설정합니다.
```
export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/usr/local/lib
```
1. pkg 파일을 두 번 클릭하여 설치 프로그램을 실행합니다.
1. 설치 관리자의 단계에 따라 설치를 완료합니다. 라이선스 계약 조건에 동의합니다.
## Windows용 RSQL 설치
아래 단계에 따라 Windows용 RSQL을 설치합니다.
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 가져오기 파라미터 크기를 초과할 때 RSQL 충돌이 발생하는 버그를 수정했습니다.
+ 페이저가 켜져 있더라도 여러 페이지의 결과가 한 번에 반환되는 문제를 수정했습니다.
+ 트랜잭션 블록 내에서 쿼리가 실패할 때 RSQL 충돌을 트리거하는 버그를 수정했습니다.
*1.1.1(2025-11-20)*
버그 수정
+ -c 플래그를 사용할 때 RSQL이 쿼리를 잘못 구문 분석하는 문제를 수정했습니다. 이 수정 사항은 모든 플랫폼에 적용됩니다.
+ 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 명령으로 출력이 잘리는 문제를 수정했습니다.
+ \$1de에 외부 Kinesis 스트림 및 Kafka 주제 설명을 위한 지원이 추가되었습니다.
*1.0.7(2023-03-22)*
버그 수정
+ RSQL이 구체화된 뷰를 설명할 수 없는 문제가 수정되었습니다.
+ Amazon Redshift Serverless를 사용할 때 stl\$1connection\$1log의 권한 거부 오류가 수정되었습니다.
+ RSQL이 \$1GOTO 레이블을 잘못 처리할 수 있는 문제가 해결되었습니다.
+ 자동 모드에서 SSL 메시지가 출력되는 문제가 해결되었습니다.
+ 저장된 프로시저를 설명할 때 임의의 문자가 표시되는 문제가 해결되었습니다.
+ 중복된 오류/정보 메시지가 출력되는 문제가 해결되었습니다.
New
+ RSQL이 이제 ODBC 드라이버에서 직접 SSL 정보를 가져옵니다.
*1.0.6(2023-02-21)*
버그 수정
+ Redshift 패치 1.0.46086(P173)에서 \$1d가 잘못된 정수 입력 구문: ‘xid’라는 오류가 발생하는 문제를 수정했습니다.
New
+ 지원되는 아키텍처를 반영하도록 설치 파일의 이름을 변경했습니다.
*1.0.5(2022-06-27)*
버그 수정
+ SQL 오류 메시지를 표준 오류(stderr)로 보냅니다.
+ ON\$1ERROR\$1STOP을 사용할 때 발생하는 종료 코드 문제를 해결했습니다. 이제 오류가 발생하면 스크립트가 종료되고 올바른 종료 코드를 반환합니다.
+ Maxerror가 이제 대/소문자를 구분하지 않습니다.
New
+ ODBC 2.x 드라이브에 대한 지원이 추가되었습니다.
*1.0.4(2022-03-19)*
+ RSPASSWORD 환경 변수에 대한 지원을 추가합니다. Amazon Redshift Redshift에 연결할 암호를 설정합니다. 예를 들어 `export RSPASSWORD=TestPassw0rd`입니다.
*1.0.3(2021-12-08)*
버그 수정
+ Windows OS에서 `\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)
**macOS 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)