SSIS を使ってCarbone のデータをSQL Server にインポート
SQL Server に基幹業務データのバックアップを保管しておくことは、ビジネス上のセーフティネットとなります。また、ユーザーはSQL Server のバックアップデータからレポーティングや分析を簡単に行うことができます。
ここでは、SQL サーバー SSIS ワークフロー内でCData SSIS Tasks for API を使用して、Carbone のデータをMicrosoft SQL Server データベースに転送する方法を説明します。
Components の追加
開始するには、新しいCarbone ソースとSQL Server ADO.NET 転送先を新しいデータフロータスクに追加します。
新しいコネクションマネジャーを作成
以下のステップに従って、接続マネジャーでCarbone 接続プロパティを保存します。
- Connection Manager ウィンドウで、右クリックで［New Connection］ を選択します。Add SSIS Connection Manager ダイアログが表示されます。
- ［Connection Manager type］メニューでAPI を選択します。CData Carbone Connection Manager が表示されます。
- 接続プロパティを構成します。
まず、Profile 接続プロパティをディスク上の Carbone プロファイルの場所に設定します（例：C:\profiles\Carbone.apip）。次に、ProfileSettings 接続プロパティを Carbone の接続文字列に設定します（以下を参照）。
Carbone API プロファイル設定
Carbone では、Authorization ヘッダーの Bearer トークンによる API キー認証を使用します。API キーは以下の手順で取得できます。
- https://account.carbone.io で Carbone アカウントにログインします。
- アカウントのホームページに表示されている API キーをコピーします。
API キーを取得したら、以下の接続プロパティを設定します。
- AuthScheme：APIKey に設定します。
- APIKey：Carbone の API キー（Bearer トークン）に設定します。
- CarboneVersion：（オプション）carbone-version リクエストヘッダーで指定する、対象の Carbone API のメジャーバージョンです。デフォルトは 5 です。指定できる値は 5、4、3、staging です。
Carbone Source の構成
以下のステップに従って、Carbone の抽出に使用するクエリを指定します。
- Carbone ソースをダブルクリックしてソースコンポーネントエディタを開きます。
- ［Connection Manager］メニューで、以前作成した接続マネジャーを選択します。
- データの書き出しに使用するクエリを指定します。例：
SELECT Id, Name FROM Templates WHERE Category = 'Invoices'
- Carbone Source コントロールを閉じて、ADO.NET Destination に接続します。
SQL Server Destination を構成する
以下のステップに従って、Carbone をロードするSQL サーバーテーブルを指定します。
- ADO.NET Destination を選択して、新しい接続を追加します。接続するサーバーおよびデータベースの情報を入力。
- Data access モードメニューで、［table or view］を選択します。
- ［Table Or View］メニューで、設定するテーブルまたはビューを選択します。
- ［Mappings］画面で必要なプロパティを設定します。
プロジェクトの実行
プロジェクトを実行できるようになりました。SSIS Task の実行が完了すると、データベースにCarbone のデータが入力されます。