製品をチェック

Bitbucket Driver の30日間無償トライアルをダウンロード

 30日間の無償トライアルへ

製品の詳細

Bitbucket アイコン Bitbucket JDBC Driver 相談したい

Bitbucket データと連携するパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

SnapLogic でBitbucket を外部サービスに連携

CData JDBC Driver を使用して、SnapLogic と外部サービスを連携。

古川えりか
コンテンツスペシャリスト

最終更新日:2021-11-05
bitbucket ロゴ

CData

jdbc ロゴ画像
SnapLogic ロゴ

こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。

SnapLogic はintegration Platform-as-a-Service(iPaaS)であり、ユーザーはノーコードでデータ連携フローを作成できます。CData JDBC ドライバと組み合わせることで、ユーザーはSnapLogic ワークフローからBitbucket を含む250を超えるSaaS、ビッグデータ、NoSQL データソースのリアルタイムデータに接続できます。

組み込みの最適化されたデータ処理によって、CData JDBC Driver はリアルタイムBitbucket データを高速に扱えます。プラットフォームがBitbucket に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をBitbucket に直接プッシュし、サポートされていない操作(主にSQL 関数とJOIN 操作)は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータソース型を使用してBitbucket データを操作することができます。

SnapLogic からBitbucket に接続する

SnapLogic からBitbucket データに接続するには、CData Bitbucket JDBC Driver をダウンロードしてインストールします。インストール画面に従ってください。インストールが完了すると、インストール先のディレクトリ(デフォルトでは、C:/Program Files/CData/CData JDBC Driver for Bitbucket/lib)にJAR ファイルが作成されます。

Bitbucket JDBC Driver をアップロードする

インストール後、JDBC JAR ファイルをSnapLogic 内のディレクトリ(例えば、projects/Jerod Johnson)にManager タブからアップロードします。

アップロードされたJDBC Driver(Salesforce とQuickBooks Online の場合)

接続を設定する

JDBC Driver がアップロードされると、Bitbucket への接続を作成できます。

  1. Designer タブに移動します。
  2. Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。 designer にGeneric JDBC snap を追加
  3. Add Account をクリック(または既存のものを選択)して、「Continue」をクリックします。
  4. 次のフォームでは、JDBC 接続プロパティを設定します。
    • JDBC JARs 以下にアップロードしたJAR ファイルを追加します。
    • JDBC Driver Classcdata.jdbc.bitbucket.BitbucketDriver に設定します。
    • JDBC URL をBitbucket JDBC Driver 用のJDBC 接続文字列に設定します。例えば、

      jdbc:bitbucket:Workspace=myworkspaceslug;Schema=InformationRTK=XXXXXX;InitiateOAuth=GETANDREFRESH
      です。

      NOTE: RTK は評価版もしくは製品版のキーです。詳しくは、CData のサポートチームにご連絡ください接続を設定(Salesforce の場合)

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

      JDBC URL の作成の補助として、Bitbucket JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

      java -jar cdata.jdbc.bitbucket.jar

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

      ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、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アカウントから、以下のステップを実行します。

      1. 設定(歯車アイコン)に移動し、ワークスペース設定を選択します。
      2. アプリと機能セクションで、OAuthコンシューマーを選択します。
      3. コンシューマーを追加をクリックします。
      4. カスタムアプリケーションの名前と説明を入力します。
      5. コールバックURLを設定します。
        • デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
        • Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
      6. クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
      7. OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
      8. 新しいカスタムアプリケーションを保存するには、保存をクリックします。
      9. アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。
      組み込みの接続文字列デザイナーを使ってJDBC URL を生成(Salesforce の場合)
  5. 接続プロパティの入力後、「Validate」、そして「Apply」をクリックします。

Bitbucket データを読み込む

接続を検証、適用後に開くフォームで、クエリを設定します。

  • Schema name を"Bitbucket" に設定します。
  • Table name を、スキーマ名を使用したBitbucket 用のテーブルに設定します。例えば、"Bitbucket"."Issues" です(ドロップダウンを使用して利用可能なテーブルの全リストを確認できます)。
  • テーブルから、使用したい項目ごとにOutput fields を追加します。
Select snap を設定(Salesforce の場合)

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の終端部分(以下のハイライト部分)をクリックしてデータをプレビューします。

snap の終端部分をクリックしてデータをプレビュー。

結果が期待どおりのものであることを確認したら、他のsnap を追加してBitbucket データを別のエンドポイントに渡すこともできます。

データをプレビュー(Salesforce の場合)。

Bitbucket データを外部サービスにパイプ

本記事では、データをGoogle Spreadsheet にロードします。他のあらゆるサポートされているsnap が使用でき、Generic JDBC snap を他のCData JDBC ドライバと利用してデータを外部サービスに移すこともできます。

  1. まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
  2. Google Sheets に接続するアカウントを追加します。 Google に接続
  3. Worksheet Writer snap を、Bitbucket データをGoogle Spreadsheet に書き込むよう設定します。 Google Spreadsheet に書き込み

これで、接続済みのパイプラインを実行してBitbucket からデータを抽出し、Google Spreadsheet にプッシュできます。

Google Spreadsheets に書き込まれたデータ(Salesforce の場合)

外部データをBitbucket にパイプ

上述のように、JDBC Driver for Bitbucket をSnapLogic から使用してデータをBitbucket に書き込むことができます。まずは、Generic JDBC - Insert またはGeneric JDBC - Update snap をダッシュボードに追加します。

  1. 既存の「Account」(接続)を選択するか、新しく作成します。
  2. クエリの設定。
    • Schema name を"Bitbucket" に設定します。
    • Table name をスキーマ名を使用したBitbucket のテーブルに設定します。例えば、"Bitbucket"."Issues"(ドロップダウンを使用して利用可能な全テーブルの一覧を確認できます)。
    INSERT snap を設定(Salesforce の場合)
  3. Generic JDBC - Insert/Update snap を保存します。

これで、Bitbucket にデータを書き込んだり、新しいレコードを挿入したり、既存のレコードを更新するsnap が設定できました。

詳細情報と無償評価版

CData JDBC Driver for Bitbucket を使えば、Bitbucket データを外部サービスに連携するためのパイプラインをSnapLogic で作成できます。Bitbucket への接続に関する詳細については、CData のBitbucket 連携ページを参照してください。30日の無償評価版をダウンロードして今すぐ使い始めましょう。

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。