JRuby からPlacid にデータ連携

加藤龍彦
加藤龍彦
デジタルマーケティング
リアルタイムPlacid に連携するシンプルなJRuby アプリケーションを作成します。



JRuby はRuby プログラミング言語の高性能で安定した、完全にスレッド化されたJava 実装です。CData JDBC Driver for API を使用すると、JRuby からリアルタイムPlacid へのデータ連携を簡単に実装できます。ここでは、Placid に接続し、クエリを実行して結果を表示する簡単なJRuby アプリを作成する方法を説明します。

Placid のデータにJDBC で接続

アプリを作成する前に、JDBC Driver のJAR ファイルのインストール場所をメモします。 (通常はC:\Program Files\CDatat\CData JDBC Driver for API\libにあります。)

JRuby は、JDBC をネイティブにサポートしているため、簡単にPlacid に接続してSQL クエリを実行できます。java.sql.DriverManager クラスのgetConnection 関数を使用してJDBC 接続を初期化します。

Placid は、API へのアクセスを制御するために API キー認証を使用します。API トークンはプロジェクトごとに固有で、placid.app のプロジェクト設定から取得できます。

API キー認証の設定

API キーを取得するには、placid.app にログインし、プロジェクトに移動してプロジェクト設定を開き、API セクションから API トークンを生成します。各 API トークンは特定のプロジェクトにスコープされている点に注意してください。

以下の接続プロパティを設定して接続を確立してください:

  • AuthScheme:APIKey に設定します。
  • APIKey:Placid のプロジェクト API トークンに設定します。

接続文字列の例:

Profile=C:\profiles\Placid.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_project_api_token';

ビルトイン接続文字列デザイナー

JDBC URL の構成については、Placid JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

java -jar cdata.jdbc.api.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

以下はPlacid の一般的なJDBC 接続文字列です。

jdbc:api:Profile=C:\profiles\Placid.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_project_api_token';

Placid のデータへの接続性を持つJRuby アプリを作成

新しいRuby ファイル(例: APISelect.rb) を作成してテキストエディタで開き、次のコードをファイルにコピーします。

require 'java'
require 'rubygems'
require 'C:/Program Files/CData/CData JDBC Driver for API 2018/lib/cdata.jdbc.api.jar'

url = "jdbc:api:Profile=C:\profiles\Placid.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_project_api_token';"
conn = java.sql.DriverManager.getConnection(url)
stmt = conn.createStatement
rs = stmt.executeQuery("SELECT ,  FROM Collections")
while (rs.next) do
  puts rs.getString(1) + ' ' + rs.getString(2)
end

ファイルが完成したら、コマンドラインからファイルを実行するだけでJRuby でPlacid を表示できるようになります。

jruby -S APISelect.rb

SQL-92 クエリをPlacid に書き込むと、Placid を独自のJRuby アプリケーションに素早く簡単に組み込むことができます。今すぐ無料トライアルをダウンロードしましょう。

はじめる準備はできましたか?

API Driver で Placid のライブデータに接続

Placid に接続