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.mdにある特定の手順を使用します。 load-from-source 抽出器は、SAP コネクタなどの特定のソース システム用に作成された コネクタでのみ使用できます。

手順 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 コネクタを実行する」をご覧ください。