こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。
Microsoft Query を使うことで、Excel からデータベースやファイル、外部データソースにアクセスしてデータをインポート、更新できます。CData ODBC Driver for BigCommerce はMicrosoft Query の連携先を拡張して、270種類以上のCRM、ERP、MA、会計ツールなどのデータソースへのアクセスを実現します。
この記事では、Microsoft Query を使ってBigCommerce データをスプレッドシートにインポートする方法をご紹介します。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持った製品です。
- BigCommerce をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- Excel やMicrosoft Query をはじめとする多様な帳票・BI ツールにBigCommerce データを連携
- ノーコードでの手軽な接続設定
- 標準SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてBigCommerce の接続を設定、2.Microsoft Query でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
BigCommerce への接続を設定
まずは、本記事右側のサイドバーからBigCommerce ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
ODBC ドライバーのインストール完了時にODBC DSN 設定画面が立ち上がります。または、Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定できます。
BigCommerce 認証は標準のOAuth フローに基づいています。
Store ID の取得
BigCommerce Store に接続するには、StoreId が必要です。Store Id を確認するには、以下の手順に従ってください。
- BigCommerce アカウントにログインします。
- ホームページから「Advanced Settings」->「API Accounts」 を選択します。
- 「Create API Account」->「Create V2/V3 API Token」をクリックします。
- 画面にAPI Path という名前のテキストボックスが表示されます。
- テキストボックス内に、次の構造のURL が表示されます：https://api.bigcommerce.com/stores/{Store Id}/v3。
- 上記で示したように、Store Id は'stores/' と'/v3' パスパラメータの間にあります。
- Store Id を取得したら、「キャンセル」 をクリックするか、まだ持っていない場合はAPI Account の作成に進むことができます。
パーソナルアクセストークンの取得
加えて、自分のデータをテストおよびアクセスするには、個人用トークンを取得する必要があります。個人用トークンを取得する方法は次のとおりです。
- BigCommerce アカウントにログインします。
- ホームページから「Advanced Settings」->「API Accounts」 を選択します。
- 「Create API Account」->「Create V2/V3 API Token」をクリックします。
- アカウント名を入力します。
- 作成するAPI Account の「OAuth Scopes」を選択します。CData 製品 は"None" とマークされたデータにアクセスできません。また、"read-only"
とマークされたデータを変更できません。
- 「保存」をクリックします。
BigCommerce への認証
次に、以下を設定してデータに接続できます。
- StoreId：API Path テキストボックスから取得したStore ID に設定。
- OAuthAccessToken：生成したトークンに設定。
- InitiateOAuth：OFF に設定。
Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法の詳細は、ヘルプドキュメントの「はじめに」を参照してください。
Excel で［データ］タブを開き［その他のデータソースから］->［Microsoft Query から］を選びます。
![Open Microsoft Query from the Data tab.]()
マシンにインストールされているMicrosoft Office のバージョンに合わせて、32 bit CData BigCommerce Source または64 bit CData BigCommerce Source x64 DSN を選びます。Query Wizard を使うオプションを選択し、クエリを作成／編集します。
![The list of available ODBC DSNs in the Choose Data Source dialog.]()
Query Wizard で、スプレッドシートにインポートしたいテーブルのノードを展開します。インポートしたいカラムを選択し、矢印をクリックしてクエリに追加します。あるいはテーブル名を選択して、テーブルにあるすべてのカラムを追加します。
![Available tables and columns in the Choose Columns step of the Query Wizard. (Salesforce is shown.)]()
［Filter Data］ページではクライテリアを指定できます。例えば、日付の範囲を設定して結果を絞れます。
![The Filter Data step of the Query Wizard. (Salesforce is shown.)]()
クエリでパラメータを使いたい場合は、Microsoft Query でクエリを編集するオプションを選択します。
クエリにパラメータを設定するには、SQL を直接修正する必要があります。その場合は、［Query Editor］の［SQL］ボタンをクリックします。フィルタクライテリアを事前に設定している場合は、クエリ内にWHERE 句が存在します。
パラメータを使うには、WHERE 句のフィールド値にワイルドカード文字として "?" を使います。例えばCustomers をインポートしている場合は、"FirstName=?" を設定できます。
SQL ステートメントの編集が終わったら［SQL］ダイアログを閉じます。パラメータ値を入力するように促されますが、次のステップでセルを選択して値を入れることになるので、このダイアログではボックスは空のままにしておきます。
![The generated SQL statement. (Salesforce is shown.)]()
Microsoft Query を閉じます。［Import Data］ダイアログが表示されます。結果をインポートするセルを入力します。
![The Import Data dialog.]()
［Import Data］ダイアログを閉じます。パラメータ値を入力するように促されます。パラメータボックスの隣にあるボタンをクリックしてセルを選択します。値が変更されたらスプレッドシートを自動的にリフレッシュするオプションを選択します。
データはこれでExcel にインポートされました。セルB1の値を変更すると、データは指定した検索クライテリアによってフィルタされます。
![The results of the query, with the search criteria applied. (Salesforce is shown.)]()
おわりに
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをMicrosoft Query からコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
日本のユーザー向けにCData ODBC ドライバは、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。
BigCommerce ODBC Driver
相談したい
