FileMaker Pro からJSON データへの双方向アクセス

この記事では、CData JDBC Driver for JSON をFileMaker Pro の External SQL Sources (ESS) 機能と統合するために使用する方法を説明します。これにより、FileMaker Pro のレコードを他の運用データストアのレコードにリンクできるようになります。

MySQL のリモーティング機能を使用し、MySQL データベースとしてJSON にアクセスします。CData JDBC Driver for JSON は、MySQL のような従来のデータベースに接続をサポートするFileMaker Pro のようなアプリケーションと連携するためにJDBC 標準とMySQL 標準を共に実装していますが、一般的なJDBC 接続には連携できません。

FileMaker Pro Integration の選択

FileMaker Pro には、二通りのデータアクセスモードがあります。

• ［Data Import］ JSON データはFileMaker Pro データベースにコピーされ、必要に応じて更新できます。FileMaker Pro はODBC をネイティブにサポートしているものの、JDBC はサポートしていないため、CData ODBC ドライバーを使用して、このソリューションを合理化します。

  このアプローチを使用するには、FileMaker Pro のODBC JSON Integration を参照してください。

• ESS:データのローカルコピーを使用する代わりに、JDBC ドライバーを使用して外部SQL ソースを作成できます。また、リモートデータはFileMahaker Pro で変更でき、テーブルは標準のFileMaker Pro テーブルと同様に、リレーションシップグラフで確認できます。

ESS セットアップのアウトライニング

JDBC ドライバーは、データアクセスチェーンの一部です。ネイティブODBC インテグレーションと比べ、MySQL リモーティングを使用するFileMaker Pro インテグレーションは、いくつかの追加コンポーネントがあります。この記事では、以下の各コンポーネントをFileMaker Pro にリンクする方法を示します。

1. CData JDBC ドライバー
2. (ドライバーに含まれている)CData MySQL Remoting デーモン
3. ODBC ドライバーfor MySQL.

   Windows では、FileMaker Pro に、公式のMySQL ドライバーであるMySQL Connector\ODBC が要求されます。

   macOS では、Actual Technologies Open Databases ODBC ドライバーが要求されます。

4. ODBC ドライバーマネジャー

   Windows では、ドライバーマネジャーが組み込まれています。macOS では、ODBC ドライバーをインストールする前に、ドライバーマネジャーをインストールする必要があります。iODBC ドライバーマネジャーをインストールしてください。

リモーティングデーモンを開始します

以下のステップに従って、MySQL Remoting 機能を有効にします。

1. ［Terminal］を開き、インストールフォルダのlib サブフォルダに変更します。

   $ cd "/Applications/CData/CData JDBC Driver for JSON/lib"

2. コマンドラインで構成ファイルまたは設定を指定し、MySQL デーモンを起動します。以下の例では、付属のサンプル構成ファイルを使用しています。

   $ java -jar cdata.jdbc.json.jar -f "cdata.jdbc.json.remoting.ini"

   データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。本製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー（ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。

   URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。

   DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。

   • Document（デフォルト）：JSON データのトップレベルのドキュメントビューをモデル化します。本製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
   • FlattenedDocuments：ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
   • Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。

   リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。

   Amazon S3 内のJSON への接続

   URI をバケット内のJSON ドキュメントに設定します。さらに、次のプロパティを設定して認証します。

   • AWSAccessKey：AWS アクセスキー（username）に設定。
   • AWSSecretKey：AWS シークレットキーに設定。

   Box 内のJSON への接続

   URI をJSON ファイルへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。 認証方法については、Box への接続 を参照してください。

   Dropbox 内のJSON への接続

   URI をJSON ファイルへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。 認証方法については、Dropbox への接続 を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。 URI=dropbox://folder1/file.json; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;

   SharePoint Online SOAP 内のJSON への接続

   URI をJSON ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。

   SharePoint Online REST 内のJSON への接続

   URI をJSON ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。 認証するには、OAuth 認証標準を使用します。

   FTP 内のJSON への接続

   URI をJSON ファイルへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。

   Google Drive 内のJSON への接続

   デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。

   リモーティングに使用できる接続プロパティおよびその他の構成オプションの詳細についてはヘルプドキュメントを参照してください。

DSN を作成する

JSON に正常に接続し、MySQL デーモンを起動した後、MySQL ODBC データソースを作成します。 ODBC データソースを使用する場合は、DSN (data source name) で接続プロパティを指定します。

ODBC ドライバーとドライバーマネジャーをまだインストールしていない場合、［Outlining the ESS Setup］を参照してプラットフォームでサポートされているコンポーネントを確認してください。

macOS

以下のステップに従って、iOBC グラフィカル管理者ツールを使用します。

1. ランチパッドで検索してiODBC を開きます。
2. ［System DSN］タブで［Add］をクリックし、［Actual Open Source Databases］を選択します。
3. ウィザードを完了するには以下の情報を入力してください。
   • Name:［DSN］を入力
   • Server:［127.0.0.1］またはMySQL デーモンを実行しているマシンのアドレスを入力
   • Port:3306 のような、デーモンがリッスンしているポートを入力
   • Database:JSON のように、デーモンの構成ファイルで指定されたデータベースの名前を入力
4. ［Test Connection］をクリックし、ダイアログに資格情報を入力します。

Windows

ODBC DSN を作成するために、ビルトインのMicrosoft ODBC Data Source Administrator を使用できます。

1. ［Control Panel］から［Set Up Data Sources (ODBC)］を選択すると、ODBC Data Source Administrator が表示されます。
2. ［System DSN］タブで［Add］をクリックし、［MySQL ODBC driver］を選択します。
3. ウィザードを完了するには以下の情報を入力してください。
   • Name:［DSN］を入力
   • Server:［127.0.0.1］またはMySQL デーモンを実行しているマシンのアドレスを入力
   • Port:3306 のような、デーモンがリッスンしているポートを入力
   • Database:JSON のように、デーモンの構成ファイルで指定されたデータベースの名前を入力
4. ［Test Connection］をクリックし、ダイアログに資格情報を入力します。

JSON Shadow Tables を作成する

シャドウテーブルは外部SQLソースに存在しますが、関係グラフの追加、データの参照、レイアウトの作成など、FileMaker データベースの他のテーブルとほぼ同じように使用できます。

1. ［File］->［Manage］->［Database］と進みます。
2. 表示されるダイアログの［Relationships］タブ［Table/Relationships］セクションで［Add a Table］ボタンをクリックします。
3. ［Data Source］メニューで、［Add ODBC Data Source］を選択し、前のセクションで作成したDSN を選択します。

DSN のユーザー名とパスワードを指定した後、JSON テーブルをリレーショングラフに追加できます。 リモートMySQL データベースの場合と同じように［View］->［Browse Mode］とクリックすることで、JSON をスクロール、並べ替え、 編集、 および要約できるようになります。