SQL コネクタを設定する

はじめに

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

「ローカルのテスト環境を設定する」に記載された開発ツールがインストールされていることが前提となります。

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

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

手順	操作
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 コネクタなどの特定のソースシステム用に作成されたコネクタでのみ使用できます。

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

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

コネクタがデータ抽出に 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` テキストを、リリースがアクティブな環境に変更します。