ODBC 드라이버에 대한 연결 문자열 구문 및 옵션 - Amazon Timestream
프록시 연결

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

ODBC 드라이버에 대한 연결 문자열 구문 및 옵션

ODBC 드라이버의 연결 문자열 옵션을 지정하는 구문은 다음과 같습니다.

DRIVER={Amazon Timestream ODBC Driver};(option)=(value);

사용 가능한 옵션은 다음과 같습니다.

드라이버 연결 옵션

  • Driver(필수) - ODBC와 함께 사용 중인 드라이버입니다.

    기본값은 Amazon Timestream입니다.

  • DSN - 연결을 구성하는 데 사용할 데이터 소스 이름(DSN)입니다.

    기본값은 NONE입니다.

  • Auth - 인증 모드입니다. 이 값은 다음 중 하나여야 합니다.

    • AWS_PROFILE - 기본 자격 증명 체인을 사용합니다.

    • IAM - AWS IAM 자격 증명을 사용합니다.

    • AAD - Azure Active Directory(AD) ID 제공업체를 사용합니다.

    • OKTA - Okta ID 제공업체를 사용합니다.

    기본값은 AWS_PROFILE입니다.

엔드포인트 구성 옵션

  • EndpointOverride - Timestream for LiveAnalytics 서비스의 엔드포인트 재정의입니다. 이는 리전을 재정의하는 고급 옵션입니다. 예:

    query-cell2.timestream.us-east-1.amazonaws.com

  • Region - Timestream for LiveAnalytics 서비스 엔드포인트의 서명 리전입니다.

    기본값은 us-east-1입니다.

자격 증명 제공업체 옵션

  • ProfileName - AWS 구성 파일의 프로필 이름입니다.

    기본값은 NONE입니다.

AWS IAM 인증 옵션

  • UID 또는 AccessKeyId - AWS 사용자 액세스 키 ID입니다. 연결 문자열에 UID와 AccessKeyId가 모두 제공된 경우 값이 비어 있지 않으면 UID 값이 사용됩니다.

    기본값은 NONE입니다.

  • PWD 또는 SecretKey - <shared id="AWS"/> 사용자 시크릿 액세스 키입니다. 연결 문자열에 PWD와 SecretKey가 모두 제공된 경우 값이 비어 있지 않으면 PWD 값이 사용됩니다.

    기본값은 NONE입니다.

  • SessionToken - 다중 인증(MFA)이 활성화된 데이터베이스에 액세스하는 데 필요한 임시 세션 토큰입니다. 입력에 후행 = 를 포함하지 마세요.

    기본값은 NONE입니다.

Okta에 대한 SAML 기반 인증 옵션

  • IdPHost - 지정된 IdP의 호스트 이름입니다.

    기본값은 NONE입니다.

  • UID 또는 IdPUserName- 지정된 IdP 계정의 사용자 이름입니다. 연결 문자열에 UID와 IdPUserName가 모두 제공된 경우 값이 비어 있지 않으면 UID 값이 사용됩니다.

    기본값은 NONE입니다.

  • PWD 또는 IdPPassword - 지정된 IdP 계정의 암호입니다. 연결 문자열에 PWD와 IdPPassword가 모두 제공된 경우 값이 비어 있지 않으면 PWD 값이 사용됩니다.

    기본값은 NONE입니다.

  • OktaApplicationID - Timestream for LiveAnalytics 애플리케이션과 연결된 고유한 Okta 제공 ID입니다. 애플리케이션 메타데이터에 제공된 entityID 필드에서 애플리케이션 ID(AppId)를 찾을 수 있습니다. 예제:

    entityID="http://www.okta.com//(IdPAppID)

    기본값은 NONE입니다.

  • RoleARN - 발신자가 수임하는 역할의 Amazon 리소스 이름(ARN)입니다.

    기본값은 NONE입니다.

  • IdPARN - IAM의 SAML 제공업체의 Amazon 리소스 이름(ARN)으로, IdP를 설명합니다.

    기본값은 NONE입니다.

Azure Active Directory에 대한 SAML 기반 인증 옵션

  • UID 또는 IdPUserName- 지정된 IdP 계정의 사용자 이름입니다.

    기본값은 NONE입니다.

  • PWD 또는 IdPPassword- 지정된 IdP 계정의 암호입니다.

    기본값은 NONE입니다.

  • AADApplicationID - Azure AD에 등록된 애플리케이션의 고유 ID입니다.

    기본값은 NONE입니다.

  • AADClientSecret - Azure AD에 등록된 애플리케이션과 연결된 클라이언트 시크릿으로, 토큰 가져오기를 승인하는 데 사용됩니다.

    기본값은 NONE입니다.

  • AADTenant - Azure AD 테넌트 ID입니다.

    기본값은 NONE입니다.

  • RoleARN - 발신자가 수임하는 역할의 Amazon 리소스 이름(ARN)입니다.

    기본값은 NONE입니다.

  • IdPARN - IAM의 SAML 제공업체의 Amazon 리소스 이름(ARN)으로, IdP를 설명합니다.

    기본값은 NONE입니다.

AWS SDK(고급) 옵션

  • RequestTimeout - 시간 초과되기 전에 AWS SDK가 쿼리 요청을 기다리는 시간(밀리초)입니다. 양수가 아닌 값은 요청 제한 시간을 비활성화합니다.

    기본값은 3000입니다.

  • ConnectionTimeout - 시간 초과되기 전에 개방형 연결을 통해 데이터가 전송될 때까지 AWS SDK가 기다리는 시간(밀리초)입니다. 0 값은 연결 제한 시간을 비활성화합니다. 이 값은 음수가 아니어야 합니다.

    기본값은 1000입니다.

  • MaxRetryCountClient - SDK에서 오류 코드 5xx의 재시도 가능한 오류에 대한 최대 재시도 횟수입니다. 값은 음수가 아니어야 합니다.

    기본값은 0입니다.

  • MaxConnections - Timestream 서비스에 대한 허용되는 동시 개방형 HTTP 연결의 최대 수입니다. 값은 양수여야 합니다.

    기본값은 25입니다.

ODBC 드라이버 로깅 옵션

  • LogLevel - 드라이버 로깅에 대한 로그 수준입니다. 다음 중 하나여야 합니다.

    • 0(OFF).

    • 1(ERROR).

    • 2(WARNING).

    • 3(INFO).

    • 4(DEBUG).

    기본값은 1(오류)입니다.

    경고: DEBUG 로깅 모드를 사용할 때 드라이버가 개인 정보를 로깅할 수 있습니다.

  • LogOutput - 로그 파일을 저장할 폴더입니다.

    기본값:

    • Windows: %USERPROFILE% 또는 %HOMEDRIVE%%HOMEPATH%(사용할 수 없는 경우)

    • macOS 및 Linux: $HOME 또는 함수 getpwuid(getuid()) 반환 값의 필드 pw_dir(사용할 수 없는 경우)

SDK 로깅 옵션

AWS SDK 로그 수준은 Timestream for LiveAnalytics ODBC 드라이버 로그 수준과 별개입니다. 하나를 설정해도 다른 하나에는 영향이 없습니다.

SDK 로그 수준은 환경 변수 TS_AWS_LOG_LEVEL을 사용하여 설정됩니다. 유효한 값은 다음과 같습니다.

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

TS_AWS_LOG_LEVEL이 설정되지 않으면 SDK 로그 수준은 기본값인 WARN으로 설정됩니다.

프록시를 통해 연결

ODBC 드라이버는 프록시를 통해 Amazon Timestream for LiveAnalytics에 연결을 지원합니다. 이 기능을 사용하려면 프록시 설정에 따라 다음 환경 변수를 구성하세요.

  • TS_PROXY_HOST - 프록시 호스트입니다.

  • TS_PROXY_PORT - 프록시 포트 번호입니다.

  • TS_PROXY_SCHEME - 프록시 체계(http 또는 https)입니다.

  • TS_PROXY_USER - 프록시 인증을 위한 사용자 이름입니다.

  • TS_PROXY_PASSWORD - 프록시 인증을 위한 사용자 암호입니다.

  • TS_PROXY_SSL_CERT_PATH - HTTPS 프록시에 연결하는 데 사용할 SSL 인증서 파일입니다.

  • TS_PROXY_SSL_CERT_TYPE - 프록시 클라이언트 SSL 인증서의 유형입니다.

  • TS_PROXY_SSL_KEY_PATH - HTTPS 프록시에 연결하는 데 사용할 프라이빗 키 파일입니다.

  • TS_PROXY_SSL_KEY_TYPE - HTTPS 프록시에 연결하는 데 사용되는 프라이빗 키 파일의 유형입니다.

  • TS_PROXY_SSL_KEY_PASSWORD - HTTPS 프록시에 연결하는 데 사용되는 프라이빗 키 파일의 암호입니다.