各製品の資料を入手。
詳細はこちら →Connect Cloud 経由でRunMyProcess のAmazon Athena のデータに接続
CData Connect Cloud を使用してAmazon Athena のデータのOData API を作成し、Akorbi Digital RunMyProcess からデータに接続します。
最終更新日:2022-03-07
この記事で実現できるAmazon Athena 連携のシナリオ
こんにちは!テクニカルディレクターの桑島です。
Akorbi Digital RunMyProcess は、予算申請や契約管理などの複雑な業務アプリケーションを簡単に作成することができます。CData Connect Cloud は、Amazon Athena へのリアルタイム接続を作成し、Amazon Athena のOData API(RunMyProcess でネイティブにサポート)を生成するために使用できます。RunMyProcess をCData Connect Cloud と組み合わせすることで、すべてのSaaS およびクラウドベースのビッグデータとNoSQL データソースへ、データを移行したり統合したりする必要なくクラウドベースの接続が可能になります。ほかのREST サービスと同様に、RunMyProcess からConnect Cloud に接続するだけで、Amazon Athena のデータに瞬時にリアルタイムでアクセスできます。
この記事では、CData Connect Cloud からAmazon Athena に接続し、RunMyProcess でOData フィードを通じてAmazon Athena にアクセスする手順を説明します。
Connect Cloud アカウントの取得
以下のステップを実行するには、CData Connect Cloud のアカウントが必要になります。こちらから製品の詳しい情報とアカウント作成、30日間無償トライアルのご利用を開始できますので、ぜひご利用ください。
Connect Cloud を構成する
RunMyProcess でAmazon Athena のデータをリアルタイムで操作するには、Connect Cloud からAmazon Athena に接続し、コネクションにユーザーアクセスを提供してAmazon Athena のデータのOData エンドポイントを作成する必要があります。
(オプション)新しいConnect Cloud ユーザーの追加
必要に応じて、Connect Cloud 経由でAmazon Athena に接続するユーザーを作成します。
- ユーザーページに移動し、 Invite Users をクリックします。
- 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
- ユーザーページからユーザーを確認および編集できます。
パーソナルアクセストークンの追加
OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン(PAT)を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- Connect Cloud アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
Connect Cloud からAmazon Athena に接続
CData Connect Cloud では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。
- Connect Cloud にログインし、 Add Connection をクリックします。
- Add Connection パネルから「Amazon Athena」を選択します。
-
必要な認証プロパティを入力し、Amazon Athena に接続します。
Amazon Athena 接続プロパティの取得・設定方法
Amazon Athena リクエストの認証には、アカウントの管理のクレデンシャルか、IAM ユーザーのカスタムPermission を設定します。 AccessKey にAccess Key Id、SecretKey にはSecret Access Key を設定します。
AWS アカウントアドミニストレータとしてアクセスできる場合でも、AWS サービスへの接続にはIAM ユーザークレデンシャルを使用することが推奨されます。
IAM ユーザーのクレデンシャル取得は以下のとおり:
- IAM コンソールにログイン。
- Navigation ペインで「ユーザー」を選択。
- ユーザーのアクセスキーを作成または管理するには、ユーザーを選択してから「セキュリティ認証情報」タブを選択。
AWS ルートアカウントのクレデンシャル取得は以下のとおり:
- ルートアカウントの資格情報を使用してAWS 管理コンソールにサインイン。
- アカウント名または番号を選択し、表示されたメニューで「My Security Credentials」を選択。
- 「Continue to Security Credentials」をクリックし、「Access Keys」セクションを展開して、ルートアカウントのアクセスキーを管理または作成。
EC2 インスタンスからの認証
EC2 インスタンスからCData 製品を使用していて、そのインスタンスにIAM ロールが割り当てられている場合は、認証にIAM ロールを使用できます。 これを行うには、UseEC2Roles をtrue に設定しAccessKey とSecretKey を空のままにします。 CData 製品は自動的にIAM ロールの認証情報を取得し、それらを使って認証します。
AWS ロールとして認証
多くの場合、認証にはAWS ルートユーザーのダイレクトなセキュリティ認証情報ではなく、IAM ロールを使用することをお勧めします。 代わりにRoleARN を指定してAWS ロールを使用できます。これにより、CData 製品は指定されたロールの資格情報を取得しようと試みます。 (すでにEC2 インスタンスなどで接続されているのではなく)AWS に接続している場合は、役割を担うIAM ユーザーのAccessKeyと SecretKey を追加で指定する必要があります。AWS ルートユーザーのAccessKey およびSecretKey を指定する場合、 ロールは使用できません。
MFA での認証
多要素認証を必要とするユーザーおよびロールには、MFASerialNumber およびMFAToken 接続プロパティを指定してください。 これにより、CData 製品は一時的な認証資格情報を取得するために、リクエストでMFA 認証情報を送信します。一時的な認証情報の有効期間 (デフォルトは3600秒)は、TemporaryTokenDuration プロパティを介して制御できます。
Amazon Athena への接続
AccessKey とSecretKey プロパティに加え、Database、S3StagingDirectory、Region を設定します。Region をAmazon Athena データがホストされているリージョンに設定します。S3StagingDirectory をクエリの結果を格納したいS3内のフォルダに設定します。
接続にDatabase が設定されていない場合は、CData 製品はAmazon Athena に設定されているデフォルトデータベースに接続します。
- Create & Test をクリックします。
- Edit Amazon Athena Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
Connect Cloud にAmazon Athena OData エンドポイントを追加する
Amazon Athena に接続したら、目的のテーブルのOData エンドポイントを作成します。
- OData ページに移動し、 Add to create new OData endpoints をクリックします。
- Amazon Athena コネクション(例:AmazonAthena1)を選択し、Next をクリックします。
- 使用するテーブルを選択し、Confirm をクリックします。
OData フィードのサンプルURL
Amazon Athena への接続を構成してユーザーを作成し、Connect Cloud でOData エンドポイントを作成すると、Amazon Athena のデータのOData フィードにアクセスできるようになります。 以下は、テーブルにアクセスするためのURL とテーブルのリストです。テーブルへのアクセスについては、Connect Cloud のOData ページを参照してください。URL については、Connect Cloud のURL が必要になります。(例: https://cloud.cdata.com/api/odata/service)
テーブル | URL | |
---|---|---|
エンティティ(テーブル)一覧 | https://cloud.cdata.com/api/odata/service/ | |
メタデータ | https://cloud.cdata.com/api/odata/service/$metadata | |
Customers | https://cloud.cdata.com/api/odata/service/Customers |
通常のOData フィードについては、返されるフィールドを制限したい場合は、クエリに$select パラメータと$filter、$orderby、$skip、$top といった他の一般的なOData URL パラメータを組み合わせて追加できます。 サポートされているOData クエリの詳細についてはヘルプドキュメントを参照してください。
コネクションとOData エンドポイントを設定したら、RunMyProcess からAmazon Athena のデータに接続できます。
RunMyProcess DigitalSuite Studio からAmazon Athena のデータを取得する
Amazon Athena への接続と構成されたOData エンドポイントがあれば、RunMyProcess にAmazon Athena のデータを追加して取得することができます。
Provider を作成する
- RunMyProcess にログインしDigitalSuite Studio を開きます。
- 「Resources」をクリックしてResources ページを立ち上げ、「CONNECTORS」タブを選択します。
- 新規プロバイダーを作成する場合は、「+(New Provider)」ボタンをクリックし、使用するアカウントを選択し、「Confirm」をクリックします。
- 設定ページで次のプロパティを設定します。
- URL:Connect Cloud OData ページのOData エンドポイントを設定します。https://cloud.cdata.com/api/odata/service
- Authentication Schema:ログイン / パスワードを選択します。
- Login:Connect Cloud のユーザー名を指定します。(例:[email protected])
- Password:Connect Cloud ユーザーのPAT を指定します。
- 「ACCEPTANCE」、「TEST」タブにも同じ情報を入力します。Note:その際、「Copy this configuration button」ボタンをクリックすることで設定をコピーでき、コピー先のタブで「Paste previously copied configuration」をクリックして内容をペーストできます。
- 「Save」をクリックしてプロパティを保存します。
コネクタを作成してAmazon Athena のデータを取得する
- 「CONNECTOR」タブで三点リーダーをクリックし、プロバイダーを作成します。メニューからAdd を選択します。
- 次に示すページでは、Connect Cloud で設定されたOData エンドポイントにConnector URL を設定する方法を説明します。(例: https://cloud.cdata.com/api/odata/service)
- 「Save」、「Launch」の順でクリックし接続の実行をテストします。「Launch test」をクリックして実行します。設定したテーブル情報のJSON レスポンスが得られれば、処理は成功です。
詳細と無料トライアル
これで、Amazon Athena のデータを取得するためのプロバイダーとコネクタが作成されました。Amazon Athena(および100を超えるほかのデータソース)からのOData フィードの作成方法の詳細については、Connect Cloud ページにアクセスしてください。無償トライアルにサインアップして、RunMyProcess でリアルタイムAmazon Athena のデータの操作をはじめましょう。