SQL コネクタを実行する

はじめに

このページでは、スクリプトを使用して SQL コネクタを実行する手順について説明します。

前提条件

run.ps1 と load.ps1 は、運用環境での Process Mining のインストールと同じサーバー上で実行する必要があります。 extraction_cdata.ps1 および transform.ps1 スクリプトは他の場所からも実行できます。

以下のことが前提です。

「ローカルのテスト環境を設定する」に記載されている開発ツールがインストールされます。
SQL コネクタは、「SQL コネクタを設定する」の説明に従って設定されます。

メモ：コネクタの scripts/ ディレクトリには、データの抽出、変換、読み込みを実行およびスケジュールするための一連の標準スクリプトが含まれています。

コネクタを実行する

コネクタの実行、データの抽出、変換、読み込みを行するには、以下の手順に従います。

手順	操作
1	管理者として Windows PowerShell を起動します。
2	`scripts/` ディレクトリに移動します。
3	`run.ps1`を実行します。

抽出のみを実行する

抽出のみを実行するには、以下の手順に従います。

手順	操作
1	Windows PowerShell を起動します。
2	`scripts/` ディレクトリに移動します。
3	`extraction_cdata.ps1`を実行します。

メモ：コネクタがデータ抽出に CData Sync を使用していない場合、 extraction_ script の名前は異なります。

変換のみを実行する

変換手順のみを実行するには、以下の手順に従います。

手順	操作
1	Windows PowerShell を起動します。
2	`scripts/` ディレクトリに移動します。
3	`transform.ps1`を実行します。

各変換ステップは、個別に実行することもできます。

実行中の読み込み専用

読み込み手順のみを実行するには、以下の手順に従います。

手順	操作
1	管理者として Windows PowerShell を起動します。
2	`scripts/` ディレクトリに移動します。
3	`load.ps1`を実行します。

デバッグエラー

LogFile.log ログファイルは、スクリプトの実行時に作成されます。このログ・ファイルには、ジョブ実行のすべてのステージと、関連するタイム・スタンプが入っています。ログファイルはエラーコードの最小限のセットを返すので、より詳細なガイダンスを得ることもできます。

読み込み

キャッシュの生成について詳しくは、「ロードスクリプトが存在するディレクトリで生成される cache_generation_output.log 」をご覧ください。

CData 抽出

CData Sync のジョブ実行の詳細については、CData Sync インスタンスに移動し、ジョブの [ ログ] > [履歴 ] タブを確認してください。以下の画像に例を示します。

詳細をログするには、[ ログファイルの動詞 ] を [ Verbose ] に設定し、抽出スクリプトを extraction_cdata.ps1 再度実行します。

CData Sync ジョブの戻りコードの概要は以下のとおりです。

コード	ログの説明
0	ジョブでの抽出が成功した。
-1	ジョブの抽出が失敗しました。
-2	抽出の実行に失敗しました。設定を確認するか、ジョブの [ ログ] > [履歴 ] タブを確認します。

変換

このログファイルは、変換スクリプトの一連のエラーコードも返します。エラーコードの概要は以下のとおりです。

コード	ログの説明
-1	一般的な `dbt run` または `dbt test` の失敗。つまり、現在の設定または構成に問題があります。詳しくは、「 `LogFile.log` 」をご覧ください。
0*	`dbt` 呼び出しはエラーなく完了しました。
1*	`dbt` 呼び出しは、処理されたエラー (例:モデルの構文エラー、不適切な権限など) に対する問題を修正しました。実行は完了しましたが、一部のモデルがスキップされた可能性があります。 `LogFile.log` には、 `dbt run` と `dbt test` フェーズのどちらでエラーが発生したかを示す追加情報が含まれます。
2*	`dbt` 呼び出しは未処理のエラー (例: ネットワークの中断) で完了しました。

* 0、1、2 は dbt固有の戻りコードです。出口コードについては、公式の dbt のドキュメントをご覧ください。

大規模な dbt プロジェクトのデバッグ

変換の実行に時間がかかる場合は、 scripts/ ディレクトリ内の response.txt を検査できます。これには、 dbtからのリアルタイム応答が含まれます。 dbt test または dbt run が完了すると、情報が LogFile.log に追加され、一時ファイルが削除されます。