●Change8

arize-phoenix-v12.0.0

Breaking Changes
📦 arize-phoenixView on GitHub →
⚠ 1 breaking✨ 19 features🐛 8 fixes🔧 6 symbols

Summary

Version 12.0.0 introduces significant database schema updates, including support for session annotations, dataset splits, and experiment snapshots. This major release includes numerous backend improvements and updates to dependency handling.

⚠️ Breaking Changes

  • Version 12 introduced significant changes, requiring users to review migration steps if applicable.

Migration Steps

  1. Review the changes associated with version 12 ([#9695]) as this is a major release.
  2. If using database features related to datasets, splits, or annotations, review the migration scripts executed during upgrade (e.g., dataset labels migration [#9409], dataset split and examples migration [#9360], Experiment migration [#9279]).

✨ New Features

  • Added annotation columns to sessions table.
  • Added DB table and GraphQL mutations for session annotations.
  • Added a junction table for taking snapshots of examples when inserting an experiment.
  • Added user_id to datasets and dataset_versions tables.
  • Implemented assignment of examples to dataset splits.
  • Added client methods for adding trace and session annotations.
  • Implemented dataset labels migration.
  • Implemented dataset split and examples migration.
  • Introduced Dataset Splits Add Dialog UI.
  • Implemented dataset splits backend.
  • Added a row for the viewer role to the database.
  • Display splits on the examples table.
  • Implemented Experiment migration.
  • Added experiment-tags on experiment and datasets.
  • Show repetitions in the experiments table.
  • Pinned the minimum version of the client.
  • Playground migration now records user_id for experiments.
  • Updated to the Google GenAI SDK.
  • Used composite primary key for crosswalk tables.

🐛 Bug Fixes

  • Added big int indexes and user id indexes.
  • Updated built-in model token prices for cost calculation.
  • Added composite indices to traces and project_sessions in the database.
  • Dropped redundant index on the experiment_runs table.
  • Implemented drop/create indices using IF (NOT) EXISTS.
  • Ensured PHOENIX_POSTGRES_HOST is not split.
  • Removed additional redundant indices.
  • Removed server default for dataset label color.

🔧 Affected Symbols

datasetsdataset_versionssessionstracesexperiment_runsproject_sessions