Services

ServingService

rpc GetFeastServingInfo(GetFeastServingInfoRequest) returns (GetFeastServingInfoResponse)

Get information about this Feast serving.

rpc GetOnlineFeaturesV2(GetOnlineFeaturesRequestV2) returns (GetOnlineFeaturesResponse)

Get online features (v2) synchronously.

Types

GetFeastServingInfoRequest

GetFeastServingInfoResponse

Field Type Description Required
version string

Feast version of this serving deployment.

No
type FeastServingType

Type of serving deployment, either ONLINE or BATCH. Different store types support different feature retrieval methods.

No
jobStagingLocation string

Note: Batch specific options start from 10. Staging location for this serving store, if any.

No

FeatureReferenceV2

Field Type Description Required
featureTable string

Name of the Feature Table to retrieve the feature from.

No
name string

Name of the Feature to retrieve the feature from.

No

GetOnlineFeaturesRequestV2

Field Type Description Required
features FeatureReferenceV2[]

List of features that are being retrieved

No
entityRows EntityRow[]

List of entity rows, containing entity id and timestamp data. Used during retrieval of feature rows and for joining feature rows into a final dataset

No
project string

Optional field to specify project name override. If specified, uses the given project for retrieval. Overrides the projects specified in Feature References if both are specified.

No

GetOnlineFeaturesResponse

Field Type Description Required
fieldValues FieldValues[]

Feature values retrieved from feast.

No

GetOnlineFeaturesRequestV2.EntityRow

Field Type Description Required
timestamp Timestamp

Request timestamp of this row. This value will be used, together with maxAge, to determine feature staleness.

No
fields map<string, Value>

Map containing mapping of entity name to entity value.

No

GetOnlineFeaturesResponse.FieldValues

Field Type Description Required
fields map<string, Value>

Map of feature or entity name to feature/entity values. Timestamps are not returned in this response.

No
statuses map<string, FieldStatus>

Map of feature or entity name to feature/entity statuses/metadata.

No

feast.types.Value

Field Type Description Required
bytesVal bytes (oneof) No
stringVal string (oneof) No
int32Val int32 (oneof) No
int64Val int64 (oneof) No
doubleVal double (oneof) No
floatVal float (oneof) No
boolVal bool (oneof) No
bytesListVal BytesList (oneof) No
stringListVal StringList (oneof) No
int32ListVal Int32List (oneof) No
int64ListVal Int64List (oneof) No
doubleListVal DoubleList (oneof) No
floatListVal FloatList (oneof) No
boolListVal BoolList (oneof) No

GetOnlineFeaturesResponse.FieldStatus

Name Description
INVALID

Status is unset for this field.

PRESENT

Field value is present for this field and age is within max age.

NULL_VALUE

Values could be found for entity key and age is within max age, but this field value is assigned a value on ingestion into feast.

NOT_FOUND

Entity key did not return any values as they do not exist in Feast. This could suggest that the feature values have not yet been ingested into feast or the ingestion failed.

OUTSIDE_MAX_AGE

Values could be found for entity key, but field values are outside the maximum allowable range.

FeastServingType

Name Description
FEAST_SERVING_TYPE_INVALID
FEAST_SERVING_TYPE_ONLINE

Online serving receives entity data directly and synchronously and will respond immediately.

FEAST_SERVING_TYPE_BATCH

Batch serving receives entity data asynchronously and orchestrates the retrieval through a staging location.

FeastServingType

Name Description
FEAST_SERVING_TYPE_INVALID
FEAST_SERVING_TYPE_ONLINE

Online serving receives entity data directly and synchronously and will respond immediately.

FEAST_SERVING_TYPE_BATCH

Batch serving receives entity data asynchronously and orchestrates the retrieval through a staging location.

GetOnlineFeaturesResponse.FieldStatus

Name Description
INVALID

Status is unset for this field.

PRESENT

Field value is present for this field and age is within max age.

NULL_VALUE

Values could be found for entity key and age is within max age, but this field value is assigned a value on ingestion into feast.

NOT_FOUND

Entity key did not return any values as they do not exist in Feast. This could suggest that the feature values have not yet been ingested into feast or the ingestion failed.

OUTSIDE_MAX_AGE

Values could be found for entity key, but field values are outside the maximum allowable range.