ColdFusion で ODBC 経由のBigQuery のデータをリアルタイムにインポートしてアプリケーションを構築
Adobe ColdFusion は、Web およびモバイルアプリケーションの開発プラットフォームです。独自のスクリプト言語である ColdFusion Markup Language(CFML)を使用して、データ駆動型の Web サイトを作成したり、REST などのリモートサービスを生成したりできます。ColdFusion を CData ODBC Driver for Google BigQuery と組み合わせることで、ColdFusion の Web およびモバイルアプリケーションとBigQuery のライブデータを連携できます。これにより、アプリケーションをより堅牢で完全なものにすることができます。この記事では、ODBC ドライバーを使って、ColdFusion マークアップファイル内でBigQuery のデータを取得してテーブルを作成する方法を説明します。
BigQuery データ連携について
CData は、Google BigQuery のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています:
- OAuth、OAuth JWT、GCP インスタンスなど、すぐに使える幅広い認証スキームのサポートにより、BigQuery へのアクセスを簡素化します。
- BigQuery と他のアプリケーション間の双方向データアクセスにより、データワークフローを強化します。
- SQL ストアドプロシージャを通じて、ジョブの開始・取得・キャンセル、テーブルの削除、ジョブロードの挿入など、主要な BigQuery アクションを実行できます。
多くの CData のお客様は、Google BigQuery をデータウェアハウスとして使用しており、CData ソリューションを使用して、別々のソースからビジネスデータを BigQuery に移行し、包括的な分析を行っています。また、BigQuery データの分析やレポート作成に当社の接続機能を使用するお客様も多く、両方のソリューションを使用しているお客様も多数います。
CData が Google BigQuery 体験をどのように向上させるかについての詳細は、ブログ記事をご覧ください:https://jp.cdata.com/blog/what-is-bigquery
はじめに
このチュートリアルを進めるには、CData ODBC Driver for Google BigQuery と Adobe ColdFusion をインストールする必要があります。
接続の設定
まだ設定していない場合は、ODBC DSN(データソース名)で接続プロパティを指定します。これはドライバーインストールの最終ステップです。Microsoft ODBC データソースアドミニストレーターを使って ODBC DSN を作成・設定できます。
BigQuery 接続プロパティの取得・設定方法
Google BigQuery はOAuth 認証標準を使用します。個々のユーザーとしてGoogle API にアクセスするには、組み込みクレデンシャルを使うか、OAuth アプリを作成します。
OAuth では、Google Apps ドメインのユーザーとしてサービスアカウントを使ってアクセスすることもできます。サービスカウントでの認証では、OAuth JWT を取得するためのアプリケーションを登録する必要があります。
OAuth 値に加え、DatasetId、ProjectId を設定する必要があります。詳細はヘルプドキュメントの「はじめに」を参照してください。
データソースの追加とテーブルの作成
DSN を作成したら、以下の手順に従って、新しいデータソースを追加し、接続をテストし、ColdFusion マークアップファイルを作成し、最後にBigQuery のデータをインポートして ColdFusion でテーブルに表示します。
-
ColdFusion 管理インターフェースから、Data & Services を選択します。
-
ここで「Add New Data Source」をクリックします。データソース名は、ColdFusion の変数命名規則に準拠していれば任意の名前で構いません。ODBC ドライバーの場合は「ODBC Socket」を選択し、「Add」ボタンをクリックします。
-
ODBC DSN ドロップダウンメニューから CData BigQuery Sys を選択します。Advanced Settings セクションでは、Connection String は空白のままにしておきます。なお、この入力フィールドで指定されたプロパティは、DSN 設定で指定されたものを上書きします。
-
次に、先ほど作成した CDataBigQueryODBC データソースの左側にあるチェックマークを押して、接続をテストします。データソースが「OK」ステータスを報告したら、使用する準備ができています。
-
次に、新しい ColdFusion マークアップファイル(.cfm)を作成し、ColdFusion の wwwroot ディレクトリ(「C:\ColdFusion2021\cfusion\wwwroot」)に配置します。
以下のコードでデータソースをクエリします:
<cfquery name="BigQueryQuery" dataSource="CDataBigQueryODBC"> SELECT * FROM Orders </cfquery>CFTable を使用すると、HTML でテーブルを簡単に出力できます:<cftable query = "BigQueryQuery" border = "1" colHeaders colSpacing = "2" headerLines = "2" HTMLTable maxRows = "500" startRow = "1"> <cfcol header="<b>OrderName</b>" align="Left" width=2 text="OrderName"/> <cfcol header="<b>Freight</b>" align="Left" width=15 text="Freight"/> ... </cftable>HTML 部分を含む完全なコードは以下のとおりです:<html> <head><title>CData Software | BigQuery Orders Table Demo </title></head> <body> <cfoutput>#ucase("BigQuery Orders Table Demo")#</cfoutput> <cfquery name="BigQueryQuery" dataSource="CDataBigQueryODBC"> SELECT * FROM Orders </cfquery> <cftable query = "BigQueryQuery" border = "1" colHeaders colSpacing = "2" headerLines = "2" HTMLTable maxRows = "500" startRow = "1"> <cfcol header="<b>OrderName</b>" align="Left" width=2 text="OrderName"/> <cfcol header="<b>Freight</b>" align="Left" width=15 text="Freight"/> ... </cftable> </body> </html> -
最後に、ブラウザでコードを実行します。BigQuery のデータを含むテーブルが表示されます。
なお、CData ODBC ドライバーは cfqueryparam 要素を使用したパラメータ化クエリもサポートしています。例:
SELECT * FROM Account WHERE name =
おわりに
CData ODBC Driver for BigQuery の 30日間無償トライアルをダウンロードして、Adobe ColdFusion でBigQuery 連携アプリケーションの構築を始めましょう。ご不明な点がございましたら、サポートチームまでお問い合わせください。