Azure Data Factory を使用してHarvest のデータをインポート

古川えりか
古川えりか
コンテンツスペシャリスト
CData Connect AI を使用してAzure Data Factory からHarvest に接続し、リアルタイムHarvest のデータをインポートします。

Azure Data Factory（ADF）は、フルマネージドのサーバーレスデータ統合サービスです。 CData Connect AI と組み合わせると、ADF はデータフローでHarvest のデータにクラウドベースで即座にアクセスできます。 この記事では、Connect AI を使用してHarvest に接続し、ADF でHarvest のデータにアクセスする方法を紹介します。

Connect AI からHarvest への接続

CData Connect AI では、直感的なクリック操作ベースのインターフェースを使ってデータソースに接続できます。

  1. Connect AI にログインし、 Add Connection をクリックします。
    2. Adding a Connection
  2. Add Connection パネルで「Harvest」を選択します。
    3. Selecting a data source
  3. 必要な認証プロパティを入力し、Harvest に接続します。

    まず、Profile 接続プロパティをディスク上のHarvest プロファイルの場所に設定します（例：C:\profiles\Harvest.apip）。次に、ProfileSettings 接続プロパティをHarvest の接続文字列に設定します（以下を参照）。

    Harvest API プロファイル設定

    Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。

    トークン認証の使用

    トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。

    OAuth 認証の使用

    まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。

    以下の接続プロパティを設定すると、接続できるようになります。

    • ProfileSettings：ProfileSettings でAccountId を設定します。
    • AuthScheme：OAuth に設定します。
    • OAuthClientId：アプリ設定で指定したclient ID に設定します。
    • OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
    • CallbackURL：アプリ設定で指定したRedirect URI に設定します。
    • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。
    Configuring a connection (Salesforce is shown)
  4. Create & Test をクリックします。
  5. Add Harvest Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。 Updating permissions

パーソナルアクセストークンの取得

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。 きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

  1. Connect AI アプリの右上にあるユーザー名をクリックし、「User Profile」をクリックします。
  2. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
  3. PAT の名前を入力して Create をクリックします。
    4. Creating a new PAT
  4. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

接続設定が完了すると、Azure Data Factory からHarvest のデータへ接続できるようになります。

Azure Data Factory からリアルタイムHarvest のデータにアクセス

Azure Data Factory からCData Connect AI の仮想SQL Server API への接続を確立するには、以下の手順を実行します。

  1. Azure Data Factory にログインします。
    2. Logging in to ADF
  2. まだData Factory を作成していない場合は、「New -> Dataset」をクリックします。
    3. Creating new data factory
  3. 検索バーにSQL Server と入力し、表示されたら選択します。次の画面で、サーバーの名前を入力します。 Linked service フィールドで「New」を選択します。
    4. Selecting SQL Server
  4. 接続設定を入力します。
    • Name - 任意の名前を入力。
    • Server name - 仮想SQL Server のエンドポイントとポートをカンマで区切って入力。例：tds.cdata.com,14333
    • Database name - 接続したいCData Connect AI データソースのConnection Name を入力。例：API1
    • User Name - CData Connect AI のユーザー名を入力。ユーザー名はCData Connect AI のインターフェースの右上に表示されています。 例：[email protected]
    • Password - Password（Azure Key Vault ではありません）を選択してSettings ページで生成したPAT を入力。
    • 「Create」をクリックします。
    5. Configuring new linked service
  5. Set properties で、Name を設定し、続けて先ほど作成したLinked service、利用可能なTable name、Import schema のfrom connection/store を選択します。 「OK」をクリックします。
    6. Setting the properties
  6. リンクされたサービスを作成すると、以下の画面が表示されます。
    7. Displaying the new screen
  7. Preview data をクリックすると、インポートされたHarvest テーブルが表示されます。
    8. Previewing the imported table Azure Data Factory でデータフローを作成する際、このデータセットを使用できるようになりました。

CData Connect AI の入手

CData Connect AI の14日間無償トライアルを利用して、クラウドアプリケーションから直接数百種類のSaaS、ビッグデータ、NoSQL データソースへのSQL アクセスをお試しください！

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

この記事の内容

関連記事