CloverDX（旧CloverETL）で UM SaaS Cloud のデータ に接続

CData JDBC Driver for UM SaaS Cloud を使用すると、CloverDX（旧CloverETL）のデータ変換コンポーネントで UM SaaS Cloud をソースおよびデスティネーションとして扱えます。この記事では、JDBC Driver for UM SaaS Cloud を使用して、フラットファイルへのシンプルな転送を設定する方法を説明します。

JDBC データソースとして UM SaaS Cloud に接続

1. UM SaaS Cloud のデータ への接続を作成します。新規のCloverDX グラフで、Outline ペインの「Connections」ノードを右クリックし、「Connections」->「Create Connection」をクリックします。Database Connection ウィザードが表示されます。
2. プラスアイコンをクリックし、JAR からドライバーをロードします。インストールディレクトリのlib サブフォルダを参照し、cdata.jdbc.umsaascloud.jar ファイルを選択します。
3. JDBC URL を入力します。

   UM SaaS Cloud 接続プロパティの取得・設定方法

   デフォルトでは、CData 製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。

   UM SaaS Cloud への認証

   UM SaaS Cloud は、Basic、OAuth、OAuthJWT（コンシューマーキー）など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。

   Basic 認証

   Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。

   デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、UM SaaS Cloud JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから実行します。

   java -jar cdata.jdbc.umsaascloud.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   一般的なJDBC URL は次のようになります：

   jdbc:umsaascloud:AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;

DBInputTable コンポーネントで UM SaaS Cloud のデータ をクエリ

1. Palette の「Readers」から「DBInputTable」をジョブフローにドラッグし、ダブルクリックして設定エディターを開きます。
2. 「DB connection」プロパティで、ドロップダウンメニューから UM SaaS Cloud JDBC データソースを選択します。
3. SQL クエリを入力します。例：

   SELECT BillingState, Name FROM Account WHERE Industry = 'Floppy Disks'

クエリの出力をUniversalDataWriter に書き込む

1. 「Writers」から「UniversalDataWriter」をジョブフローにドラッグします。
2. UniversalDataWriter をダブルクリックして設定エディターを開き、ファイルURL を追加します。
3. DBInputTable を右クリックし、「Extract Metadata」をクリックします。
4. DBInputTable の出力ポートをUniversalDataWriter に接続します。
5. UniversalDataWriter の「Select Metadata」メニューで、Account テーブルを選択します。（このメニューはUniversalDataWriter の入力ポートを右クリックしても開けます。）
6. 「Run」をクリックして、ファイルに書き込みます。