CData Connect AI 経由でPostgreSQL インターフェースからリアルタイムの Paylocity のデータに接続

Dibyendu Datta
Lead Technology Evangelist

CData Connect AI で Paylocity へのリアルタイム接続を作成し、PostgreSQL からPaylocity のデータに接続できます。

インターネット上には数多くのPostgreSQL クライアントがあります。PostgreSQL はデータアクセスのための一般的なインターフェースです。PostgreSQL をCData Connect AI と組み合わせることで、PostgreSQL からリアルタイムのPaylocity のデータにデータベースのようにアクセスできます。この記事では、Connect AI でPaylocity のデータに接続し、TDS foreign data wrapper（FDW）を使用してConnect AI とPostgreSQL 間の接続を確立するプロセスを説明します。

CData Connect AI は Paylocity 専用のSQL Server インターフェースを提供し、ネイティブでサポートされているデータベースにデータをレプリケートすることなく Paylocity のデータをクエリできます。最適化されたデータ処理を標準で使用し、CData Connect AI はサポートされているすべてのSQL 操作（フィルター、JOIN など）を Paylocity に直接プッシュし、サーバーサイド処理を活用して必要なPaylocity のデータを迅速に返します。

Connect AI で Paylocity に接続

CData Connect AI は、シンプルなポイント＆クリック操作でデータソースに接続できるインターフェースを提供しています。

Connect AI にログインして「Sources」をクリックし、 Add Connection をクリックします

Add Connection パネルから「Paylocity」を選択します

Paylocity への接続に必要な認証プロパティを入力します。
Paylocity への接続を確立するには以下を設定します。
- RSAPublicKey：Paylocity アカウントでRSA 暗号化が有効になっている場合は、Paylocity に関連付けられたRSA キーを設定。
  このプロパティは、Insert およびUpdate ステートメントを実行するために必須です。この機能が無効になっている場合は必須ではありません。
- UseSandbox：サンドボックスアカウントを使用する場合はTrue に設定。
- CustomFieldsCategory：Customfields カテゴリに設定。これは、IncludeCustomFields がtrue に設定されている場合は必須です。デフォルト値はPayrollAndHR です。
- Key：Paylocity の公開鍵で暗号化されたAES 共通鍵（base 64 エンコード）。これはコンテンツを暗号化するためのキーです。
  Paylocity は、RSA 復号化を使用してAES 鍵を復号化します。
  これはオプションのプロパティで、IV の値が指定されていない場合、ドライバーは内部でキーを生成します。
- IV：コンテンツを暗号化するときに使用するAES IV（base 64 エンコード）。これはオプションのプロパティで、Key の値が指定されていない場合、ドライバーは内部でIV を生成します。
OAuth

OAuth を使用してPaylocity で認証する必要があります。OAuth では認証するユーザーにブラウザでPaylocity との通信を要求します。詳しくは、ヘルプドキュメントのOAuth セクションを参照してください。
Pay Entry API

Pay Entry API はPaylocity API の他の部分と完全に分離されています。個別のクライアントID とシークレットを使用し、アカウントへのアクセスを許可するにはPaylocity から明示的にリクエストする必要があります。 Pay Entry API を使用すると、個々の従業員の給与情報を自動的に送信できます。 Pay Entry API によって提供されるものの性質が非常に限られているため、CData では個別のスキーマを提供しないことを選択しましたが、UsePayEntryAPI 接続プロパティを介して有効にできます。
UsePayEntryAPI をtrue に設定する場合は、CreatePayEntryImportBatch、MergePayEntryImportBatch、Input_TimeEntry、およびOAuth ストアドプロシージャのみ利用できることに注意してください。製品のその他の機能を使用しようとするとエラーが発生します。また、OAuthAccessToken を個別に保存する必要があります。これは、この接続プロパティを使用するときに異なるOAuthSettingsLocation を設定することを意味します。
Save & Test をクリックします
Add Paylocity Connection ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。

Personal Access Token の追加

REST API、OData API、またはVirtual SQL Server 経由でConnect AI に接続する場合、Personal Access Token（PAT）を使用してConnect AI への接続を認証します。アクセス管理の粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
Settings ページで「Access Tokens」セクションに移動し、 Create PAT をクリックします。
PAT に名前を付けて「Create」をクリックします。
Personal Access Token は作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

接続の設定とPAT の生成が完了したら、PostgreSQL からPaylocity のデータに接続する準備が整いました。

TDS Foreign Data Wrapper のビルド

Foreign Data Wrapper は、PostgreSQL を再コンパイルすることなく、PostgreSQL の拡張機能としてインストールできます。例として tds_fdw 拡張機能を使用します（https://github.com/tds-fdw/tds_fdw）。

以下のようにgit リポジトリをクローンしてビルドできます：
```
sudo apt-get install git
git clone https://github.com/tds-fdw/tds_fdw.git
cd tds_fdw
make USE_PGXS=1
sudo make USE_PGXS=1 install
```
注意：複数のPostgreSQL バージョンがあり、デフォルト以外のバージョン用にビルドする場合は、まずpg_config のバイナリの場所を見つけてフルパスをメモし、make コマンドでUSE_PGXS=1 の後にPG_CONFIG= を追加します。
インストールが完了したら、サーバーを起動します：
```
sudo service postgresql start
```
次に、Postgres データベースに入ります
```
psql -h localhost -U postgres -d postgres
```
注意：localhost の代わりにPostgreSQL がホストされているIP を指定することもできます。

PostgreSQL データベースとしてPaylocity のデータに接続し、データをクエリ！

拡張機能をインストールした後、以下の手順に従ってPaylocity のデータへのクエリを開始します：

データベースにログインします。
データベース用の拡張機能をロードします：
```
CREATE EXTENSION tds_fdw;
```

Paylocity のデータ用のサーバーオブジェクトを作成します：

CREATE SERVER "Paylocity1" FOREIGN DATA WRAPPER tds_fdw OPTIONS (servername'tds.cdata.com', port '14333', database 'Paylocity1');

Connect AI アカウントのメールアドレスとPersonal Access Token を使用してユーザーマッピングを設定します：
```
CREATE USER MAPPING for postgres SERVER "Paylocity1" OPTIONS (username '[email protected]', password 'your_personal_access_token' );
```
ローカルスキーマを作成します：
```
CREATE SCHEMA "Paylocity1";
```

ローカルデータベースに外部テーブルを作成します：

#table_name 定義を使用：

CREATE FOREIGN TABLE "Paylocity1".Employee  (
id varchar,
LastName varchar)
SERVER "Paylocity1"
OPTIONS(table_name 'Paylocity.Employee', row_estimate_method 'showplan_all');

#またはschema_name とtable_name 定義を使用：

CREATE FOREIGN TABLE "Paylocity1".Employee (
id varchar,
LastName varchar)
SERVER "Paylocity1"
OPTIONS (schema_name 'Paylocity', table_name 'Employee', row_estimate_method 'showplan_all');

#またはquery 定義を使用：

CREATE FOREIGN TABLE  "Paylocity1".Employee (
id varchar,
LastName varchar)
SERVER "Paylocity1"
OPTIONS (query 'SELECT * FROM Paylocity.Employee', row_estimate_method 'showplan_all');

#またはリモートカラム名を設定：

CREATE FOREIGN TABLE "Paylocity1".Employee (
id varchar,
col2 varchar OPTIONS (column_name 'LastName'))
SERVER "Paylocity1"
OPTIONS (schema_name 'Paylocity', table_name 'Employee', row_estimate_method 'showplan_all');

これで、Paylocity に対して読み取り/書き込みコマンドを実行できます：
```
SELECT id, LastName
FROM "Paylocity1".Employee;
```

詳細情報と無償トライアル

これで、リアルタイムのPaylocity のデータからシンプルなクエリを作成できました。Paylocity（およびその他200以上のデータソース）への接続の詳細については、Connect AI ページをご覧ください。無償トライアルに登録して、今すぐPostgreSQL でリアルタイムのPaylocity のデータを活用してみてください。

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

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアルお問い合わせ

CData Connect AI 経由でPostgreSQL インターフェースからリアルタイムの Paylocity のデータに接続

Connect AI で Paylocity に接続

OAuth

Pay Entry API

Personal Access Token の追加

TDS Foreign Data Wrapper のビルド

PostgreSQL データベースとしてPaylocity のデータに接続し、データをクエリ！

詳細情報と無償トライアル

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

この記事の内容

関連記事