Package com.linkedin.venice.meta

Enum Class ExternalStorageReadMode

java.lang.Object
java.lang.Enum<ExternalStorageReadMode>
com.linkedin.venice.meta.ExternalStorageReadMode
All Implemented Interfaces:
VeniceEnumValue, Serializable, Comparable<ExternalStorageReadMode>, Constable
public enum ExternalStorageReadMode extends Enum<ExternalStorageReadMode> implements VeniceEnumValue
Store-level read routing for clients backed by both Venice local storage and a configured external storage system. Applies to the store as a whole, not per-version. Mirrors the externalStorageReadMode field staged on StoreProperties (StoreMetaValue v44) by PR #2814.

Field plumbing only at the OSS Venice layer; the actual routing decisions live in proprietary client code.

  • Enum Constant Details

    • VENICE_ONLY

      public static final ExternalStorageReadMode VENICE_ONLY
      Default. All reads served from Venice local storage. No external-storage involvement.

    • DUAL_MODE_CONSISTENCY_CHECK

      public static final ExternalStorageReadMode DUAL_MODE_CONSISTENCY_CHECK
      Client reads from both Venice and the external storage in parallel; the external-storage result is compared against the Venice result for correctness metrics but never reaches the user. Used to validate dual-write correctness before cutover.

    • DUAL_MODE_EARLY_RETURN

      public static final ExternalStorageReadMode DUAL_MODE_EARLY_RETURN
      Client issues reads against both Venice and the external storage in parallel and returns the first response. On miss from the early responder, the slower one is awaited as a fallback. Enabled only after consistency checking has validated zero divergence over a sustained window.

    • EXTERNAL_ONLY

      public static final ExternalStorageReadMode EXTERNAL_ONLY
      All user-data reads served from the external storage. Venice continues to serve metadata (catalog, schemas, compression dictionary) and acts as the metadata/CDC path.

  • Method Details

    • values

      public static ExternalStorageReadMode[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static ExternalStorageReadMode valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null

    • valueOf

      public static ExternalStorageReadMode valueOf(int value)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      value - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null

    • getValue

      public int getValue()
      Specified by:
      getValue in interface VeniceEnumValue