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/)을 참조하세요.
# JDBC 드라이버 버전 2.x 구성 옵션
아래에서 Amazon Redshift JDBC 드라이버 버전 2.2에 지정할 수 있는 옵션에 대한 설명을 찾을 수 있습니다. 구성 옵션은 대소문자를 구분하지 않습니다.
연결 URL을 사용하여 구성 속성을 설정할 수 있습니다. 자세한 내용은 [연결 URL 구축](jdbc20-build-connection-url.md) 섹션을 참조하세요.
**Topics**
+ [AccessKeyID](#jdbc20-accesskeyid-option)
+ [AllowDBUserOverride](#jdbc20-allowdbuseroverride-option)
+ [App\$1ID](#jdbc20-app-id-option)
+ [App\$1Name](#jdbc20-app-name-option)
+ [ApplicationName](#jdbc20-applicationname-option)
+ [AuthProfile](#jdbc20-authprofile-option)
+ [AutoCreate](#jdbc20-autocreate-option)
+ [Client\$1ID](#jdbc20-client_id-option)
+ [Client\$1Secret](#jdbc20-client_secret-option)
+ [ClusterID](#jdbc20-clusterid-option)
+ [압축](#jdbc20-compression-option)
+ [connectTimeout](#jdbc20-connecttimeout-option)
+ [connectionTimezone](#jdbc20-connecttimezone-option)
+ [databaseMetadataCurrentDbOnly](#jdbc20-databasemetadatacurrentdbonly-option)
+ [DbUser](#jdbc20-dbuser-option)
+ [DbGroups](#jdbc20-dbgroups-option)
+ [DBNAME](#jdbc20-dbname-option)
+ [defaultRowFetchSize](#jdbc20-defaultrowfetchsize-option)
+ [DisableIsValidQuery](#jdbc20-disableisvalidquery-option)
+ [enableFetchRingBuffer](#jdbc20-enablefetchringbuffer-option)
+ [enableMultiSqlSupport](#jdbc20-enablemultisqlsupport-option)
+ [fetchRingBufferSize](#jdbc20-fetchringbuffersize-option)
+ [ForceLowercase](#jdbc20-forcelowercase-option)
+ [groupFederation](#jdbc20-groupFederation-option)
+ [HOST](#jdbc20-host-option)
+ [IAMDisableCache](#jdbc20-iamdisablecache-option)
+ [IAMDuration](#jdbc20-iamduration-option)
+ [Idc\$1Client\$1Display\$1Name](#jdbc20-idc_client_display_name)
+ [Idc\$1Region](#jdbc20-idc_region)
+ [IdP\$1Host](#jdbc20-idp_host-option)
+ [IdP\$1Partition](#jdbc20-idp_partition-option)
+ [IdP\$1Port](#jdbc20-idp_port-option)
+ [IdP\$1Tenant](#jdbc20-idp_tenant-option)
+ [IdP\$1Response\$1Timeout](#jdbc20-idp_response_timeout-option)
+ [INIFILE](#jdbc20-inifile-option)
+ [IniSection](#jdbc20-inisection-option)
+ [isServerless](#jdbc20-isserverless-option)
+ [Issuer\$1Url](#jdbc20-issuer-url)
+ [Listen\$1Port](#jdbc20-listen-port)
+ [Login\$1URL](#jdbc20-login_url-option)
+ [loginTimeout](#jdbc20-logintimeout-option)
+ [loginToRp](#jdbc20-logintorp-option)
+ [LogLevel](#jdbc20-loglevel-option)
+ [LogPath](#jdbc20-logpath-option)
+ [OverrideSchemaPatternType](#jdbc20-override-schema-pattern-type)
+ [Partner\$1SPID](#jdbc20-partner_spid-option)
+ [암호](#jdbc20-password-option)
+ [Plugin\$1Name](#jdbc20-plugin_name-option)
+ [PORT](#jdbc20-port-option)
+ [Preferred\$1Role](#jdbc20-preferred_role-option)
+ [프로필](#jdbc20-profile-option)
+ [PWD](#jdbc20-pwd-option)
+ [queryGroup](#jdbc20-querygroup-option)
+ [readOnly](#jdbc20-readonly-option)
+ [리전](#jdbc20-region-option)
+ [reWriteBatchedInserts](#jdbc20-rewritebatchedinserts-option)
+ [reWriteBatchedInsertsSize](#jdbc20-rewritebatchedinsertssize-option)
+ [roleArn](#jdbc20-rolearn-option)
+ [roleSessionName](#jdbc20-roleaessionname-option)
+ [범위](#jdbc20-scope-option)
+ [SecretAccessKey](#jdbc20-secretaccesskey-option)
+ [SessionToken](#jdbc20-sessiontoken-option)
+ [serverlessAcctId](#jdbc20-serverlessacctid-option)
+ [serverlessWorkGroup](#jdbc20-serverlessworkgroup-option)
+ [socketFactory](#jdbc20-socketfactory-option)
+ [socketTimeout](#jdbc20-sockettimeout-option)
+ [SSL](#jdbc20-ssl-option)
+ [SSL\$1Insecure](#jdbc20-ssl_insecure-option)
+ [SSLCert](#jdbc20-sslcert-option)
+ [SSLFactory](#jdbc20-sslfactory-option)
+ [SSLKey](#jdbc20-sslkey-option)
+ [SSLMode](#jdbc20-sslmode-option)
+ [SSLPassword](#jdbc20-sslpassword-option)
+ [SSLRootCert](#jdbc20-sslrootcert-option)
+ [StsEndpointUrl](#jdbc20-stsendpointurl-option)
+ [tcpKeepAlive](#jdbc20-tcpkeepalive-option)
+ [토큰](#jdbc20-token-option)
+ [token\$1type](#jdbc20-token-type-option)
+ [UID](#jdbc20-uid-option)
+ [User](#jdbc20-user-option)
+ [webIdentityToken](#jdbc20-webidentitytoken-option)
## 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\$1ID
+ **기본값** – 없음
+ **데이터 형식** – 문자열
Amazon Redshift 애플리케이션과 연결된 Okta 제공 고유 ID입니다.
Okta 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다.
## App\$1Name
+ **기본값** – 없음
+ **데이터 형식** – 문자열
Amazon Redshift에 대한 연결을 인증하는 데 사용하는 Okta 애플리케이션의 이름입니다.
이 파라미터는 선택 사항입니다.
## ApplicationName
+ **기본값** – null
+ **데이터 형식** – 문자열
감사 목적으로 Amazon Redshift에 전달할 애플리케이션의 이름입니다.
이 파라미터는 선택 사항입니다.
## AuthProfile
+ **기본값** – 없음
+ **데이터 형식** – 문자열
Amazon Redshift에 연결하는 데 사용할 인증 프로파일의 이름입니다.
이 파라미터는 선택 사항입니다.
## AutoCreate
+ **기본값** – false
+ **데이터 형식** – 부울
이 옵션은 지정된 사용자가 없을 때 드라이버가 새 사용자를 생성하도록 하는지 여부를 지정합니다.
이 파라미터는 선택 사항입니다.
**true**
`DBUser` 또는 고유 ID(UID)로 지정된 사용자가 없으면 해당 이름의 사용자가 새로 생성됩니다.
**false**
드라이버로 인해 새 사용자가 생성되지는 않습니다. 지정된 사용자가 없으면 인증에 실패합니다.
## Client\$1ID
+ **기본값** – 없음
+ **데이터 형식** – 문자열
Azure AD 서비스를 사용하여 연결을 인증할 때 사용할 클라이언트 ID입니다.
Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다.
## Client\$1Secret
+ **기본값** – 없음
+ **데이터 형식** – 문자열
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 파라미터는 링 버퍼 크기를 지정합니다.
링 버퍼는 JDBC에서 자동 메모리 관리를 구현하여 데이터 검색 작업 중에 메모리 부족(OOM) 오류를 방지합니다. 링 버퍼는 버퍼링된 데이터의 실제 크기를 실시간으로 모니터링하여 드라이버의 총 메모리 사용량이 정의된 한도 내에 있도록 합니다. 버퍼 용량에 도달하면 드라이버가 데이터 가져오기 작업을 일시 중지하여 수동 개입 없이 메모리 오버플로를 방지합니다. 이 내장 보호 기능은 사용자의 구성 없이도 OOM 오류를 자동으로 제거합니다.
트랜잭션이 세미콜론으로 구분된 여러 SQL 명령이 포함된 명령문을 감지하면 해당 트랜잭션의 페치 링 버퍼가 거짓으로 설정됩니다. enableFetchRingBuffer의 값은 변경되지 않습니다.
이 파라미터는 선택 사항입니다.
**참고**
링 버퍼가 비활성화되고 가져오기 크기가 제대로 구성되지 않은 경우 메모리 부족(OOM) 문제가 발생할 수 있습니다. 가져오기 크기 구성에 대한 자세한 내용은 [여기](https://docs.aws.amazon.com/redshift/latest/dg/set-the-JDBC-fetch-size-parameter.html)를 참조하세요.
## 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
이 파라미터는 선택 사항입니다.
## Idc\$1Client\$1Display\$1Name
+ **기본값** - Amazon Redshift JDBC 드라이버
+ **데이터 형식** – 문자열
BrowserIdcAuthPlugin을 사용하는 클라이언트에 사용할 표시 이름입니다.
이 파라미터는 선택 사항입니다.
## Idc\$1Region
+ **기본값** – 없음
+ **데이터 형식** – 문자열
IAM Identity Center 인스턴스가 위치한 AWS 리전입니다.
이 파라미터는 plugin\$1name 구성 옵션에서 `BrowserIdcAuthPlugin`을 사용하여 인증하는 경우에만 필요합니다.
## IdP\$1Host
+ **기본값** – 없음
+ **데이터 형식** – 문자열
Amazon Redshift에 인증하는 데 사용하는 자격 증명 공급자(IdP) 호스트입니다. 연결 문자열이나 프로파일에 지정할 수 있습니다.
이 파라미터는 선택 사항입니다.
## 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\$1Port
+ **기본값** – 없음
+ **데이터 형식** – 문자열
자격 증명 공급자(IdP)가 사용하는 포트입니다. 연결 문자열이나 프로파일에 포트를 지정할 수 있습니다. 기본 포트는 5439입니다. 클러스터를 생성, 수정 또는 마이그레이션할 때 선택한 포트에 따라 선택한 포트에 대한 액세스를 허용합니다.
이 파라미터는 선택 사항입니다.
## IdP\$1Tenant
+ **기본값** – 없음
+ **데이터 형식** – 문자열
Amazon Redshift 애플리케이션의 Azure AD 테넌트 ID입니다.
Azure AD 서비스를 통해 인증하는 경우 이 파라미터는 필수입니다.
## IdP\$1Response\$1Timeout
+ **기본값** – 120
+ **데이터 형식** – 정수
브라우저 플러그인을 통해 SAML 또는 Azure AD 서비스를 사용할 때 드라이버가 자격 증명 공급자의 SAML 응답을 기다리는 시간(초)입니다.
이 파라미터는 선택 사항입니다.
## INIFILE
+ **기본값** – 없음
+ **데이터 형식** – 문자열
파일 이름을 포함한 .ini 파일의 전체 경로입니다. 예:
```
IniFile="C:\tools\rsjdbc.ini"
```
.ini 파일에 대한 자세한 내용은 [JDBC 드라이버 버전 2.x용 초기화(.ini) 파일 생성](jdbc20-ini-file.md) 섹션을 참조하세요.
이 파라미터는 선택 사항입니다.
## IniSection
+ **기본값** – 없음
+ **데이터 형식** – 문자열
구성 옵션을 포함하는.ini 파일의 섹션 이름입니다. .ini 파일에 대한 자세한 내용은 [JDBC 드라이버 버전 2.x용 초기화(.ini) 파일 생성](jdbc20-ini-file.md) 섹션을 참조하세요.
다음 예에서는 .ini 파일의 [Prod] 섹션을 지정합니다.
```
IniSection="Prod"
```
이 파라미터는 선택 사항입니다.
## isServerless
+ **기본값** – false
+ **데이터 형식** – 부울
이 옵션은 Amazon Redshift 엔드포인트 호스트가 서버리스 인스턴스인지 여부를 지정합니다. 드라이버는 지정된 호스트에서 이 파라미터를 감지하려고 시도합니다. Network Load Balancer(NLB)를 사용하는 경우 드라이버가 이를 감지하지 못하므로, 여기에서 설정하면 됩니다.
이 파라미터는 선택 사항입니다.
**true**
Amazon Redshift 엔드포인트 호스트가 서버리스 인스턴스입니다.
**false**
Amazon Redshift 엔드포인트 호스트가 프로비저닝된 클러스터입니다.
## Issuer\$1Url
+ **기본값** – 없음
+ **데이터 형식** – 문자열
AWS IAM Identity Center 서버의 인스턴스 엔드포인트를 가리킵니다.
이 파라미터는 plugin\$1name 구성 옵션에서 `BrowserIdcAuthPlugin`을 사용하여 인증하는 경우에만 필요합니다.
## Listen\$1Port
+ **기본값** – 7890
+ **데이터 형식** – 정수
드라이버가 브라우저 플러그인을 통해 SAML, Azure AD 또는 AWS IAM Identity Center 서비스를 사용할 때 ID 제공업체 또는 권한 부여 코드로부터 SAML 응답을 받는 데 사용하는 포트입니다.
이 파라미터는 선택 사항입니다.
## Login\$1URL
+ **기본값** – 없음
+ **데이터 형식** – 문자열
브라우저 플러그인을 통해 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 애플리케이션과 호환되는지 확인하려면 다른 백슬래시를 입력하여 파일 경로에서 백슬래시(\$1)를 이스케이프 처리하는 것이 좋습니다.
이 파라미터는 선택 사항입니다.
## OverrideSchemaPatternType
+ **기본값** – null
+ **데이터 형식** – 정수
이 옵션은 getTables 호출에 사용하는 쿼리 유형을 재정의할지 여부를 지정합니다.
**0**
스키마 없는 범용 쿼리
**1**
로컬 스키마 쿼리
**2**
외부 스키마 쿼리
이 파라미터는 선택 사항입니다.
## Partner\$1SPID
+ **기본값** – 없음
+ **데이터 형식** – 문자열
PingFederate 서비스를 사용하여 연결을 인증할 때 사용할 파트너 SPID(서비스 공급자 ID) 값입니다.
이 파라미터는 선택 사항입니다.
## 암호
+ **기본값** – 없음
+ **데이터 형식** – 문자열
IDP를 통해 IAM 인증을 사용하여 연결할 때 IDP\$1Host 서버의 암호입니다. 표준 인증을 사용할 때 Amazon Redshift 데이터베이스 암호에 PWD 대신 사용할 수 있습니다.
이 파라미터는 선택 사항입니다.
## Plugin\$1Name
+ **기본값** – 없음
+ **데이터 형식** – 문자열
특정 자격 증명 공급자 플러그인을 구현하기 위한 정규화된 클래스 이름입니다.
이 파라미터는 선택 사항입니다.
다음과 같은 공급자 옵션이 지원됩니다.
+ **`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입니다.
+ **`BrowserIdcAuthPlugin`** - AWS IAM Identity Center를 사용하는 인증 플러그인입니다.
+ **`BrowserSamlCredentialsProvider`** – Okta, Ping, ADFS 등의 SAML 서비스용 Browser SAML입니다.
+ **`IdpTokenAuthPlugin`** – AWS IAM Identity Center 토큰 또는 AWS IAM Identity Center에 연결된 웹 ID 제공업체의 OpenID Connect(OIDC) JSON 기반 자격 증명 토큰(JWT)을 수락하는 권한 부여 플러그인입니다.
+ **`OktaCredentialsProvider`** – Okta Service입니다.
+ **`PingCredentialsProvider`** – PingFederate Service입니다.
## PORT
+ **기본값** – null
+ **데이터 형식** – 정수
연결할 Amazon Redshift 서버의 포트입니다. 이 옵션을 사용하여 JDBC 연결 URL에 포트를 지정할 수 있습니다.
이 파라미터는 선택 사항입니다.
## Preferred\$1Role
+ **기본값** – 없음
+ **데이터 형식** – 문자열
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\$1Name 옵션에 BasicJwtCredentialsProvider를 지정할 때 이 파라미터를 지정해야 합니다. 다음 형식으로 ARN을 지정합니다.
`arn:partition:service:region:account-id:resource-id`
Plugin\$1Name 옵션에 BasicJwtCredentialsProvider를 지정하는 경우 이 파라미터는 필수입니다.
## roleSessionName
+ **기본값** – jwt\$1redshift\$1session
+ **데이터 형식** – 문자열
맡은 역할 세션의 식별자입니다. 일반적으로 애플리케이션 사용자와 연결된 이름 또는 식별자를 전달합니다. 애플리케이션에서 사용하는 임시 보안 자격 증명은 해당 사용자와 연결됩니다. Plugin\$1Name 옵션에 BasicJwtCredentialsProvider를 지정할 때 이 파라미터를 지정할 수 있습니다.
이 파라미터는 선택 사항입니다.
## 범위
+ **기본값** – 없음
+ **데이터 형식** – 문자열
사용자가 동의할 수 있는 공백으로 구분된 범위 목록입니다. Microsoft Azure 애플리케이션이 해당 사용자가 호출하려는 API에 대한 동의를 얻을 수 있도록 이 파라미터를 지정합니다. Plugin\$1Name 옵션에 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\$1Insecure
+ **기본값** – 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를 사용하지 않습니다.
## 토큰
+ **기본값** – 없음
+ **데이터 형식** – 문자열
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
+ **기본값** – 없음
+ **데이터 형식** – 문자열
데이터베이스에 액세스하는 데 사용하는 데이터베이스 사용자 이름입니다.
이 파라미터는 필수 사항입니다.
## User
+ **기본값** – 없음
+ **데이터 형식** – 문자열
IDP를 통해 IAM 인증을 사용하여 연결 시 idp\$1host 서버의 사용자 이름입니다. 표준 인증을 사용하는 경우 Amazon Redshift 데이터베이스 사용자 이름에 사용할 수 있습니다.
이 파라미터는 선택 사항입니다.
## webIdentityToken
+ **기본값** – 없음
+ **데이터 형식** – 문자열
자격 증명 공급자가 제공하는 OAuth 2.1 액세스 토큰 또는 OpenID Connect ID 토큰입니다. 애플리케이션에서 웹 자격 증명 공급자로 애플리케이션 사용자를 인증하여 이 토큰을 가져와야 합니다. Plugin\$1Name 옵션에 BasicJwtCredentialsProvider를 지정할 때 이 파라미터를 지정해야 합니다.
Plugin\$1Name 옵션에 BasicJwtCredentialsProvider를 지정하는 경우 이 파라미터는 필수입니다.