SQLのインポート
外部データベースに対するSQLクエリの結果を、PlaidCloudのプロジェクトテーブルにインポートします。クエリはリモートデータベース上で実行され、結果セットだけがPlaidCloudに取り込まれます。
外部データベーステーブルのインポートとの違いは、SQLを自分で記述する点です。データがPlaidCloudに取り込まれる前に、ソースデータベースで実行したい複雑な結合、フィルター、集計がある場合に便利です。
インポートパラメーター
Section titled “インポートパラメーター”
ソースとターゲット
Section titled “ソースとターゲット”データベース接続
Section titled “データベース接続”データベース接続を確立するには、 PlaidCloudデータ接続を参照してください。
ターゲットテーブル
ビューには基になるデータが含まれないため、インポートのターゲットとして選択できるのはテーブルのみです。
Dynamic オプション
Dynamic オプションでは、変数を含むテキストでテーブルを指定できます。テーブルやビューの参照が指定した変数に応じて決まる、変数駆動型のワークフローで便利です。
current_month 変数を使用して、ターゲットテーブルを動的に指定する例:
legal_entity/inputs/{current_month}/ledger_valuesStatic オプション
インポートのターゲットとして特定のテーブルを使用する場合は、Dynamic ボックスをオフのままにして、ターゲットテーブルを選択します。
ターゲットテーブルが存在しない場合は、新規作成ボタンを選択して、目的の場所にテーブルを作成します。
テーブルエクスプローラーは、どのテーブル選択でも常に利用できます。テーブル選択の右側にあるテーブルエクスプローラーボタンをクリックすると、テーブルエクスプローラーのウィンドウが開きます。
SQLクエリ
Section titled “SQLクエリ”このセクションでは、必要なデータを返すSQLクエリを記述します。
プレビュー
ソースタブでプレビューをクリックすると、ステップが読み取る内容の最大100行を、実行せずに確認できます。結果がそれより長い場合、プレビューには最初の行のみが表示されていること、すべてを読み取るにはステップを実行する必要があることが表示されます。
プレビューは、実行時と同じ方法で、プロジェクト変数とワークフロー変数を埋め込みます。{x:>9}のような変数の書式指定には対応していません。また、トリガーの値のように、実行中にのみ値を持つ変数は埋め込めません。
プレビューはデータの読み取りのみを行います。何かを変更する可能性のあるクエリは拒否し、行の代わりにメッセージを表示します。
- Preview only supports standard SQL functions. Run the step to see results. クエリで、プレビューが読み取り専用かどうかをチェックできない関数が使用されています。結果を確認するには、ステップを実行してください。
- 単一の
SELECTではないクエリ、または変数が展開された結果として書き込みを行うステートメントになるクエリは、拒否されます。
プレビューは、ロックされたプロジェクト、SQL Server、Oracle、SQLiteの接続、およびAgent Remote Execution of SQL ステップのようにエージェント経由で実行されるステップでは利用できません。
列タイプの推測
Section titled “列タイプの推測”SQLのインポートでは、読み込み時にデータ型の推測を試みるか、すべての列をテキスト型に設定するかを選択できます。データがクリーンな場合は、データ型を動的に設定する方が高速ですが、状況によっては問題が発生することがあります。
たとえば、データのほとんどが数値に見えても一部にテキストが含まれていると、数値として設定しようとして、データ型の不一致による読み込みの問題が発生することがあります。また、たとえば16桁の数値の商品コードがある場合にも問題が発生することがあります。先頭のゼロが切り捨てられ、16桁のコードではなく数値になってしまいます。
ただし、データをすべてテキストに設定した場合は、後続のExtractステップで、日付や数値など、テキストにすべきでないデータ型を適切な型に変換する必要があります。
トラブルシューティング
Section titled “トラブルシューティング”| 症状 | 考えられる原因 |
|---|---|
| クエリ、接続、データ量に変更がないにもかかわらず、ステップに通常よりも著しく長い時間(最大で約30分)がかかった | インポートを実行しているバックグラウンドワーカーが途中で中断され(ワークフローではなく、プラットフォーム側の再起動または退避によるものです)、プラットフォームがそのテーブルのインポートを再試行しました。再試行は中断が検出されてから開始されるため、余分な時間がかかります。 |
| その遅延の後、ステップは正常に完了した | 再試行ではテーブルの内容が完全に置き換えられるため、結果は1回で正常に実行された場合と同じです。確認や再実行は必要ありません。 |
| ステップが「has already been attempted and cannot be safely re-run」で失敗する | SQLのインポートステップでは、この拒否はなくなりました。実行途中の中断は再試行されます。プロジェクトアーカイブの復元やディメンションの読み込みでは、再実行すると何かを置き換えるのではなく重複が作成されるため、設計上、引き続きこのエラーが表示されます。SQLのインポートステップ自体でこのエラーが表示された場合は、サポートチケットを開いてください。 |