FileMaker Pro（Mac）から Bitbucket のデータ に接続
FileMaker Pro は、ユーザーがデータベースを視覚的に変更できるクロスプラットフォームのリレーショナルデータベースアプリケーションです。 CData Connect AI と組み合わせることで、FileMaker Pro はリアルタイムのBitbucket のデータにアクセスできます。この記事では、 Connect AI を使用して Bitbucket に接続し、FileMaker Pro でBitbucket のデータをクエリする方法を説明します。
CData Connect AI は、Bitbucket 向けの純粋な SQL Server インターフェースを提供し、 ネイティブにサポートされたデータベースにデータをレプリケーションすることなく Bitbucket のデータをクエリできます。 最適化されたデータ処理を標準で備えており、サポートされているすべての SQL 操作 （フィルター、JOIN など）を Bitbucket に直接プッシュし、サーバーサイド処理を活用して 要求されたBitbucket のデータを迅速に返します。
FileMaker Pro 用の Bitbucket 接続を設定
FileMaker Pro から Bitbucket への接続は、CData Connect AI によって実現されます。FileMaker Pro からBitbucket のデータを扱うには、まず Bitbucket 接続を作成・設定します。
- Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
- 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 をクリック
-
Add Bitbucket Connection ページで Permissions タブに移動し、ユーザーベースの権限を更新します。
Personal Access Token を追加
REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、Personal Access Token（PAT）が Connect AI への接続認証に使用されます。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開きます。
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック。
-
PAT に名前を付けて Create をクリック。
- Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。
接続の設定と PAT の生成が完了したら、FileMaker Pro からBitbucket のデータに接続する準備が整いました。
Connect AI を使用して FileMaker Pro から Bitbucket に接続
以下の手順に従って、FileMaker Pro から CData Connect AI 仮想 SQL Server API への接続を確立します。
CData Connect AI への ODBC 接続を設定
- Actual ODBC Driver for SQL Server（actualtech.com）をダウンロード・インストール
- 以下のプロパティを設定して、Actual ODBC ドライバーの DSN を設定：
- URL：tds.cdata.com
- Port：ポートを 1433 から 14333 に変更
- Username：Connect AI のメールアドレス
- Password：先ほど作成した PAT
FileMaker Pro から Bitbucket をクエリ
- SQL Query Builder の「SELECT」タブで、クエリに含めるカラムを選択。
- SQL Query Builder の「WHERE」タブを開き、「Show only selected columns」を選択。
- 「Table.Column」でテーブルとカラム名を選択。
- 「Operator」を = に設定。
- 「Column」を選択し、「Table.Column」と同じテーブルとカラム名を選択。
- 「Insert into SQL Query」をクリック。
- SQL クエリへの他の変更が不要であれば、「Execute」をクリック。
CData Connect AI を入手
SQL Server データベースから 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、 CData Connect AI をお試しください！