インポートステップ

外部ソースのデータをプロジェクトのテーブルに取り込むワークフローステップです。

ファイルのインポートでは、実行前に、ターゲットテーブルを読み込むクエリが検査されます。型付き列に対する単純なSQL文以外を含むクエリは、ターゲットテーブルが作成、置換、読み込みされる前に拒否されるため、テーブルは元の状態のまま保たれます。

ソースファイルが存在しなくてもエラーにはなりません。インポートはパスを示す警告を出し、ターゲットテーブルを宣言済みの列を持つ空の状態のまま残すため、後続のステップは0行を読み取ります。これは、CSV、Excel、JSON、固定幅、YXDB、dBASE、ORC、Avro、Parquet、XML、Db2抽出のインポートに適用されます。タグ付きのXMLインポートでは、フィールドを宣言しているタグごとにのみ空のテーブルが作成されます。アーカイブとAccessのインポートも警告を出しますが、列を宣言しないため、テーブルは作成されません。ドキュメント検索でファイルを見つけるアーカイブのインポートでは、ファイルが存在しない場合の警告は出ません。

ステップの実行前でも同様です。ファイルのインポートのマッピングでの取り込みや、REST APIまたはAIアシスタントによるファイルの列の読み取りは、ファイルが存在しない場合や空の場合、エラーではなく、パスを示す警告とともに取り込む列がありません（APIでは空の列リスト）と応答します。存在しないファイルを、ドキュメントから新しいテーブルまたはステップにインポートしても何も作成されず、そのファイルはスキップとしてマークされ、パスを示す警告が表示されます。