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

# 연결 파라미터
<a name="sagemaker-sql-extension-connection-properties"></a>

다음 표에는 데이터 스토어당 AWS Glue 연결에 대해 지원되는 Python 속성이 자세히 나와 있습니다.

## Amazon Redshift 연결 파라미터
<a name="sagemaker-sql-extension-connection-properties-redshift"></a>

다음 Python 연결 파라미터는 Amazon Redshift에 대한 AWS Glue 연결에서 지원됩니다.


| Key(키) | 유형 | 설명 | 제약 조건 | 필수 | 
| --- | --- | --- | --- | --- | 
| auto\_create | 유형: boolean | 사용자가 없는 경우 사용자를 만들어야 하는지를 나타냅니다. 기본값은 false입니다. | true, false | 아니요 | 
| aws\_secret\_arn | 유형: string | 연결에 대한 추가 파라미터를 검색하는 데 사용되는 보안 암호의 ARN입니다. | 유효한 ARN | 아니요 | 
| cluster\_identifier | 유형: string - maxLength: 63 | Amazon Redshift 클러스터의 클러스터 식별자입니다. | ^(?\!.\*—)[a-z][a-z0-9-]{0,61}[a-z0-9]$ | 아니요 | 
| database | 유형: string - maxLength: 127 | 연결할 데이터베이스의 이름입니다. |  | 아니요 | 
| database\_metadata\_current\_db\_only | 유형: boolean | 애플리케이션이 다중 데이터베이스 데이터 공유 카탈로그를 지원하는지를 나타냅니다. 애플리케이션이 이전 버전과의 호환성을 위해 다중 데이터베이스 데이터 공유 카탈로그를 지원하지 않음을 나타내는 기본값은 true입니다. | true, false | 아니요 | 
| db\_groups | 유형: string | db\_user가 현재 세션에 대해 조인하는 기존 데이터베이스 그룹 이름을 쉼표로 구분한 목록입니다. |  | 아니요 | 
| db\_user | 유형: string | Amazon Redshift에 사용할 사용자 ID입니다. |  | 아니요 | 
| host | 유형: string - maxLength: 256 | Amazon Redshift 클러스터의 호스트 이름입니다. |  | 아니요 | 
| iam | 유형: boolean | 연결에 대한 IAM 기반 인증을 활성화 또는 비활성화하는 플래그입니다. 기본값은 false입니다. | true, false | 아니요 | 
| iam\_disable\_cache | 유형: boolean | 이 옵션은 IAM 자격 증명이 캐시되는지 여부를 지정합니다. 기본값은 true입니다. API 게이트웨이에 대한 요청이 제한될 때 성능이 향상됩니다. | true, false | 아니요 | 
| max\_prepared\_statements | 유형: integer | 한 번에 열 수 있는 준비된 문의 최대 개수입니다. |  | 아니요 | 
| numeric\_to\_float | 소수를 부동소수점으로 | NUMERIC 데이터 유형 값을 소수에서 변환할지를 지정합니다. 기본적으로 NUMERIC 값은 decimal.Decimal Python 객체로 수신됩니다. 결과가 반올림될 수 있으므로 높은 정밀도를 선호하는 사용 사례에는 이 옵션을 활성화하지 않는 것이 좋습니다. 이 옵션을 활성화하기 전에 [https://docs.python.org/3/library/decimal.html#decimal-objects](https://docs.python.org/3/library/decimal.html#decimal-objects)의 Python 설명서를 참조하여 decimal.Decimal과 float의 장단점을 이해하세요. 기본값은 false입니다. | true, false | 아니요 | 
| port | 유형: integer | Amazon Redshift 클러스터의 포트 번호입니다. | 범위 1150\~65535 | 아니요 | 
| profile | 유형: string - maxLength: 256 |  AWS CLI에서 사용하는 자격 증명 및 설정이 포함된 프로필의 이름입니다. |  | 아니요 | 
| region | 유형: string | 클러스터가 위치한 AWS 리전입니다. | 유효한 AWS 리전 | 아니요 | 
| serverless\_acct\_id | 유형: string - maxLength: 256 | Amazon Redshift 서버리스 리소스와 연결된 AWS 계정 ID입니다. |  | 아니요 | 
| serverless\_work\_group | 유형: string - maxLength: 256 | Amazon Redshift 서버리스 엔드포인트의 작업 그룹 이름입니다. |  | 아니요 | 
| ssl | 유형: boolean | SSL이 활성화된 경우 true입니다. | true, false | 아니요 | 
| ssl\_mode | 유형: enum[verify-ca, verify-full, null]) | Amazon Redshift에 대한 연결의 보안입니다. verify-ca(SSL을 사용하고 서버 인증서를 확인해야 함) 및 verify-full(SSL을 사용해야 함. 서버 인증서를 확인해야 하며 서버 호스트 이름이 인증서의 호스트 이름 속성과 일치해야 함)가 지원됩니다. 자세한 내용은 Amazon Redshift 설명서의 [연결을 위한 보안 옵션 구성](https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-ssl-support.html)을 참조하세요. 기본값은 verify-ca입니다. | verify-ca, verify-full | 아니요 | 
| timeout | 유형: integer | 서버 연결 시간이 초과되기까지의 시간(초)입니다. | 0 | 아니요 | 

## Athena 연결 파라미터
<a name="sagemaker-sql-extension-connection-properties-athena"></a>

다음 Python 연결 파라미터는 Athena에 대한 AWS Glue 연결에서 지원됩니다.


| Key(키) | 유형 | 설명 | 제약 조건 | 필수 | 
| --- | --- | --- | --- | --- | 
| aws\_access\_key\_id | 유형: string - maxLength: 256 | IAM 계정과 연결된 AWS 액세스 키를 지정합니다. 이 정보는 aws\_secret에 저장하는 것이 좋습니다. | 길이 16\~128 | 아니요 | 
| aws\_secret\_access\_key | 유형: string - maxLength: 256 |  AWS 액세스 키의 보안 암호 부분입니다. 이 정보는 aws\_secret에 저장하는 것이 좋습니다. |  | 아니요 | 
| aws\_secret\_arn | 유형: string | 연결에 대한 추가 파라미터를 검색하는 데 사용되는 보안 암호의 ARN입니다. | 유효한 ARN | 아니요 | 
| catalog\_name | 유형: string - maxLength: 256 | 드라이버로 액세스하는 데이터베이스와 테이블이 들어 있는 카탈로그입니다. 카탈로그에 대한 자세한 내용은 [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html)를 참조하세요. |  | 아니요 | 
| duration\_seconds | 유형: number | 역할 세션 지속 시간(초)입니다. 이 설정에는 1\~12시간의 값을 지정할 수 있습니다. 기본적으로 기간은 3,600초(1시간)로 설정됩니다. | 범위는 900초(15분)에서 해당 역할에 대한 최대 세션 기간 설정까지일 수 있습니다. | 아니요 | 
| encryption\_option | 유형: enum[SSE\_S3, SSE\_KMS, CSE\_KMS, null]) | Amazon S3의 저장 중 암호화입니다. [Athena 가이드](https://docs.aws.amazon.com/athena/latest/ug/encryption.html)의 저장 중 암호화 섹션을 참조하세요. | SSE\_S3, SSE\_KMS, CSE\_KMS | 아니요 | 
| kms\_key | 유형: string - maxLength: 256 | AWS KMS CSE\_KMS에서를 사용하는 경우 키입니다encrytion\_option. |  | 아니요 | 
| poll\_interval | 유형: number | Athena에서 쿼리 결과의 상태를 폴링하는 초 단위 간격입니다. |  | 아니요 | 
| profile\_name | 유형: string - maxLength: 256 | Athena에 대한 요청을 인증하는 데 자격 증명을 사용해야 하는 AWS 구성 프로필의 이름입니다. |  | 아니요 | 
| region\_name | 유형: string | 쿼리가 실행되는 AWS 리전입니다. | 유효한 AWS 리전 | 아니요 | 
| result\_reuse\_enable | 유형: boolean | 이전 쿼리 결과의 재사용을 활성화합니다. | true, false | 아니요 | 
| result\_reuse\_minutes | 유형: integer | Athena에서 재사용을 고려해야 하는 이전 쿼리 결과의 최대 수명(분)을 지정합니다. 기본값은 60입니다. | >= 1 | 아니요 | 
| role\_arn | 유형: string | 쿼리를 실행하는 데 사용할 역할입니다. | 유효한 ARN | 아니요 | 
| schema\_name | 유형: string - maxLength: 256 | 데이터베이스에 사용할 기본 스키마의 이름입니다. |  | 아니요 | 
| s3\_staging\_dir | 유형: string - maxLength: 1024 | 쿼리 결과가 저장되는 Amazon S3의 위치입니다. |  | s3\_staging\_dir 또는 work\_group은 필수입니다. | 
| work\_group | 유형: string | 쿼리가 실행될 작업 그룹입니다. 작업 그룹에 대한 자세한 내용은 [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)을 참조하세요. | ^[a-zA-Z0-9.\_-]{1,128}$ | s3\_staging\_dir 또는 work\_group은 필수입니다. | 

## Snowflake 연결 파라미터
<a name="sagemaker-sql-extension-connection-properties-snowflake"></a>

다음 Python 연결 파라미터는 Snowflake에 대한 AWS Glue 연결에서 지원됩니다.

Snowflake 연결 파라미터


| Key(키) | 유형 | 설명 | 제약 조건 | 필수 | 
| --- | --- | --- | --- | --- | 
| account | 유형: string - maxLength: 256 | Snowflake 계정 식별자입니다. 계정 식별자에는 snowflakecomputing.com 접미사가 포함되지 않습니다. |  | 예 | 
| arrow\_number\_to\_decimal | 유형: boolean | 기본적으로 False입니다. 즉, NUMBER 열 값은 이중 정밀도 부동 소수점 숫자(float64)로 반환됩니다. fetch\_pandas\_all() 및 fetch\_pandas\_batches() 메서드를 직접 호출할 때 DECIMAL 열 값을 소수(decimal.Decimal)로 반환하려면 이 값을 True로 설정합니다. | true, false | 아니요 | 
| autocommit | 유형: boolean | Snowflake 파라미터 AUTOCOMMIT을 준수하는 false로 기본 설정됩니다. true 또는 false로 설정하여 세션에서 autocommit 모드를 각각 활성화 또는 비활성화합니다. | true, false | 아니요 | 
| aws\_secret\_arn | 유형: string | 연결에 대한 추가 파라미터를 검색하는 데 사용되는 보안 암호의 ARN입니다. | 유효한 ARN | 아니요 | 
| client\_prefetch\_threads | 유형: integer | 결과 세트를 다운로드하는 데 사용되는 스레드 수입니다(기본적으로 4개). 값을 늘리면 가져오기 성능이 향상되지만 메모리가 더 필요합니다. |  | 아니요 | 
| database | 유형: string - maxLength: 256 | 사용할 기본 데이터베이스의 이름입니다. |  | 아니요 | 
| login\_timeout | 유형: integer | 로그인 요청에 대한 초 단위 제한 시간입니다. 기본값은 60초입니다. HTTP 응답이 success가 아닌 경우 제한 시간 이후에 로그인 요청을 포기합니다. |  | 아니요 | 
| network\_timeout | 유형: integer | 그 외 모든 작업에 대한 제한 시간(초)입니다. 기본값은 none(무한)입니다. HTTP 응답이 success가 아닌 경우 제한 시간 이후에 일반 요청을 포기합니다. |  | 아니요 | 
| paramstyle | 유형: string - maxLength: 256 | Python 코드에서 SQL 쿼리를 실행할 때 파라미터 대체에 사용되는 자리 표시자 구문입니다. 클라이언트 측 바인딩의 경우 기본값은 pyformat입니다. 서버 측 바인딩에 대한 바인딩 변수 형식을 변경하려면 qmark 또는 numeric을 지정합니다. |  | 아니요 | 
| role | 유형: string - maxLength: 256 | 사용할 기본 역할의 이름입니다. |  | 아니요 | 
| schema | 유형: string - maxLength: 256 | 데이터베이스에 사용할 기본 스키마의 이름입니다. |  | 아니요 | 
| timezone | 유형: string - maxLength: 128 | 기본적으로 해당 사항이 없습니다. 이는 Snowflake 파라미터 TIMEZONE을 준수하는 것입니다. 세션 시간대를 설정하려면 유효한 시간대(예: America/Los\_Angeles)로 설정합니다. | America/Los\_Angeles와 유사한 형식의 시간대 | 아니요 | 
| validate\_default\_parameters | 유형: boolean | 지정된 데이터베이스, 스키마 또는 웨어하우스가 없는 경우 예외를 발생시키려면 true로 설정합니다. 기본값은 false입니다. |  | 아니요 | 
| warehouse | 유형: string - maxLength: 256 | 사용할 기본 웨어하우스의 이름입니다. |  | 아니요 |