テーブルとビューの管理
PlaidCloud では、ラベルを含めてテーブルを整理、管理できます。テーブルはプロジェクト内のすべてのワークフローで利用でき、多くのツールとオプションがあります。
PlaidCloud には、テーブルに加えて、テーブルデータに基づくビューもあります。ビューを使用すると、基になるテーブルが変更されたときに即座に更新され、データストレージの容量も節約できます。
オプションには次のものがあります。
- 同じテーブルを階層内の複数のパスに配置できます(代替階層)
- テーブルにタグを付けて、PlaidCloud のプロセスでの検索や組み込みを容易にできます
- テーブルをバージョン管理できます
- テーブルを公開して、ダッシュボードのビジュアライゼーションで利用できるようにできます
PlaidCloud は、フォルダーをたどるときと同じようなパスベースの仕組みでテーブルを整理します。これにより、テーブルをより柔軟かつ論理的に整理できます。この仕組みでは、テーブルを階層内で移動できるほか、1 つのテーブルに対して、階層内の別の場所から複数の参照(代替階層)を作成することもできます。この方法でテーブルを管理することで、運用、レポート、統制のニーズに合わせた構造にできます。
テーブルの検索
Section titled “テーブルの検索”一覧の下部の行数の横にあるフィルターを使用して、テーブルの名前とラベルを検索します。/ または Ctrl/Cmd+F を押すと移動できます。同じフィルターが、ツリーとフラットな一覧の両方に適用されます。フィルターの横にあるすべて | 公開済み スイッチで、一覧を公開済みのテーブルに絞り込めます。デフォルトはすべてで、ツリーとフラットな一覧の両方に適用されます。
ワークフロー別
Section titled “ワークフロー別”テーブルタブの末尾にあるワークフロー別フォルダーは、テーブルを読み取りまたは書き込みするワークフローごとにまとめます。ワークフローを開くと、そのテーブルが表示されます。このフォルダーは同じテーブルのビューであるため、ここから何かを移動またはコピーすることはできません。
テーブルタブのツールバーで列を検索を選択すると、指定した名前の列を持つテーブルを見つけられます。検索は、データではなく列名を対象とするため高速で、構築済みのテーブルだけが見つかります。プロジェクトを開いてからそのプロジェクトで検索を実行した場合、ウィンドウは最後に実行した検索を開いた状態で表示されます。
2 文字以上を入力すると、入力に合わせて結果が更新されます。Enter を押すと、すぐに検索します。入力した内容の結果が表示されているときは、検索ボックスで Enter を押すと、行で押した場合と同様に、ハイライトされたテーブルが選択されます。名前の一致のさせ方を選択します。
- 完全一致 — 大文字と小文字を区別せず、列名全体に一致します
- 含む — 大文字と小文字を区別せず、列名の一部に一致します。これがデフォルトです。
- あいまい — 大文字と小文字、スペース、アンダースコアなどの区切り文字を無視し、小さなタイプミスも許容して、近い名前に一致します。最も近い一致が先頭に表示されます。
ウィンドウは、そのブラウザーで最後に選択した一致方法を記憶します。検索ボックスが空の間は、そのブラウザーでのそのプロジェクトの直近 5 件の検索が一覧表示されます。1 つを選択すると、もう一度実行されます。検索は、Enter を押したとき、一覧から選択したとき、またはその結果を操作したときに、実行されたものとして扱われ、一覧に追加されます。
一致した各テーブルは 1 行で表示され、名前、パス、最初の 3 つの一致した列が含まれます。結果の上の行には、検索の実行中に見つかったテーブルの数が表示されます。完全一致または含むで一致するものがない場合は、「あいまい」を試しますか? を選択すると、あいまいでもう一度検索します。検索が失敗した場合や途中で停止した場合は、再試行を選択します。一部のテーブルの列を読み取れなかった場合、結果が不完全な可能性があることが結果に表示されます。
結果に複数の列名が含まれる場合、一覧の上のチップに、最も多い列名から順に最大 12 件の列名と、その列を持つテーブルの数が表示されます。チップを選択すると、その列を持つテーブルだけが一覧表示され、もう一度選択するとすべてが一覧表示されます。
行を展開すると、次の内容が表示されます。
- 一致した列 — 一致した各列と、その型(テキスト、整数、数値、日付、タイムスタンプ、ブール値の場合)。警告色で表示された列は、結果内の他のテーブルでは型が異なります。ポインターを合わせると型が表示されます。
- 参照元 — このテーブルに書き込むステップが読み取るテーブル。それぞれにステップの名前が付きます
- 参照先 — このテーブルを読み取るステップが書き込むテーブル。それぞれにステップの名前が付きます
同じプロジェクト内のステップのみが一覧表示されます。
結果を操作するには、次のようにします。
- 行をダブルクリックするか、行で Enter を押すと、ウィンドウが閉じ、テーブルタブでそのテーブルが選択されます。ツリーに表示された列検索やすべて | 公開済みスイッチによってそのテーブルが非表示になっている場合は、それが解除され、メッセージで通知されます。代わりにテーブルエクスプローラーでテーブルを開くには、Ctrl+Enter(Mac では Cmd+Enter)を押します。検索ボックスで上下の矢印キーを押すと、行間を移動できます。
- ツリーに表示を選択すると、ツリーとフラットな一覧が結果のテーブル、または選択したチップのテーブルに絞り込まれ、それらを含むツリー内のフォルダーが開きます。一覧の上のチップに検索名とそのテーブル数が表示されます。チップを選択すると検索をもう一度開き、チップの × を選択するとすべてのテーブルが表示されます。テーブルタブを更新すると、検索がもう一度実行されます。
- コピーを選択すると、一覧のテーブルをコピーします。1 行に 1 テーブルで、各テーブルの名前、パス、一致した列とその型がタブで区切られます。
ツリーに表示とコピーは、検索が終了し、1 つ以上のテーブルが見つかると使用できます。
MCP 経由で接続された AI アシスタントは、table_find(column=...) で同じテーブルを検索します。名前の全体、一部、先頭、末尾に一致させるほか、column_match='fuzzy' で近い名前にも一致させることができ、一致した列の型を返します。あいまい一致では、最も近い列がどれだけ近いかも返します。
どのテーブルに値があるかを調べるには、テーブルタブのアクションメニューからデータ内の値を検索… (低速)を選択します。または、テーブルを右クリックして選択すると、そのテーブルだけが対象になります。値を入力し、値の一部に一致させるには含むを選択して、検索を選択します。その値を含む各テーブルが、値が現れる列と、一致する値のいくつかとともに一覧表示されます。テーブルをダブルクリックするか、Enter を押すと、テーブルエクスプローラーで開きます。列を選択すると、一致する行に絞り込まれた状態でテーブルが開きます。
検索する前に、次の点に注意してください。
- 検索は、対象となるすべてのテーブルのすべての行を読み取るため、非常に遅くなったり、ウェアハウスのリソースを大量に使用したりすることがあります。ウィンドウに警告が表示され、検索が終了するまで検索ボタンは無効のままです。
- 表示されるのは、すでに開くことができる行のみです。行レベルセキュリティは、すべての検索に適用されます。
- 検索した値は、ウェアハウスのクエリ履歴に記録されます。
- 検索の対象は、テーブルのテキスト列です。構築されていないテーブルはスキップされ、警告に名前が表示されます。
- 結果はページ単位で返されます。検索が途中で停止したとステータス行に表示された場合は、さらに検索を選択すると、まだ検索していないテーブルについて続行します。
MCP 経由で接続された AI アシスタントは、table_value_search を使用します。これは、値を含むテーブルと列を返しますが、値そのものは返しません。プロジェクトで AI アシスタントに値の検索を依頼すると、Weave は一致したテーブル名と列名を言語モデルプロバイダーに送信します。
CSV ファイルのインポート
Section titled “CSV ファイルのインポート”CSV ファイルをこのプロジェクトの新しいテーブルにするには、次の手順に従います。
- コンピューターからファイルを、プロジェクトのテーブル一覧にドラッグします。または、ツールバーの新規 > CSVファイルからテーブルを作成を選択し、ボックスにファイルをドロップするか、CSVファイルを選択をクリックします。
- PlaidCloud はファイルを Personal Temp Drive にアップロードします(ない場合はワークスペースの Temp Drive にアップロードします)。そして、ファイル名にちなんだ名前の新しいテーブルとして、一覧の最上位にインポートします。たとえば、
Sales Data.csvはsales_dataになります。プロジェクトにすでに同じ名前のテーブルがある場合は、sales_data_2のように、新しいテーブルに番号が付きます。 - 一覧が更新されて新しいテーブルが選択され、そのテーブルでデータの概要が開きます。パネルに表示される内容については、独自の CSV から始めるを参照してください。
受け付けるのは、.csv で終わるファイルだけです。テーブルの作成とドキュメントストレージへの書き込みの権限が必要です。ロックされているプロジェクトは、ロックを解除するまで CSV を受け付けません。インポートが失敗した場合は、ウィンドウに理由が表示され、プロジェクトは元の状態のままです。PlaidCloud は、インポートが完了すると、成功したかどうかにかかわらず、アップロードされたファイルを一時ドライブから削除します。削除できなかった場合は、一時ドライブが 1 日後に削除します。
テーブルを移動するには、次の手順に従います。
- 配置したいフォルダーにドラッグします
テーブルをプロジェクトの最上位に移動するには、最後の行の下の空白部分にドラッグします。フォルダーピッカーでは、/ がプロジェクトの最上位です。
テーブルの名前を変更するには、次の手順に従います。
- テーブルを右クリックします
- 名前の変更オプションを選択します
- 新しい名前を入力して保存します
- テーブルの名前は変更されますが、元の一意の識別子は保持されます。
テーブルをクリアするには、次の手順に従います。
- 階層でテーブルを選択します ‘
- 上部のツールバーにあるクリアボタンをクリックします。
注記: 1 つのテーブルも、複数のテーブルもクリアできます
テーブルを削除するには、次の手順に従います。
- 階層でテーブルを選択します
- 上部のツールバーにある削除ボタンをクリックします
- 削除操作では、そのテーブルがワークフローのステップまたはビューで使用されていないかを確認します。使用されている場合は、削除する前にそれらの関連付けを削除するよう求められます。
注記: テーブルを強制的に削除することもできます。強制削除すると参照が壊れたままになるため、使用は最小限にしてください。
最終読み取り
Section titled “最終読み取り”削除ウィンドウには、テーブルが最後に読み取られた時期が、たとえば Last read 3 days ago by のあとにユーザーまたはステップが続く形で表示されるため、誰も使っていないテーブルと、まだ使用中のテーブルを見分けられます。PlaidCloud は、これをウェアハウス自体のクエリ履歴から取得し、PlaidCloud 自身の管理処理による読み取りは除外します。
| ウェアハウス | 必要なもの |
|---|---|
| Snowflake | 読み取りは Access History から取得されます。Snowflake は、最大で約 3 時間遅れて記録します。接続のロールには SNOWFLAKE.GOVERNANCE_VIEWER データベースロールが必要です(SNOWFLAKE データベースの IMPORTED PRIVILEGES でも動作します)。Snowflake Standard エディションには Access History がありません。 |
| Databricks | 読み取りはリネージテーブルから取得されます。Databricks はこれも遅れて記録するため、最近の読み取りはまだ表示されないことがあります。接続の ID には、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']) から同じ回答を得られます。
テーブルの列を確認する
Section titled “テーブルの列を確認する”テーブルを選択すると、詳細パネルが開きます。その列セクションには、各列がタイプと説明とともに一覧表示されます。説明は列のプロパティから取得されます。行にポインターを合わせると、長い説明の全文を読めます。
データの有効期限が切れた、またはテーブルを構築するステップがないなどの理由で、現在ウェアハウスにないテーブルには、一覧表示する列がありません。セクションにはその旨と、テーブルの列数が表示されます。列を一覧表示するには、そのテーブルに書き込むステップを実行します。
テーブルの使用箇所を確認する
Section titled “テーブルの使用箇所を確認する”テーブルを選択すると、詳細パネルが開き、そのテーブルに関係するワークフローステップが一覧表示されます。
- テーブルの作成元 — テーブルに書き込むステップ
- テーブルの出力先 — テーブルから読み取るステップ
- このテーブルを参照する可能性あり — 解決できない変数を通じてテーブルにアクセスするステップ。このセクションは、そのようなステップがある場合にのみ表示されます。
別のテーブルを選択すると、これらの一覧は直ちにクリアされます。このプロジェクトのデータを共有している別のプロジェクトのステップ(このテーブルを読み取るインポート: 外部プロジェクトテーブルステップなど)も、そのプロジェクトにアクセスできない可能性があるため、名前とワークフローなしで一覧表示されます。これらのステップは、他のステップより少し遅れて表示されることがあります。
ステップは、テーブルを直接指定することも、/Periods/{period}/Sales のような変数を含むパスを通じて参照することもできます。その変数に現在の値がある場合、ステップは最初の 2 つの一覧に、横に情報アイコンが付いて表示されます。行にポインターを合わせると、ステップが保存しているとおりのパスを確認できます。
これらの行は、確度が低い回答として扱ってください。これらは、今開始した実行が触れる内容を示すもので、これまでにテーブルに触れたすべてを示すものではありません。変数を変更すると、別のテーブルが読み取られます。
解決できない変数もあります。変数がまったく設定されていないか、実行で使用される値が保存されている内容に由来しないかのどちらかです。たとえば、Workflow Loop は繰り返しの中でデータから変数を取得し、Set Variable ステップは実行中に代入し、マクロは呼び出し元のステップから変数を渡され、センサーによって開始された実行はそのセンサー自身の詳細を持ちます。いずれの場合も、実行の間に保存されている内容は、信頼できる値ではなく、前回の実行の名残です。PlaidCloud は、誤ったテーブルの可能性があるものに解決する代わりに、解決できなかった変数とともに、ステップを名前でこのテーブルを参照する可能性ありの下に一覧表示します。開いて確認できます。
ロールで見られないステップも一覧表示されるため、テーブルが使用中であることは分かりますが、名前とワークフローは表示されず、開くこともできません。テーブルを削除するときは、そのステップも使用中として数えられます。見られるステップは、ロールで非表示のワークフローを除いて一覧表示されます。アーキテクトには、非表示のものはありません。
注記: テーブル一覧からテーブルを削除するとき、変数の有無にかかわらず、パスを通じてテーブルにアクセスするステップは、変数を解決できない場合でも、そのテーブルを使用しているものとして数えられます。削除ウィンドウにはそのステップが一覧表示され、強制した場合にのみ削除が実行されます。
新しいディレクトリ構造を作成する
Section titled “新しいディレクトリ構造を作成する”新しいフォルダーを追加するには、次の手順に従います。
- ツールバーの新規フォルダーボタンをクリックします
既存のフォルダーにフォルダーを追加するには、次の手順に従います。
- フォルダーを右クリックします
- 新規フォルダーを選択します
選択内容がフォルダー内にある場合、新しいフォルダーの名前を入力するプロンプトにも最上位に作成があります。これにチェックを入れると、新しいフォルダーがプロジェクトの最上位に作成されます。
データの表示(テーブルエクスプローラー)
Section titled “データの表示(テーブルエクスプローラー)”テーブルデータは、データエクスプローラーで表示します。データエクスプローラーには、データのグリッドビューのほか、値と統計の列ごとのサマリーが表示されます。ポイントアンドクリックによるフィルタリングと、一般的なファイル形式へのエクスポートの両方を利用できます。フィルターの選択内容は、ワークフローで使用できる抽出ステップとして保存することもできます。
レポート用にテーブルを公開する
Section titled “レポート用にテーブルを公開する”ダッシュボードのビジュアライゼーションは、公開されたテーブルに意図的に限定されています。テーブルを公開するときに、データを区別できる一意の名前を付けられます。これは、テーブルを生成したワークフローの一部では分かりにくい名前になっているものの、ダッシュボードを作成するユーザーにはより明確な名前が必要な場合に役立ちます。
公開されたテーブルにはパスが関連付けられません。ダッシュボード領域で使用するテーブルの一覧として表示されます。
閲覧ロール用にテーブルをマークする
Section titled “閲覧ロール用にテーブルをマークする”ロールごとのテーブルの閲覧は、エクスプローラーまたはマネージャーのチェックボックスをクリックして制御できます。複数のテーブルを更新する必要がある場合は、階層でテーブルを選択し、上部のツールバーのアクションメニューから目的の閲覧ロールを選択します。
テーブルの内容を説明するメモ
Section titled “テーブルの内容を説明するメモ”テーブルにメモを追加すると、データを理解しやすくなります。
テーブルの形状、サイズ、最終更新時刻を表示する
Section titled “テーブルの形状、サイズ、最終更新時刻を表示する”各テーブルの行数、列数、データサイズは、テーブル階層に表示されます。非常に大きなテーブル(数百万行以上)では、行数が推定値になることがあり、その場合は概算の行数であることを示す表示が出ます。
テーブルのその他の属性を表示する
Section titled “テーブルのその他の属性を表示する”テーブルのその他の属性を表示、編集するには、次の手順に従います。
- テーブルを選択します
- 右側のテーブルのコンテキストフォームを表示するをクリックします。
テーブルを複製する
Section titled “テーブルを複製する”テーブルを複製するには、次の手順に従います。
- テーブルを選択します
- 上部のツールバーにある複製ボタンをクリックします。
テーブルから Panel アプリを作成する
Section titled “テーブルから Panel アプリを作成する”テーブルまたはビューを選択し、新規メニューまたは右クリックメニューから Panel アプリを作成を選択します。新しい Studio アプリダイアログが、プロジェクトとテーブルが選択された状態で開きます。アプリにはテーブルの名前が付けられます。必要に応じて変更し、作成を選択すると、Panel Studio がアプリを開き、Weave が最初のページを作成する準備ができた状態になります。このコマンドは、単一のテーブルまたはビューを選択していて、プロジェクトへの編集アクセスがあり、プロジェクトが読み取り専用でない場合に利用できます。Panel アプリの作成を参照してください。
テーブルの保存内容を確認する
Section titled “テーブルの保存内容を確認する”テーブル一覧には、各テーブルのサイズの横に、現在のデータ、履歴、タイムトラベル日数、注記の列が表示されます。タイムトラベル日数はテーブル自身の設定で、1 はプロジェクトのデフォルトを使用することを意味します。一覧の下のステータスバーには、プロジェクトの合計が表示されます。保存しているデータ量と、そのうち現在のデータと履歴がそれぞれどれだけかです。推定とマークされたサイズは、PlaidCloud が測定するまで、テーブルの形状から算出されたものです。
アクションメニューからストレージを選択すると、プロジェクトのストレージウィンドウが開き、容量を空けるための提案とタイムトラベルの設定が表示されます。ストレージの管理を参照してください。
テーブルからデータエディターを作成する
Section titled “テーブルからデータエディターを作成する”テーブルを選択し、新規メニューまたは右クリックメニューからテーブルからデータエディターを作成を選択すると、テーブルを構成済みのデータエディターに 1 ステップで変換できます。PlaidCloud はテーブルの列を調べ、エディターの入力コントロールを事前に構築します。詳細については、テーブルからデータエディターを作成するを参照してください。