テーブルとビューの管理

PlaidCloud では、ラベルを含めてテーブルを整理、管理できます。テーブルはプロジェクト内のすべてのワークフローで利用でき、多くのツールとオプションがあります。

テーブルに加えて、PlaidCloud ではテーブルデータに基づくビューも利用できます。ビューを使うと、基になるテーブルが変更されたときに即座に更新され、データのストレージ容量も節約できます。

オプションには次のものがあります。

• 同じテーブルを階層内の複数のパスに存在させることができます（代替階層）
• テーブルにはタグを付けられるため、PlaidCloud のプロセスでの検索や組み込みが容易になります
• テーブルのバージョン管理ができます
• テーブルを公開して、ダッシュボードのビジュアライゼーションで利用できるようにできます

PlaidCloud では、フォルダーをたどる場合と同様のパスベースの仕組みでテーブルを整理するため、より柔軟で論理的にテーブルを編成できます。この仕組みにより、階層内でテーブルを移動したり、階層内の異なる場所から 1 つのテーブルへの複数の参照（代替階層）を作成したりできます。この方法でテーブルを管理できるため、運用、レポート、統制のニーズを反映した構造にできます。

テーブルの検索

階層の左下にあるフィルターボックスを使って、テーブル名とラベルを検索します。一致したものは上の階層に表示されます。

ワークフロー別

テーブルタブの末尾にあるBy Workflowフォルダーは、テーブルを読み書きするワークフローごとにテーブルをまとめます。ワークフローを開くと、そのテーブルが表示されます。このフォルダーは同じテーブルを別の見方で表示するものなので、ここから移動やコピーはできません。

列別

テーブルタブの列検索ボックスに列名を入力すると、その名前の列を持つテーブルだけが表示されます。列名全体ではなく一部に一致させるには、含むを選択します。ボックスをクリアすると、すべてのテーブルが再び表示されます。長い検索結果はページ単位で返されることがあり、ステータス行には、検索が続いているか、結果が不完全な可能性があるかが表示されます。

Column Treeを選択すると、専用のウィンドウから検索できます。その列を持つ各テーブルを開くと、2 つの一覧が表示されます。

• Fed by — その列を供給するテーブル
• Feeds — その列がさらに供給するテーブル

MCP 経由で接続された AI アシスタントは、table_find(column=...) で同じテーブルを見つけられます。列名の全体または一部に一致させられます。

値の検索

どのテーブルが特定の値を保持しているかを調べるには、テーブルタブでSearch Valuesを選択します。特定のテーブルだけを検索する場合は、テーブルを右クリックしてSearch Valueを選択します。値を入力し、値の一部に一致させるには含むを選択して、検索を選択します。その値を保持する各テーブルが、値が現れる列といくつかの一致する値とともに一覧表示されます。

検索する前に、次の点にご注意ください。

• 表示されるのは、すでに開くことができる行のみです。すべての検索に行レベルセキュリティが適用されます。
• 検索した値は、ウェアハウスのクエリ履歴に記録されます。
• 検索の対象はテーブルのテキスト列です。まだ構築されていないテーブルはスキップされ、警告で名前が示されます。
• 結果はページ単位で返されます。ステータス行に検索が途中で止まったと表示された場合は、Search moreを選択して、まだ検索していないテーブルで続行します。

MCP 経由で接続された AI アシスタントは、table_value_search を使用します。値を保持するテーブルと列を返しますが、値そのものは返しません。プロジェクト内で AI アシスタントに値の検索を依頼すると、Weave は一致したテーブルと列の名前を言語モデルプロバイダーに送信します。

CSVファイルのインポート

CSV ファイルをこのプロジェクトの新しいテーブルにするには、次の手順に従います。

1. コンピューターからファイルをプロジェクトのテーブル一覧にドラッグするか、ツールバーで新規 > CSVファイルからテーブルを作成を選択して、ボックスにファイルをドロップするか、CSVファイルを選択をクリックします。
2. PlaidCloud はファイルを Personal Temp Drive にアップロードします。お持ちでない場合は、ワークスペースの Temp Drive にアップロードし、一覧の最上位に、ファイル名にちなんだ名前の新しいテーブルとしてインポートします。Sales Data.csv は sales_data になります。同じ名前のテーブルがプロジェクトにすでにある場合、新しいテーブルには sales_data_2 のように番号が付きます。
3. 一覧が更新され、新しいテーブルが選択された状態で、データの概要がそのテーブルに対して開きます。パネルに表示される内容については、独自の CSV から始めるを参照してください。

受け付けられるのは .csv で終わるファイルのみです。テーブルを作成する権限とドキュメントストレージに書き込む権限が必要で、ロックされたプロジェクトは、ロックが解除されるまで CSV を受け付けません。インポートに失敗した場合は、ウィンドウに理由が表示され、プロジェクトは元の状態のままです。PlaidCloud は、インポートが完了すると、成功したかどうかにかかわらず、アップロードされたファイルを一時ドライブから削除します。削除されなかった場合は、一時ドライブが 1 日後に削除します。

移動

テーブルを移動するには、次の手順に従います。

1. 配置したいフォルダーにドラッグします

名前の変更

テーブルの名前を変更するには、次の手順に従います。

1. テーブルを右クリックします
2. 名前の変更オプションを選択します
3. 新しい名前を入力して保存します
4. テーブルの名前が変更されますが、元の一意の識別子は保持されます。

クリア

テーブルをクリアするには、次の手順に従います。

1. 階層でテーブルを選択します
2. 上部のツールバーのクリアボタンをクリックします。

注記: 1 つのテーブルも複数のテーブルもクリアできます

削除

テーブルを削除するには、次の手順に従います。

1. 階層でテーブルを選択します
2. 上部のツールバーの削除ボタンをクリックします
3. 削除操作では、テーブルがワークフローステップまたはビューで使用されているかが確認されます。使用されている場合は、削除する前にそれらの関連付けを削除するよう求められます。

注記: テーブルを強制削除することもできます。強制削除すると参照が壊れたままになるため、使用は最小限にしてください。

最終読み取り

削除ウィンドウには、テーブルが最後に読み取られた日時が表示されます。たとえば、ユーザーまたはステップによるLast read 3 days ago byのように表示され、誰も使っていないテーブルと、まだ使用中のテーブルを見分けられます。PlaidCloud はこの情報をウェアハウス自身のクエリ履歴から取得し、自身のハウスキーピングによる読み取りは除外します。

ウェアハウス	必要なもの
Snowflake	読み取りは Access History から取得されます。Snowflake は最大 3 時間ほど遅れて記録します。接続のロールには SNOWFLAKE.GOVERNANCE_VIEWER データベースロールが必要です（SNOWFLAKE データベースの IMPORTED PRIVILEGES でも動作します）。Snowflake Standard エディションには Access History がありません。
Databricks	読み取りはリネージテーブルから取得されます。Databricks もこれを遅れて記録するため、直近の読み取りはまだ表示されない場合があります。接続のアイデンティティには、system に対する USE CATALOG、system.access に対する USE SCHEMA、system.access.table_lineage に対する SELECT が必要です。
PlaidCloud Lakehouse	読み取り履歴はまだ利用できません。ウィンドウにはRead history incompleteと表示されます。

ウェアハウスを接続すると、接続チェックが、不足しているこれらの権限を、実行するステートメントとともに推奨します。これらは推奨であり必須ではありません。権限がなくてもウェアハウスは接続され、ウィンドウにはRead history incompleteと表示されます。

PlaidCloud が履歴全体を読み取れない場合、その行にはRead history incompleteと表示され、代わりに「読み取りなし」と報告されることはありません。ウェアハウスに直接 SQL でアクセスできるユーザーは、自身の読み取りのラベルの付き方を変えるセッションタグを設定できます。

MCP 経由で接続された AI アシスタントは、table_describe(include=['last_read']) で同じ答えを得られます。

テーブルの使用箇所の確認

テーブルを選択すると詳細パネルが開き、そのテーブルに関係するワークフローステップが一覧表示されます。

• テーブルの作成元 — テーブルに書き込むステップ
• テーブルの出力先 — テーブルから読み取るステップ
• このテーブルを参照する可能性あり — 解決できない変数を介してテーブルに到達するステップ。このセクションは、そのようなステップがある場合にのみ表示されます。

ステップは、テーブルを直接指定することも、/Periods/{period}/Sales のように変数を含むパスを介して到達することもできます。その変数に現在の値がある場合、ステップは最初の 2 つの一覧に、横に情報アイコンが付いた状態で表示されます。行にカーソルを合わせると、ステップが保存しているパスを確認できます。

これらの行は、確度の低い回答として扱ってください。これらは、今開始した実行が触れる内容を示すものであり、そのテーブルに過去に触れたすべてを示すものではありません。変数を変更すると、別のテーブルが読み取られます。

解決できない変数もあります。変数が何にも設定されていないか、実行で使われる値が保存されているものに由来しないかのいずれかです。ワークフローループは反復中にデータから変数を取得し、変数設定ステップは実行中に代入し、マクロは呼び出すステップから変数を渡され、センサーによって開始された実行はそのセンサー自身の詳細を持ちます。いずれの場合も、実行間で保存されているものは前回の実行の名残であり、信頼できる値ではありません。誤っている可能性のあるテーブルに解決する代わりに、PlaidCloud は、解決できなかった変数とともに、ステップを名前でこのテーブルを参照する可能性ありの下に一覧表示します。開いて確認できます。

ロールで表示できないステップも一覧には表示されるため、テーブルが使用中であることがわかりますが、名前やワークフローは表示されず、開くこともできません。テーブルを削除する際には、そのステップも考慮されます。表示できるステップは、ロールで非表示になっているワークフローを除いて一覧表示されます。アーキテクトには何も隠されません。

注記: テーブル一覧からテーブルを削除する際、変数の有無にかかわらず、パスを介してテーブルに到達するステップは、その変数を解決できない場合でも、そのテーブルを使用しているものとして扱われます。削除ウィンドウにそのステップが表示され、強制した場合にのみ削除が実行されます。

新しいディレクトリ構造の作成

新しいフォルダーを追加するには、次の手順に従います。

1. ツールバーの新規フォルダーボタンをクリックします

既存のフォルダーにフォルダーを追加するには、次の手順に従います。

1. フォルダーを右クリックします
2. 新規フォルダーを選択します

データの表示（テーブルエクスプローラー）

テーブルデータは、データエクスプローラーで表示します。データエクスプローラーでは、データをグリッド表示で確認でき、列ごとの値と統計の概要も確認できます。ポイント操作によるフィルタリングと、一般的なファイル形式へのエクスポートの両方が利用できます。フィルターの選択内容は、ワークフローで使用できる抽出ステップとして保存することもできます。

レポート用のテーブルの公開

ダッシュボードのビジュアライゼーションは、公開されたテーブルのみに意図的に制限されています。テーブルを公開するときに、データを区別できる一意の名前を付けられます。これは、テーブルを生成したワークフローの一部では分かりにくい名前になっていても、ダッシュボードを作成する人にはより分かりやすい名前が必要な場合に便利です。

公開されたテーブルにはパスが関連付けられません。ダッシュボード領域で使用するテーブルの一覧として表示されます。

表示ロール用のテーブルのマーク

各ロールによるテーブルの表示は、エクスプローラーまたはマネージャーのチェックボックスをクリックして制御できます。複数のテーブルを更新する必要がある場合は、階層でテーブルを選択し、上部のツールバーのアクションメニューから目的の表示ロールを選択します。

テーブルの内容を説明するメモ

テーブルにメモを追加すると、データを理解しやすくなります。

テーブルの形状、サイズ、最終更新時刻の表示

各テーブルの行数、列数、データサイズは、テーブル階層に表示されます。非常に大きなテーブル（数百万行規模）では、行数が推定値になる場合があり、その場合は概算の行数であることを示す表示が出ます。

テーブルのその他の属性の表示

その他のテーブル属性を表示および編集するには、次の手順に従います。

1. テーブルを選択します
2. 右側のテーブルコンテキストフォームをクリックして表示します。

テーブルの複製

テーブルを複製するには、次の手順に従います。

1. テーブルを選択します
2. 上部のツールバーの複製ボタンをクリックします。

テーブルからデータエディターを作成

テーブルを選択し、新規メニューまたは右クリックメニューからテーブルからデータエディターを作成を選択すると、1 回の操作でテーブルを構成済みのデータエディターに変換できます。PlaidCloud はテーブルの列を調べ、エディターの入力コントロールをあらかじめ構築します。詳細については、テーブルからデータエディターを作成を参照してください。