JDBC 드라이버 버전 2.1 구성 옵션

아래에서 Amazon Redshift JDBC 드라이버 버전 2.1에 지정할 수 있는 옵션에 대한 설명을 찾을 수 있습니다. 구성 옵션은 대소문자를 구분하지 않습니다.

연결 URL을 사용하여 구성 속성을 설정할 수 있습니다. 자세한 내용은 연결 URL 구축 섹션을 참조하세요.

AccessKeyID

• 기본값 – 없음

• 데이터 형식 – 문자열

이 파라미터를 지정하여 사용자 또는 역할에 대한 IAM 액세스 키를 입력할 수 있습니다. 일반적으로 기존 문자열 또는 사용자 프로파일을 보고 키를 찾을 수 있습니다. 이 파라미터를 지정할 경우 SecretAccessKey 파라미터도 지정해야 합니다. JDBC URL에 전달된 경우 AccessKeyID는 URL 인코딩되어야 합니다.

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

AllowDBUserOverride

• 기본값 - 0

• 데이터 형식 – 문자열

이 옵션은 드라이버가 SAML 어설션의 DbUser 값을 사용하는지 아니면 연결 URL의 DbUser 연결 속성에 지정된 값을 사용하는지를 지정합니다.

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

1

드라이버가 SAML 어설션의 DbUser 값을 사용합니다.

SAML 어설션이 DBUser에 대한 값을 지정하지 않으면 드라이버가 DBUser 연결 속성에 지정된 값을 사용합니다. 연결 속성도 값을 지정하지 않으면 드라이버가 연결 프로파일에 지정된 값을 사용합니다.

0

드라이버가 DBUser 연결 속성에 지정된 DBUser 값을 사용합니다.

DBUser 연결 속성이 값을 지정하지 않으면 드라이버가 연결 프로파일에 지정된 값을 사용합니다. 연결 프로파일도 값을 지정하지 않으면 드라이버가 SAML 어설션의 값을 사용합니다.

App_ID

• 기본값 – 없음

• 데이터 형식 – 문자열

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

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

App_Name

• 기본값 – 없음

• 데이터 형식 – 문자열

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

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

ApplicationName

• 기본값 – null

• 데이터 형식 – 문자열

감사 목적으로 Amazon Redshift에 전달할 애플리케이션의 이름입니다.

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

AuthProfile

• 기본값 – 없음

• 데이터 형식 – 문자열

Amazon Redshift에 연결하는 데 사용할 인증 프로파일의 이름입니다.

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

AutoCreate

• 기본값 – false

• 데이터 형식 – 부울

이 옵션은 지정된 사용자가 없을 때 드라이버가 새 사용자를 생성하도록 하는지 여부를 지정합니다.

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

true

DBUser 또는 고유 ID(UID)로 지정된 사용자가 없으면 해당 이름의 사용자가 새로 생성됩니다.

false

드라이버로 인해 새 사용자가 생성되지는 않습니다. 지정된 사용자가 없으면 인증에 실패합니다.

Client_ID

• 기본값 – 없음

• 데이터 형식 – 문자열

Azure AD 서비스를 사용하여 연결을 인증할 때 사용할 클라이언트 ID입니다.

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

Client_Secret

• 기본값 – 없음

• 데이터 형식 – 문자열

Azure AD 서비스를 사용하여 연결을 인증할 때 사용할 클라이언트 암호입니다.

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

ClusterID

• 기본값 – 없음

• 데이터 형식 – 문자열

연결하려는 Amazon Redshift 클러스터의 이름입니다. 드라이버는 지정된 호스트에서 이 파라미터를 감지하려고 시도합니다. Network Load Balancer(NLB)를 사용하며 IAM을 통해 연결하는 경우, 드라이버가 이를 감지하지 못하므로 이 연결 옵션을 사용하여 설정할 수 있습니다.

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

압축

• 기본값 - 끄기

• 데이터 형식 – 문자열

Amazon Redshift 서버와 클라이언트 또는 드라이버 간의 유선 프로토콜 통신에 사용되는 압축 방법입니다.

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

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

• lz4

  Amazon Redshift와의 유선 프로토콜 통신에 사용되는 압축 방법을 lz4로 설정합니다.

• 꺼짐

  Amazon Redshift와의 유선 프로토콜 통신에 압축을 사용하지 않습니다.

connectTimeout

• 기본값 - 10

• 데이터 형식 – 정수

소켓 연결 작업에 사용할 제한 시간 값입니다. Amazon Redshift 연결을 설정하는 데 필요한 시간이 이 값을 초과하면 연결을 사용할 수 없는 것으로 간주됩니다. 제한 시간은 초 단위로 지정됩니다. 값이 0이면 제한 시간을 지정하지 않는 것입니다.

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

connectionTimezone

• 기본값 – LOCAL

• 데이터 형식 – 문자열

세션 수준 시간대입니다.

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

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

LOCAL

세션 수준 시간대를 LOCAL JVM 시간대로 구성합니다.

SERVER

Amazon Redshift 서버에서 사용자에 대해 설정된 시간대로 세션 수준 시간대를 구성합니다. 다음 명령으로 사용자에 대한 세션 수준 시간대를 구성할 수 있습니다.

ALTER USER
[...]
SET TIMEZONE TO [...];

databaseMetadataCurrentDbOnly

• 기본값 – true

• 데이터 형식 – 부울

이 옵션은 메타데이터 API가 액세스 가능한 모든 데이터베이스에서 데이터를 검색할지 아니면 연결된 데이터베이스에서만 데이터를 검색할지를 지정합니다.

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

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

true

애플리케이션이 단일 데이터베이스에서 메타데이터를 검색합니다.

false

애플리케이션이 액세스 가능한 모든 데이터베이스에서 메타데이터를 검색합니다.

DbUser

• 기본값 – 없음

• 데이터 형식 – 문자열

Amazon Redshift 계정에 사용할 사용자 ID입니다. AutoCreate 속성을 사용하도록 설정한 경우 현재 존재하지 않는 ID를 사용할 수 있습니다.

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

DbGroups

• 기본값 – PUBLIC

• 데이터 형식 – 문자열

DBUser가 현재 세션에 대해 조인하는 기존 데이터베이스 그룹 이름의 쉼표로 구분된 목록입니다.

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

DBNAME

• 기본값 – null

• 데이터 형식 – 문자열

연결할 데이터베이스의 이름입니다. 이 옵션을 사용하여 JDBC 연결 URL에 데이터베이스 이름을 지정할 수 있습니다.

이 파라미터는 필수 사항입니다. 연결 URL 또는 클라이언트 애플리케이션의 연결 속성에 데이터베이스 이름을 지정해야 합니다.

defaultRowFetchSize

• 기본값 - 0

• 데이터 형식 – 정수

이 옵션은 getFetchSize의 기본값을 지정합니다.

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

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

0

단일 작업으로 모든 행을 가져옵니다.

양의 정수

ResultSet의 각 가져오기 반복에 대해 데이터베이스에서 가져올 행 수입니다.

DisableIsValidQuery

• 기본값 – False

• 데이터 형식 – 부울

이 옵션은 Connection.isValid () 메서드를 사용하여 데이터베이스 연결이 활성 상태인지 여부를 확인할 때 드라이버가 새 데이터베이스 쿼리를 제출할지 여부를 지정합니다.

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

true

드라이버가 Connection.isValid()를 사용하여 데이터베이스 연결이 활성 상태인지 여부를 확인할 때 쿼리를 제출하지 않습니다. 이로 인해 데이터베이스 서버가 예기치 않게 종료된 경우 드라이버가 데이터베이스 연결을 활성 상태로 잘못 식별할 수 있습니다.

false

드라이버가 Connection.isValid()를 사용하여 데이터베이스 연결이 활성 상태인지 여부를 확인할 때 쿼리를 제출합니다.

enableFetchRingBuffer

• 기본값 – true

• 데이터 형식 – 부울

이 옵션은 드라이버가 별도의 스레드에서 링 버퍼를 사용하여 행을 가져오도록 지정합니다. fetchRingBufferSize 파라미터는 링 버퍼 크기를 지정합니다.

트랜잭션이 세미콜론으로 구분된 여러 SQL 명령이 포함된 명령문을 감지하면 해당 트랜잭션의 페치 링 버퍼가 거짓으로 설정됩니다. enableFetchRingBuffer의 값은 변경되지 않습니다.

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

enableMultiSqlSupport

• 기본값 – true

• 데이터 형식 – 부울

이 옵션은 Statement에서 세미콜론으로 구분된 여러 SQL 명령을 처리할지 여부를 지정합니다.

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

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

true

드라이버가 Statement 객체에서 세미콜론으로 구분된 여러 SQL 명령을 처리합니다.

false

드라이버가 단일 Statement에서 여러 SQL 명령에 대한 오류를 반환합니다.

fetchRingBufferSize

• 기본값 – 1G

• 데이터 형식 – 문자열

이 옵션은 결과 집합을 가져오는 동안 사용되는 링 버퍼의 크기를 지정합니다. 크기를 바이트 단위로 지정할 수 있습니다(예: 1KB의 경우 1K, 5,000바이트의 경우 5000, 1MB의 경우 1M, 1GB의 경우 1G). 또한 힙 메모리의 비율을 지정할 수 있습니다. 드라이버는 제한에 도달하면 행 가져오기를 중지합니다. 애플리케이션이 행을 읽고 링 버퍼의 공간을 확보하면 가져오기가 다시 시작됩니다.

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

ForceLowercase

• 기본값 – false

• 데이터 형식 – 부울

이 옵션은 드라이버가 Single Sign-On 인증을 사용할 때 자격 증명 공급자에서 Amazon Redshift로 전송된 모든 데이터베이스 그룹(DbGroups)을 소문자로 표시할지 여부를 지정합니다.

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

true

드라이버가 ID 공급자에서 전송된 모든 데이터베이스 그룹을 소문자로 표시합니다.

false

드라이버가 데이터베이스 그룹을 변경하지 않습니다.

groupFederation

• 기본값 – false

• 데이터 형식 – 부울

이 옵션은 Amazon Redshift IDP 그룹을 사용할지 여부를 지정합니다. 이 옵션은 GetClusterCredentialsV2 API에서 지원됩니다.

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

true

Amazon Redshift IDP(자격 증명 공급자) 그룹을 사용합니다.

false

사용자 페더레이션을 위해 STS API 및 GetClusterCredentials를 사용하고 연결을 위해 DbGroups를 명시적으로 지정합니다.

HOST

• 기본값 – null

• 데이터 형식 – 문자열

연결할 Amazon Redshift 서버의 호스트 이름입니다. 이 옵션을 사용하여 JDBC 연결 URL에 호스트 이름을 지정할 수 있습니다.

이 파라미터는 필수 사항입니다. 연결 URL 또는 클라이언트 애플리케이션의 연결 속성에 호스트 이름을 지정해야 합니다.

IAMDisableCache

• 기본값 – false

• 데이터 형식 – 부울

이 옵션은 IAM 자격 증명이 캐시되는지 여부를 지정합니다.

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

true

IAM 자격 증명이 캐시되지 않습니다.

false

IAM 자격 증명이 캐시되지 않습니다. 예를 들어 API 게이트웨이에 대한 요청이 제한될 때 성능이 향상됩니다.

IAMDuration

• 기본값 – 900

• 데이터 형식 – 정수

임시 IAM 자격 증명이 만료될 때까지 남은 시간(초)입니다.

• 최솟값 – 900

• 최댓값 – 3,600

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

Identity_Namespace

• 기본값 – 없음

• 데이터 형식 – 문자열

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

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

IdP_Host

• 기본값 – 없음

• 데이터 형식 – 문자열

Amazon Redshift에 인증하는 데 사용하는 자격 증명 공급자(IdP) 호스트입니다. 연결 문자열이나 프로파일에 지정할 수 있습니다.

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

IdP_Port

• 기본값 – 없음

• 데이터 형식 – 문자열

자격 증명 공급자(IdP)가 사용하는 포트입니다. 연결 문자열이나 프로파일에 포트를 지정할 수 있습니다. 기본 포트는 5439입니다. 클러스터를 생성, 수정 또는 마이그레이션할 때 선택한 포트에 따라 선택한 포트에 대한 액세스를 허용합니다.

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

IdP_Tenant

• 기본값 – 없음

• 데이터 형식 – 문자열

Amazon Redshift 애플리케이션의 Azure AD 테넌트 ID입니다.

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

IdP_Response_Timeout

• 기본값 – 120

• 데이터 형식 – 정수

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

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

INIFILE

• 기본값 – 없음

• 데이터 형식 – 문자열

파일 이름을 포함한 .ini 파일의 전체 경로입니다. 예:

IniFile="C:\tools\rsjdbc.ini"

.ini 파일에 대한 자세한 내용은 JDBC 드라이버 버전 2.1용 초기화(.ini) 파일 생성 섹션을 참조하세요.

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

IniSection

• 기본값 – 없음

• 데이터 형식 – 문자열

구성 옵션을 포함하는.ini 파일의 섹션 이름입니다. .ini 파일에 대한 자세한 내용은 JDBC 드라이버 버전 2.1용 초기화(.ini) 파일 생성 섹션을 참조하세요.

다음 예에서는 .ini 파일의 [Prod] 섹션을 지정합니다.

IniSection="Prod"

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

isServerless

• 기본값 – false

• 데이터 형식 – 부울

이 옵션은 Amazon Redshift 엔드포인트 호스트가 서버리스 인스턴스인지 여부를 지정합니다. 드라이버는 지정된 호스트에서 이 파라미터를 감지하려고 시도합니다. Network Load Balancer(NLB)를 사용하는 경우 드라이버가 이를 감지하지 못하므로, 여기에서 설정하면 됩니다.

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

true

Amazon Redshift 엔드포인트 호스트가 서버리스 인스턴스입니다.

false

Amazon Redshift 엔드포인트 호스트가 프로비저닝된 클러스터입니다.

Login_URL

• 기본값 – 없음

• 데이터 형식 – 문자열

브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스를 사용할 때 자격 증명 공급자의 웹 사이트에 있는 리소스의 URL입니다.

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

loginTimeout

• 기본값 - 0

• 데이터 형식 – 정수

서버에 연결하고 인증하면서 시간 제한이 지날 때까지 대기하는 시간(초)입니다. 연결 구성이 이 제한 시간보다 어래 걸리면 연결이 중단됩니다.

이 속성이 0으로 설정되는 경우에는 연결 시간 제한이 없습니다.

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

loginToRp

• 기본값 – urn:amazon:webservices

• 데이터 형식 – 문자열

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

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

LogLevel

• 기본값 - 0

• 데이터 형식 – 정수

이 속성을 사용하여 드라이버에서 로깅을 설정하거나 해제하고 로그 파일에 포함되는 세부 정보의 양을 지정합니다.

문제를 포착할 수 있을 만큼만 로깅을 사용합니다. 로깅은 성능을 떨어뜨릴 뿐만 아니라 대용량의 디스크 공간을 소비할 수 있기 때문입니다.

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

파라미터를 다음 값 중 하나로 설정합니다.

0

모든 로깅을 사용 중지합니다.

1

드라이버를 중단시키는 매우 심각한 오류 이벤트를 로그하는 FATAL 수준에서 로깅을 사용합니다.

2

드라이버가 계속 실행될 수 있는 오류 이벤트를 로그하는 ERROR 수준에서 로깅을 사용합니다.

3

작업을 수행하지 않으면 오류가 발생할 수 있는 이벤트를 로그하는 WARNING 수준에서 로깅을 사용합니다.

4

드라이버의 진행 상황을 설명하는 일반 정보를 로그하는 INFO 수준에서 로깅을 사용합니다.

5

드라이버 디버깅에 유용한 세부 정보를 로그하는 DEBUG 수준에서 로깅을 사용합니다.

6

모든 드라이버 활동을 로그하는 TRACE 수준에서 로깅을 사용합니다.

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

• redshift_jdbc.log – 연결과 관련되지 않은 드라이버 활동을 로그하는 파일입니다.

• redshift_jdbc_connection_[Number].log – 각 데이터베이스 연결에 대한 파일입니다. 여기서 [Number]는 각 로그 파일을 다른 로그 파일과 구별하는 숫자입니다. 이 파일은 연결과 관련된 드라이버 활동을 로그합니다.

LogPath 값이 유효하지 않으면 드라이버가 로그된 정보를 표준 출력 스트림인 System.out으로 전송합니다.

LogPath

• 기본값 – 현재 작업 디렉터리.

• 데이터 형식 – 문자열

DSILogLevel 속성을 사용할 때 드라이버가 로그 파일을 저장하는 폴더의 전체 경로입니다.

연결 URL이 모든 JDBC 애플리케이션과 호환되는지 확인하려면 다른 백슬래시를 입력하여 파일 경로에서 백슬래시(\)를 이스케이프 처리하는 것이 좋습니다.

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

OverrideSchemaPatternType

• 기본값 – null

• 데이터 형식 – 정수

이 옵션은 getTables 호출에 사용하는 쿼리 유형을 재정의할지 여부를 지정합니다.

0

스키마 없는 범용 쿼리

1

로컬 스키마 쿼리

2

외부 스키마 쿼리

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

Partner_SPID

• 기본값 – 없음

• 데이터 형식 – 문자열

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

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

암호

• 기본값 – 없음

• 데이터 형식 – 문자열

IDP를 통해 IAM 인증을 사용하여 연결할 때 IDP_Host 서버의 암호입니다. 표준 인증을 사용할 때 Amazon Redshift 데이터베이스 암호에 PWD 대신 사용할 수 있습니다.

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

Plugin_Name

• 기본값 – 없음

• 데이터 형식 – 문자열

특정 자격 증명 공급자 플러그인을 구현하기 위한 정규화된 클래스 이름입니다.

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

다음과 같은 공급자 옵션이 지원됩니다.

• AdfsCredentialsProvider – Active Directory Federation Service입니다.

• AzureCredentialsProvider – Microsoft Azure Active Directory(AD) Service입니다.

• BasicJwtCredentialsProvider – JSON Web Tokens (JWT) Service입니다.

• BasicSamlCredentialsProvider - 많은 SAML 서비스 공급자와 함께 사용할 수 있는 SAML(Security Assertion Markup Language) 자격 증명입니다.

• BrowserAzureCredentialsProvider – Browser Microsoft Azure Active Directory(AD) Service입니다.

• BrowserAzureOAuth2CredentialsProvider – 네이티브 인증용 Browser Microsoft Azure Active Directory(AD) Service입니다.

• BrowserSamlCredentialsProvider – Okta, Ping, ADFS 등의 SAML 서비스용 Browser SAML입니다.

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

• OktaCredentialsProvider – Okta Service입니다.

• PingCredentialsProvider – PingFederate Service입니다.

PORT

• 기본값 – null

• 데이터 형식 – 정수

연결할 Amazon Redshift 서버의 포트입니다. 이 옵션을 사용하여 JDBC 연결 URL에 포트를 지정할 수 있습니다.

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

Preferred_Role

• 기본값 – 없음

• 데이터 형식 – 문자열

Amazon Redshift에 연결하는 동안 수임하려는 IAM 역할입니다.

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

프로필

• 기본값 – 없음

• 데이터 형식 – 문자열

IAM 인증에 사용할 프로파일의 이름입니다. 이 프로파일에는 연결 문자열에 지정되지 않은 추가 연결 속성이 포함되어 있습니다.

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

PWD

• 기본값 – 없음

• 데이터 형식 – 문자열

속성 UID를 사용하여 제공한 Amazon Redshift 사용자 이름에 해당하는 암호입니다.

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

queryGroup

• 기본값 – null

• 데이터 형식 – 문자열

이 옵션은 적절한 쿼리 그룹에 쿼리를 할당하여 런타임에 쿼리를 대기열에 할당합니다. 쿼리 그룹이 세션에 대해 설정됩니다. 연결에서 실행되는 모든 쿼리는 이 쿼리 그룹에 속합니다.

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

readOnly

• 기본값 – false

• 데이터 형식 – 부울

이 속성은 드라이버가 읽기 전용 모드인지 여부를 지정합니다.

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

true

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

false

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

리전

• 기본값 – null

• 데이터 형식 – 문자열

이 옵션은 클러스터가 위치한 AWS 리전을 지정합니다. StsEndPoint 옵션을 지정하면 리전 옵션이 무시됩니다. Redshift GetClusterCredentials API 작업도 리전 옵션을 사용합니다.

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

reWriteBatchedInserts

• 기본값 – false

• 데이터 형식 – 부울

이 옵션을 사용하면 최적화를 통해 호환 가능한 INSERT 문을 다시 작성하고 배치로 결합할 수 있습니다.

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

reWriteBatchedInsertsSize

• 기본값 – 128

• 데이터 형식 – 정수

이 옵션을 사용하면 최적화를 통해 호환 가능한 INSERT 문을 다시 작성하고 배치로 결합할 수 있습니다. 이 값은 2의 거듭제곱으로 기하급수적으로 증가해야 합니다.

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

roleArn

• 기본값 – 없음

• 데이터 형식 – 문자열

역할의 Amazon 리소스 이름(ARN)입니다. Plugin_Name 옵션에 BasicJwtCredentialsProvider를 지정할 때 이 파라미터를 지정해야 합니다. 다음 형식으로 ARN을 지정합니다.

arn:partition:service:region:account-id:resource-id

Plugin_Name 옵션에 BasicJwtCredentialsProvider를 지정하는 경우 이 파라미터는 필수입니다.

roleSessionName

• 기본값 – jwt_redshift_session

• 데이터 형식 – 문자열

맡은 역할 세션의 식별자입니다. 일반적으로 애플리케이션 사용자와 연결된 이름 또는 식별자를 전달합니다. 애플리케이션에서 사용하는 임시 보안 자격 증명은 해당 사용자와 연결됩니다. Plugin_Name 옵션에 BasicJwtCredentialsProvider를 지정할 때 이 파라미터를 지정할 수 있습니다.

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

scope

• 기본값 – 없음

• 데이터 형식 – 문자열

사용자가 동의할 수 있는 공백으로 구분된 범위 목록입니다. Microsoft Azure 애플리케이션이 해당 사용자가 호출하려는 API에 대한 동의를 얻을 수 있도록 이 파라미터를 지정합니다. Plugin_Name 옵션에 BrowserAzureOAuth2CredentialsProvider를 지정할 때 이 파라미터를 지정할 수 있습니다.

이 파라미터는 BrowserAzureOAuth2CredentialsProvider 플러그인에 반드시 필요합니다.

SecretAccessKey

• 기본값 – 없음

• 데이터 형식 – 문자열

사용자 또는 역할에 대한 IAM 액세스 키입니다. 이 파라미터를 지정하는 경우 AccessKeyID도 지정해야 합니다. JDBC URL에 전달된 SecretAccessKey는 URL 인코딩되어야 합니다.

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

SessionToken

• 기본값 – 없음

• 데이터 형식 – 문자열

인증에 사용하는 IAM 역할과 연결된 임시 IAM 세션 토큰입니다. JDBC URL에 전달된 경우 임시 IAM 세션 토큰은 URL 인코딩되어야 합니다.

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

serverlessAcctId

• 기본값 – null

• 데이터 형식 – 문자열

Amazon Redshift Serverless 계정 ID입니다. 드라이버는 지정된 호스트에서 이 파라미터를 감지하려고 시도합니다. Network Load Balancer(NLB)를 사용하는 경우 드라이버가 이를 감지하지 못하므로, 여기에서 설정하면 됩니다.

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

serverlessWorkGroup

• 기본값 – null

• 데이터 형식 – 문자열

Amazon Redshift Serverless 작업 그룹 이름입니다. 드라이버는 지정된 호스트에서 이 파라미터를 감지하려고 시도합니다. Network Load Balancer(NLB)를 사용하는 경우 드라이버가 이를 감지하지 못하므로, 여기에서 설정하면 됩니다.

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

socketFactory

• 기본값 – null

• 데이터 형식 – 문자열

이 옵션은 소켓 생성을 위한 소켓 팩토리를 지정합니다.

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

socketTimeout

• 기본값 - 0

• 데이터 형식 – 정수

소켓 읽기 작업에서 제한 시간이 지날 때까지 대기하는 시간(초)입니다. 작업이 이 임계값보다 오래 걸리면 연결이 닫힙니다. 이 속성이 0으로 설정되는 경우에는 연결 시간 제한이 없습니다.

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

SSL

• 기본값 – TRUE

• 데이터 형식 – 문자열

이 속성을 사용하여 연결에 SSL을 설정하거나 해제합니다.

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

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

TRUE

드라이버가 SSL을 통해 서버에 연결합니다.

FALSE

드라이버가 SSL을 사용하지 않고 서버에 연결합니다. IAM 인증에서는 이 옵션이 지원되지 않습니다.

또는 AuthMech 속성을 구성할 수 있습니다.

SSL_Insecure

• 기본값 – true

• 데이터 형식 – 문자열

이 속성은 IDP 호스트 서버 인증서를 확인해야 하는지 여부를 나타냅니다.

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

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

true

드라이버가 IDP 서버 인증서의 신뢰성을 확인하지 않습니다.

false

드라이버가 IDP 서버 인증서의 신뢰성을 확인합니다.

SSLCert

• 기본값 – 없음

• 데이터 형식 – 문자열

SSL 사용 시 Amazon Redshift 서버 인스턴스 확인을 위한 신뢰할 수 있는 추가 CA 인증서가 포함된 .pem 또는 .crt 파일의 전체 경로입니다.

SSLKey가 지정된 경우 이 파라미터는 필수입니다.

SSLFactory

• 기본값 – 없음

• 데이터 형식 – 문자열

서버 인증서를 사용하지 않고 TLS/SSL을 통해 서버에 연결할 때 사용할 SSL 팩토리입니다.

SSLKey

• 기본값 – 없음

• 데이터 형식 – 문자열

SSLCert에 지정된 인증서 확인을 위한 PKCS8 키 파일이 포함된.der 파일의 전체 경로입니다.

SSLCert가 지정된 경우 이 파라미터는 필수입니다.

SSLMode

• 기본값 – verify-ca

• 데이터 형식 – 문자열

이 속성을 사용하여 TLS/SSL 사용 시 드라이버가 인증서를 검증하는 방법을 지정합니다.

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

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

[verify-ca]

드라이버가 신뢰할 수 있는 인증 기관(CA)에서 인증서를 제공하는지 확인합니다.

[verify-full]

드라이버가 신뢰할 수 있는 CA에서 인증서를 제공하고 인증서의 호스트 이름이 연결 URL에 지정된 호스트 이름과 일치하는지 확인합니다.

SSLPassword

• 기본값 - 0

• 데이터 형식 – 문자열

SSLKey에 지정된 암호화된 키 파일의 암호입니다.

SSLKey가 지정되고 키 파일이 암호화된 경우 이 파라미터는 필수입니다.

SSLRootCert

• 기본값 – 없음

• 데이터 형식 – 문자열

SSL 사용 시 Amazon Redshift 서버 인스턴스 확인을 위한 루트 CA 인증서가 포함된 .pem 또는 .crt 파일의 전체 경로입니다.

StsEndpointUrl

• 기본값 – null

• 데이터 형식 – 문자열

AWS Security Token Service(AWS STS) 엔드포인트를 지정할 수 있습니다. 이 옵션을 지정하면 리전 옵션이 무시됩니다. 이 엔드포인트에는 보안 프로토콜(HTTPS)만 지정할 수 있습니다.

tcpKeepAlive

• 기본값 – TRUE

• 데이터 형식 – 문자열

이 속성을 사용하여 TCP KeepAlive를 설정하거나 해제합니다.

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

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

TRUE

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

FALSE

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

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

• 기본값 – 없음

• 데이터 형식 – 문자열

IDP를 통해 IAM 인증을 사용하여 연결할 때 idp_host 서버의 사용자 이름입니다. 표준 인증을 사용할 때 Amazon Redshift 데이터베이스 사용자 이름에 사용할 수 있습니다.

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

webIdentityToken

• 기본값 – 없음

• 데이터 형식 – 문자열

자격 증명 공급자가 제공하는 OAuth 2.1 액세스 토큰 또는 OpenID Connect ID 토큰입니다. 애플리케이션에서 웹 자격 증명 공급자로 애플리케이션 사용자를 인증하여 이 토큰을 가져와야 합니다. Plugin_Name 옵션에 BasicJwtCredentialsProvider를 지정할 때 이 파라미터를 지정해야 합니다.

Plugin_Name 옵션에 BasicJwtCredentialsProvider를 지정하는 경우 이 파라미터는 필수입니다.