SQL コネクタを設定する

はじめに

このページでは、新しい SQL コネクタを作成し、ソース システムに接続する方法について説明します。

前提条件

「ローカルのテスト環境を設定する」で説明されている開発ツールがインストールされていることを前提としています。

新しい SQL コネクタを作成する

新しい SQL コネクタを構築する場合は、SQL コネクタの基本設定を含む テンプレート コネクタ をダウンロードできます。

リポジトリを開始

コネクタは、バージョン管理システム (GitHub など) に保存することをお勧めします。

手順	操作
1	完全なコネクタ ディレクトリを含む新しいリポジトリを作成します。このディレクトリは、ダウンロードした (テンプレート) コネクタと同じ構造である必要があります。

抽出を設定する

まず、抽出の設定が、目的のソース・システムおよびステージング・データベースを指すよう設定する必要があります。 これらの構成手順は、開発者環境と運用環境のそれぞれについて、1 回ずつ実行する必要があります。

ステップ1:抽出方法を選択する

各コネクタには、一連の特定の抽出方法が付属しています。 ソース データを抽出するには、抽出方法の 1 つを設定する必要があります。

抽出方法	説明
Load-from-file	• Load-from-file 抽出器の CData ジョブを設定します。「 抽出器: ファイルから読み込む」をご覧ください。• このコネクタに固有のカスタム クエリを使用します。 extractors/load-from-file/instructions.mdで提供されます。
Load-from-source	ソース システムから入力データを読み込むには、特定の命令を使用しますextractors/load-from-source/instructions.mdload-from-source 抽出器は、特定のソース システム用に作成されたコネクタ ( SAP の Purchase-to-Pay コネクタなど) でのみ使用できます。

手順 2: ソース データを制限する

分析に必要なデータのみを読み込むよう、抽出器に適切なフィルターを設定してください。 たとえば、データを過去 6 か月間、または対象の特定の部署のみに制限します。

入力データのフィルター処理に関する具体的な手順は、抽出器の instructions.md にあります。

ステップ 3: 抽出スクリプトを設定する

コネクタがデータ抽出に CData Sync を使用する場合は、 extract_cdata.ps1 スクリプトが正しいジョブを指している必要があります。 抽出スクリプトを設定するには、以下の手順に従います。

手順	操作
1	scripts/ ディレクトリで、config_template.jsonの名前を config.jsonに変更します。config.json は Git によって無視されるため、開発環境と運用環境で異なる抽出構成を使用できます。
2	[ config.jsonで、 JOB_NAME_CREATED_IN_CDATA テキストを、先ほど作成した CData ジョブに変更します。

コネクタがデータの抽出に CData Sync を使用していない場合は、 instructions.mdで提供される特定の手順を使用します。

変換を設定

適切なステージング・データベースで変換を実行するには、 profiles.yml このコネクター用のステージング・データベースへの参照が必要です。 これらの構成手順は、各開発者環境と運用環境のそれぞれについて 1 回実行する必要があります。 変換を設定するには、以下の手順に従います。

手順	操作
1	コネクタの transformations/profiles.yml 内容をコピーします。
2	内容を個人の profiles.yml に貼り付けて追加します。個人用 profiles.yml は、コネクタ ディレクトリの外部に配置する必要があります。
3	ステージング・データベースを指す内容を変更する。

読み込みを設定

load.ps1 スクリプトを使用してキャッシュ生成を実行するには、対応するアプリ リリースがアクティブな Process Mining 環境を指している必要があります。抽出スクリプトを設定するには、以下の手順に従います。

手順 1 が抽出の構成時に既に実行されている場合は省略できます。

手順	操作
1	scripts/ ディレクトリで、config_template.jsonの名前を config.jsonに変更します。config.json は Git によって無視されるため、開発環境と運用環境で異なる抽出構成を使用できます。
2	[ config.jsonで、 PROCESS_MINING_ENVIRONMENT テキストを、リリースがアクティブな環境に変更します。

次の手順

SQL コネクタが正しく設定されていれば、実行することができます。「 SQL コネクタを実行する」をご覧ください。