# Copyright 2019 The Feast Authors

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

# https://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

import copy

import itertools

import os

import warnings

from collections import Counter, defaultdict

from datetime import datetime, timedelta

from pathlib import Path

from typing import (

TYPE_CHECKING,

Any,

Callable,

Dict,

Iterable,

List,

Mapping,

Optional,

Sequence,

Set,

Tuple,

Union,

cast,

)

import pandas as pd

import pyarrow as pa

from colorama import Fore, Style

from google.protobuf.timestamp_pb2 import Timestamp

from tqdm import tqdm

from feast import feature_server, flags, flags_helper, ui_server, utils

from feast.base_feature_view import BaseFeatureView

from feast.batch_feature_view import BatchFeatureView

from feast.data_source import DataSource

from feast.diff.infra_diff import InfraDiff, diff_infra_protos

from feast.diff.registry_diff import RegistryDiff, apply_diff_to_registry, diff_between

from feast.dqm.errors import ValidationFailed

from feast.entity import Entity

from feast.errors import (

EntityNotFoundException,

ExperimentalFeatureNotEnabled,

FeatureNameCollisionError,

FeatureViewNotFoundException,

RequestDataNotFoundInEntityDfException,

RequestDataNotFoundInEntityRowsException,

)

from feast.feast_object import FeastObject

from feast.feature_service import FeatureService

from feast.feature_view import (

DUMMY_ENTITY,

DUMMY_ENTITY_ID,

DUMMY_ENTITY_NAME,

DUMMY_ENTITY_VAL,

FeatureView,

)

from feast.inference import (

update_data_sources_with_inferred_event_timestamp_col,

update_feature_views_with_inferred_features_and_entities,

)

from feast.infra.infra_object import Infra

from feast.infra.provider import Provider, RetrievalJob, get_provider

from feast.on_demand_feature_view import OnDemandFeatureView

from feast.online_response import OnlineResponse

from feast.protos.feast.core.InfraObject_pb2 import Infra as InfraProto

from feast.protos.feast.serving.ServingService_pb2 import (

FieldStatus,

GetOnlineFeaturesResponse,

)

from feast.protos.feast.types.EntityKey_pb2 import EntityKey as EntityKeyProto

from feast.protos.feast.types.Value_pb2 import RepeatedValue, Value

from feast.registry import Registry

from feast.repo_config import RepoConfig, load_repo_config

from feast.repo_contents import RepoContents

from feast.request_feature_view import RequestFeatureView

from feast.saved_dataset import SavedDataset, SavedDatasetStorage, ValidationReference

from feast.stream_feature_view import StreamFeatureView

from feast.type_map import (

feast_value_type_to_python_type,

python_values_to_proto_values,

)

from feast.usage import log_exceptions, log_exceptions_and_usage, set_usage_attribute

from feast.value_type import ValueType

from feast.version import get_version

warnings.simplefilter("once", DeprecationWarning)

if TYPE_CHECKING:

from feast.embedded_go.online_features_service import EmbeddedOnlineFeatureServer

class FeatureStore:

"""

A FeatureStore object is used to define, create, and retrieve features.

Args:

repo_path (optional): Path to a `feature_store.yaml` used to configure the

feature store.

config (optional): Configuration object used to configure the feature store.

"""

config: RepoConfig

repo_path: Path

_registry: Registry

_provider: Provider

_go_server: "EmbeddedOnlineFeatureServer"

@log_exceptions

def __init__(

self, repo_path: Optional[str] = None, config: Optional[RepoConfig] = None,

):

"""

Creates a FeatureStore object.

Raises:

ValueError: If both or neither of repo_path and config are specified.

"""

if repo_path is not None and config is not None:

raise ValueError("You cannot specify both repo_path and config.")

if config is not None:

self.repo_path = Path(os.getcwd())

self.config = config

elif repo_path is not None:

self.repo_path = Path(repo_path)

self.config = load_repo_config(Path(repo_path))

else:

raise ValueError("Please specify one of repo_path or config.")

registry_config = self.config.get_registry_config()

self._registry = Registry(registry_config, repo_path=self.repo_path)

self._registry._initialize_registry()

self._provider = get_provider(self.config, self.repo_path)

self._go_server = None

@log_exceptions

def version(self) -> str:

"""Returns the version of the current Feast SDK/CLI."""

return get_version()

@property

def registry(self) -> Registry:

"""Gets the registry of this feature store."""

return self._registry

@property

def project(self) -> str:

"""Gets the project of this feature store."""

return self.config.project

def _get_provider(self) -> Provider:

# TODO: Bake self.repo_path into self.config so that we dont only have one interface to paths

return self._provider

@log_exceptions_and_usage

def refresh_registry(self):

"""Fetches and caches a copy of the feature registry in memory.

Explicitly calling this method allows for direct control of the state of the registry cache. Every time this

method is called the complete registry state will be retrieved from the remote registry store backend

(e.g., GCS, S3), and the cache timer will be reset. If refresh_registry() is run before get_online_features()

is called, then get_online_features() will use the cached registry instead of retrieving (and caching) the

registry itself.

Additionally, the TTL for the registry cache can be set to infinity (by setting it to 0), which means that

refresh_registry() will become the only way to update the cached registry. If the TTL is set to a value

greater than 0, then once the cache becomes stale (more time than the TTL has passed), a new cache will be

downloaded synchronously, which may increase latencies if the triggering method is get_online_features().

"""

registry_config = self.config.get_registry_config()

registry = Registry(registry_config, repo_path=self.repo_path)

registry.refresh()

self._registry = registry

@log_exceptions_and_usage

def list_entities(self, allow_cache: bool = False) -> List[Entity]:

"""

Retrieves the list of entities from the registry.

Args:

allow_cache: Whether to allow returning entities from a cached registry.

Returns:

A list of entities.

"""

return self._list_entities(allow_cache)

def _list_entities(

self, allow_cache: bool = False, hide_dummy_entity: bool = True

) -> List[Entity]:

all_entities = self._registry.list_entities(

self.project, allow_cache=allow_cache

)

return [

entity

for entity in all_entities

if entity.name != DUMMY_ENTITY_NAME or not hide_dummy_entity

]

@log_exceptions_and_usage

def list_feature_services(self) -> List[FeatureService]:

"""

Retrieves the list of feature services from the registry.

Returns:

A list of feature services.

"""

return self._registry.list_feature_services(self.project)

@log_exceptions_and_usage

def list_feature_views(self, allow_cache: bool = False) -> List[FeatureView]:

"""

Retrieves the list of feature views from the registry.

Args:

allow_cache: Whether to allow returning entities from a cached registry.

Returns:

A list of feature views.

"""

return self._list_feature_views(allow_cache)

@log_exceptions_and_usage

def list_request_feature_views(

self, allow_cache: bool = False

) -> List[RequestFeatureView]:

"""

Retrieves the list of feature views from the registry.

Args:

allow_cache: Whether to allow returning entities from a cached registry.

Returns:

A list of feature views.

"""

return self._registry.list_request_feature_views(

self.project, allow_cache=allow_cache

)

def _list_feature_views(

self, allow_cache: bool = False, hide_dummy_entity: bool = True,

) -> List[FeatureView]:

feature_views = []

for fv in self._registry.list_feature_views(

self.project, allow_cache=allow_cache

):

if hide_dummy_entity and fv.entities[0] == DUMMY_ENTITY_NAME:

fv.entities = []

fv.entity_columns = []

feature_views.append(fv)

return feature_views

@log_exceptions_and_usage

def list_on_demand_feature_views(

self, allow_cache: bool = False

) -> List[OnDemandFeatureView]:

"""

Retrieves the list of on demand feature views from the registry.

Returns:

A list of on demand feature views.

"""

return self._registry.list_on_demand_feature_views(

self.project, allow_cache=allow_cache

)

@log_exceptions_and_usage

def list_stream_feature_views(

self, allow_cache: bool = False

) -> List[StreamFeatureView]:

"""

Retrieves the list of stream feature views from the registry.

Returns:

A list of stream feature views.

"""

return self._registry.list_stream_feature_views(

self.project, allow_cache=allow_cache

)

@log_exceptions_and_usage

def list_data_sources(self, allow_cache: bool = False) -> List[DataSource]:

"""

Retrieves the list of data sources from the registry.

Args:

allow_cache: Whether to allow returning data sources from a cached registry.

Returns:

A list of data sources.

"""

return self._registry.list_data_sources(self.project, allow_cache=allow_cache)

@log_exceptions_and_usage

def get_entity(self, name: str, allow_registry_cache: bool = False) -> Entity:

"""

Retrieves an entity.

Args:

name: Name of entity.

allow_registry_cache: (Optional) Whether to allow returning this entity from a cached registry

Returns:

The specified entity.

Raises:

EntityNotFoundException: The entity could not be found.

"""

return self._registry.get_entity(

name, self.project, allow_cache=allow_registry_cache

)

@log_exceptions_and_usage

def get_feature_service(

self, name: str, allow_cache: bool = False

) -> FeatureService:

"""

Retrieves a feature service.

Args:

name: Name of feature service.

allow_cache: Whether to allow returning feature services from a cached registry.

Returns:

The specified feature service.

Raises:

FeatureServiceNotFoundException: The feature service could not be found.

"""

return self._registry.get_feature_service(name, self.project, allow_cache)

@log_exceptions_and_usage

def get_feature_view(

self, name: str, allow_registry_cache: bool = False

) -> FeatureView:

"""

Retrieves a feature view.

Args:

name: Name of feature view.

allow_registry_cache: (Optional) Whether to allow returning this entity from a cached registry

Returns:

The specified feature view.

Raises:

FeatureViewNotFoundException: The feature view could not be found.

"""

return self._get_feature_view(name, allow_registry_cache=allow_registry_cache)

def _get_feature_view(

self,

name: str,

hide_dummy_entity: bool = True,

allow_registry_cache: bool = False,

) -> FeatureView:

feature_view = self._registry.get_feature_view(

name, self.project, allow_cache=allow_registry_cache

)

if hide_dummy_entity and feature_view.entities[0] == DUMMY_ENTITY_NAME:

feature_view.entities = []

return feature_view

@log_exceptions_and_usage

def get_on_demand_feature_view(self, name: str) -> OnDemandFeatureView:

"""

Retrieves a feature view.

Args:

name: Name of feature view.

Returns:

The specified feature view.

Raises:

FeatureViewNotFoundException: The feature view could not be found.

"""

return self._registry.get_on_demand_feature_view(name, self.project)

@log_exceptions_and_usage

def get_data_source(self, name: str) -> DataSource:

"""

Retrieves the list of data sources from the registry.

Args:

name: Name of the data source.

Returns:

The specified data source.

Raises:

DataSourceObjectNotFoundException: The data source could not be found.

"""

return self._registry.get_data_source(name, self.project)

@log_exceptions_and_usage

def delete_feature_view(self, name: str):

"""

Deletes a feature view.

Args:

name: Name of feature view.

Raises:

FeatureViewNotFoundException: The feature view could not be found.

"""

return self._registry.delete_feature_view(name, self.project)

@log_exceptions_and_usage

def delete_feature_service(self, name: str):

"""

Deletes a feature service.

Args:

name: Name of feature service.

Raises:

FeatureServiceNotFoundException: The feature view could not be found.

"""

return self._registry.delete_feature_service(name, self.project)

def _get_features(

self, features: Union[List[str], FeatureService], allow_cache: bool = False,

) -> List[str]:

_features = features

if not _features:

raise ValueError("No features specified for retrieval")

_feature_refs = []

if isinstance(_features, FeatureService):

feature_service_from_registry = self.get_feature_service(

_features.name, allow_cache

)

if feature_service_from_registry != _features:

warnings.warn(

"The FeatureService object that has been passed in as an argument is"

"inconsistent with the version from Registry. Potentially a newer version"

"of the FeatureService has been applied to the registry."

)

for projection in feature_service_from_registry.feature_view_projections:

_feature_refs.extend(

[

f"{projection.name_to_use()}:{f.name}"

for f in projection.features

]

)

else:

assert isinstance(_features, list)

_feature_refs = _features

return _feature_refs

def _should_use_plan(self):

"""Returns True if _plan and _apply_diffs should be used, False otherwise."""

# Currently only the local provider with sqlite online store supports _plan and _apply_diffs.

return self.config.provider == "local" and (

self.config.online_store and self.config.online_store.type == "sqlite"

)

def _validate_all_feature_views(

self,

views_to_update: List[FeatureView],

odfvs_to_update: List[OnDemandFeatureView],

request_views_to_update: List[RequestFeatureView],

sfvs_to_update: List[StreamFeatureView],

):

"""Validates all feature views."""

if (

not flags_helper.enable_on_demand_feature_views(self.config)

and len(odfvs_to_update) > 0

):

raise ExperimentalFeatureNotEnabled(flags.FLAG_ON_DEMAND_TRANSFORM_NAME)

set_usage_attribute("odfv", bool(odfvs_to_update))

_validate_feature_views(

[

*views_to_update,

*odfvs_to_update,

*request_views_to_update,

*sfvs_to_update,

]

)

def _make_inferences(

self,

data_sources_to_update: List[DataSource],

entities_to_update: List[Entity],

views_to_update: List[FeatureView],

odfvs_to_update: List[OnDemandFeatureView],

sfvs_to_update: List[StreamFeatureView],

feature_services_to_update: List[FeatureService],

):

"""Makes inferences for entities, feature views, odfvs, and feature services."""

update_data_sources_with_inferred_event_timestamp_col(

data_sources_to_update, self.config

)

update_data_sources_with_inferred_event_timestamp_col(

[view.batch_source for view in views_to_update], self.config

)

update_data_sources_with_inferred_event_timestamp_col(

[view.batch_source for view in sfvs_to_update], self.config

)

# New feature views may reference previously applied entities.

entities = self._list_entities()

update_feature_views_with_inferred_features_and_entities(

views_to_update, entities + entities_to_update, self.config

)

# TODO(kevjumba): Update schema inferrence

for sfv in sfvs_to_update:

if not sfv.schema:

raise ValueError(

f"schema inference not yet supported for stream feature views. please define schema for stream feature view: {sfv.name}"

)

for odfv in odfvs_to_update:

odfv.infer_features()

fvs_to_update_map = {

view.name: view for view in [*views_to_update, *sfvs_to_update]

}

for feature_service in feature_services_to_update:

feature_service.infer_features(fvs_to_update=fvs_to_update_map)

@log_exceptions_and_usage

def _plan(

self, desired_repo_contents: RepoContents

) -> Tuple[RegistryDiff, InfraDiff, Infra]:

"""Dry-run registering objects to metadata store.

The plan method dry-runs registering one or more definitions (e.g., Entity, FeatureView), and produces

a list of all the changes the that would be introduced in the feature repo. The changes computed by the plan

command are for informational purposes, and are not actually applied to the registry.

Args:

desired_repo_contents: The desired repo state.

Raises:

ValueError: The 'objects' parameter could not be parsed properly.

Examples:

Generate a plan adding an Entity and a FeatureView.

>>> from feast import FeatureStore, Entity, FeatureView, Feature, FileSource, RepoConfig

>>> from feast.feature_store import RepoContents

>>> from datetime import timedelta

>>> fs = FeatureStore(repo_path="feature_repo")

>>> driver = Entity(name="driver_id", description="driver id")

>>> driver_hourly_stats = FileSource(

... path="feature_repo/data/driver_stats.parquet",

... timestamp_field="event_timestamp",

... created_timestamp_column="created",

... )

>>> driver_hourly_stats_view = FeatureView(

... name="driver_hourly_stats",

... entities=[driver],

... ttl=timedelta(seconds=86400 * 1),

... batch_source=driver_hourly_stats,

... )

>>> registry_diff, infra_diff, new_infra = fs._plan(RepoContents(

... data_sources=[driver_hourly_stats],

... feature_views=[driver_hourly_stats_view],

... on_demand_feature_views=list(),

... stream_feature_views=list(),

... request_feature_views=list(),

... entities=[driver],

... feature_services=list())) # register entity and feature view

"""

# Validate and run inference on all the objects to be registered.

self._validate_all_feature_views(

desired_repo_contents.feature_views,

desired_repo_contents.on_demand_feature_views,

desired_repo_contents.request_feature_views,

desired_repo_contents.stream_feature_views,

)

_validate_data_sources(desired_repo_contents.data_sources)

self._make_inferences(

desired_repo_contents.data_sources,

desired_repo_contents.entities,

desired_repo_contents.feature_views,

desired_repo_contents.on_demand_feature_views,

desired_repo_contents.stream_feature_views,

desired_repo_contents.feature_services,

)

# Compute the desired difference between the current objects in the registry and

# the desired repo state.

registry_diff = diff_between(

self._registry, self.project, desired_repo_contents

)

# Compute the desired difference between the current infra, as stored in the registry,

# and the desired infra.

self._registry.refresh()

current_infra_proto = (

self._registry.cached_registry_proto.infra.__deepcopy__()

if self._registry.cached_registry_proto

else InfraProto()

)

desired_registry_proto = desired_repo_contents.to_registry_proto()

new_infra = self._provider.plan_infra(self.config, desired_registry_proto)

new_infra_proto = new_infra.to_proto()

infra_diff = diff_infra_protos(current_infra_proto, new_infra_proto)

return registry_diff, infra_diff, new_infra

@log_exceptions_and_usage

def _apply_diffs(

self, registry_diff: RegistryDiff, infra_diff: InfraDiff, new_infra: Infra

):

"""Applies the given diffs to the metadata store and infrastructure.

Args:

registry_diff: The diff between the current registry and the desired registry.

infra_diff: The diff between the current infra and the desired infra.

new_infra: The desired infra.

"""

infra_diff.update()

apply_diff_to_registry(

self._registry, registry_diff, self.project, commit=False

)

self._registry.update_infra(new_infra, self.project, commit=True)

@log_exceptions_and_usage

def apply(

self,

objects: Union[

DataSource,

Entity,

FeatureView,

OnDemandFeatureView,

RequestFeatureView,

StreamFeatureView,

FeatureService,

ValidationReference,

List[FeastObject],

],

objects_to_delete: Optional[List[FeastObject]] = None,

partial: bool = True,

):

"""Register objects to metadata store and update related infrastructure.

The apply method registers one or more definitions (e.g., Entity, FeatureView) and registers or updates these

objects in the Feast registry. Once the apply method has updated the infrastructure (e.g., create tables in

an online store), it will commit the updated registry. All operations are idempotent, meaning they can safely

be rerun.

Args:

objects: A single object, or a list of objects that should be registered with the Feature Store.

objects_to_delete: A list of objects to be deleted from the registry and removed from the

provider's infrastructure. This deletion will only be performed if partial is set to False.

partial: If True, apply will only handle the specified objects; if False, apply will also delete

all the objects in objects_to_delete, and tear down any associated cloud resources.

Raises:

ValueError: The 'objects' parameter could not be parsed properly.

Examples:

Register an Entity and a FeatureView.

>>> from feast import FeatureStore, Entity, FeatureView, Feature, FileSource, RepoConfig

>>> from datetime import timedelta

>>> fs = FeatureStore(repo_path="feature_repo")

>>> driver = Entity(name="driver_id", description="driver id")

>>> driver_hourly_stats = FileSource(

... path="feature_repo/data/driver_stats.parquet",

... timestamp_field="event_timestamp",

... created_timestamp_column="created",

... )

>>> driver_hourly_stats_view = FeatureView(

... name="driver_hourly_stats",

... entities=[driver],

... ttl=timedelta(seconds=86400 * 1),

... batch_source=driver_hourly_stats,

... )

>>> fs.apply([driver_hourly_stats_view, driver]) # register entity and feature view

"""

# TODO: Add locking

if not isinstance(objects, Iterable):

objects = [objects]

assert isinstance(objects, list)

if not objects_to_delete:

objects_to_delete = []

# Separate all objects into entities, feature services, and different feature view types.

entities_to_update = [ob for ob in objects if isinstance(ob, Entity)]

views_to_update = [

ob

for ob in objects

if (

isinstance(ob, FeatureView)

and not isinstance(ob, StreamFeatureView)

and not isinstance(ob, BatchFeatureView)

)

]

sfvs_to_update = [ob for ob in objects if isinstance(ob, StreamFeatureView)]

request_views_to_update = [

ob for ob in objects if isinstance(ob, RequestFeatureView)

]

odfvs_to_update = [ob for ob in objects if isinstance(ob, OnDemandFeatureView)]

services_to_update = [ob for ob in objects if isinstance(ob, FeatureService)]

data_sources_set_to_update = {

ob for ob in objects if isinstance(ob, DataSource)

}

validation_references_to_update = [

ob for ob in objects if isinstance(ob, ValidationReference)

]

for fv in itertools.chain(views_to_update, sfvs_to_update):

data_sources_set_to_update.add(fv.batch_source)

if fv.stream_source:

data_sources_set_to_update.add(fv.stream_source)

if request_views_to_update:

warnings.warn(

"Request feature view is deprecated. "

"Please use request data source instead",

DeprecationWarning,

)

for rfv in request_views_to_update:

data_sources_set_to_update.add(rfv.request_data_source)

for odfv in odfvs_to_update:

for v in odfv.source_request_sources.values():

data_sources_set_to_update.add(v)

data_sources_to_update = list(data_sources_set_to_update)

# Handle all entityless feature views by using DUMMY_ENTITY as a placeholder entity.

entities_to_update.append(DUMMY_ENTITY)

# Validate all feature views and make inferences.

self._validate_all_feature_views(

views_to_update, odfvs_to_update, request_views_to_update, sfvs_to_update

)

self._make_inferences(

data_sources_to_update,

entities_to_update,

views_to_update,

odfvs_to_update,

sfvs_to_update,

services_to_update,

)

# Add all objects to the registry and update the provider's infrastructure.

for ds in data_sources_to_update:

self._registry.apply_data_source(ds, project=self.project, commit=False)

for view in itertools.chain(

views_to_update, odfvs_to_update, request_views_to_update, sfvs_to_update

):

self._registry.apply_feature_view(view, project=self.project, commit=False)

for ent in entities_to_update:

self._registry.apply_entity(ent, project=self.project, commit=False)

for feature_service in services_to_update:

self._registry.apply_feature_service(

feature_service, project=self.project, commit=False

)

for validation_references in validation_references_to_update:

self._registry.apply_validation_reference(

validation_references, project=self.project, commit=False

)

if not partial:

# Delete all registry objects that should not exist.

entities_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, Entity)

]

views_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, FeatureView)

]

request_views_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, RequestFeatureView)

]

odfvs_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, OnDemandFeatureView)

]

sfvs_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, StreamFeatureView)

]

services_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, FeatureService)

]

data_sources_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, DataSource)

]

validation_references_to_delete = [

ob for ob in objects_to_delete if isinstance(ob, ValidationReference)

]

for data_source in data_sources_to_delete:

self._registry.delete_data_source(

data_source.name, project=self.project, commit=False

)

for entity in entities_to_delete:

self._registry.delete_entity(

entity.name, project=self.project, commit=False

)

for view in views_to_delete:

self._registry.delete_feature_view(

view.name, project=self.project, commit=False

)

for request_view in request_views_to_delete:

self._registry.delete_feature_view(

request_view.name, project=self.project, commit=False

)

for odfv in odfvs_to_delete:

self._registry.delete_feature_view(

odfv.name, project=self.project, commit=False

)

for sfv in sfvs_to_delete:

self._registry.delete_feature_view(

sfv.name, project=self.project, commit=False

)

for service in services_to_delete:

self._registry.delete_feature_service(

service.name, project=self.project, commit=False

)

for validation_references in validation_references_to_delete:

self._registry.delete_validation_reference(

validation_references.name, project=self.project, commit=False

)

self._get_provider().update_infra(

project=self.project,

tables_to_delete=views_to_delete if not partial else [],

tables_to_keep=views_to_update,

entities_to_delete=entities_to_delete if not partial else [],

entities_to_keep=entities_to_update,

partial=partial,

)

self._registry.commit()

# go server needs to be reloaded to apply new configuration.

# we're stopping it here

# new server will be instantiated on the next online request

self._teardown_go_server()

@log_exceptions_and_usage

def teardown(self):

"""Tears down all local and cloud resources for the feature store."""

tables: List[FeatureView] = []

feature_views = self.list_feature_views()

tables.extend(feature_views)

entities = self.list_entities()

self._get_provider().teardown_infra(self.project, tables, entities)

self._registry.teardown()

self._teardown_go_server()

@log_exceptions_and_usage

def get_historical_features(

self,

entity_df: Union[pd.DataFrame, str],

features: Union[List[str], FeatureService],

full_feature_names: bool = False,

) -> RetrievalJob:

"""Enrich an entity dataframe with historical feature values for either training or batch scoring.

This method joins historical feature data from one or more feature views to an entity dataframe by using a time

travel join.

Each feature view is joined to the entity dataframe using all entities configured for the respective feature

view. All configured entities must be available in the entity dataframe. Therefore, the entity dataframe must

contain all entities found in all feature views, but the individual feature views can have different entities.

Time travel is based on the configured TTL for each feature view. A shorter TTL will limit the

amount of scanning that will be done in order to find feature data for a specific entity key. Setting a short

TTL may result in null values being returned.

Args:

entity_df (Union[pd.DataFrame, str]): An entity dataframe is a collection of rows containing all entity

columns (e.g., customer_id, driver_id) on which features need to be joined, as well as a event_timestamp

column used to ensure point-in-time correctness. Either a Pandas DataFrame can be provided or a string

SQL query. The query must be of a format supported by the configured offline store (e.g., BigQuery)

features: The list of features that should be retrieved from the offline store. These features can be

specified either as a list of string feature references or as a feature service. String feature

references must have format "feature_view:feature", e.g. "customer_fv:daily_transactions".

full_feature_names: If True, feature names will be prefixed with the corresponding feature view name,

changing them from the format "feature" to "feature_view__feature" (e.g. "daily_transactions"

changes to "customer_fv__daily_transactions").

Returns:

RetrievalJob which can be used to materialize the results.

Raises:

ValueError: Both or neither of features and feature_refs are specified.

Examples:

Retrieve historical features from a local offline store.

>>> from feast import FeatureStore, RepoConfig

>>> import pandas as pd

>>> fs = FeatureStore(repo_path="feature_repo")

>>> entity_df = pd.DataFrame.from_dict(

... {

... "driver_id": [1001, 1002],

... "event_timestamp": [

... datetime(2021, 4, 12, 10, 59, 42),

... datetime(2021, 4, 12, 8, 12, 10),

... ],

... }

... )

>>> retrieval_job = fs.get_historical_features(

... entity_df=entity_df,

... features=[

... "driver_hourly_stats:conv_rate",

... "driver_hourly_stats:acc_rate",

... "driver_hourly_stats:avg_daily_trips",

... ],

... )

>>> feature_data = retrieval_job.to_df()

"""

_feature_refs = self._get_features(features)

(

all_feature_views,

all_request_feature_views,

all_on_demand_feature_views,

all_stream_feature_views,

) = self._get_feature_views_to_use(features)

if all_request_feature_views:

warnings.warn(

"Request feature view is deprecated. "

"Please use request data source instead",

DeprecationWarning,

)

# TODO(achal): _group_feature_refs returns the on demand feature views, but it's not passed into the provider.

# This is a weird interface quirk - we should revisit the `get_historical_features` to

# pass in the on demand feature views as well.

fvs, odfvs, request_fvs, request_fv_refs = _group_feature_refs(

_feature_refs,

all_feature_views,

all_request_feature_views,

all_on_demand_feature_views,

)

feature_views = list(view for view, _ in fvs)

on_demand_feature_views = list(view for view, _ in odfvs)

request_feature_views = list(view for view, _ in request_fvs)

set_usage_attribute("odfv", bool(on_demand_feature_views))

set_usage_attribute("request_fv", bool(request_feature_views))

# Check that the right request data is present in the entity_df

if type(entity_df) == pd.DataFrame:

entity_pd_df = cast(pd.DataFrame, entity_df)

for fv in request_feature_views:

for feature in fv.features:

if feature.name not in entity_pd_df.columns:

raise RequestDataNotFoundInEntityDfException(

feature_name=feature.name, feature_view_name=fv.name

)

for odfv in on_demand_feature_views:

odfv_request_data_schema = odfv.get_request_data_schema()

for feature_name in odfv_request_data_schema.keys():

if feature_name not in entity_pd_df.columns:

raise RequestDataNotFoundInEntityDfException(

feature_name=feature_name, feature_view_name=odfv.name,

)

_validate_feature_refs(_feature_refs, full_feature_names)

# Drop refs that refer to RequestFeatureViews since they don't need to be fetched and

# already exist in the entity_df

_feature_refs = [ref for ref in _feature_refs if ref not in request_fv_refs]

provider = self._get_provider()

job = provider.get_historical_features(

self.config,

feature_views,

_feature_refs,

entity_df,

self._registry,

self.project,

full_feature_names,

)

return job

@log_exceptions_and_usage

def create_saved_dataset(