Amazon Redshiftコネクタ > 部 II: Amazon Redshift V2コネクタを使用したデータ統合 > Amazon Redshift V2の接続 > Amazon Redshift への接続

Amazon Redshift への接続

Amazon Redshiftに接続するようにAmazon Redshift V2接続プロパティを設定してみましょう。

始める前に

開始する前に、設定する認証タイプに基づいてAmazon Redshiftアカウントから情報を取得する必要があります。

接続を設定する前に、認証の準備を参照して認証要件を確認してください。

接続の詳細

次の表に、基本接続プロパティを示します。

プロパティ	説明
接続名	接続の名前。各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_.+ -。最大長は255文字です。
説明	接続の説明。最大長は4000文字です。
シークレットコンテナの使用	組織に対して設定されているSecrets Managerにこの接続の機密資格情報を保存します。このプロパティは、組織にSecrets Managerが設定されている場合にのみ表示されます。接続でシークレットコンテナを有効にすると、Secure AgentがSecrets Managerからどの資格情報を取得するかを選択できます。このオプションを無効にした場合、資格情報は組織の設定方法に応じてリポジトリまたはローカルSecure Agentに保存されます。注: この接続を使用してプッシュダウンまたはプロキシサービスを介してデータアクセスポリシーを適用する場合、シークレットコンテナ設定オプションを使用することはできません。 Secrets Managerを設定および使用する方法については、Secrets manager configurationを参照してください。
ランタイム環境	タスクを実行するランタイム環境の名前。 Secure Agent、ホステッドエージェント、サーバーレスランタイム環境、またはエラスティックランタイム環境を選択します。注: ホステッドエージェントは、詳細クラスタで実行されるマッピングには適用されません。また、IAM認証およびEC2 AssumeRole認証にホステッドエージェントを使用することはできません。ランタイム環境の設定および使用方法の詳細については、Administratorのヘルプにある「ランタイム環境」を参照してください。

認証タイプ

Amazon Redshiftにアクセスするために、デフォルトの認証タイプおよびRedshift IAM AssumeRole認証タイプを設定できます。

必要な認証方法を選択し、認証固有のパラメータを設定します。

デフォルト認証

次の表に、デフォルト認証の基本接続プロパティを示します。

プロパティ	説明
JDBC URL	Amazon Redshiftクラスタに接続するためのJDBC URL。 JDBC URLは、Amazon AWS Redshiftクラスタ設定ページから取得できます。 JDBC URLは次の形式で入力します。 jdbc:redshift://<cluster_endpoint>:<port_number>/<database_name>ここで、エンドポイントにはRedshiftクラスタ名とリージョンが含まれます。例: jdbc:redshift://infa-rs-cluster.abc.us-west-2.redshift.amazonaws.com:5439/rsdb この例では、 - infa-rs-qa-clusterはRedshiftクラスタの名前です。 - us-west-2.redshift.amazonaws.comは、米国西部（オレゴン）リージョンであるRedshiftクラスタエンドポイントです。 - 5439はRedshiftクラスタのポート番号です。 - rsdbは、接続先のRedshiftクラスタ内の特定のデータベースインスタンスです。
ユーザー名	Amazon Redshiftクラスタ内のデータベースインスタンスのユーザー名。
パスワード	Amazon Redshiftデータベースユーザーのパスワード。
ロールの引き受けにEC2ロールを使用	S3 IAMロールを引き受けるEC2インスタンスがS3リソースにアクセスし、一時的なセキュリティ資格情報を使用してデータをステージングできるようにします。 EC2ロールには、S3 IAMロールを引き受ける権限がアタッチされたポリシーが必要です。S3 IAMロールとEC2インスタンスは、同じAWSアカウントでも異なるAWSアカウントでもかまいません。このチェックボックスを選択すると、EC2ロールが［S3 IAMロールARN］オプションで指定されたS3 IAMロールを引き受けて、ステージングデータ用のS3リソースにアクセスできるようになります。詳細については、EC2にAssumeRoleを使用した一時的なセキュリティ資格情報の生成を参照してください。
S3 IAMロールARN	Amazon S3にデータをステージングする目的で動的に生成された一時的なセキュリティ資格情報を使用するためにIAMユーザーまたはEC2に引き受けられたIAMロールのAmazon Resource Number（ARN）。このプロパティは、EC2インスタンス、またはS3 IAMロールを引き受けるIAMユーザーを使用してS3ステージングバケットにアクセスするための一時的なセキュリティ資格情報を生成する場合に適用されます。一時的なセキュリティ資格情報を使用してAmazon S3ステージングバケットにアクセスするためのS3 IAMロール名を指定します。 S3 IAMロールのARNの取得方法の詳細については、AWS documentationを参照してください。

詳細設定

次の表に、デフォルト認証の詳細接続プロパティを示します。

プロパティ	説明
S3アクセスキーID	Amazon S3ステージングバケットにアクセスするためのIAMユーザーのアクセスキーID。 S3ステージングに次の方法を使用する場合は、アクセスキーIDを入力します。 - IAMユーザーがS3ステージングにアクセスできる場合。 - S3 IAMロールを引き受けるIAMユーザーが一時的なセキュリティ資格情報を使用してS3にアクセスする場合。 S3アクセスキーIDは実行時にのみ検証されるため、実行時のエラーを防ぐために、接続を保存する前にそれが正確であることを確認してください。 IAM認証またはEC2の引き受けロールを使用してS3にアクセスする場合は、S3アクセスキーIDを入力する必要はありません。
S3シークレットアクセスキー	Amazon S3ステージングバケットにアクセスするためのシークレットアクセスキー。シークレットアクセスキーはアクセスキーIDに関連付けられており、アカウントを一意に識別します。 S3ステージングに次の方法を使用する場合は、シークレットアクセスキー値を入力します。 - IAMユーザーがS3ステージングにアクセスできる場合。 - S3 IAMロールを引き受けるIAMユーザーが一時的なセキュリティ資格情報を使用してS3にアクセスする場合。 S3シークレットアクセスキーは実行時にのみ検証されるため、実行時のエラーを防ぐために、接続を保存する前にそれが正確であることを確認してください。 IAM認証またはEC2の引き受けロールを使用してS3にアクセスする場合は、S3シークレットアクセスキーを入力する必要はありません。
S3 VPCエンドポイントタイプ¹	Amazon S3用のAmazon Virtual Private Cloudエンドポイントのタイプ。 VPCエンドポイントを使用して、Amazon S3とのプライベート通信を有効にすることができます。次のいずれかのオプションを選択します。 - デフォルト。VPCエンドポイントを使用しない場合に選択します。 - インタフェースエンドポイント。サブネットのIPアドレス範囲のプライベートIPアドレスを使用しているインタフェースエンドポイント経由でAmazon S3とのプライベート通信を確立する場合に選択します。これは、AWSのサービス宛てのトラフィックのエントリポイントとして機能します。
Amazon S3のエンドポイントDNS名¹	Amazon S3インタフェースエンドポイントのDNS名。 DNS名のアスタリスク記号をbucketキーワードで置き換えます。 DNS名は以下の形式で入力します。 bucket.<インタフェースエンドポイントのDNS名> 例: bucket.vpce-s3.us-west-2.vpce.amazonaws.com
STS VPCエンドポイントタイプ¹	AWS Security Token Service用のAmazon Virtual Private Cloudエンドポイントのタイプ。 VPCエンドポイントを使用して、Amazon Security Token Serviceとのプライベート通信を有効にすることができます。次のいずれかのオプションを選択します。 - デフォルト。VPCエンドポイントを使用しない場合に選択します。 - インタフェースエンドポイント。サブネットのIPアドレス範囲のプライベートIPアドレスを持つインタフェースエンドポイント経由でAmazon Security Token Serviceとのプライベート通信を確立する場合に選択します。
AWS STSのエンドポイントDNS名¹	AWS STSインタフェースエンドポイントのDNS名。例: vpce-01f22cc14558c241f-s8039x4c.sts.us-west-2.vpce.amazonaws.com
KMS VPCエンドポイントタイプ¹	AWS Key Management Service用のAmazon Virtual Private Cloudエンドポイントのタイプ。 VPCエンドポイントを使用して、Amazon Key Management Serviceとのプライベート通信を有効にすることができます。次のいずれかのオプションを選択します。 - デフォルト。VPCエンドポイントを使用しない場合に選択します。 - インタフェースエンドポイント。サブネットのIPアドレス範囲のプライベートIPアドレスを持つインタフェースエンドポイント経由でAmazon Key Management Serviceとのプライベート通信を確立する場合に選択します。
AWS KMSのエンドポイントDNS名¹	AWS KMSインタフェースエンドポイントのDNS名。例: vpce-0e722f5c721e19232-g2pkm2r7.kms.us-west-2.vpce.amazonaws.com
外部ID	IAMロールに関連付けられた外部ID。 Amazon S3バケットへのより安全なアクセスを提供する場合は、外部IDを指定できます。Amazon S3ステージングバケットとIAMロールは、同じAWSアカウントでも異なるAWSアカウントでもかまいません。必要に応じて、引き受けたIAMロールの信頼ポリシーの外部ID条件を使用して、AWS Security Token Service（STS）へのAssumeRole要求で外部IDを指定することもできます。外部IDの使用方法の詳細については、External ID when granting access to your AWS resourcesを参照してください。
クラスタリージョン	Redshiftクラスタが存在するAWSクラスタリージョン。［JDBC URL］フィールドプロパティで指定されているものとは異なるクラスタリージョンのカスタムJDBC URLを指定する場合は、リストからクラスタリージョンを選択します。［JDBC URL］フィールドプロパティで指定されているクラスタリージョン名を引き続き使用するには、このプロパティでクラスタリージョンとして［なし］を選択します。 AWS SDKによってサポートされるクラスタリージョンとの間でのみ、データの読み取りと書き込みを行うことができます。次のいずれかのクラスタリージョンを選択します。なしアジアパシフィック（ムンバイ）アジアパシフィック（ソウル）アジアパシフィック（シンガポール）アジアパシフィック（シドニー）アジアパシフィック（東京）アジアパシフィック（香港） AWS GovCloud(米国) AWS GovCloud （米国東部）カナダ（中部）中国（北京）中国（寧夏）欧州（アイルランド）欧州（フランクフルト）欧州(パリ) 欧州(ストックホルム) 南米（サンパウロ）中東(バーレーン) 米国東部（バージニア北部）米国東部（オハイオ）米国西部（北カリフォルニア）米国西部（オレゴン）デフォルトは［なし］です。
接続環境SQL	セッション全体に適用されるデータベース環境を設定するためのSQL文。複数の値をセミコロン（;）で区切ります。 SQL文では、データベース環境の設定のみを指定してください。SQL文にはDDLコマンドやDMLコマンドを指定しないようにしてください。
マスタ対称キー	Amazon Redshift V2コネクタにクライアントサイド暗号化タイプを使用することはできません。そのため、マスター対称キーを指定すると、そのキーは無視されます。
顧客マスタキーID	AWS Key Management Service（AWS KMS）によって生成されたカスタママスタキーID、またはAmazon S3でデータをステージングする際にクロスアカウントアクセスするためのカスタムキーのARN。カスタママスタキーは、データがAmazon S3に保存される前にコピー先で暗号化するためのものです。顧客が生成した顧客マスタキーID、またはデフォルトの顧客マスタキーIDを入力できます。クロスアカウントKMSキーは、詳細モードのマッピングの接続で使用できます。クラスタとステージングバケットは、同じリージョンに存在する必要があります。
¹詳細モードのマッピングには適用されません。

AssumeRoleによるRedshiftのIAM認証。

Redshift AssumeRole認証を使用すると、ユーザーはIAMロールを引き受けるか、必要な信頼ポリシーで設定されたEC2ロールを定義して、Amazon Redshiftにアクセスするための一時的なセキュリティ資格情報を生成できます。

次の表に、Redshift IAM AssumeRole認証の基本接続プロパティを示します。

プロパティ	説明
JDBC URL	Amazon Redshiftクラスタに接続するためのJDBC URL。 JDBC URLは、Amazon AWS Redshiftクラスタ構成ページから取得することができます。 JDBC URLは次の形式で入力します。 jdbc:redshift://<cluster_endpoint>:<port_number>/<database_name>。ここで、エンドポイントにはRedshiftクラスタ名とリージョンが含まれます。例: jdbc:redshift://infa-rs-cluster.abc.us-west-2.redshift.amazonaws.com:5439/rsdb この例では、 - infa-rs-qa-clusterはRedshiftクラスタの名前です。 - us-west-2.redshift.amazonaws.comは、米国西部（オレゴン）リージョンであるRedshiftクラスタエンドポイントです。 - 5439はRedshiftクラスタのポート番号です。 - rsdbは、接続先のRedshiftクラスタ内の特定のデータベースインスタンスです。
ユーザー名	Amazon Redshiftクラスタ内のデータベースインスタンスのユーザー名。
クラスタ識別子	Amazon Redshiftをホストするクラスタの一意の識別子。 Amazon Redshiftクラスタ名を指定します。
データベース名	アクセスするテーブルが保存されているAmazon Redshiftデータベースの名前。
Redshift IAMロールARN	動的に生成された一時的なセキュリティ資格情報を使用してAmazon RedshiftにアクセスするためにEC2が引き受けるIAMロールのAmazonリソース番号（ARN）。 Redshift IAMロールARNを入力して、Amazon Redshiftクラスタにアクセスします。
ロールの引き受けにEC2ロールを使用	EC2ロールがIAMロールを引き受けて、Redshiftに接続するか、一時的なセキュリティ資格情報を使用してデータをステージングできるようにします。 EC2ロールを使用したIAM認証によるRedshiftへの接続このチェックボックスをオンにすると、［Redshift IAMロールARN］フィールドで指定されたRedshift IAMロールを引き受けるEC2ロールがAmazon Redshiftにアクセスできるようになります。 EC2ロールには、同じアカウントまたは異なるアカウントからRedshift IAMロールを引き受けるための権限がアタッチされたポリシーが必要です。データのステージングのためのS3リソースへのアクセスこのチェックボックスをオンにすると、［S3 IAMロールARN］フィールドで指定されたS3 IAMロールをEC2ロールが引き受け、S3ステージングバケットにアクセスするための一時的なセキュリティ資格情報を動的に生成できるようになります。 EC2ロールには、同じAWSアカウントまたは異なるAWSアカウントからS3 IAMロールを引き受けるための権限がアタッチされたポリシーが必要です。
S3 IAMロールARN	動的に生成された一時的なセキュリティ資格情報を使用してAmazon S3にデータをステージングするために、IAMユーザーまたはEC2が引き受けるS3 IAMロールのAmazonリソース番号（ARN）。このプロパティは、EC2インスタンスまたはS3 IAMロールを引き受けるIAMユーザーを使用して、S3ステージングバケットにアクセスするための一時的なセキュリティ資格情報を生成する場合に適用されます。一時的なセキュリティ資格情報を使用してAmazon S3ステージングバケットにアクセスする場合はS3 IAMロール名を指定します。 IAMロールのARNの取得方法の詳細については、「AWS documentation」を参照してください。

詳細設定

次の表に、Redshift IAM AssumeRole認証の詳細接続プロパティを示します。

プロパティ	説明
RedshiftアクセスキーID	Redshift IAM AssumeRole ARNを引き受ける権限を持つIAMユーザーのアクセスキー。このプロパティは、EC2ロールを使用したAmazon Redshift AssumeRole認証には適用されません。
Redshiftシークレットアクセスキー	Redshift IAM AssumeRole ARNを引き受ける権限を持つIAMユーザーのシークレットアクセスキー。このプロパティは、EC2ロールを使用したAmazon Redshift AssumeRole認証には適用されません。
データベースグループ	この接続プロパティで［DBUserの自動作成］オプションを選択した場合に、データベースユーザーを追加するデータベースグループの名前。このデータベースグループに追加したユーザーは、指定されたグループ特権を継承します。データベースグループ名が指定されていない場合、ユーザーはパブリックグループに追加され、関連する特権を継承します。また、複数のデータベースグループをカンマで区切って入力し、指定した各データベースグループにユーザーを追加することもできます。
有効期限	Amazon Redshiftデータベースユーザーのパスワードの有効期限。 900秒から3600秒の間の値を指定します。デフォルトは900です。
DBUserの自動作成	実行時に新しいAmazon Redshiftデータベースユーザーの作成を選択します。エージェントは、［ユーザー名］フィールドで指定したユーザーをデータベースグループに追加します。追加されたユーザーは、データベースグループに割り当てられた特権を引き受けます。デフォルトでは無効になっています。
S3アクセスキーID	Amazon S3ステージングバケットにアクセスするためのIAMユーザーのアクセスキー。 S3ステージングに次の方法を使用する場合は、アクセスキーIDを入力します。 - IAMユーザーがS3ステージングにアクセスできる場合。 - S3 IAMロールを引き受けるIAMユーザーが一時的なセキュリティ資格情報を使用してS3にアクセスできる場合。 S3アクセスキーIDは実行時にのみ検証されるため、実行時のエラーを防ぐために、接続を保存する前にそれが正確であることを確認してください。 IAM認証またはEC2のロールの引き受けを使用してS3にアクセスする場合、S3アクセスキーIDを入力する必要はありません。
S3シークレットアクセスキー	Amazon S3ステージングバケットにアクセスするためのシークレットアクセスキー。秘密鍵はアクセスキーに関連付けられており、アカウントを一意に識別します。 S3ステージングに次の方法を使用する場合は、シークレットアクセスキーの値を入力します。 - IAMユーザーがS3ステージングにアクセスできる場合。 - S3 IAMロールを引き受けるIAMユーザーが一時的なセキュリティ資格情報を使用してS3にアクセスできる場合。 S3シークレットアクセスキーは実行時にのみ検証されるため、実行時のエラーを防ぐために、接続を保存する前にそれが正確であることを確認してください。 IAM認証またはEC2のロールの引き受けを使用してS3にアクセスする場合、S3シークレットアクセスキーを入力する必要はありません。
S3 VPCエンドポイントタイプ¹	Amazon S3用のAmazon Virtual Private Cloudエンドポイントのタイプ。 VPCエンドポイントを使用して、Amazon S3とのプライベート通信を有効にすることができます。次のいずれかのオプションを選択します。 - デフォルト。VPCエンドポイントを使用しない場合に選択します。 - インタフェースエンドポイント。サブネットのIPアドレス範囲のプライベートIPアドレスを使用しているインタフェースエンドポイント経由でAmazon S3とのプライベート通信を確立する場合に選択します。これは、AWSのサービス宛てのトラフィックのエントリポイントとして機能します。
Amazon S3のエンドポイントDNS名¹	Amazon S3インタフェースエンドポイントのDNS名。アスタリスク記号をDNS名内のbucketキーワードで置き換えます。 DNS名は以下の形式で入力します。 bucket.<インタフェースエンドポイントのDNS名> 例: bucket.vpce-s3.us-west-2.vpce.amazonaws.com
STS VPCエンドポイントタイプ¹	AWS Security Token Service用のAmazon Virtual Private Cloudエンドポイントのタイプ。 VPCエンドポイントを使用して、Amazon Security Token Serviceとのプライベート通信を有効にすることができます。次のいずれかのオプションを選択します。 - デフォルト。VPCエンドポイントを使用しない場合に選択します。 - インタフェースエンドポイント。サブネットのIPアドレス範囲のプライベートIPアドレスを持つインタフェースエンドポイント経由でAmazon Security Token Serviceとのプライベート通信を確立する場合に選択します。
AWS STSのエンドポイントDNS名¹	AWS STSインタフェースエンドポイントのDNS名。例: vpce-01f22cc14558c241f-s8039x4c.sts.us-west-2.vpce.amazonaws.com
KMS VPCエンドポイントタイプ¹	AWS Key Management Service用のAmazon Virtual Private Cloudエンドポイントのタイプ。 VPCエンドポイントを使用して、Amazon Key Management Serviceとのプライベート通信を有効にすることができます。次のいずれかのオプションを選択します。 - デフォルト。VPCエンドポイントを使用しない場合に選択します。 - インタフェースエンドポイント。サブネットのIPアドレス範囲のプライベートIPアドレスを持つインタフェースエンドポイント経由でAmazon Key Management Serviceとのプライベート通信を確立する場合に選択します。
AWS KMSのエンドポイントDNS名¹	AWS KMSインタフェースエンドポイントのDNS名。例: vpce-0e722f5c721e19232-g2pkm2r7.kms.us-west-2.vpce.amazonaws.com
外部ID	IAMロールに関連付けられた外部ID。 Amazon S3ステージングバケットが同じAWSアカウントまたは異なるAWSアカウントにある場合に、Amazon S3バケットへのより安全なアクセスを提供するには、外部IDを指定します。また、必要に応じて、引き受けたIAMロールの信頼ポリシーの外部ID条件を使用して、AWS Security Token Service（STS）へのAssumeRole要求で外部IDを指定することもできます。外部IDの使用方法の詳細については、「External ID when granting access to your AWS resources」を参照してください。
クラスタリージョン	Redshiftクラスタが存在するAWSジオグラフィカルリージョン。［JDBC URL］フィールドプロパティで指定されたリージョンとは異なるクラスタリージョンを持つカスタムJDBC URLを指定する場合は、リストからクラスタリージョンを選択します。［JDBC URL］フィールドプロパティで指定されたクラスタリージョン名を引き続き使用するには、このプロパティでクラスタリージョンとして［なし］を選択します。 AWS SDKによってサポートされるクラスタリージョンとの間でのみ、データの読み取りと書き込みを行うことができます。次のいずれかのクラスタリージョンを選択します。なしアジアパシフィック（ムンバイ）アジアパシフィック（ソウル）アジアパシフィック（シンガポール）アジアパシフィック（シドニー）アジアパシフィック（東京）アジアパシフィック（香港） AWS GovCloud（米国） AWS GovCloud （米国東部）カナダ（中部）中国（北京）中国（寧夏）欧州（アイルランド）欧州（フランクフルト） EU（パリ） EU（ストックホルム）南米（サンパウロ）中東（バーレーン）米国東部（バージニア北部）米国東部（オハイオ）米国西部（北カリフォルニア）米国西部（オレゴン）デフォルトは［なし］です。
接続環境SQL	セッション全体に適用されるデータベース環境を設定するためのSQL文。複数の値をセミコロン（;）で区切ります。 SQL文では、データベース環境の設定のみを指定してください。SQL文にはDDLコマンドやDMLコマンドを指定しないようにしてください。
マスタ対称キー	Amazon Redshift V2コネクタにクライアントサイド暗号化タイプを使用することはできません。そのため、マスター対称キーを指定すると、そのキーは無視されます。
顧客マスタキーID	AWS Key Management Service（AWS KMS）によって生成された顧客マスタキーID、またはAmazon S3でデータをステージングする場合のアカウント間アクセス用のカスタムキーのARN。顧客マスタキーは、データがAmazon S3に保存される前に保存先でデータを暗号化します。顧客が生成した顧客マスタキーID、またはデフォルトの顧客マスタキーIDを入力できます。クロスアカウントKMSキーは、詳細モードのマッピングの接続で使用することができます。クラスタとステージングバケットは、同じリージョンに存在している必要があります。サーバー側の暗号化を設定する方法の詳細については、「暗号化を有効にする」を参照してください。
¹詳細モードのマッピングには適用されません。

関連リンク