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/)을 참조하세요. # ODBC 드라이버 옵션 드라이버 구성 옵션을 사용하여 Amazon Redshift ODBC 드라이버의 동작을 제어할 수 있습니다. 드라이버 옵션은 대소문자를 구분하지 않습니다. Microsoft Windows에서는 일반적으로 데이터 원본 이름(DSN)을 구성할 때 드라이버 옵션을 설정합니다. 프로그래밍 방식으로 연결할 때 또는 `HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\your_DSN`에서 레지스트리 키를 추가하거나 변경하여 연결 문자열에 드라이버 옵션을 설정할 수도 있습니다. Linux에서는 `odbc.ini` 및 `amazon.redshiftodbc.ini` 파일에서 드라이버 구성 옵션을 설정합니다. `amazon.redshiftodbc.ini` 파일에서 설정하는 구성 옵션이 모든 연결에 적용됩니다. 반대로 `odbc.ini` 파일에서 설정하는 구성 옵션은 연결에 따라 다릅니다. `odbc.ini`에서 설정하는 구성 옵션이 `amazon.redshiftodbc.ini`에서 설정하는 구성 옵션보다 우선합니다. 다음은 Amazon Redshift ODBC 드라이버 버전 2.x 드라이버에 지정할 수 있는 옵션에 대한 설명입니다. ## AccessKeyID + **기본값** – 없음 + **데이터 형식** – 문자열 사용자 또는 역할에 대한 IAM 액세스 키입니다. 이 파라미터를 설정할 경우 **SecretAccessKey**도 지정해야 합니다 이 파라미터는 선택 사항입니다. ## app\$1id + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift 애플리케이션과 연결된 Okta 제공 고유 ID입니다. 이 파라미터는 선택 사항입니다. ## ApplicationName + **기본값** – 없음 + **데이터 유형** – 문자열 감사 목적으로 Amazon Redshift에 전달할 클라이언트 애플리케이션의 이름입니다. 입력하는 애플리케이션 이름은 [SYS\$1CONNECTION\$1LOG](https://docs.aws.amazon.com/redshift/latest/dg/SYS_CONNECTION_LOG.html) 테이블의 'application\$1name' 열에 나타납니다. 이렇게 하면 문제를 디버깅할 때 연결 소스를 추적하고 문제를 해결할 수 있습니다. 이 파라미터는 선택 사항입니다. ## app\$1name + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift에 대한 연결을 인증하는 데 사용하는 Okta 애플리케이션의 이름입니다. 이 파라미터는 선택 사항입니다. ## AuthProfile + **기본값** – 없음 + **데이터 형식** – 문자열 연결 설정을 관리하는 데 사용되는 인증 프로필입니다. 이 파라미터를 설정할 경우 **AccessKeyID**와 **SecretAccessKey**도 설정해야 합니다 이 파라미터는 선택 사항입니다. ## AuthType + **기본값** - 표준(Standard) + **데이터 형식** – 문자열 이 옵션은 Amazon Redshift ODBC 드라이버 DSN 설정 대화 상자를 사용하여 DSN을 구성할 때 드라이버가 사용하는 인증 모드를 지정합니다. + 표준(Standard): Amazon Redshift 사용자 이름과 암호를 사용하는 표준 인증입니다. + AWS Profile(프로필): 프로필을 사용하는 IAM 인증입니다. + AWS IAM Credentials(IAM 보안 인증 정보): IAM 보안 인증 정보를 사용하는 IAM 인증입니다. + 자격 증명 공급자(Identity Provider): AD FS: Active Directory Federation Services(AD FS)를 사용하는 IAM 인증입니다. + ID 제공업체: 인증 플러그인: AWS IAM Identity Center 토큰 또는 AWS IAM Identity Center에 연결된 웹 ID 제공업체의 OpenID Connect(OIDC) JSON 기반 자격 증명 토큰(JWT)을 수락하는 권한 부여 플러그인입니다. + 자격 증명 공급자(Identity Provider): Azure AD: Azure AD 포털을 사용한 IAM 인증입니다. + 자격 증명 공급자(Identity Provider): JWT: JSON 웹 토큰(JWT)을 사용한 IAM 인증입니다. + 자격 증명 공급자(Identity Provider): Okta: Okta를 사용한 IAM 인증입니다. + 자격 증명 공급자(Identity Provider): PingFederate: PingFederate를 사용한 IAM 인증입니다. 이 옵션은 Windows 드라이버에서 Amazon Redshift ODBC 드라이버 DSN 설정 대화 상자를 사용하여 DSN을 구성하는 경우에만 사용할 수 있습니다. 연결 문자열 또는 Windows 이외의 시스템을 사용하여 연결을 구성하면, 드라이버가 지정된 자격 증명에 따라 표준, AWS 프로필 또는 AWS IAM 보안 인증 중 어떤 인증 방법을 사용할지 자동으로 결정합니다. 자격 증명 공급자를 사용하려면 **plugin\$1name** 속성을 설정해야 합니다. 이 파라미터는 필수 사항입니다. ## AutoCreate + **기본값** - 0 + **데이터 형식** – 부울 지정된 사용자가 존재하지 않을 경우 드라이버가 새 사용자를 생성할지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: **UID**로 지정된 사용자가 없는 경우 드라이버가 새 사용자를 생성합니다. + 0 \$1 FALSE: 드라이버가 새 사용자를 생성하지 않습니다. 지정된 사용자가 없으면 인증에 실패합니다. 이 파라미터는 선택 사항입니다. ## CaFile + **기본값** – 없음 + **데이터 형식** – 문자열 일부 IAM 인증 방식에 사용되는 CA 인증서 파일의 파일 경로입니다. 이 파라미터는 Linux에서만 사용 가능합니다. 이 파라미터는 선택 사항입니다. ## client\$1id + **기본값** – 없음 + **데이터 형식** – 문자열 Azure AD에서 Amazon Redshift 애플리케이션과 연결된 클라이언트 ID입니다. Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다. ## client\$1 secret + **기본값** – 없음 + **데이터 형식** – 문자열 Azure AD에서 Amazon Redshift 애플리케이션과 연결된 비밀 키입니다. Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다. ## ClusterId + **기본값** – 없음 + **데이터 형식** – 문자열 연결하려는 Amazon Redshift 클러스터의 이름입니다. IAM 인증에 사용됩니다. 이 클러스터 ID는 **Server** 파라미터에 지정되어 있지 않습니다. 이 파라미터는 선택 사항입니다. ## 압축 + **기본값** - 끄기 + **데이터 형식** – 문자열 Amazon Redshift 서버와 클라이언트 또는 드라이버 간의 유선 프로토콜 통신에 사용되는 압축 방법입니다. 다음 값을 지정할 수 있습니다. + lz4: Amazon Redshift와의 유선 프로토콜 통신에 사용되는 압축 방법을 `lz4`로 설정합니다. + zstd: Amazon Redshift와의 유선 프로토콜 통신에 사용되는 압축 방법을 `zstd`로 설정합니다. + off: Amazon Redshift와의 유선 프로토콜 통신에 압축을 사용하지 않습니다. 이 파라미터는 선택 사항입니다. ## 데이터베이스 + **기본값** – 없음 + **데이터 형식** – 문자열 액세스할 Amazon Redshift 데이터베이스의 이름입니다. 이 파라미터는 필수 사항입니다. ## DatabaseMetadataCurrentDbOnly + **기본값** – 1 + **데이터 형식** – 부울 드라이버가 여러 데이터베이스 및 클러스터의 메타데이터를 반환하는지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 현재 데이터베이스의 메타데이터만 반환합니다. + 0 \$1 FALSE. 드라이버가 여러 Amazon Redshift 데이터베이스 및 클러스터의 메타데이터를 반환합니다. 이 파라미터는 선택 사항입니다. ## dbgroups\$1filter + **기본값** – 없음 + **데이터 형식** – 문자열 Azure, 브라우저 Azure 및 브라우저 SAML 인증 유형을 사용할 경우 Amazon Redshift에 대한 SAML 응답에서 수신된 DbGroups를 필터링하기 위해 지정할 수 있는 정규식입니다. 이 파라미터는 선택 사항입니다. ## 드라이버 + **기본값** - Amazon Redshift ODBC 드라이버(x64) + **데이터 형식** – 문자열 드라이버의 이름입니다. 지원되는 유일한 값은 **Amazon Redshift ODBC 드라이버(x64)(Amazon Redshift ODBC Driver (x64))**입니다. **DSN**를 설정하지 않을 경우 이 파라미터가 필요합니다. ## DSN + **기본값** – 없음 + **데이터 형식** – 문자열 드라이버 데이터 소스의 이름입니다. 애플리케이션이 SQLDriverConnect API에 DSN을 지정합니다. **드라이버(Driver)**를 설정하지 않을 경우 이 파라미터가 필요합니다. ## EndpointUrl + **기본값** – 없음 + **데이터 형식** – 문자열 IAM 인증을 위해 Amazon Redshift Coral Service와 통신하는 데 사용되는 재정의 엔드포인트입니다. 이 파라미터는 선택 사항입니다. ## ForceLowercase + **기본값** - 0 + **데이터 형식** – 부울 드라이버가 Single Sing-On 인증을 사용할 때 자격 증명 공급자에서 Amazon Redshift로 전송된 모든 DbGroups를 소문자로 표시할지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 ID 공급자에서 전송된 모든 DbGroups를 소문자로 표시합니다. + 0 \$1 FALSE: 드라이버가 DbGroups를 변경하지 않습니다. 이 파라미터는 선택 사항입니다. ## group\$1federation + **기본값** - 0 + **데이터 형식** – 부울 프로비저닝된 클러스터에서 임시 클러스터 보안 인증 정보를 얻는 데 `getClusterCredentialsWithIAM` API를 사용할지 여부를 지정하는 부울입니다. 이 옵션을 사용하면 IAM 사용자가 프로비저닝된 클러스터의 Redshift 데이터베이스 역할과 통합할 수 있습니다. 이 옵션은 Redshift Serverless 네임스페이스에 적용되지 않습니다. + 1 \$1 TRUE: 드라이버가 `getClusterCredentialsWithIAM` API를 사용하여 프로비저닝된 클러스터에서 임시 클러스터 보안 인증 정보를 얻습니다. + 0 \$1 FALSE: 드라이버가 기본 `getClusterCredentials` API를 사용하여 프로비저닝된 클러스터에서 임시 클러스터 보안 인증 정보를 얻습니다. 이 파라미터는 선택 사항입니다. ## https\$1proxy\$1host + **기본값** – 없음 + **데이터 형식** – 문자열 IAM 인증 프로세스를 통과하도록 하려는 프록시 서버의 호스트 이름 또는 IP 주소입니다. 이 파라미터는 선택 사항입니다. ## https\$1proxy\$1password + **기본값** – 없음 + **데이터 형식** – 문자열 프록시 서버에 액세스하는 데 사용하는 암호입니다. IAM 인증에 사용됩니다. 이 파라미터는 선택 사항입니다. ## https\$1proxy\$1port + **기본값** – 없음 + **데이터 형식** – 정수 프록시 서버가 클라이언트 연결을 수신 대기하는 데 사용하는 포트 번호입니다. IAM 인증에 사용됩니다. 이 파라미터는 선택 사항입니다. ## https\$1proxy\$1username + **기본값** – 없음 + **데이터 형식** – 문자열 프록시 서버에 액세스하는 데 사용하는 사용자 이름입니다. IAM 인증에 사용됩니다. 이 파라미터는 선택 사항입니다. ## IAM + **기본값** - 0 + **데이터 형식** – 부울 드라이버가 IAM 인증 방법을 사용하여 연결을 인증하는지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 IAM 인증 방법(액세스 키와 비밀 키의 페어, 프로필 또는 보안 인증 서비스 사용) 중 하나를 사용합니다. + 0 \$1 FALSE. 드라이버가 표준 인증(데이터베이스 사용자 이름 및 암호 사용)을 사용합니다. 이 파라미터는 선택 사항입니다. ## idc\$1client\$1display\$1name + **기본값** - Amazon Redshift ODBC 드라이버 + **데이터 형식** – 문자열 BrowserIdcAuthPlugin을 사용하는 클라이언트에 사용할 표시 이름입니다. 이 파라미터는 선택 사항입니다. ## idc\$1region + **기본값** – 없음 + **데이터 형식** – 문자열 AWS IAM Identity Center 인스턴스가 위치한 AWS 리전입니다. 이 파라미터는 plugin\$1name 구성 옵션에서 `BrowserIdcAuthPlugin`을 사용하여 인증하는 경우에만 필요합니다. ## idp\$1host + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift에 인증하는 데 사용하는 자격 증명 공급자(IdP) 호스트입니다. 이 파라미터는 선택 사항입니다. ## idp\$1port + **기본값** – 없음 + **데이터 형식** – 정수 Amazon Redshift에 인증하는 데 사용하는 자격 증명 공급자(IdP)용 포트입니다. 클러스터를 생성, 수정 또는 마이그레이션할 때 선택한 포트에 따라 선택한 포트에 대한 액세스를 허용합니다. 이 파라미터는 선택 사항입니다. ## idp\$1response\$1timeout + **기본값** – 120 + **데이터 형식** – 정수 브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스를 사용할 때 드라이버가 자격 증명 공급자의 SAML 응답을 기다리는 시간(초)입니다. 이 파라미터는 선택 사항입니다. ## idp\$1tenant + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift 애플리케이션과 연결된 Azure AD 테넌트 ID입니다. Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다. ## idp\$1partition + **기본값** – 없음 + **데이터 형식** – 문자열 ID 제공업체(IdP)가 구성된 클라우드 파티션을 지정합니다. 드라이버가 연결하는 IdP 인증 엔드포인트를 결정합니다. 이 파라미터를 비워 두면 드라이버는 기본적으로 상용 파티션으로 설정됩니다. 가능한 값은 다음과 같습니다. + `us-gov`: IdP가 Azure Government에 구성된 경우 이 값을 사용합니다. 예를 들어 Azure AD Government는 `login.microsoftonline.us` 엔드포인트를 사용합니다. + `cn`: IdP가 중국 클라우드 파티션에 구성된 경우 이 값을 사용합니다. 예를 들어 Azure AD China는 `login.chinacloudapi.cn` 엔드포인트를 사용합니다. 이 파라미터는 선택 사항입니다. ## idp\$1use\$1https\$1proxy + **기본값** - 0 + **데이터 형식** – 부울 드라이버가 프록시 서버를 통해 아이덴티티 제공업체(IdP)에 대한 인증 프로세스를 통과하는지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 프록시 서버를 통해 IdP 인증 프로세스를 통과합니다. + 0 \$1 FALSE. 드라이버가 프록시 서버를 통해 IdP 인증 프로세스를 통과하지 않습니다. 이 파라미터는 선택 사항입니다. ## InstanceProfile + **기본값** - 0 + **데이터 형식** – 부울 인증에 프로필을 사용하도록 구성된 경우 드라이버가 Amazon EC2 인스턴스 프로파일을 사용하는지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 Amazon EC2 인스턴스 프로파일을 사용합니다. + 0 \$1 FALSE. 드라이버가 프로필 이름 옵션(**Profile(프로필)**)에 지정된 함께 묶은 역할 프로필을 대신 사용합니다. 이 파라미터는 선택 사항입니다. ## issuer\$1url + **기본값** – 없음 + **데이터 형식** – 문자열 AWS IAM Identity Center 서버의 인스턴스 엔드포인트를 가리킵니다. 이 파라미터는 plugin\$1name 구성 옵션에서 `BrowserIdcAuthPlugin`을 사용하여 인증하는 경우에만 필요합니다. ## KeepAlive + **기본값** – 1 + **데이터 형식** – 부울 드라이버가 TCP KeepAlive를 사용하여 연결 시간 초과를 방지하는지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 TCP KeepAlive를 사용하여 연결 시간 초과를 방지합니다. + 0 \$1 FALSE. 드라이버가 TCP KeepAlive를 사용하지 않습니다. 이 파라미터는 선택 사항입니다. ## KeepAliveCount + **기본값** - 0 + **데이터 형식** – 정수 연결이 끊긴 것으로 간주할 때까지 손실될 수 있는 TCP keepalive 패킷의 수입니다. 이 파라미터를 0으로 설정하면 드라이버가 이 설정에 시스템 기본값을 사용합니다. 이 파라미터는 선택 사항입니다. ## KeepAliveInterval + **기본값** - 0 + **데이터 형식** – 정수 TCP keepalive가 재전송되는 시간 간격(초)입니다. 이 파라미터를 0으로 설정하면 드라이버가 이 설정에 시스템 기본값을 사용합니다. 이 파라미터는 선택 사항입니다. ## KeepAliveTime + **기본값** - 0 + **데이터 형식** – 정수 드라이버가 TCP keepalive 패킷을 전송할 때까지 아무런 작업 없이 대기하는 시간(초)입니다. 이 파라미터를 0으로 설정하면 드라이버가 이 설정에 시스템 기본값을 사용합니다. 이 파라미터는 선택 사항입니다. ## listen\$1port + **기본값** – 7890 + **데이터 형식** – 정수 드라이버가 브라우저 플러그인을 통해 SAML, Azure AD 또는 AWS IAM Identity Center 서비스를 사용할 때 ID 제공업체 또는 권한 부여 코드로부터 SAML 응답을 받는 데 사용하는 포트입니다. 이 파라미터는 선택 사항입니다. ## login\$1url + **기본값** – 없음 + **데이터 형식** – 문자열 일반 브라우저 SAML 플러그인을 사용할 때 자격 증명 공급자의 웹 사이트에 있는 리소스의 URL입니다. 브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스로 인증하는 경우 이 파라미터는 필수입니다. ## loginToRp + **기본값** - urn:amazon:webservices + **데이터 형식** – 문자열 AD FS 인증 유형에 사용할 신뢰 당사자 트러스트입니다. 이 문자열은 선택 사항입니다. ## LogLevel + **기본값** - 0 + **데이터 형식** – 정수 이 속성을 사용하여 드라이버에서 로깅을 활성화하거나 비활성화하고 로그 파일에 포함되는 세부 정보의 양을 지정합니다. 로깅은 성능을 저하시킬 뿐만 아니라 대용량의 디스크 공간을 소모할 수 있기 때문에, 문제를 포착하기에 충분한 시간 동안만 로깅을 활성화하는 것이 좋습니다. 이 속성을 다음 값 중 하나로 설정합니다. + 0: 끔. 모든 로깅을 사용 중지합니다. + 1: 오류. 드라이버가 계속 실행되지만 오류가 발생할 수 있는 오류 이벤트를 로깅합니다. + 2: API\$1CALL. 함수 인수 값을 사용하여 ODBC API 함수 호출을 로깅합니다. + 3: 정보. 드라이버의 진행 상황을 설명하는 일반 정보를 로깅합니다. + 4: MSG\$1PROTOCOL. 드라이버의 메시지 프로토콜에 대한 자세한 정보를 로깅합니다. + 5: DEBUG. 모든 드라이버 작업을 로깅합니다. + 6: DEBUG\$1APPEND. 모든 드라이버 작업에 대한 로그를 계속 추가합니다. 로깅을 사용하면 **LogPath** 속성에 지정한 위치에 드라이버가 다음 로그 파일을 생성합니다. + 연결의 핸드셰이크 중에 발생하는 드라이버 작업을 로깅하는 `redshift_odbc.log.1` 파일입니다. + 데이터베이스에 연결한 후의 모든 드라이버 작업에 대한 `redshift_odbc.log` 파일입니다. 이 파라미터는 선택 사항입니다. ## LogPath + **기본값** - OS별 TEMP 디렉터리 + **데이터 형식** – 문자열 **LogLevel**이 0보다 높은 경우 드라이버가 로그 파일을 저장하는 폴더의 전체 경로입니다. 이 파라미터는 선택 사항입니다. ## Min\$1TLS + **기본값** – 1.2 + **데이터 형식** – 문자열 드라이버가 데이터 스토어에서 연결을 암호화하는 데 사용하도록 허용하는 TLS/SSL의 최소 버전입니다. 예를 들어 TLS 1.2를 지정하면 연결을 암호화하는 데 TLS 1.1을 사용할 수 없습니다. Min\$1TLS는 다음 값으로 지정할 수 있습니다. + 1.0: 연결에 TLS 1.0 이상을 사용해야 합니다. + 1.1: 연결에 TLS 1.1 이상을 사용해야 합니다. + 1.2: 연결에 TLS 1.2 이상을 사용해야 합니다. 이 파라미터는 선택 사항입니다. ## partner\$1spid + **기본값** – 없음 + **데이터 형식** – 문자열 PingFederate 서비스를 사용하여 연결을 인증할 때 사용할 파트너 SPID(서비스 공급자 ID) 값입니다. 이 파라미터는 선택 사항입니다. ## Password \$1 PWS + **기본값** – 없음 + **데이터 형식** – 문자열 사용자 필드(**UID**\$1**User(사용자)**\$1**LogonID**)에서 제공한 데이터베이스 사용자 이름에 해당하는 암호입니다. 이 파라미터는 선택 사항입니다. ## plugin\$1name + **기본값** – 없음 + **데이터 형식** – 문자열 인증에 사용할 보안 인증 공급자 플러그인 이름입니다. 다음과 같은 값이 지원됩니다. + `ADFS`: Active Directory Federation Services를 사용하여 인증합니다. + `AzureAD`: Microsoft Azure Active Directory(AD) Service를 사용하여 인증합니다.. + `BrowserAzureAD`: Microsoft Azure Active Directory(AD) Service용 브라우저 플러그인을 사용하여 인증합니다. + `BrowserIdcAuthPlugin `: AWS IAM Identity Center를 사용하는 인증 플러그인입니다. + `BrowserSAML`: Okta 또는 Ping과 같은 SAML 서비스용 브라우저 플러그인을 사용하여 인증합니다. + `IdpTokenAuthPlugin`: AWS IAM Identity Center 토큰 또는 AWS IAM Identity Center에 연결된 웹 ID 제공업체의 OpenID Connect(OIDC) JSON 기반 자격 증명 토큰(JWT)을 수락하는 권한 부여 플러그인입니다. + `JWT`: JSON 웹 토큰(JWT)을 사용하여 인증합니다. + `Ping`: PingFederate 서비스를 사용하여 인증합니다. + `Okta`: Okta 서비스를 사용하여 인증합니다. 이 파라미터는 선택 사항입니다. ## Port \$1 PortNumber + **기본값** - 5439 + **데이터 형식** – 정수 Amazon Redshift 서버가 클라이언트 연결을 수신 대기하는 데 사용하는 TCP 포트의 번호입니다. 이 파라미터는 선택 사항입니다. ## preferred\$1role + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift에 연결하는 동안 수임하려는 역할입니다. IAM 인증에 사용됩니다. 이 파라미터는 선택 사항입니다. ## 프로필 + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift에 연결하기 위한 인증에 사용되는 사용자 AWS 프로필의 이름입니다. + 인스턴스 프로파일 사용(Use Instance Profile) 파라미터(**InstanceProfile** 속성)가 1 \$1 TRUE로 설정된 경우 해당 설정이 우선하며 드라이버가 Amazon EC2 인스턴스 프로파일을 대신 사용합니다. + 프로필이 포함된 보안 인증 파일의 기본 위치는 `~/.aws/Credentials`입니다. `AWS_SHARED_CREDENTIALS_FILE` 환경 변수를 사용하여 다른 보안 인증 파일을 가리킬 수 있습니다. 이 파라미터는 선택 사항입니다. ## provider\$1name + **기본값** – 없음 + **데이터 형식** – 문자열 사용자가 CREATE IDENTITY PROVIDER 쿼리를 사용하여 생성한 인증 공급자입니다. 네이티브 Amazon Redshift 인증에 사용됩니다. 이 파라미터는 선택 사항입니다. ## ProxyHost + **기본값** – 없음 + **데이터 형식** – 문자열 연결하는 데 사용할 프록시 서버의 호스트 이름 또는 IP 주소입니다. 이 파라미터는 선택 사항입니다. ## ProxyPort + **기본값** – 없음 + **데이터 형식** – 정수 프록시 서버가 클라이언트 연결을 수신 대기하는 데 사용하는 포트 번호입니다. 이 파라미터는 선택 사항입니다. ## ProxyPwd + **기본 ValPrevious ODBC 드라이버 버전** - 없음 + **데이터 형식** – 문자열 프록시 서버에 액세스하는 데 사용하는 암호입니다. 이 파라미터는 선택 사항입니다. ## ProxyUid + **기본값** – 없음 + **데이터 형식** – 문자열 프록시 서버에 액세스하는 데 사용하는 사용자 이름입니다. 이 파라미터는 선택 사항입니다. ## ReadOnly + **기본값** - 0 + **데이터 형식** – 부울 드라이버가 읽기 전용 모드인지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 연결이 읽기 전용 모드이며 데이터 스토어에 쓸 수 없습니다. + 0 \$1 FALSE: 연결이 읽기 전용 모드가 아니며 데이터 스토어에 쓸 수 있습니다. 이 파라미터는 선택 사항입니다. ## region + **기본값** – 없음 + **데이터 형식** – 문자열 클러스터가 있는 AWS 리전입니다. 이 파라미터는 선택 사항입니다. ## SecretAccessKey + **기본값** – 없음 + **데이터 형식** – 문자열 사용자 또는 역할에 대한 IAM 비밀 키입니다. 이 파라미터를 설정할 경우 **AccessKeyID**도 설정해야 합니다 이 파라미터는 선택 사항입니다. ## SessionToken + **기본값** – 없음 + **데이터 형식** – 문자열 인증에 사용하는 IAM 역할과 연결된 임시 IAM 세션 토큰입니다. 이 파라미터는 선택 사항입니다. ## Server \$1 HostName \$1 Host + **기본값** – 없음 + **데이터 형식** – 문자열 연결할 엔드포인트 서버입니다. 이 파라미터는 필수 사항입니다. ## ssl\$1insecure + **기본값** - 0 + **데이터 형식** – 부울 드라이버가 IdP 서버 인증서의 신뢰성을 확인하는지 여부를 지정하는 부울 값입니다. + 1 \$1 TRUE: 드라이버가 IdP 서버 인증서의 신뢰성을 확인하지 않습니다. + 0 \$1 FALSE: 드라이버가 IdP 서버 인증서의 신뢰성을 확인합니다. 이 파라미터는 선택 사항입니다. ## SSLMode + **기본값** – `verify-ca` + **데이터 형식** – 문자열 Amazon Redshift 연결 시 사용할 SSL 인증서 검증 모드입니다. 다음과 같은 값이 가능합니다. + `verify-full`: SSL, 신뢰할 수 있는 인증 기관 및 인증서와 일치하는 서버 이름을 사용해서만 연결합니다. + `verify-ca`: SSL 및 신뢰할 수 있는 인증 기관을 사용해서만 연결합니다. + `require`: SSL을 사용해서만 연결합니다. + `prefer`: 가능한 경우 SSL을 사용하여 연결합니다. 그렇지 않으면 SSL을 사용하지 않고 연결합니다. + `allow`: 기본적으로 SSL을 사용하지 않고 연결합니다. 서버에서 SSL 연결을 요구하는 경우 SSL을 사용합니다. + `disable`: SSL을 사용하지 않고 연결합니다. 이 파라미터는 선택 사항입니다. ## StsConnectionTimeout + **기본값** - 0 + **데이터 형식** – 정수 IAM 연결의 최대 대기 시간(초)입니다. 0으로 설정되거나 지정되지 않은 경우, 드라이버는 각 AWS STS 호출에 대해 60초 동안 대기합니다. 이 파라미터는 선택 사항입니다. ## StsEndpointUrl + **기본값** – 없음 + **데이터 형식** – 문자열 이 옵션은 AWS Security Token Service(AWS STS)와 통신하는 데 사용되는 재정의 엔드포인트를 지정합니다.. 이 파라미터는 선택 사항입니다. ## 토큰 + **기본값** – 없음 + **데이터 형식** – 문자열 AWS IAM Identity Center에서 제공한 액세스 토큰 또는 AWS IAM Identity Center와 연결된 웹 ID 제공업체가 제공한 OpenID Connect(OIDC) JSON 웹 토큰(JWT)입니다. 애플리케이션은 AWS IAM Identity Center 또는 AWS IAM Identity Center와 연결된 자격 증명 공급자를 통해 애플리케이션 사용자를 인증하여 이 토큰을 생성해야 합니다. 이 파라미터는 `IdpTokenAuthPlugin`과 함께 작동합니다. ## token\$1type + **기본값** – 없음 + **데이터 형식** – 문자열 `IdpTokenAuthPlugin`에서 사용되는 토큰 유형입니다. 다음 값을 지정할 수 있습니다. **ACCESS\$1TOKEN** AWS IAM Identity Center에서 제공한 액세스 토큰을 사용하는 경우 이 값을 입력합니다. **EXT\$1JWT** AWS IAM Identity Center와 통합된 웹 기반 ID 제공업체가 제공하는 OpenID Connect(OIDC) JSON 웹 토큰(JWT)을 사용하는 경우 이 값을 입력합니다. 이 파라미터는 `IdpTokenAuthPlugin`과 함께 작동합니다. ## UID \$1 User \$1 LogonID + **기본값** – 없음 + **데이터 형식** – 문자열 Amazon Redshift 서버에 액세스하는 데 사용하는 사용자 이름입니다. 데이터베이스 인증을 사용하는 경우 이 파라미터가 필요합니다. ## UseUnicode + **기본값** - 0 + **데이터 형식** – 부울 드라이버가 Redshift 데이터를 유니코드 또는 일반 SQL 유형으로 반환할지 여부를 지정하는 부울입니다. + 1 \$1 TRUE: 드라이버가 문자 데이터 유형에 대해 와이드 SQL 유형을 반환합니다. + SQL\$1CHAR 대신 SQL\$1WCHAR가 반환됩니다. + SQL\$1VARCHAR 대신 SQL\$1WVARCHAR가 반환됩니다. + SQL\$1LONGVARCHAR 대신 SQL\$1WLONGVARCHAR가 반환됩니다. + 0 \$1 FALSE: 드라이버가 문자 데이터 유형에 대해 일반 SQL 유형을 반환합니다. + SQL\$1WCHAR 대신 SQL\$1CHAR가 반환됩니다. + SQL\$1WVARCHAR 대신 SQL\$1VARCHAR가 반환됩니다. + SQL\$1WLONGVARCHAR 대신 SQL\$1LONGVARCHAR가 반환됩니다. 이 파라미터는 선택 사항입니다. 드라이버 버전 2.1.15 이상에서 사용할 수 있습니다. ## web\$1identity\$1token + **기본값** – 없음 + **데이터 형식** – 문자열 자격 증명 공급자가 제공하는 OAUTH 토큰입니다. JWT 플러그인에서 사용됩니다. **plugin\$1name** 파라미터를 BasicJwtCredentialsProvider로 설정한 경우 이 파라미터가 필요합니다.