PolyBase で外部データソースとしてGaroon を連携利用

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

Garoon ODBC Driver

Garoon ODBC ドライバーは、ODBC 接続をサポートする任意のアプリケーションからリアルタイムGaroon データに直接接続できる強力なツールです。標準のODBC ドライバーインタフェースを使用して、データベースのようにGaroon にアクセスし、スケジュール、ワークフロー、ユーザーなどの読み出し、書き込み、および更新を実行できます。



CData ODBC Driver for Garoon とSQL Server 2019 のPolyBase を使って、リアルタイムGaroon に外部データソースとしてアクセス。

SQL Server のPolyBase は、データベーステーブルをクエリするTransact-SQL 構文を使って、外部データにクエリする仕組みです。 CData ODBC Drivers for Garoon を組み合わせて使うことで、SQL Server データと同じようにGaroon へのアクセスが可能です。 本記事では、外部データソースと外部テーブルの作成から、T-SQL クエリを使ってライブGaroon データへ接続を認可するところまで説明します。

CData ODBC ドライバーは、ドライバーに組み込まれた最適化されたデータ処理により、PolyBase でライブGaroon データを送受信するための圧倒的なパフォーマンスを提供します。SQL Server からGaroon に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をGaroon に直接プッシュダウンし、組み込みSQL エンジンを利用して、サポートされていない操作(一般的にはSQL 関数とJOIN 操作) をクライアント側で処理します。また、PolyBase を使用することで、単一のクエリを使用して分散ソースからデータをプルし、SQL Server データをGaroon と結合することもできます。

Garoon への接続

未指定の場合は、初めにODBC DSN(data source name)で接続プロパティを指定します。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC Data Source Administrator を使用して、ODBC DSN を作成および構成できます。PolyBase を使用してSQL Server に外部データソースを作成するには、System DSN を構成します。(CData Garoon Sys は自動的に作成されます。)

Garoon への認証は、パスワード認証、Basic 認証、クライアントSSL をサポートしています。

パスワード認証

Garoon への認証には、以下を設定する必要があります。

  • Url:アカウントのURL。
  • User:アカウントのユーザー名。
  • Password:アカウントのパスワード。

Basic 認証

Basic 認証セキュリティ機能がドメインに設定されている場合は、BasicAuthUser とBasicAuthPassword の追加ログイン資格情報を指定します。Basic 認証ではUser とPassword に加えて、これらのクレデンシャルが必要です。

クライアントSSL

Basic 認証の代わりに、クライアント証明書を指定して本製品を認証できます。 SSLClientCert、SSLClientCertType、 SSLClientCertSubject、 およびSSLClientCertPassword を設定します。 さらに、User とPassword をGaroon のログイン資格情報に設定します。

[接続のテスト]をクリックして、DSN がGaroon に正しく接続できているかを確認します。[テーブル]タブに移動し、Garoon のテーブル定義を確認します。

Garoon データの外部データソースを作成

接続を構成したのち、外部データソースのマスター暗号化キーと資格情報データベースを作成する必要があります。

マスター暗号化キーの作成

以下のSQL コマンドを実行して新しいマスターキー[ENCRYPTION]を作成し、外部データソースの資格情報を暗号化します。

CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'password';

資格情報データベースの作成

以下のSQL コマンドを実行してGaroon に接続されている外部データソースの資格情報を作成します。

Note:IDENTITY とSECRET はGaroon のUser プロパティとPassword プロパティに対応しています。

CREATE DATABASE SCOPED CREDENTIAL garoon_creds
WITH IDENTITY = 'username', SECRET = 'password';

Garoon の外部データソースを作成

以下のSQL コマンドを実行し、以前作成したDSN と資格情報を使用して、PolyBase でGaroon の外部データソースを作成します。

Garoon の場合、SERVERNAME を[localhost]または[127.0.0.1]に設定し、PORT を空のままにします。PUSHDOWN は、デフォルトでON に設定されているため、ODBC Driver は、サーバー側の処理を利用して複雑なクエリを実行できます。

CREATE EXTERNAL DATA SOURCE cdata_garoon_source
WITH ( 
  LOCATION = 'odbc://SERVERNAME[:PORT]',
  CONNECTION_OPTIONS = 'DSN=CData Garoon Sys',
  -- PUSHDOWN = ON | OFF,
  CREDENTIAL = garoon_creds
);

Garoon の外部テーブルを作成

外部データソースを作成したら、CREATE EXTERNAL TABLE ステートメントを使用してSQL Server インスタンスからGaroon にリンクします。テーブルカラムの定義は、CData ODBC Driver for Garoon によって公開されているものと一致しなければなりません。DSN Configuration Wizard の[テーブル]タブを参照し、テーブルの定義を確認できます。

CREATE TABLE ステートメントのサンプル

以下は、Garoon Events に基づいて外部テーブルを作成するステートメントの一例です。

CREATE EXTERNAL TABLE Events(
  Id [nvarchar](255) NULL,
  EventMenu [nvarchar](255) NULL,
  ...
) WITH ( 
  LOCATION='Events',
  DATA_SOURCE=cdata_garoon_source
);

SQL Server インスタンスでGaroon の外部テーブルを作成すると、ローカルデータとリモートデータを同時にクエリできるようになります。CData ODBC Driver に組み込まれているクエリ処理により、可能な限り多くのクエリ処理がGaroon にプッシュされることで、ローカルのリソースと計算リソースが解放されます。ODBC Driver for Garoon の30日間無料トライアルをダウンロードし、SQL Server データでライブGaroon データを使い始めましょう。