CData SSIS Components for Unbounce はじめに:インストールから接続まで
このガイドでは、CData SSIS Components for Unbounce の使い方を詳しく解説します。コンポーネントのインストール、ライセンスの認証、初回 SSIS 接続マネージャーの設定、そして SQL Server Integration Services ワークフローで Unbounce のデータ を移動・変換するためのデータフロータスクの作成方法を学べます。
インストールとライセンス認証
システム要件
- Windows: Windows 10/11 または Windows Server 2016 以降
- Visual Studio: Visual Studio 2015 以降
- SQL Server: SQL Server 2014、2016、2017、2019、または 2022
SSIS コンポーネントのインストール
- CData アカウントまたは評価版ダウンロードページから Unbounce 用の SSIS Components インストーラーをダウンロードします
- インストーラーを実行し、インストールウィザードに従います
- インストーラーが自動的に接続マネージャー、ソース、宛先コンポーネントを Visual Studio に登録します
- プロンプトが表示されたら、CData Orders チームから送られたプロダクトキーを使用してライセンスを認証します:
XXXX-XXXX-XXXX-XXXX-XXXX- Note: 試用版を実行するには、Trial Key オプションを選択してください。
Visual Studio 2022 での SSIS の有効化
Visual Studio 2022 を使用している場合は、SQL Server Integration Services Projects 拡張機能をインストールする必要があります。
- Visual Studio で 拡張機能 > 拡張機能の管理 を選択します
- SQL Server Integration Services Projects 2022 を検索します
- インストールをクリックします
- Visual Studio を閉じ、ダウンロードした Microsoft.DataTools.IntegrationServices.exe インストーラーを実行します
- Visual Studio を再度開きます。新しいプロジェクトを作成する際に Integration Services Project テンプレートが表示されるようになります
ライセンスの認証
インストール中に SSIS Component ライセンスの認証が求められます。認証を更新または変更する必要がある場合は、以下の手順に従ってください:
ライセンス認証
インストーラーが自動的にライセンスの追加を促します。インストール時に以下を選択できます:
- 既存のサブスクリプションライセンスキーを使用する、または
- 試用版ライセンスを入力する
正規サブスクリプションライセンスを認証するには、CData Orders チームにお問い合わせいただき、[email protected] でプロダクトキーをリクエストしてください。
プロンプトが表示されたら、インストーラーにライセンスキーを入力します。認証が完了すると、追加の手順なしに Visual Studio 内でコンポーネントがライセンス認証され、使用できるようになります。
ランタイムライセンス
SSIS パッケージをデプロイする際は、ランタイムキー(RTK)も使用できます:
- デプロイ前に接続マネージャーで RTK プロパティを設定します
ライセンスに関するよくある質問
ライセンスは複数のマシンで使用できますか?
はい、サブスクリプションプランによります。詳細については [email protected] までお問い合わせください。
ライセンスキーを紛失しました。どうすれば取得できますか?
注文番号を添えて [email protected] までメールでお問い合わせいただければ、ライセンスキーを再送いたします。
ライセンスを別のマシンに移行するにはどうすればよいですか?
はい。ライセンスを別のマシンに移行するには、以下のリンクからライセンス移行リクエストを送信する必要があります:
https://www.cdata.com/lic/transfer/ライセンス移行リクエストが送信され、正常に処理されると、プロダクトキーにアクティベーションが追加され、別のマシンで正規ライセンスを認証できるようになります。このプロセスが完了すると、以前のマシンのライセンスは無効になります。
ライセンスの確認とアップグレードは、セルフサービスポータル portal.cdata.com から行えます。
接続設定
コンポーネントがインストールされ、ライセンスが認証されたら、SSIS 接続マネージャーを使用して Unbounce への接続を設定できます。この接続マネージャーは、ソースおよび宛先コンポーネントで使用されるすべての認証および接続プロパティを保存します。
接続マネージャーの作成
- SSIS パッケージの下部にある接続マネージャーパネルで右クリックし、新しい接続を選択します
- リストから CData API Driver for SSIS を選択します
- 追加をクリックして接続マネージャー UI を開きます
- Unbounce に応じて必要な認証プロパティ(OAuth、API トークン、クライアント資格情報など)を入力します
- AuthScheme:OAuth に設定します。
- InitiateOAuth:GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId:アプリ設定で指定されているClient Id を設定します。
- OAuthClientSecret:アプリ設定で指定されているClient Secret を設定します。
- CallbackURL:アプリ設定で指定したRedirect URI を設定します。
- 接続テストをクリックして接続を確認します
接続プロパティの設定
まず、Profile 接続プロパティにUnbounce プロファイルのディスク上の場所を設定します(例:C:\profiles\Unbounce.apip)。
次に、ProfileSettings 接続プロパティにUnbounce の接続文字列を設定します(以下を参照)。
Unbounce API プロファイル設定
Unbounce はOAuth を使用してデータに認証します。
Unbounce に認証するには、まずOAuth アプリケーションを登録する必要があります。https://developer.unbounce.com/getting_started/ にアクセスし、Register OAuth Application フォームを完了します。
以下の接続プロパティを設定すると、接続の準備が整います:
SSIS データフローの作成
接続マネージャーを作成したら、SSIS データフロータスクを使用して Unbounce からデータを取得したり、データをプッシュしたりできます。
データフロータスクの作成
- 制御フロータブで、データフロータスクをデザインサーフェスにドラッグします
- タスクをダブルクリックしてデータフローワークスペースを開きます
ソースコンポーネントの使用
- SSIS ツールボックスから、CData Unbounce Source コンポーネントをデータフローにドラッグします
- ダブルクリックしてソースエディターを開きます
- 作成した CData Unbounce 接続マネージャーを選択します
- レコードを抽出するテーブルまたはビューを選択します
- OK をクリックして設定を保存します
宛先コンポーネントの使用
- SQL Server 宛先をキャンバスにドラッグします
- ダブルクリックして宛先エディターを開きます
- 既存のテーブルを選択するか、新規をクリックしてソースのスキーマに基づいてテーブルを自動生成します
- ソースの出力を宛先の入力に接続し、必要に応じてカラムをマッピングします
- これで Unbounce のデータ を SQL Server データベースにレプリケートするデータフロータスクが作成されました
データフローのテスト
- 制御フロータブに戻ります
- デバッグの開始をクリックします
- 進行状況インジケーターを監視します
- 行数を確認し、データが期待どおりに読み込まれていることを確認します
よくある接続の問題
認証エラー
解決策: Unbounce の OAuth 設定、クライアント ID、シークレット、またはトークンの権限を確認してください。OAuth のトラブルシューティングについては [email protected] までお問い合わせください。
サーバーに接続できない
解決策: ファイアウォール、プロキシ、VPN の設定を確認してください。特定のポート要件については [email protected] までお問い合わせください。
テーブルが見つからない
解決策: Unbounce をクエリする際に、正しいスキーマまたはデータベースを選択しているか確認してください。
次のステップ
SSIS Components のインストール、ライセンス認証、接続設定が完了しました。以下のシナリオを参考に、SSIS ツールをさらに活用してみてください:
| SSIS Component | 記事タイトル |
|---|
サポート
ご不明な点がございましたら、お気軽にお問い合わせください:
- テクニカルサポート: [email protected]
- コミュニティフォーラム: CData Community Site
- ヘルプドキュメント: ローカルにインストールされているほか、オンラインでも参照可能です
FAQ
インストールとライセンス
- SSIS Components のインストールには管理者権限が必要ですか?
はい、Visual Studio 全体で使用するコンポーネントをインストールするには管理者権限が必要です。 - Azure Data Factory にデプロイする際に RTK は必要ですか?
はい。公開前に接続マネージャーで RTK プロパティを設定してください。
接続
- 複数の Unbounce アカウントを使用できますか?
アカウントごとに個別の接続マネージャーを作成してください。 - プロキシ経由で接続できますか?
はい。接続マネージャーのプロパティでプロキシ設定を構成できます。 - 接続をテストするにはどうすればよいですか?
接続マネージャー UI で接続テストをクリックしてください。
パフォーマンスとトラブルシューティング
- データフローが遅いのはなぜですか?
フィルターの追加、行数の制限、ソースコンポーネントでのバッチ処理設定を確認してください。 - ログを有効にするにはどうすればよいですか?
接続マネージャーに以下を追加してください:- Logfile: /path/to/logfile.log
- Verbosity: 3
トラブルシューティングの際は、[email protected] にご連絡の上、ログファイルを安全にアップロードしてください。
この FAQ で解決しない場合は、[email protected] までお問い合わせください。