翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 接続パラメータ
<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 への接続でサポートされています。


| キー | 型 | 説明 | 制約 | 必須 | 
| --- | --- | --- | --- | --- | 
| 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 gateway へのリクエストがスロットルされた場合のパフォーマンスが向上します。 | 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 Serverless エンドポイントのワークグループ名 |  | いいえ | 
| 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>

Athena への接続では、次の Python AWS Glue 接続パラメータがサポートされています。


| キー | 型 | 説明 | 制約 | 必須 | 
| --- | --- | --- | --- | --- | 
| 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>

Snowflake への接続では、次の Python AWS Glue 接続パラメータがサポートされています。

Snowflake 接続パラメータ


| キー | 型 | 説明 | 制約 | 必須 | 
| --- | --- | --- | --- | --- | 
| account | タイプ: string - maxLength: 256 | Snowflake アカウント識別子。このアカウント識別子には snowflakecomputing.com サフィックスは含まれません。 |  | はい | 
| arrow\_number\_to\_decimal | 型: boolean | デフォルトでは False です。つまり、NUMBER 列の値は倍精度浮動小数点数 (float64) として返されます。これを True に設定すると、fetch\_pandas\_all() メソッドや fetch\_pandas\_batches() メソッドを呼び出す際に、DECIMAL 列の値が小数 (decimal.Decimal) として返されます。 | true, false | いいえ | 
| autocommit | 型: boolean | デフォルトでは false で、Snowflake パラメータ AUTOCOMMIT が優先されます。セッションの autocommit モードを有効または無効にするには、それぞれ true または false に設定します。 | 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 | デフォルトでは None で、Snowflake パラメータ TIMEZONE が優先されます。セッションのタイムゾーンを設定するには、有効なタイムゾーン (America/Los\_Angeles など) を指定します。 | America/Los\_Angeles のような形式のタイムゾーン | いいえ | 
| validate\_default\_parameters | 型: boolean | 指定されたデータベース、スキーマ、またはウェアハウスが存在しない場合に例外を発生させるには、true に設定します。デフォルトは false です。 |  | いいえ | 
| warehouse | タイプ: string - maxLength: 256 | デフォルトで使用するウェアハウス名 |  | いいえ |