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 インスタンスに移動し、ジョブの [Logging & History ] タブを確認してください。以下の画像に例を示します。

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

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

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

変換

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

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

• 0、1、および 2 は dbt 固有の戻りコードです。終了コードに関する dbt の公式ドキュメントをご覧ください。

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

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

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

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