SQL コネクタを実行する
はじめに
このページでは、スクリプトを使用して SQL コネクタを実行する手順について説明します。
前提条件
run.ps1 と load.ps1 は、運用環境での Process Mining のインストールと同じサーバー上で実行する必要があります。 extraction_cdata.ps1 および transform.ps1 スクリプトは他の場所からも実行できます。
以下のことが前提です。
- 「ローカルのテスト環境を設定する 」に記載されている開発ツールがインストールされます。
-
SQL コネクタは、「SQL コネクタを設定する」の説明 に従って設定されます。
メモ： コネクタのscripts/ディレクトリには、データの抽出、変換、読み込みを実行およびスケジュールするための一連の標準スクリプトが含まれています。
コネクタを実行する
コネクタの実行、データの抽出、変換、読み込みを行するには、以下の手順に従います。
|
手順 |
操作 |
|---|---|
|
1 |
管理者として Windows PowerShell を起動します。 |
|
2 |
|
|
3 |
|
抽出のみを実行する
抽出のみを実行するには、以下の手順に従います。
|
手順 |
操作 |
|---|---|
|
1 |
Windows PowerShell を起動します。 |
|
2 |
|
|
3 |
|
extraction_ script の名前は異なります。
変換のみを実行する
変換手順のみを実行するには、以下の手順に従います。
|
手順 |
操作 |
|---|---|
|
1 |
Windows PowerShell を起動します。 |
|
2 |
|
|
3 |
|
各変換ステップは、個別に実行することもできます。
実行中の読み込み専用
読み込み手順のみを実行するには、以下の手順に従います。
|
手順 |
操作 |
|---|---|
|
1 |
管理者として Windows PowerShell を起動します。 |
|
2 |
|
|
3 |
|
デバッグ エラー
LogFile.log ログ ファイルは、スクリプトの実行時に作成されます。このログ・ファイルには、ジョブ実行のすべてのステージと、関連するタイム・スタンプが入っています。 ログ ファイルはエラー コードの最小限のセットを返すので、より詳細なガイダンスを得ることもできます。
読み込み
キャッシュの生成について詳しくは、「ロード スクリプトが存在するディレクトリで生成される cache_generation_output.log 」をご覧ください。
CData 抽出
CData Sync のジョブ実行の詳細については、CData Sync インスタンスに移動し、ジョブの [ ログ] > [履歴 ] タブを確認してください。 以下の画像に例を示します。
詳細をログするには、[ ログ ファイルの動詞 ] を [ Verbose ] に設定し、抽出スクリプトを extraction_cdata.ps1 再度実行します。
CData Sync ジョブの戻りコードの概要は以下のとおりです。
|
コード |
ログの説明 |
|---|---|
|
0 |
ジョブでの抽出が成功した。 |
|
-1 |
ジョブの抽出が失敗しました。 |
|
-2 |
抽出の実行に失敗しました。 設定を確認するか、ジョブの [ ログ] > [履歴 ] タブを確認します。 |
変換
このログ ファイルは、変換スクリプトの一連のエラー コードも返します。 エラー コードの概要は以下のとおりです。
|
コード |
ログの説明 |
|---|---|
|
-1 |
一般的な |
|
0* |
|
|
1* |
|
|
2* |
|
* 0、1、2 は dbt固有の戻りコードです。 出口コードについては、公式の dbt のドキュメントをご覧ください。
大規模な dbt プロジェクトのデバッグ
変換の実行に時間がかかる場合は、 scripts/ ディレクトリ内の response.txt を検査できます。これには、 dbtからのリアルタイム応答が含まれます。 dbt test または dbt run が完了すると、情報が LogFile.log に追加され、一時ファイルが削除されます。
データ抽出をスケジュール設定する
データ抽出を定期的にスケジュールすることもできます。 詳しくは、「 データ抽出をスケジュールする」をご覧ください。
