コンテンツにスキップ

テーブルとディメンションを操作する

サインインすると、タスクペインにプロジェクトが一覧表示されます。プロジェクトを選択し、そのテーブルとディメンションをブックに取得します。

タスクペインのヘッダーには、ワークスペースと、このブックにリンクされているプロジェクトが表示されます。プロジェクト名をクリックするとプロジェクトリストが開き、PlaidCloudと同じフォルダー構成で、開けるすべてのプロジェクトが表示されます。フォルダーは折りたたまれた状態で始まります。クリックして開くか、Filter projects by name に入力してリストを絞り込みます。ワークスペースに開けるプロジェクトが1つしかない場合は、PlaidXLがブックを自動的にそのプロジェクトにリンクし、ヘッダーにはそのプロジェクトが Linked to と表示され、その横に change が表示されます。

プロジェクトをクリックして選択します。そのテーブルはテーブルタブに、ディメンションはディメンションタブに表示されます。

プロジェクトはブックに属します

Section titled “プロジェクトはブックに属します”

選択したプロジェクトはブックに保存されるため、ブックごとに独自のプロジェクトを持ちます。そのブックでPlaidXLのカスタム関数やドリルコマンドが読み取るのは、このプロジェクトです。2つのブックを開くと、それぞれが自身のプロジェクトから読み取り、ブックを開き直すと、タスクペインはそのプロジェクトに戻ります。プロジェクトはファイルとともに受け渡され、ファイルを開いてアクセス権のあるアカウントでサインインしたすべてのユーザーに引き継がれます。

プロジェクトは1つのワークスペースに属します。ワークスペースを切り替えると、以前のワークスペースのプロジェクトにリンクされていたブックには、プロジェクトを選択するまでプロジェクトがない状態になります。以前のワークスペースから取得したテーブルとディメンションはブックに残りますが、更新も保存もされません。Refresh All Tables は、別のワークスペースのテーブルまたはディメンションが更新されなかったことを伝えます。新しいワークスペースでもう一度取得すると、リンクされます。

  1. テーブルタブでテーブルをクリックします。一覧が長い場合は、Filter tables by name を使って見つけます。各テーブルの横にある行数と列で、テーブルの大きさがわかります。
  2. 列の下で、不要な列のチェックボックスをオフにします。最初はすべての列が選択されています。
  3. 一部の行だけを取得するには、高度を選択してフィルターを作成します。行をフィルターするを参照してください。
  4. Select where to place this table の下で、次のいずれかを選択します。
    • Matching Worksheet — テーブル名のワークシートのセルA1から配置します。シートが存在しない場合は、PlaidXLが作成します。
    • Current Selection — アクティブなシートで選択しているセルから配置します。
  5. Retrieve Table をクリックします。

データはPlaidCloudのテーブル名が付いたExcelテーブルとして取り込まれるため、それを参照する数式、ピボットテーブル、グラフは、データが増減しても追従します。数値、日付、時刻には、データ型に合った書式、またはPlaidCloudで列に設定された表示形式が適用されます。テキスト列は文字列として書式設定されるため、0012 のようなコードも先頭のゼロが保持されます。テーブルを初めて取得するときは、ヘッダー行が固定され、列幅が内容に合わせて調整されます。

テーブルの配置先のセルにPlaidXLのテーブルではないものがすでにある場合、PlaidXLは代わりに新しいシートにテーブルを配置し、その場所を通知します。テーブルの配置先がPlaidXLの管理対象ではないExcelテーブルの一部に重なる場合は、何も変更されず、Move that Table or convert it to a range, then try again. というメッセージが表示されます。

すでにシート上にあるテーブルを取得すると、その場で更新されます。ご自身で追加した列は残り、選択を解除したソース列はヘッダーが残ったまま、その下のセルが空になります。

Excelが正確に保持できないほど大きな整数のID(9,007,199,254,740,991を超えるもの)と、1900年3月1日より前の日付はテキストとして取り込まれるため、表示も保存し直しも正確に行われます。

ワークシート名には、半角の英字(A~Z)、数字、アンダースコア、スペースのみが使われ、スペースはアンダースコアに変換され、名前はExcelの上限である31文字に切り詰められます。たとえば、Q3 Revenue (EMEA) というテーブルはシート Q3_Revenue_EMEA に、sales_2024 は sales_2024 に取得されます。アクセント付きの文字は削除されます。

大きなテーブルは、Web版のExcelと最新のデスクトップ版Excelではるかに高速に取得できます。70,000行17列のテーブルはWebで約15~20秒、143,000行77列のテーブルは約1分で、以前は10分以上かかっていました。古いバージョンのExcelでも動作しますが、高速化の効果は得られません。列幅は、ヘッダーと先頭の数行に合わせて調整されます。

Excelのセルに入る文字数は最大32,767文字のため、それより長いテキストは途中で切り取られて表示されます。テーブルにそのようなテキストがある場合、タスクペインには、どのテーブルのどの列にExcelのセルの上限である32,767文字を超えるテキストがあるか、およびExcelでは途中で切り取られて表示されるため、このテーブルでは保存が無効になることが表示されます。保存するとPlaidCloud側でもテキストが切り取られてしまうため、Save to PlaidCloud はそのテーブルを受け付けません。

行数が1,048,575を超える、列数が16,384を超える、または一度もロードされていないテーブルのようにPlaidCloudがサイズを報告できない場合、テーブルは赤で表示され、ツールチップに Too large for an Excel worksheet と表示されます。それでも取得できます。1つのワークシートに収まらない行は、最初のシート名に (2)、 (3) などを付けた次のシートに続きます。複数のシートに分割されたテーブルはPlaidCloudに保存し直せないため、編集する予定がある場合は、高度で行をフィルターし、収まるまで列をオフにしてください。

高度を選択すると、フィルタービルダーが開きます。各ルールでは、列、等しい、in、含む、開始文字列、空であるなどの比較、および値を指定します。ANDグループ、ORグループ、またはその両方を使ってルールを組み合わせます。

フィルターは値をテキストとして比較するため、完全一致の値とテキストパターンに一致します。数値や日付の範囲は指定できません。範囲を取得するには、必要な値を in でフィルターするか、テーブルを取得してからExcelでフィルターしてください。

  • 値は引用符なしで入力します。"EMEA" ではなく EMEA と入力します。
  • in のように複数の値を取る比較では、値をカンマとスペースで区切ります。EMEA, APAC, NA のように入力します。

フィルターが適用されるのは、高度が選択されている間だけです。PlaidXLは、取得したテーブルごとにフィルターと選択した列を記憶し、更新するときに再び使用します。ANDで結合した等しいとinのルールだけで作成したフィルターは、保存で置き換えられる行も決定します。

PlaidXLは、ブックに取得したテーブルとディメンションの一覧を保持し、それぞれに選択した列とフィルターで更新します。一覧はブックに保存されるため、ファイルを開いて同じプロジェクトへのアクセス権のあるアカウントでサインインすれば、誰でも更新できます。

  • タスクペインの Refresh This Sheet は、アクティブなシート上のテーブルを更新します。
  • タスクペインの Refresh All Tables は、ブック内のすべてのテーブルとディメンションを更新します。
  • リボンの更新メニューでも、シート、選択範囲、またはすべてのテーブルを更新し、PlaidXLの数式を再計算できます。更新を参照してください。

更新の実行中、タスクペインにはテーブルごとの進行状況(PlaidCloudへのクエリ、続いて書き込み済みの行の割合)がキャンセルボタンとともに表示されます。更新は同時に3つのテーブルで行われ、別の更新を開始すると、すでに実行中の更新に追加されます。完了すると、ペインに各テーブルの行数、または失敗した理由が一覧表示されます。一覧のテーブルをクリックすると、そのテーブルが選択されます。失敗したテーブルがあっても、他のテーブルの更新は止まりません。

Refresh All Tables の実行中は、ペイン、リボン、またはWeaveのすべてのテーブルの更新のいずれから実行した場合でも、各シートのタブは、そのシートの更新中は黄色になります。シートの更新が完了、失敗、またはキャンセルされると、以前の色(なし、またはご自身で設定した色)に戻ります。更新の途中でブックを保存して閉じた場合は、次にそのブックでPlaidXLが起動したときに、タブの色が元に戻されます。1つのシートまたは選択範囲の更新では、タブに色は付きません。

キャンセルすると、ブックは更新前の状態のままになります。テーブルのデータは、すべての行が届いてから初めて置き換えられます。StarRocksのテーブルでは、PlaidCloudでのクエリが停止します。DatabendやSnowflakeなどの他のエンジンでは、PlaidXLは待機を止めますが、PlaidCloudでのクエリは停止されません。データの書き込み中はExcelの計算が一時停止され、最後に一度だけ実行されます。

テーブルは、現在の場所にかかわらず、同じExcelテーブルに更新されます。Current Selection に取得したテーブルは、Excelテーブルを移動したり名前を変更したりしても、同じシートの元のセルで更新されます。Excelテーブルは新しいデータに合わせて拡大または縮小し、以前の大きな取得で残った行と列はクリアされます。

  • ご自身で追加した列 — Excelテーブルの内側にデータの横に追加した列は残ります。すべての行で同じ数式は、新しい行にも自動的にコピーされます。メモなどの他の値は、PlaidCloudのテーブルにキー列がある場合は行に追従し、なくなった行のメモはテーブルの下に残されます。キー列がない場合、メモは位置で元の場所に残ります。
  • 書式 — 列に設定した表示形式は保持されます。

他のセル、またはそのテーブル自身のものではないExcelテーブルにまで拡大してしまう更新では、何も変更されず、Move what is there, then try again. というメッセージが表示されます。行が届いている間にExcelテーブルが変更された場合は、もう一度試すようメッセージが表示されます。

テーブルのワークシートが削除されている場合、そのテーブルはスキップされ、PlaidXLは Recreate sheet または Stop refreshing を提示します。

Excelが最終的な書き込みの一部を拒否した場合、ペインには、テーブルが一部しか書き込まれなかったこととその理由、および保存する前に更新するよう表示されます。更新が成功するまで、Save to PlaidCloud はそのテーブルを受け付けません。

更新リストからテーブルを削除する

Section titled “更新リストからテーブルを削除する”

On this sheet の下に、タスクペインはアクティブなシートに取得した各テーブルとディメンションを、その行数と最後に更新した日時とともに一覧表示します。Stop refreshing をクリックすると、更新リストから削除されます。データはシート上に残り、メッセージには元に戻すが表示されます。

リストにすでにあるテーブルに重ねて取得すると、リスト内のそのテーブルが置き換えられるため、何度取得しても、テーブルは1回だけ更新されます。各テーブルの横にあるコピーを使うと、数式で使うためにそのExcelテーブル名をコピーできます。

ディメンションタブには、プロジェクトのディメンションが一覧表示されます。

  1. ディメンションをクリックします。Filter dimensions by name を使って見つけます。
  2. Select where to place this dimension の下で、Matching Worksheet または Current Selection を選択します。
  3. Retrieve Dimension をクリックします。

PlaidXLは、ディメンションのノードを階層順の1列として書き込みます。ディメンションには列フィルターや行フィルターはありません。Refresh All Tables は、テーブルとともにディメンションも更新します。

インデントとExcelのアウトラインのグループ化で階層をレイアウトしたい場合や、特定のノードまたは代替階層から始めたい場合は、代わりにドリルコマンドまたはPLAIDXL.DRILLを使用します。1つのメンバーをセルに入力するには、ディメンションタブで Pick member… をクリックします。メンバーを選択するを参照してください。

ブックに取得したテーブルは、PlaidCloudのテーブルの行をシート上の内容で置き換える形で、保存し直すことができます。

  1. 取得したテーブルのあるワークシートに移動します。On this sheet の下に、そのシートに取得した各テーブルがタスクペインに一覧表示されます。1つもない場合は、先にそこにテーブルを取得するよう、ペインに表示されます。
  2. テーブルの横にある Save to PlaidCloud をクリックします。シート上のすべてのテーブルを保存するには、リボンの書き込みグループで Save sheet to PlaidCloud… をクリックします(Ctrl+Alt+Shift+W、Macでは ⌘⌥⇧W)。

保存は確認なしで即座に行われます。メッセージには、保存された行数、知っておくべき注意点が表示され、元に戻すが提示されます。

PlaidXLは、テーブルのヘッダー行とその下の行を読み取ります。ヘッダーは取得した列と一致している必要があり、値は各列のデータ型に変換されます。変換できない値がある場合は、何も書き込まれず、失敗した行が一覧表示されます。PlaidCloudの列定義は変更されません。

  • 空のセルは空として保存されます。
  • 1,5 のようにカンマで書かれた数値は、15とは解釈されません。列に収まらない大きさの整数は該当する行について報告され、Excelが作り出した日付である1900年2月29日は拒否されます。
  • 取得した行の途中にある空の行はスキップされます。それより下では、最初の空の行でテーブルが終わり、さらに下の行は保存されず、メッセージにその行が示されます。
  • 取得しなかった列はPlaidCloudで空になり、メッセージにその列が示されます。
  • 取得した後にPlaidCloudでテーブルが変更された場合、保存するとそのテーブルが置き換えられ、メッセージにその旨が表示されます。復元ポイントには、元の内容が保持されます。
  • ドリルスルーのシートを保存した場合に、取得後にそのノードの下のメンバーが変更されていると、何も書き込まれず、Retrieve again before saving. というメッセージが表示されます。取得または更新するとシートが置き換えられるため、先に保存していない編集内容をコピーしてください。

一部の行だけを置き換える保存

Section titled “一部の行だけを置き換える保存”

次の場合、保存は自身の行だけを置き換え、テーブルの残りは保持されます。

  • フィルターでテーブルを取得した場合(ANDで結合した等しいとinのルールで作成したもの)。フィルターの対象となる行だけが置き換えられます。フィルターの範囲外に追加した行も保存され、メッセージにその行数が表示されます。それ以外のフィルターで取得したテーブルは保存できません。そのようなフィルターで、またはフィルターなしで取得し直してください。
  • シートに詳細行が表示されている場合(詳細行の表示)。その値の背後にある行だけが置き換えられます。
  • テーブルへのアクセスが一部の行に制限されている場合。 表示できる行だけが置き換えられるため、他のユーザーの行は保持されます。シートにアクセス範囲外の行がある場合は、何も保存されず、メッセージにその行が一覧表示されます。それらの行を削除してから、もう一度保存してください。

PlaidXLは、書き込む前に復元ポイントを作成します。保存ごとに独自の復元ポイントが7日間保持されるため、その後に再度保存していても、各保存から最大7日間は元に戻すが使えます。これはLakehouseのテーブルに適用されます。書き込みが失敗した場合、テーブルは元の状態に戻され、変更内容はシートに残ります。ただし、書き込みの開始後に他のユーザーがテーブルを変更した場合は、そのまま何も行わず、メッセージにその旨が表示されます。

保存を元に戻すには、メッセージの元に戻す、またはリボンの書き込みグループの Undo last write をクリックします。テーブルは保存前の状態に戻ります。一部の行だけを置き換えた保存の場合は、その行だけが戻ります。結果を確認するには、シートを更新します。書き込みを元に戻すを参照してください。保存を完了することも元に戻すこともできない場合、メッセージにはテーブルを復元できるよう復元ポイントが示されます。その場合、元に戻すを実行すると、その後にテーブルに加えられた変更も上書きされます。復元ポイントを作成できないテーブルでも保存はされ、その保存を元に戻せないことがメッセージに表示されます。

書き込みを元に戻せるのは、その書き込みを行ったユーザーとワークスペースだけです。