【コネクター】 Amazon Redshift の接続設定および使用方法 – HULFT Square

■Amazon Redshift データベースの準備

Amazon Redshift 上で作成したデータベースの接続情報を用意します。

以降の「コネクションリソースの作成」で次の項目値を使用しますので、あらかじめご確認ください

　・URL　・ユーザ名　・パスワード

■コネクションリソースの作成

HULFT Square で Amazon Redshift コネクターを利用するには、最初にコネクションリソースを作成する必要があります。

１．HULFT Square の [メイン] - [HULFT INTEGRATE] - [コネクション] を選択し、「新規追加」をクリックします。

２．「種類」セクションで、コネクターに「Amazon Web Services」、種類に「Amazon Redshift接続」を選択し、「次へ」をクリックします。

３．「全般」セクションで、コネクションリソースの名前、ワークスペース（任意）と説明（任意）を設定して「次へ」をクリックします。

４．「設定」セクションで、接続に必要なパラメータ値を各項目に設定します。入力値での接続を確認するには、「接続テスト」をクリックしてください。

項目名	項目値	必須	備考
URL	データベースへの接続URLを入力します。	○	・Amazon Redshiftのコンソール画面で表示されている、Cluster Database Properties-JDBC URLを指定してください。 Private Linkを介して接続するときは、JDBC URLのクラスターのエンドポイント名の部分を、HULFT Squareで作成したVPCエンドポイントのDNS名に置き換えて設定してください。
ユーザ名	データベースのユーザ名	○
パスワード	データベースのパスワード	○
SSL接続	SSL接続を行うかどうかを選択します。 [チェックあり]: SSL接続を行います。 [チェックなし]:(デフォルト) SSL接続は行いません。
ソケットタイムアウト(秒)	Amazon Web Services接続時のソケットタイムアウト時間を秒単位で指定します。		・「0」を入力した場合、タイムアウトしません。
接続タイムアウト(秒)	Amazon Web Services接続時の接続タイムアウト時間を秒単位で指定します。		・「0」を入力した場合、タイムアウトしません。

５．「接続テスト」ダイアログが開きますので、使用する「Integrateサービス」、「プロファイル」を設定し「OK」をクリックしてください。

接続テストが正常に完了した場合は、以下のようなダイアログが表示されますので「OK」をクリックし、元の画面で「次へ」をクリックしてください。

６．「プロファイル」セクションでプロファイルを設定します。

７．「サマリー」セクションに設定内容が表示されますので、問題が無ければ「完了」をクリックしてコネクション追加処理を完了してください。

以上でコネクションリソースの追加は完了です。

【参考】 Amazon Web Services 上のリソースに接続される場合

Amazon Web Services（以下 AWS）上のリソースへ接続する場合、必要に応じて HULFT Square とお客様の AWS 環境（VPC）間を AWS PrivateLink を介して接続を行います。

HULFT Square の「VPCエンドポイント」を作成することで、お客様の AWS 環境の VPC エンドポイントサービスへ PrivateLink で接続いただけます。
この場合、[リソース - コネクション] の「コネクションを追加」画面で「ホスト名」または「URL」に設定する値には、作成した「VPCエンドポイント」の「DNS名」を使用する必要があります。

「VPCエンドポイント」の詳細につきましては、以下の HULFT Square ヘルプをご参照ください。
----------
・[HULFT Square ヘルプ] 1.10.3 VPCエンドポイント
https://www.hulft.com/help/ja-jp/HULFTSquare/Content/HULFT_Square/HS_Settings/settings_vpc_endpoint.htm

■コネクターの設定

上記で追加したコネクションリソースを使用して、スクリプト上でAmazon Redshift コネクターを使用する例は以下の通りです。

（例）Amazon Redshift コネクター「テーブル読み取り」処理の設定例

スクリプトキャンバスに [クラウド] - [Amazon Redshift] - [COPYコマンド実行] を
ドラッグ＆ドロップで配置すると、以下のようなダイアログが開きます。

　　「必須設定」タブ内の各項目の設定値は以下の通りです。

- 接続先　　　：　上記「コネクションリソースの作成」で作成したリソース名を選択します
- COPYコマンド　：　Amazon Redshiftへ発行するCOPY文を入力します。