表のインポート・エクスポート

この機能の利用対象

Enterpriseプラン以上のユーザー。

エクスポート・インポート図

以下は、Tulipのテーブル、クエリ、集計に関する転送フロー全体です。このドキュメントでは、このフローについて詳しく説明します。

カスタムユーザーフィールドおよびマシンアクティビティテーブル

以下で説明するフローは、カスタムユーザーフィールドテーブルおよびマシンアクティビティフィールドテーブルのエクスポートとインポートにも適用されます。

エクスポート

エクスポート処理中、エクスポートされるアプリケーションまたはオートメーションには、そのアプリケーション内で使用されているすべてのテーブルが含まれます。テーブルは、以下の条件のいずれかを満たす場合、「使用中」とみなされます：

「テーブルレコード」ウィジェットに表示されている
入力ウィジェットで使用されている
インタラクティブテーブルに表示されている
トリガーで使用されている
オートメーションアクションで使用されている
オートメーションイベントブロックで使用される
テーブルクエリ、インタラクティブテーブル、または分析ウィジェットのフィルターで使用される
カスタムウィジェットの入力または出力として使用される

フィールドがアーカイブされている場合、そのフィールドはエクスポートされません。フィールドがアーカイブされているが使用中の場合、エクスポートは失敗します。

インポート

同一のテーブルを検索

インポート時に一致するテーブルを特定するために、IDの一致を確認します。同じ ID を持つテーブルが見つかった場合、新しいテーブルは作成せず、既存のテーブルを使用します。

ソースでテーブルがアーカイブされており、宛先には存在しない場合、そのテーブルは宛先に作成され、アーカイブされます。

ソースインスタンスのテーブルがアーカイブされている場合、その状態は維持されます。アーカイブされたテーブルはアーカイブされたまま、アーカイブされていないテーブルはアーカイブされていないままとなります。

各テーブルフィールドについて

各テーブルフィールドについて、そのフィールドの列 ID に基づいて、一致するフィールドを検索します。

一致するフィールドのデータ型が異なる場合、インポートは失敗します。

フィールドがリンクされたレコードフィールドである場合、リンクされたテーブルがインポートの依存関係リストに追加され、そのテーブルに対してこの処理が繰り返されます。

ソースでフィールドがアーカイブされており、宛先には存在しない場合、そのフィールドはアーカイブされていない状態で宛先に作成されます（注：これはテーブルの動作とは異なります）。

フィールドが宛先にすでに存在する場合、そのアーカイブ状態はインポートによって更新されることはありません。アーカイブされたフィールドはアーカイブされたまま、アーカイブされていないフィールドはアーカイブされていないままとなります。

NOTE

When exporting a table directly, archived fields are not included. However, if an archived field is referenced by an app, it will be included in the export (with the above import rules applying).

各クエリについて

インポートされたテーブル内の各クエリについて、そのクエリが存在するかどうかを確認します。一致する ID が見つかった場合、ターゲットとソース間で設定（制限、ソート、フィルタリング）が同一であることを検証します。

一致するクエリが見つからない場合は、新しいクエリが作成されます。一致するクエリが見つかったものの、ターゲットインスタンスと完全に同一でない場合は、新しい名前で新しいクエリが作成されます。

注：これは、カスタムユーザーフィールドやマシンアクティビティテーブルには適用されません。

:::(情報) (r347/LTS15 時点でのインポート/エクスポート動作の更新)
インポート/エクスポート動作の更新により、重複が減少しました。テーブルクエリは、development version としてインポートされるようになりました。テーブルクエリがスナップショットとしてインポートされるのは、同一のクエリがすでに存在し、かつ設定が異なる場合のみです。

以前の動作（r329/LTS14およびそれ以前のインスタンスでは現在も有効）では、スナップショットはスナップショットとして、development versions はdevelopment versions としてインポートされていました。
:::

各集計について

インポートされたテーブル内の各集計について、そのクエリが存在するかどうかを確認します。一致する ID が見つかった場合、ターゲットとソースの間で構成（操作、フィールド）が同一であるかを確認します。

一致する集計が見つからない場合は、新しい集計が作成されます。一致する集計が見つかったものの、ターゲットインスタンスと完全に同一でない場合は、新しい名前で新しい集計が作成されます。

注：これは、カスタムユーザーフィールドやマシンアクティビティテーブルには適用されません。

:::(情報) (r347/LTS15 時点でのインポート/エクスポート動作の更新)
インポート/エクスポート動作の更新により、重複が削減されました。テーブル集計は、development version としてインポートされるようになりました。テーブル集計がスナップショットとしてインポートされるのは、同一の集計がすでに存在し、かつ設定が異なる場合のみです。