ODBC 드라이버 옵션 구성 - Amazon Redshift

ODBC 드라이버 옵션 구성

드라이버 구성 옵션을 사용하여 Amazon Redshift ODBC 드라이버의 동작을 제어할 수 있습니다. 드라이버 옵션은 대소문자를 구분하지 않습니다.

Microsoft Windows에서는 일반적으로 데이터 원본 이름(DSN)을 구성할 때 드라이버 옵션을 설정합니다. 프로그래밍 방식으로 연결할 때 또는 HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\your_DSN에서 레지스트리 키를 추가하거나 변경하여 연결 문자열에 드라이버 옵션을 설정할 수도 있습니다. DSN 구성에 대한 자세한 내용은 Microsoft Windows에서 Amazon Redshift ODBC 드라이버 설치 및 구성 섹션을 참조하세요.

Linux에서는 ODBC 드라이버 관리자를 사용하여 Linux 및 macOS X 운영 체제에서 드라이버 구성 섹션에서 설명한 바와 같이 드라이버 구성 옵션을 odbc.iniamazon.redshiftodbc.ini 파일에서 설정합니다. amazon.redshiftodbc.ini 파일에서 설정하는 구성 옵션이 모든 연결에 적용됩니다. 반대로 odbc.ini 파일에서 설정하는 구성 옵션은 연결에 따라 다릅니다. odbc.ini에서 설정하는 구성 옵션이 amazon.redshiftodbc.ini에서 설정하는 구성 옵션보다 우선합니다.

다음은 Amazon Redshift ODBC 드라이버 버전 2.x 드라이버에 지정할 수 있는 옵션에 대한 설명입니다.

AccessKeyID

  • 기본값 – 없음

  • 데이터 형식 – 문자열

사용자 또는 역할에 대한 IAM 액세스 키입니다. 이 파라미터를 설정할 경우 SecretAccessKey도 지정해야 합니다

이 파라미터는 선택 사항입니다.

app_id

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift 애플리케이션과 연결된 Okta 제공 고유 ID입니다.

이 파라미터는 선택 사항입니다.

app_name

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift에 대한 연결을 인증하는 데 사용하는 Okta 애플리케이션의 이름입니다.

이 파라미터는 선택 사항입니다.

AuthProfile

  • 기본값 – 없음

  • 데이터 형식 – 문자열

연결 설정을 관리하는 데 사용되는 인증 프로필입니다. 이 파라미터를 설정할 경우 AccessKeyIDSecretAccessKey도 설정해야 합니다

이 파라미터는 선택 사항입니다.

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 인증입니다.

  • 자격 증명 공급자: 인증 플러그인: IAM Identity Center 토큰 또는 IAM Identity Center에 연결된 웹 자격 증명 공급자의 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_name 속성을 설정해야 합니다.

이 파라미터는 필수 사항입니다.

AutoCreate

  • 기본값 - 0

  • 데이터 형식 – 부울

지정된 사용자가 존재하지 않을 경우 드라이버가 새 사용자를 생성할지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: UID로 지정된 사용자가 없는 경우 드라이버가 새 사용자를 생성합니다.

  • 0 | FALSE: 드라이버가 새 사용자를 생성하지 않습니다. 지정된 사용자가 없으면 인증에 실패합니다.

이 파라미터는 선택 사항입니다.

CaFile

  • 기본값 – 없음

  • 데이터 형식 – 문자열

일부 IAM 인증 방식에 사용되는 CA 인증서 파일의 파일 경로입니다.

이 파라미터는 Linux에서만 사용 가능합니다.

이 파라미터는 선택 사항입니다.

client_id

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Azure AD에서 Amazon Redshift 애플리케이션과 연결된 클라이언트 ID입니다.

Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다.

client_ 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 | TRUE: 드라이버가 현재 데이터베이스의 메타데이터만 반환합니다.

  • 0 | FALSE. 드라이버가 여러 Amazon Redshift 데이터베이스 및 클러스터의 메타데이터를 반환합니다.

이 파라미터는 선택 사항입니다.

dbgroups_filter

  • 기본값 – 없음

  • 데이터 형식 – 문자열

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 | TRUE: 드라이버가 ID 공급자에서 전송된 모든 DbGroups를 소문자로 표시합니다.

  • 0 | FALSE: 드라이버가 DbGroups를 변경하지 않습니다.

이 파라미터는 선택 사항입니다.

group_federation

  • 기본값 - 0

  • 데이터 형식 – 부울

프로비저닝된 클러스터에서 임시 클러스터 보안 인증 정보를 얻는 데 getClusterCredentialsWithIAM API를 사용할지 여부를 지정하는 부울입니다. 이 옵션을 사용하면 IAM 사용자가 프로비저닝된 클러스터의 Redshift 데이터베이스 역할과 통합할 수 있습니다. 이 옵션은 Redshift Serverless 네임스페이스에 적용되지 않습니다.

  • 1 | TRUE: 드라이버가 getClusterCredentialsWithIAM API를 사용하여 프로비저닝된 클러스터에서 임시 클러스터 보안 인증 정보를 얻습니다.

  • 0 | FALSE: 드라이버가 기본 getClusterCredentials API를 사용하여 프로비저닝된 클러스터에서 임시 클러스터 보안 인증 정보를 얻습니다.

이 파라미터는 선택 사항입니다.

https_proxy_host

  • 기본값 – 없음

  • 데이터 형식 – 문자열

IAM 인증 프로세스를 통과하도록 하려는 프록시 서버의 호스트 이름 또는 IP 주소입니다.

이 파라미터는 선택 사항입니다.

https_proxy_password

  • 기본값 – 없음

  • 데이터 형식 – 문자열

프록시 서버에 액세스하는 데 사용하는 암호입니다. IAM 인증에 사용됩니다.

이 파라미터는 선택 사항입니다.

https_proxy_port

  • 기본값 – 없음

  • 데이터 형식 – 정수

프록시 서버가 클라이언트 연결을 수신 대기하는 데 사용하는 포트 번호입니다. IAM 인증에 사용됩니다.

이 파라미터는 선택 사항입니다.

https_proxy_username

  • 기본값 – 없음

  • 데이터 형식 – 문자열

프록시 서버에 액세스하는 데 사용하는 사용자 이름입니다. IAM 인증에 사용됩니다.

이 파라미터는 선택 사항입니다.

IAM

  • 기본값 - 0

  • 데이터 형식 – 부울

드라이버가 IAM 인증 방법을 사용하여 연결을 인증하는지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: 드라이버가 IAM 인증 방법(액세스 키와 비밀 키의 페어, 프로필 또는 보안 인증 서비스 사용) 중 하나를 사용합니다.

  • 0 | FALSE. 드라이버가 표준 인증(데이터베이스 사용자 이름 및 암호 사용)을 사용합니다.

이 파라미터는 선택 사항입니다.

identity_namespace

  • 기본값 – 없음

  • 데이터 형식 – 문자열

IdpTokenAuthPlugin을 사용하여 인증할 때 사용되는 ID 네임스페이스입니다. Redshift가 사용할 IAM Identity Center 인스턴스를 결정하는 데 도움이 됩니다.

IAM Identity Center 인스턴스가 하나뿐이거나 기본 ID 네임스페이스가 설정된 경우 이 파라미터는 선택 사항이고, 그렇지 않은 경우 필수 사항입니다.

idp_host

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift에 인증하는 데 사용하는 자격 증명 공급자(IdP) 호스트입니다.

이 파라미터는 선택 사항입니다.

idp_port

  • 기본값 – 없음

  • 데이터 형식 – 정수

Amazon Redshift에 인증하는 데 사용하는 자격 증명 공급자(IdP)용 포트입니다. 클러스터를 생성, 수정 또는 마이그레이션할 때 선택한 포트에 따라 선택한 포트에 대한 액세스를 허용합니다.

이 파라미터는 선택 사항입니다.

idp_response_timeout

  • 기본값 – 120

  • 데이터 형식 – 정수

브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스를 사용할 때 드라이버가 자격 증명 공급자의 SAML 응답을 기다리는 시간(초)입니다.

이 파라미터는 선택 사항입니다.

idp_tenant

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift 애플리케이션과 연결된 Azure AD 테넌트 ID입니다.

Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다.

idp_use_https_proxy

  • 기본값 - 0

  • 데이터 형식 – 부울

드라이버가 프록시 서버를 통해 아이덴티티 제공업체(IdP)에 대한 인증 프로세스를 통과하는지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: 드라이버가 프록시 서버를 통해 IdP 인증 프로세스를 통과합니다.

  • 0 | FALSE. 드라이버가 프록시 서버를 통해 IdP 인증 프로세스를 통과하지 않습니다.

이 파라미터는 선택 사항입니다.

InstanceProfile

  • 기본값 - 0

  • 데이터 형식 – 부울

인증에 프로필을 사용하도록 구성된 경우 드라이버가 Amazon EC2 인스턴스 프로파일을 사용하는지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: 드라이버가 Amazon EC2 인스턴스 프로파일을 사용합니다.

  • 0 | FALSE. 드라이버가 프로필 이름 옵션(Profile(프로필))에 지정된 함께 묶은 역할 프로필을 대신 사용합니다.

이 파라미터는 선택 사항입니다.

KeepAlive

  • 기본값 – 1

  • 데이터 형식 – 부울

드라이버가 TCP KeepAlive를 사용하여 연결 시간 초과를 방지하는지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: 드라이버가 TCP KeepAlive를 사용하여 연결 시간 초과를 방지합니다.

  • 0 | FALSE. 드라이버가 TCP KeepAlive를 사용하지 않습니다.

이 파라미터는 선택 사항입니다.

KeepAliveCount

  • 기본값 - 0

  • 데이터 형식 – 정수

연결이 끊긴 것으로 간주할 때까지 손실될 수 있는 TCP keepalive 패킷의 수입니다. 이 파라미터를 0으로 설정하면 드라이버가 이 설정에 시스템 기본값을 사용합니다.

이 파라미터는 선택 사항입니다.

KeepAliveInterval

  • 기본값 - 0

  • 데이터 형식 – 정수

TCP keepalive가 재전송되는 시간 간격(초)입니다. 이 파라미터를 0으로 설정하면 드라이버가 이 설정에 시스템 기본값을 사용합니다.

이 파라미터는 선택 사항입니다.

KeepAliveTime

  • 기본값 - 0

  • 데이터 형식 – 정수

드라이버가 TCP keepalive 패킷을 전송할 때까지 아무런 작업 없이 대기하는 시간(초)입니다. 이 파라미터를 0으로 설정하면 드라이버가 이 설정에 시스템 기본값을 사용합니다.

이 파라미터는 선택 사항입니다.

listen_port

  • 기본값 – 7890

  • 데이터 형식 – 정수

브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스를 사용할 때 드라이버가 자격 증명 공급자로부터 SAML 응답을 수신하는 데 사용하는 포트입니다.

이 파라미터는 선택 사항입니다.

login_url

  • 기본값 – 없음

  • 데이터 형식 – 문자열

일반 브라우저 SAML 플러그인을 사용할 때 자격 증명 공급자의 웹 사이트에 있는 리소스의 URL입니다.

브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스로 인증하는 경우 이 파라미터는 필수입니다.

loginToRp

  • 기본값 - urn:amazon:webservices

  • 데이터 형식 – 문자열

AD FS 인증 유형에 사용할 신뢰 당사자 트러스트입니다.

이 문자열은 선택 사항입니다.

LogLevel

  • 기본값 - 0

  • 데이터 형식 – 정수

이 속성을 사용하여 드라이버에서 로깅을 활성화하거나 비활성화하고 로그 파일에 포함되는 세부 정보의 양을 지정합니다. 로깅은 성능을 저하시킬 뿐만 아니라 대용량의 디스크 공간을 소모할 수 있기 때문에, 문제를 포착하기에 충분한 시간 동안만 로깅을 활성화하는 것이 좋습니다.

이 속성을 다음 값 중 하나로 설정합니다.

  • 0: 끔. 모든 로깅을 사용 중지합니다.

  • 1: 오류. 드라이버가 계속 실행되지만 오류가 발생할 수 있는 오류 이벤트를 로깅합니다.

  • 2: API_CALL. 함수 인수 값을 사용하여 ODBC API 함수 호출을 로깅합니다.

  • 3: 정보. 드라이버의 진행 상황을 설명하는 일반 정보를 로깅합니다.

  • 4: MSG_PROTOCOL. 드라이버의 메시지 프로토콜에 대한 자세한 정보를 로깅합니다.

  • 5: DEBUG. 모든 드라이버 작업을 로깅합니다.

  • 6: DEBUG_APPEND. 모든 드라이버 작업에 대한 로그를 계속 추가합니다.

로깅을 사용하면 LogPath 속성에 지정한 위치에 드라이버가 다음 로그 파일을 생성합니다.

  • 연결의 핸드셰이크 중에 발생하는 드라이버 작업을 로깅하는 redshift_odbc.log.1 파일입니다.

  • 데이터베이스에 연결한 후의 모든 드라이버 작업에 대한 redshift_odbc.log 파일입니다.

이 파라미터는 선택 사항입니다.

LogPath

  • 기본값 - OS별 TEMP 디렉터리

  • 데이터 형식 – 문자열

LogLevel이 0보다 높은 경우 드라이버가 로그 파일을 저장하는 폴더의 전체 경로입니다.

이 파라미터는 선택 사항입니다.

Min_TLS

  • 기본값 – 1.2

  • 데이터 형식 – 문자열

드라이버가 데이터 스토어에서 연결을 암호화하는 데 사용하도록 허용하는 TLS/SSL의 최소 버전입니다. 예를 들어 TLS 1.2를 지정하면 연결을 암호화하는 데 TLS 1.1을 사용할 수 없습니다.

Min_TLS는 다음 값으로 지정할 수 있습니다.

  • 1.0: 연결에 TLS 1.0 이상을 사용해야 합니다.

  • 1.1: 연결에 TLS 1.1 이상을 사용해야 합니다.

  • 1.2: 연결에 TLS 1.2 이상을 사용해야 합니다.

이 파라미터는 선택 사항입니다.

partner_spid

  • 기본값 – 없음

  • 데이터 형식 – 문자열

PingFederate 서비스를 사용하여 연결을 인증할 때 사용할 파트너 SPID(서비스 공급자 ID) 값입니다.

이 파라미터는 선택 사항입니다.

Password | PWS

  • 기본값 – 없음

  • 데이터 형식 – 문자열

사용자 필드(UID|User(사용자)|LogonID)에서 제공한 데이터베이스 사용자 이름에 해당하는 암호입니다.

이 파라미터는 선택 사항입니다.

plugin_name

  • 기본값 – 없음

  • 데이터 형식 – 문자열

인증에 사용할 보안 인증 공급자 플러그인 이름입니다.

다음과 같은 값이 지원됩니다.

  • ADFS: Active Directory Federation Services를 사용하여 인증합니다.

  • AzureAD: Microsoft Azure Active Directory(AD) Service를 사용하여 인증합니다..

  • BrowserAzureAD: Microsoft Azure Active Directory(AD) Service용 브라우저 플러그인을 사용하여 인증합니다.

  • BrowserSAML: Okta 또는 Ping과 같은 SAML 서비스용 브라우저 플러그인을 사용하여 인증합니다.

  • IdpTokenAuthPlugin: IAM Identity Center 토큰 또는 IAM Identity Center에 연결된 웹 자격 증명 공급자의 OpenID Connect(OIDC) JSON 기반 자격 증명 토큰(JWT)을 수락하는 권한 부여 플러그인입니다.

  • JWT: JSON 웹 토큰(JWT)을 사용하여 인증합니다.

  • Ping: PingFederate 서비스를 사용하여 인증합니다.

  • Okta: Okta 서비스를 사용하여 인증합니다.

이 파라미터는 선택 사항입니다.

Port | PortNumber

  • 기본값 - 5439

  • 데이터 형식 – 정수

Amazon Redshift 서버가 클라이언트 연결을 수신 대기하는 데 사용하는 TCP 포트의 번호입니다.

이 파라미터는 선택 사항입니다.

preferred_role

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift에 연결하는 동안 수임하려는 역할입니다. IAM 인증에 사용됩니다.

이 파라미터는 선택 사항입니다.

프로필

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift에 연결하기 위한 인증에 사용되는 사용자 AWS 프로필의 이름입니다.

  • 인스턴스 프로파일 사용(Use Instance Profile) 파라미터(InstanceProfile 속성)가 1 | TRUE로 설정된 경우 해당 설정이 우선하며 드라이버가 Amazon EC2 인스턴스 프로파일을 대신 사용합니다.

  • 프로필이 포함된 보안 인증 파일의 기본 위치는 ~/.aws/Credentials입니다. AWS_SHARED_CREDENTIALS_FILE 환경 변수를 사용하여 다른 보안 인증 파일을 가리킬 수 있습니다.

이 파라미터는 선택 사항입니다.

provider_name

  • 기본값 – 없음

  • 데이터 형식 – 문자열

사용자가 CREATE IDENTITY PROVIDER 쿼리를 사용하여 생성한 인증 공급자입니다. 네이티브 Amazon Redshift 인증에 사용됩니다.

이 파라미터는 선택 사항입니다.

ProxyHost

  • 기본값 – 없음

  • 데이터 형식 – 문자열

연결하는 데 사용할 프록시 서버의 호스트 이름 또는 IP 주소입니다.

이 파라미터는 선택 사항입니다.

ProxyPort

  • 기본값 – 없음

  • 데이터 형식 – 정수

프록시 서버가 클라이언트 연결을 수신 대기하는 데 사용하는 포트 번호입니다.

이 파라미터는 선택 사항입니다.

ProxyPwd

  • 기본값 – 없음

  • 데이터 형식 – 문자열

프록시 서버에 액세스하는 데 사용하는 암호입니다.

이 파라미터는 선택 사항입니다.

ProxyUid

  • 기본값 – 없음

  • 데이터 형식 – 문자열

프록시 서버에 액세스하는 데 사용하는 사용자 이름입니다.

이 파라미터는 선택 사항입니다.

ReadOnly

  • 기본값 - 0

  • 데이터 형식 – 부울

드라이버가 읽기 전용 모드인지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: 연결이 읽기 전용 모드이며 데이터 스토어에 쓸 수 없습니다.

  • 0 | FALSE: 연결이 읽기 전용 모드가 아니며 데이터 스토어에 쓸 수 있습니다.

이 파라미터는 선택 사항입니다.

region

  • 기본값 – 없음

  • 데이터 형식 – 문자열

클러스터가 있는 AWS 리전입니다.

이 파라미터는 선택 사항입니다.

SecretAccessKey

  • 기본값 – 없음

  • 데이터 형식 – 문자열

사용자 또는 역할에 대한 IAM 비밀 키입니다. 이 파라미터를 설정할 경우 AccessKeyID도 설정해야 합니다

이 파라미터는 선택 사항입니다.

SessionToken

  • 기본값 – 없음

  • 데이터 형식 – 문자열

인증에 사용하는 IAM 역할과 연결된 임시 IAM 세션 토큰입니다.

이 파라미터는 선택 사항입니다.

Server | HostName | Host

  • 기본값 – 없음

  • 데이터 형식 – 문자열

연결할 엔드포인트 서버입니다.

이 파라미터는 필수 사항입니다.

ssl_insecure

  • 기본값 - 0

  • 데이터 형식 – 부울

드라이버가 IdP 서버 인증서의 신뢰성을 확인하는지 여부를 지정하는 부울 값입니다.

  • 1 | TRUE: 드라이버가 IdP 서버 인증서의 신뢰성을 확인하지 않습니다.

  • 0 | 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)와 통신하는 데 사용되는 재정의 엔드포인트를 지정합니다..

이 파라미터는 선택 사항입니다.

token

  • 기본값 – 없음

  • 데이터 형식 – 문자열

IAM Identity Center에서 제공한 액세스 토큰 또는 IAM Identity Center와 연결된 웹 자격 증명 공급자가 제공한 OpenID Connect(OIDC) JSON 웹 토큰(JWT)입니다. 애플리케이션은 IAM Identity Center 또는 IAM Identity Center와 연결된 자격 증명 공급자를 통해 애플리케이션 사용자를 인증하여 이 토큰을 생성해야 합니다.

이 파라미터는 IdpTokenAuthPlugin과 함께 작동합니다.

token_type

  • 기본값 – 없음

  • 데이터 형식 – 문자열

IdpTokenAuthPlugin에서 사용되는 토큰 유형입니다.

다음 값을 지정할 수 있습니다.

ACCESS_TOKEN

IAM Identity Center에서 제공한 액세스 토큰을 사용하는 경우 이 값을 입력합니다.

EXT_JWT

IAM Identity Center와 통합된 웹 기반 자격 증명 공급자가 제공하는 OpenID Connect(OIDC) JSON 웹 토큰(JWT)을 사용하는 경우 이 값을 입력합니다.

이 파라미터는 IdpTokenAuthPlugin과 함께 작동합니다.

UID | User | LogonID

  • 기본값 – 없음

  • 데이터 형식 – 문자열

Amazon Redshift 서버에 액세스하는 데 사용하는 사용자 이름입니다.

데이터베이스 인증을 사용하는 경우 이 파라미터가 필요합니다.

web_identity_token

  • 기본값 – 없음

  • 데이터 형식 – 문자열

자격 증명 공급자가 제공하는 OAUTH 토큰입니다. JWT 플러그인에서 사용됩니다.

plugin_name 파라미터를 BasicJwtCredentialsProvider로 설정한 경우 이 파라미터가 필요합니다.