Node.js からAzure Data Catalog のデータをSQL Server データベースとしてクエリ
CData Connect AI を使用すると、SQL Server インターフェース経由でAzure Data Catalog のデータをクエリできます。以下のステップに従って、Connect AI にAzure Data Catalog の仮想データベースを作成し、Node.js を使用してクエリを実行します。
CData Connect AI は、Azure Data Catalog のピュアMySQL かつクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなくNode.js からの手軽なリアルタイムAzure Data Catalog のデータクエリを実現します。Node.js でデータをクエリすると、CData Connect AI はサポートされているすべてのSQL 操作（フィルタ、JOIN など）を直接Azure Data Catalog にプッシュし、サーバー側の処理を活用してAzure Data Catalog のデータを高速で返します。
Connect AI からAzure Data Catalog に接続する
CData Connect AI は直感的なクリック操作ベースのインターフェースを使ってデータソースに接続します。- Connect AI にログインし、 Add Connection をクリックします。
- Add Connection パネルから「Azure Data Catalog」を選択します。
-
必要な認証情報を入力し、Azure Data Catalog に接続します。
Azure Data Catalog 接続プロパティの取得・設定方法
OAuth 認証で接続
Azure Data Catalog の認証にはOAuth を使用します。CData 製品では組込みOAuth が利用できるので、接続プロパティを設定することなく接続を試行するだけで、ブラウザ経由でAzure Data Catalog に認証できます。詳しい設定方法については、ヘルプドキュメントの「Azure Data Catalog への認証」セクションを参照してください。
設定は任意ですが、CatalogName プロパティを設定することでAzure Data Catalog から返されるカタログデータを明示的に指定できます。
CatalogName：Azure Data Catalog に紐づいているカタログ名に設定。空のままにすると、デフォルトのカタログが使用されます。カタログ名は、「Azure Portal」->「データカタログ」->「カタログ名」から取得できます。
- Create & Test をクリックします。
- Edit Azure Data Catalog Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
パーソナルアクセストークンを追加する
OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
- server：tds.cdata.com
- port：14333
- user：Connect AI ユーザー（例：[email protected]）
- password：上記のユーザーのPAT
- database：Azure Data Catalog 用に構成した接続（AzureDataCatalog1）
接続が設定されたら、Node.js からAzure Data Catalog のデータに接続できるようになります。
Node.js からAzure Data Catalog をクエリ
以下の例は、SQL Server モジュールを使用してAzure Data Catalog へのクエリを実行する方法を説明しています。以下の情報が必要です。
以下のコードで、Azure Data Catalog に接続してクエリが実行できます。
var sql = require('mssql')
var config = {
server: 'tds.cdata.com',
port:14333,
user: '[email protected]', //update me
password:'CONNECT_USER_PAT', //update me
options: {
encrypt: true,
database: 'AzureDataCatalog1'
}
}
sql.connect(config, err => {
if(err){
throw err ;
}
new sql.Request().query('SELECT * FROM Tables', (err, result) => {
console.dir(result)
})
});
sql.on('error', err => {
console.log("SQL Error: " ,err);
})