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

# 연결 파라미터
<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(키) | Type | 설명 | 제약 조건 | 필수 | 
| --- | --- | --- | --- | --- | 
| auto\$1create | 유형: boolean | 사용자가 없는 경우 사용자를 만들어야 하는지를 나타냅니다. 기본값은 false입니다. | true, false | 아니요 | 
| aws\$1secret\$1arn | 유형: string | 연결에 대한 추가 파라미터를 검색하는 데 사용되는 보안 암호의 ARN입니다. | 유효한 ARN | 아니요 | 
| cluster\$1identifier | 유형: string - maxLength: 63 | Amazon Redshift 클러스터의 클러스터 식별자입니다. | ^(?\$1.\$1—)[a-z][a-z0-9-]\$10,61\$1[a-z0-9]\$1 | 아니요 | 
| database | 유형: string - maxLength: 127 | 연결할 데이터베이스의 이름입니다. |  | 아니요 | 
| database\$1metadata\$1current\$1db\$1only | 유형: boolean | 애플리케이션이 다중 데이터베이스 데이터 공유 카탈로그를 지원하는지를 나타냅니다. 애플리케이션이 이전 버전과의 호환성을 위해 다중 데이터베이스 데이터 공유 카탈로그를 지원하지 않음을 나타내는 기본값은 true입니다. | true, false | 아니요 | 
| db\$1groups | 유형: string | db\$1user가 현재 세션에 대해 조인하는 기존 데이터베이스 그룹 이름을 쉼표로 구분한 목록입니다. |  | 아니요 | 
| db\$1user | 유형: string | Amazon Redshift에 사용할 사용자 ID입니다. |  | 아니요 | 
| host | 유형: string - maxLength: 256 | Amazon Redshift 클러스터의 호스트 이름입니다. |  | 아니요 | 
| iam | 유형: boolean | 연결에 대한 IAM 기반 인증을 활성화 또는 비활성화하는 플래그입니다. 기본값은 false입니다. | true, false | 아니요 | 
| iam\$1disable\$1cache | 유형: boolean | 이 옵션은 IAM 자격 증명이 캐시되는지 여부를 지정합니다. 기본값은 true입니다. API 게이트웨이에 대한 요청이 제한될 때 성능이 향상됩니다. | true, false | 아니요 | 
| max\$1prepared\$1statements | 유형: integer | 한 번에 열 수 있는 준비된 문의 최대 개수입니다. |  | 아니요 | 
| numeric\$1to\$1float | 소수를 부동소수점으로 | 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\$165535 | 아니요 | 
| profile | 유형: string - maxLength: 256 |  AWS CLI에서 사용하는 자격 증명 및 설정이 포함된 프로필의 이름입니다. |  | 아니요 | 
| region | 유형: string | 클러스터가 위치한 AWS 리전입니다. | 유효한 AWS 리전 | 아니요 | 
| serverless\$1acct\$1id | 유형: string - maxLength: 256 | Amazon Redshift 서버리스 리소스와 연결된 AWS 계정 ID입니다. |  | 아니요 | 
| serverless\$1work\$1group | 유형: string - maxLength: 256 | Amazon Redshift 서버리스 엔드포인트의 작업 그룹 이름입니다. |  | 아니요 | 
| ssl | 유형: boolean | SSL이 활성화된 경우 true입니다. | true, false | 아니요 | 
| ssl\$1mode | 유형: 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(키) | Type | 설명 | 제약 조건 | 필수 | 
| --- | --- | --- | --- | --- | 
| aws\$1access\$1key\$1id | 유형: string - maxLength: 256 | IAM 계정과 연결된 AWS 액세스 키를 지정합니다. 이 정보는 aws\$1secret에 저장하는 것이 좋습니다. | 길이 16\$1128 | 아니요 | 
| aws\$1secret\$1access\$1key | 유형: string - maxLength: 256 |  AWS 액세스 키의 보안 암호 부분입니다. 이 정보는 aws\$1secret에 저장하는 것이 좋습니다. |  | 아니요 | 
| aws\$1secret\$1arn | 유형: string | 연결에 대한 추가 파라미터를 검색하는 데 사용되는 보안 암호의 ARN입니다. | 유효한 ARN | 아니요 | 
| catalog\$1name | 유형: string - maxLength: 256 | 드라이버로 액세스하는 데이터베이스와 테이블이 들어 있는 카탈로그입니다. 카탈로그에 대한 자세한 내용은 [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html)를 참조하세요. |  | 아니요 | 
| duration\$1seconds | 유형: number | 역할 세션 지속 시간(초)입니다. 이 설정에는 1\$112시간의 값을 지정할 수 있습니다. 기본적으로 기간은 3,600초(1시간)로 설정됩니다. | 범위는 900초(15분)에서 해당 역할에 대한 최대 세션 기간 설정까지일 수 있습니다. | 아니요 | 
| encryption\$1option | 유형: enum[SSE\$1S3, SSE\$1KMS, CSE\$1KMS, null]) | Amazon S3의 저장 중 암호화입니다. [Athena 가이드](https://docs.aws.amazon.com/athena/latest/ug/encryption.html)의 저장 중 암호화 섹션을 참조하세요. | SSE\$1S3, SSE\$1KMS, CSE\$1KMS | 아니요 | 
| kms\$1key | 유형: string - maxLength: 256 | AWS KMS CSE\$1KMS에서를 사용하는 경우 키입니다encrytion\$1option. |  | 아니요 | 
| poll\$1interval | 유형: number | Athena에서 쿼리 결과의 상태를 폴링하는 초 단위 간격입니다. |  | 아니요 | 
| profile\$1name | 유형: string - maxLength: 256 | Athena에 대한 요청을 인증하는 데 자격 증명을 사용해야 하는 AWS 구성 프로필의 이름입니다. |  | 아니요 | 
| region\$1name | 유형: string | 쿼리가 실행되는 AWS 리전입니다. | 유효한 AWS 리전 | 아니요 | 
| result\$1reuse\$1enable | 유형: boolean | 이전 쿼리 결과의 재사용을 활성화합니다. | true, false | 아니요 | 
| result\$1reuse\$1minutes | 유형: integer | Athena에서 재사용을 고려해야 하는 이전 쿼리 결과의 최대 수명(분)을 지정합니다. 기본값은 60입니다. | >= 1 | 아니요 | 
| role\$1arn | 유형: string | 쿼리를 실행하는 데 사용할 역할입니다. | 유효한 ARN | 아니요 | 
| schema\$1name | 유형: string - maxLength: 256 | 데이터베이스에 사용할 기본 스키마의 이름입니다. |  | 아니요 | 
| s3\$1staging\$1dir | 유형: string - maxLength: 1024 | 쿼리 결과가 저장되는 Amazon S3의 위치입니다. |  | s3\$1staging\$1dir 또는 work\$1group은 필수입니다. | 
| work\$1group | 유형: string | 쿼리가 실행될 작업 그룹입니다. 작업 그룹에 대한 자세한 내용은 [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)을 참조하세요. | ^[a-zA-Z0-9.\$1-]\$11,128\$1\$1 | s3\$1staging\$1dir 또는 work\$1group은 필수입니다. | 

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

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

Snowflake 연결 파라미터


| Key(키) | Type | 설명 | 제약 조건 | 필수 | 
| --- | --- | --- | --- | --- | 
| account | 유형: string - maxLength: 256 | Snowflake 계정 식별자입니다. 계정 식별자에는 snowflakecomputing.com 접미사가 포함되지 않습니다. |  | 예 | 
| arrow\$1number\$1to\$1decimal | 유형: boolean | 기본적으로 False입니다. 즉, NUMBER 열 값은 이중 정밀도 부동 소수점 숫자(float64)로 반환됩니다. fetch\$1pandas\$1all() 및 fetch\$1pandas\$1batches() 메서드를 직접 호출할 때 DECIMAL 열 값을 소수(decimal.Decimal)로 반환하려면 이 값을 True로 설정합니다. | true, false | 아니요 | 
| autocommit | 유형: boolean | Snowflake 파라미터 AUTOCOMMIT을 준수하는 false로 기본 설정됩니다. true 또는 false로 설정하여 세션에서 autocommit 모드를 각각 활성화 또는 비활성화합니다. | true, false | 아니요 | 
| aws\$1secret\$1arn | 유형: string | 연결에 대한 추가 파라미터를 검색하는 데 사용되는 보안 암호의 ARN입니다. | 유효한 ARN | 아니요 | 
| client\$1prefetch\$1threads | 유형: integer | 결과 세트를 다운로드하는 데 사용되는 스레드 수입니다(기본적으로 4개). 값을 늘리면 가져오기 성능이 향상되지만 메모리가 더 필요합니다. |  | 아니요 | 
| database | 유형: string - maxLength: 256 | 사용할 기본 데이터베이스의 이름입니다. |  | 아니요 | 
| login\$1timeout | 유형: integer | 로그인 요청에 대한 초 단위 제한 시간입니다. 기본값은 60초입니다. HTTP 응답이 success가 아닌 경우 제한 시간 이후에 로그인 요청을 포기합니다. |  | 아니요 | 
| network\$1timeout | 유형: 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\$1Angeles)로 설정합니다. | America/Los\$1Angeles와 유사한 형식의 시간대 | 아니요 | 
| validate\$1default\$1parameters | 유형: boolean | 지정된 데이터베이스, 스키마 또는 웨어하우스가 없는 경우 예외를 발생시키려면 true로 설정합니다. 기본값은 false입니다. |  | 아니요 | 
| warehouse | 유형: string - maxLength: 256 | 사용할 기본 웨어하우스의 이름입니다. |  | 아니요 |