View a markdown version of this page

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

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

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

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

Driver={AWS IoT SiteWise ODBC Driver};(option)=(value);

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

드라이버 연결 옵션

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

    기본값은 AWS IoT SiteWise입니다.

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

    기본값은 NONE입니다.

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

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

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

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

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

    기본값은 AWS_PROFILE입니다.

엔드포인트 구성 옵션

  • EndpointOverride   - AWS IoT SiteWise 서비스에 대한   엔드포인트 재정의입니다. 이는 리전을 재정의하는 고급 옵션입니다. 예제:

    iotsitewise.us-east-1.amazonaws.com

  • Region   - AWS IoT SiteWise 서비스 엔드포인트의   서명 리전입니다.

    기본값은 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   - AWS IoT SiteWise 애플리케이션과 연결된   고유한 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   - AWS IoT SiteWise 서비스에 대해 동시에 열린 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 로그 수준은 AWS IoT SiteWise ODBC 드라이버 로그 수준과 별개입니다. 하나를 설정해도 다른 하나에는 영향이 없습니다.

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

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

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

프록시를 통해 연결

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

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

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

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

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

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

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

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

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

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

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