Class FeatureView

sdk/python/feast/feature_view.py:111–806

A FeatureView defines a logical group of features. Attributes: name: The unique name of the feature view. entities: The list of names of entities that this feature view is associated with. ttl: The amount of time this group of features lives. A ttl of 0 indicates th

@typechecked
class FeatureView(BaseFeatureView):
    """
    A FeatureView defines a logical group of features.

    Attributes:
        name: The unique name of the feature view.
        entities: The list of names of entities that this feature view is associated with.
        ttl: The amount of time this group of features lives. A ttl of 0 indicates that
            this group of features lives forever. Note that large ttl's or a ttl of 0
            can result in extremely computationally intensive queries.
        batch_source: Optional batch source of data where this group of features
            is stored. If no source is provided, this will be None.
        stream_source: The stream source of data where this group of features is stored.
        schema: The schema of the feature view, including feature, timestamp, and entity
            columns. If not specified, can be inferred from the underlying data source.
        entity_columns: The list of entity columns contained in the schema. If not specified,
            can be inferred from the underlying data source.
        features: The list of feature columns contained in the schema. If not specified,
            can be inferred from the underlying data source.
        online: A boolean indicating whether online retrieval is enabled for this feature
            view.
        description: A human-readable description.
        tags: A dictionary of key-value pairs to store arbitrary metadata.
        owner: The owner of the feature view, typically the email of the primary
            maintainer.
        org: The organizational unit that owns this feature view (e.g. "ads", "search").
            Defaults to empty string.
        mode: The transformation mode for feature transformations. Only meaningful when
            transformations are applied. Choose from TransformationMode enum values
            (e.g., PYTHON, PANDAS, RAY, SQL, SPARK, SUBSTRAIT).
    """

    name: str
    entities: List[str]
    ttl: Optional[timedelta]
    batch_source: Optional[DataSource]
    stream_source: Optional[DataSource]
    source_views: Optional[List["FeatureView"]]
    entity_columns: List[Field]
    features: List[Field]
    online: bool
    offline: bool
    description: str
    tags: Dict[str, str]
    owner: str
    org: str
    materialization_intervals: List[Tuple[datetime, datetime]]
    mode: Optional[Union["TransformationMode", str]]
    enable_validation: bool
    enabled: bool
    state: FeatureViewState
    _raw_feature_transformation_proto: Optional[Message] = None

    def __init__(
        self,
        *,
        name: str,
        source: Optional[Union[DataSource, "FeatureView", List["FeatureView"]]] = None,