Class BatchReadFeatureValuesRequest (1.17.1)

BatchReadFeatureValuesRequest(
    mapping=None, *, ignore_unknown_fields=False, **kwargs
)

Request message for FeaturestoreService.BatchReadFeatureValues.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Attributes

NameDescription
csv_read_instances google.cloud.aiplatform_v1.types.CsvSource
Each read instance consists of exactly one read timestamp and one or more entity IDs identifying entities of the corresponding EntityTypes whose Features are requested. Each output instance contains Feature values of requested entities concatenated together as of the read time. An example read instance may be ``foo_entity_id, bar_entity_id, 2020-01-01T10:00:00.123Z``. An example output instance may be ``foo_entity_id, bar_entity_id, 2020-01-01T10:00:00.123Z, foo_entity_feature1_value, bar_entity_feature2_value``. Timestamp in each read instance must be millisecond-aligned. ``csv_read_instances`` are read instances stored in a plain-text CSV file. The header should be: [ENTITY_TYPE_ID1], [ENTITY_TYPE_ID2], ..., timestamp The columns can be in any order. Values in the timestamp column must use the RFC 3339 format, e.g. ``2012-07-30T10:43:17.123Z``. This field is a member of `oneof`_ ``read_option``.
bigquery_read_instances google.cloud.aiplatform_v1.types.BigQuerySource
Similar to csv_read_instances, but from BigQuery source. This field is a member of `oneof`_ ``read_option``.
featurestore str
Required. The resource name of the Featurestore from which to query Feature values. Format: ``projects/{project}/locations/{location}/featurestores/{featurestore}``
destination google.cloud.aiplatform_v1.types.FeatureValueDestination
Required. Specifies output location and format.
pass_through_fields Sequence[google.cloud.aiplatform_v1.types.BatchReadFeatureValuesRequest.PassThroughField]
When not empty, the specified fields in the \*_read_instances source will be joined as-is in the output, in addition to those fields from the Featurestore Entity. For BigQuery source, the type of the pass-through values will be automatically inferred. For CSV source, the pass-through values will be passed as opaque bytes.
entity_type_specs Sequence[google.cloud.aiplatform_v1.types.BatchReadFeatureValuesRequest.EntityTypeSpec]
Required. Specifies EntityType grouping Features to read values of and settings. Each EntityType referenced in [BatchReadFeatureValuesRequest.entity_type_specs] must have a column specifying entity IDs in the EntityType in [BatchReadFeatureValuesRequest.request][] .

Inheritance

builtins.object > proto.message.Message > BatchReadFeatureValuesRequest

Classes

EntityTypeSpec

EntityTypeSpec(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Selects Features of an EntityType to read values of and specifies read settings.

PassThroughField

PassThroughField(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Describe pass-through fields in read_instance source.