CSA Data Uploader にてCosmos DB データを、クラウドストレージにアップロード

Cosmos DB 用のCData ODBC ドライバは、ODBC 標準インターフェースを利用したCosmos DB へのライブデータアクセスを可能にし、使い慣れたSQL クエリで多種多様なBI、レポート、ETL ツールでCosmos DB を扱うことができます 。

この記事では、Amazon S3 やGoogle Cloud Storage などのクラウドストレージへのデータプレパレーション、ファイルアップロードを得意とするCSA Data Uploader でODBC 接続を使用してCosmos DB データの利用方法を示します。

Cosmos DB データへの接続

1. まずODBN DSN に必要な接続プロパティの値を入力します。組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。これは、ドライバーのインストール時の最後のステップでも可能です。Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
   
   

   SQL API を使ってCosmos DB アカウントに接続するために必要な接続文字列を取得するには、Azure Portal にログインして「Azure Cosmos DB」を選択し、自分のアカウントを選択します。「Settings」セクションで、「Connection String」をクリックして次の値を設定します。

   • AccountEndpoint: 値は、Cosmos DB アカウントの「Keys」ブレードからのCosmos DB アカウントURL である必要があります。
   • AccountKey: Azure ポータルで、Cosmos DB サービスに移動してAzure Cosmos DB アカウントを選択します。リソースメニューから、 「Keys」ページに移動します。「PRIMARY KEY」値を見つけ、Token をこの値に設定します。
2. CSA Data Uploader を開いて「設定 -> ODBC」に移動します。
3. 「追加」をクリックします。
4. 種別を「汎用ODBC」、「データソース名」で先ほど作成したODBC DSN を選択します。

入力後、接続テストが成功すれば設定は完了です。併せて任意のデータアップロード先の接続（Amazon S3・Google Cloud Storage など）も作成しておきましょう。

Cosmos DB ジョブの構成

続いてCSA DataUploader の対象データ参照し、クラウドストレージへデータをアップロードするジョブを構成します。

1. 「ジョブ」のページに移動して「ジョブを作成」をクリックします。
2. 任意の名称でジョブを作成します。ジョブ種別は「データアップロード」を選んでください。
3. ジョブは最初に入力対象となるデータを設定します。
4. 入力種別では、ODBC 接続を選択し、データソース名で先ほど設定したODBC DSN を選択します。併せて、Cosmos DB からデータを取得するためのSQL ベースのクエリを記述します。
5. なお、SQL でクエリ可能なテーブルはODBC DSN の「テーブル」タブで確認できます。
6. 入力設定を保存したら、「データ表示」ボタンをクリックすることで実際にCosmos DB から取得したデータを確認できます。
7. 以下のようにプレビューが表示されれば設定はOK です。
8. 併せて出力設定先となるクラウドストレージの情報を追加してください。
9. 事前に構成したコネクション情報で出力先を設定します。
10. これでジョブの作成は完了です。実行することで Cosmos DB データをクラウドストレージにアップロードすることができます。