Skip to main content
W&B 表で表形式データを可視化およびログします。W&B 表は、各列が単一のデータタイプを持つ 2 次元のグリッドです。各行は W&B run にログされた 1 つ以上のデータポイントを表します。W&B 表はプリミティブ型および数値型に加え、ネストしたリスト、辞書、リッチメディアタイプをサポートします。 W&B 表は W&B の特殊な データタイプ で、アーティファクト オブジェクトとしてログされます。 W&B Python SDK を使用して 表オブジェクトを作成およびログ します。表オブジェクトを作成する際は、表の列とデータ、および モード を指定します。このモードにより、ML 実験中に表がどのようにログおよび更新されるかが決まります。
INCREMENTAL モードは W&B Server v0.70.0 以降でサポートされます。

表を作成してログする

  1. wandb.init() で新しい run を初期化します。
  2. wandb.Table クラスを使用して Table オブジェクトを作成します。columns と data の各パラメーターに、表の列とデータをそれぞれ指定します。オプションの log_mode パラメーターを 3 つのモードのいずれかに設定することを推奨します: IMMUTABLE (デフォルト)、MUTABLE、または INCREMENTAL。詳細については、次のセクションの Table ログモード を参照してください。
  3. run.log() で表を W&B にログします。
次の例は、2 つの列 a と b、および 2 行のデータ ["a1", "b1"] と ["a2", "b2"] を持つ表を作成してログする方法を示しています:

ログモード

wandb.Table の log_mode パラメーターは、ML 実験中に表をどのようにログし、更新するかを決定します。log_mode パラメーターは、IMMUTABLE、MUTABLE、INCREMENTAL の 3 つの引数のいずれかを受け入れます。モードによって、表のログ方法、変更方法、および W&B アプリでのレンダリング方法が異なります。 以下に、3 つのログモードの定義、主な違い、および各モードの一般的なユースケースを示します。 次のセクションでは、各モードのコードスニペット例と、各モードを使用する際の考慮事項を示します。

MUTABLE モード

MUTABLE モードでは、既存の表を新しい表に置き換えることで表を更新します。MUTABLE モードは、反復処理ではないプロセスで既存の表に新しい列や行を追加する場合に便利です。UI では、最初にログした後に追加された列や行も含め、すべての行と列が表にレンダリングされます。
MUTABLE モードでは、表をログするたびに表オブジェクトが置き換えられます。表を新しい表で上書きする処理は計算コストが高く、大きな表では時間がかかる場合があります。
次の例では、MUTABLE モードで表を作成してログし、その後に新しい列を追加する方法を示します。表オブジェクトは 3 回ログされます。1 回目は初期データ、2 回目は信頼度スコア、3 回目は最終的な予測を追加した時点です。
次の例では、データの読み込みに仮の関数 load_eval_data() を、予測に仮の関数 model.predict() を使用しています。これらは、ご自身のデータ読み込み関数と予測関数に置き換えてください。
トレーニングループのように、列は追加せずに新しい行のバッチだけを段階的に追加したい場合は、代わりに INCREMENTAL モード を使用することを検討してください。

段階的モード

段階的モードでは、機械学習の実験中に行をバッチ単位で表にログします。これは、長時間実行されるジョブのモニタリングや、更新のたびに run 中にログすると非効率になる大きな表を扱う場合に最適です。UI では、行がログされるたびに表に新しい行が追加されるため、run 全体の終了を待たずに最新のデータを確認できます。また、増分を順に切り替えて、さまざまな時点の表を確認することもできます。
W&B アプリ の run ワークスペースには、増分数の上限が 100 あります。100 を超える増分をログした場合、run ワークスペースには最新の 100 のみが表示されます。
次の例では、INCREMENTAL モードで表を作成してログした後、新しい行を追加します。表はトレーニングステップ (step) ごとに 1 回ログされます。
次の例では、データを読み込むための仮の関数 get_training_batch()、モデルをトレーニングするための仮の関数 train_model_on_batch()、予測を行うための仮の関数 predict_on_batch() を使用しています。これらを独自のデータ読み込み、トレーニング、予測の関数に置き換える必要があります。
段階的にログする方法は、通常、毎回新しい表をログする方法 (log_mode=MUTABLE) よりも計算効率が高くなります。ただし、多数の増分をログすると、W&B アプリ が表のすべての行をレンダリングしない場合があります。run の実行中に表のデータを更新して表示し、すべてのデータを分析に利用できるようにしたい場合は、2 つの表の使用を検討してください。一方のログモードを INCREMENTAL に、もう一方を IMMUTABLE に設定します。 次の例では、INCREMENTAL と IMMUTABLE のログモードを組み合わせて、これを実現する方法を示します。
この例では、トレーニング中に incr_table を段階的にログします (log_mode="INCREMENTAL" を使用) 。これにより、新しいデータが処理されるたびに、表の更新をログして表示できます。トレーニングの終了時に、段階的な表のすべてのデータを含む不変の表 (final_table) が作成されます。不変の表をログすることで、完全なデータセットを追加の分析用に保存し、W&B アプリ ですべての行を表示できます。

サンプル

MUTABLE を使用して評価結果を拡充する

段階的な表を使用した run の再開

run を再開すると、段階的な表にログし続けることができます。
wandb.Run.define_metric("<table_key>", summary="none") または wandb.Run.define_metric("*", summary="none") を使用して、段階的な表に使用するキーのサマリーを無効にすると、増分は新しい表にログされます。

段階的なバッチトレーニングによるトレーニング

最終更新日 2026年9月30日