Dremio でCosmos DB のデータに外部ソースとして接続

CData JDBC Driver for Cosmos DB はJDBC 標準を実装しており、Dremio を含むさまざまなアプリケーションでリアルタイムのCosmos DB のデータを扱えるようにします。Dremio は、データレイク上でのセルフサービス型インタラクティブ分析を実現するために設計されたデータレイクハウスプラットフォームです。CData JDBC ドライバーを使用することで、エンタープライズデータレイクの一部としてリアルタイムCosmos DB のデータを活用できます。この記事では、Dremio でCosmos DB のデータに外部ソースとして接続する方法について説明します。

CData JDBC Driver を使用すると、Dremio でリアルタイムCosmos DB のデータへの高速アクセスが可能になります。ドライバーをインストールしてCosmos DB で認証すれば、データレイク内でCosmos DB のデータにすぐにアクセスできます。ネイティブのデータ型を使用してCosmos DB のデータを表示し、複雑なフィルタ、集計、その他の操作を自動的に処理することで、CData JDBC Driver はCosmos DB のデータへのシームレスなアクセスを提供します。

前提条件

この記事では、Docker を使用して Dremio を実行することを想定しています。以下のようなコマンドで Dremio サービスを含む Docker コンテナを作成できます。

docker run -d --name dremio -p 9047:9047 -p 31010:31010 dremio/dremio-oss

ここで、dremio はコンテナの名前、9047 は Dremio Web インターフェース用のコンテナポート、31010 は Dremio クエリサービスにマッピングされるポートです。dremio/dremio-oss は使用するイメージを指定します。

ARP コネクタのビルド

CData JDBC Driver を Dremio で使用するには、Advanced Relation Pushdown（ARP）コネクタをビルドする必要があります。GitHub でソースコードを確認するか、ZIP ファイル（GitHub.com）を直接ダウンロードできます。ファイルをコピーまたは展開したら、コネクタのルートディレクトリ（pom.xml ファイルがあるディレクトリ）から以下のコマンドを実行してコネクタをビルドします。

mvn clean install

NOTE：CData ARP コネクタは Java 11 でコンパイルするようにビルドされています。Java 11 をインストールし、正しいバージョンを使用していることを確認してください。以下のようなコマンドで Java バージョンを更新できます。

sudo update-alternatives --config java

コネクタ用の JAR ファイルが（target ディレクトリに）ビルドされたら、ARP コネクタと JDBC Driver を Dremio インスタンスにコピーする準備が整いました。

コネクタと JDBC Driver のインストール

ARP コネクタを %DREMIO_HOME%/jars/ に、Cosmos DB 用の JDBC Driver を %DREMIO_HOME%/jars/3rdparty にインストールします。以下のようなコマンドを使用できます。

ARP コネクタ

docker cp PATH\TO\dremio-cosmosdb-plugin-{DREMIO_VERSION}.jar dremio_image_name:/opt/dremio/jars/

Cosmos DB 用 JDBC Driver

docker cp PATH\TO\cdata.jdbc.cosmosdb.jar dremio_image_name:/opt/dremio/jars/3rdparty/

Cosmos DB への接続

これで、Dremio の外部ソースオプションに Cosmos DB が表示されるようになりました。ビルドした ARP コネクタは、JDBC URL を使用してCosmos DB のデータに接続します。JDBC Driver には、接続文字列を作成できるビルトインの接続文字列デザイナーがあります（以下を参照）。

ビルトイン接続文字列デザイナー

JDBC URL の構成については、Cosmos DB JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

java -jar cdata.jdbc.cosmosdb.jar

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

CosmosDB 接続プロパティの取得・設定方法

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 をこの値に設定します。

NOTE：Dremio で JDBC Driver を使用するには、ライセンス（正式版または評価版）とランタイムキー（RTK）が必要です。このライセンス（または評価版）の取得については、営業チームにお問い合わせください。

ランタイムキー（RTK）を JDBC URL に追加します。最終的に、以下のような JDBC URL になります。

jdbc:cosmosdb:RTK=5246...;AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;

Cosmos DB に外部ソースとしてアクセス

Cosmos DB を外部ソースとして追加するには、新しいソースを追加するためにクリックし、CosmosDB を選択します。JDBC URL をコピーして、New CosmosDB Source ウィザードに貼り付けます。

接続を保存すれば、Dremio でリアルタイムCosmos DB のデータをクエリする準備が整い、Cosmos DB のデータをデータレイクに簡単に取り込むことができます。

詳細情報と無償トライアル

Dremio で CData JDBC Driver for Cosmos DB を使用すると、リアルタイムCosmos DB のデータをデータレイクに取り込むことができます。Cosmos DB への接続の詳細については、CData JDBC Driver for Cosmos DB ページをご覧ください。CData JDBC Driver for Cosmos DB の30日間無償トライアルをダウンロードして、今すぐ始めましょう。