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 に追加され、一時ファイルが削除されます。

データ抽出をスケジュール設定する

データ抽出を定期的にスケジュールすることもできます。 詳しくは、「 データ抽出をスケジュールする」をご覧ください。