SAS Viya で Bitbucket のリアルタイムデータを分析
SAS Viya は、データ管理、機械学習、分析を強化し、効率的な意思決定とインサイトの創出を促進する分析プラットフォームです。CData Connect AI と組み合わせることで、クラウド間でリアルタイムにBitbucket のデータにアクセスし、予測モデルの構築やデータドリブンな意思決定のためのインサイト作成など、さまざまな用途に活用できます。この記事では、SAS Viya クラウドプラットフォームから Connect AI に接続し、セルフサービス AI と分析のデプロイメントにBitbucket のデータを統合する方法をご紹介します。
CData Connect AI は、Bitbucket 向けに純粋な SQL インターフェースをクラウド間で提供します。これにより、データをレプリケーションすることなく、SAS Viya でBitbucket のデータに簡単に接続できます。Connect AI は SAS Viya からは SQL Server データベースとまったく同じように見え、フィルタや JOIN などの SQL 操作をBitbucketに直接プッシュする最適化されたデータ処理により、サーバーサイド処理を活用してBitbucket のデータをすばやく取得します。
Bitbucket への接続を設定(SAS Viya 向け)
SAS Viya から Bitbucket への接続は、CData Connect AI を介して行います。それでは、Bitbucket のデータを SAS Viya から利用できるようにするため、Bitbucket への接続を作成していきましょう。
- Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック
- 接続を追加パネルから「Bitbucket」を選択
-
Bitbucket に接続するために必要な認証プロパティを入力します。
ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。
Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。
- Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
- Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。
Bitbucketでの認証
BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。
特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。
カスタムOAuthアプリケーションの作成
Bitbucketアカウントから、以下のステップを実行します。
- 設定(歯車アイコン)に移動し、ワークスペース設定を選択します。
- アプリと機能セクションで、OAuthコンシューマーを選択します。
- コンシューマーを追加をクリックします。
- カスタムアプリケーションの名前と説明を入力します。
- コールバックURLを設定します。
- デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
- Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
- クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
- OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
- 新しいカスタムアプリケーションを保存するには、保存をクリックします。
- アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。
- 「Save & Test」をクリック
-
Bitbucket 接続の追加ページで「Permissions」タブに移動し、ユーザーベースの権限を更新します。
パーソナルアクセストークンを追加
REST API、OData API、または仮想 SQL Server を通じて Connect AI に接続する場合は、パーソナルアクセストークン(PAT)を使用して認証を行います。アクセス管理を細かく制御するため、サービスごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして設定ページを開きます。
- 設定ページで「Access Tokens」セクションに移動し、「 Create PAT」をクリックします。
-
PAT に名前を付けて「Create」をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されます。必ずコピーして、今後の利用のために安全に保管してください。
接続の設定と PAT の生成が完了したら、SAS Viya からBitbucket のデータに接続する準備は完了です。
SAS Viya から CData Connect AI に接続
以下の手順で、CData Connect AI で確立した接続を使用して Bitbucket から SAS Viya にデータを読み込む方法を説明します。
-
CData Connect AI JDBC ドライバーをダウンロードしてインストールします。
- CData Connect AI の Integrations ページを開きます。
- JDBC を検索して選択します。
- セットアップファイルをダウンロードして実行します。
- インストールが完了すると、JAR ファイルはインストールディレクトリ(lib フォルダ内)に配置されます。
- SAS Viya にログインし、左上の Applications Menu に移動します。
- Analytics Life Cycle トピックから Develop Code and Flows を選択します。
- Explorer タブに移動し、左パネルの SAS Server をクリックします。
- 以下の手順で CData Connect JDBC ドライバーの JAR ファイルをアップロードします。
- 「Home」ディレクトリを右クリックします。
- Upload files をクリックします。
- 指定された場所に JAR ファイルを配置し、ファイルパスをメモします。
- 完了したら、Libraries タブに移動し、CData Connect JDBC 用の Create a new library connection(以下に示すように左上隅)をクリックします。
- ライブラリ接続設定を入力します。
- Connection name: 接続の名前を入力
- Library name (libref): ライブラリの参照名を入力
- Library type: 「SAS/ACCESS to JDBC」を選択
- Properties タブをクリックし、Library attributes を READONLY に設定します。
- 「Connection Options」タブをクリックし、以下の詳細を入力します。
- Hive JDBC driver's class name: cdata.jdbc.connect.ConnectDriver
- Java CLASSPATH: JAR ドライバーファイルへのファイルパスを入力(手順 5 を参照)
- Test connection をクリックします。成功したら、Save and connect をクリックします。
- をクリックして新しいタブを追加し、SAS program を選択します。
- 以下のコードブロックに設定パラメータを入力します。
- Libref: 手順 9 で定義したライブラリ参照名を入力
- ClassPath: JAR ドライバーファイルへのファイルパスを入力
- Username: CData Connect のユーザー名を入力。CData Connect インターフェースの右上に表示されています(例: [email protected])
- DefaultCatalog: クエリを実行したい CData Connect AI で設定した接続を入力
- Password: 「パーソナルアクセストークンを追加」セクションで生成した PAT を入力
libname [Libref] JDBC classpath=[ClassPath] class="cdata.jdbc.connect.ConnectDriver" URL="jdbc:Connect:AuthScheme=Basic;User=[Username];DefaultCatalog=[DefaultCatalog];DefaultSchema=dbo;Password=[PAT]"; proc sql; SELECT * FROM [Libref].MyTable; quit; - Run をクリックします。CData Connect AI から SAS Viya にデータが読み込まれるのを確認できます。
クラウドアプリケーションから Bitbucket へのリアルタイムアクセス
これで、SAS Viya からBitbucket のデータへのダイレクトなクラウド間接続が完成しました。データをレプリケーションすることなく、予測モデルの構築、データドリブンな意思決定のためのインサイト作成など、さまざまな用途に活用できます。
Connect AI をお試しいただき、数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスをクラウドアプリケーションから直接実現してください。