Google Cloud Ai Platform V1 Client - Class BatchReadFeatureValuesRequest (0.11.1)

Version 0.11.1

• 1.11.0 (latest)
• 1.10.0
• 1.9.0
• 1.8.0
• 1.7.0
• 1.6.0
• 1.5.0
• 1.4.0
• 1.3.0
• 1.2.0
• 1.1.0
• 1.0.0
• 0.39.0
• 0.38.0
• 0.37.1
• 0.32.0
• 0.31.0
• 0.30.0
• 0.29.0
• 0.28.0
• 0.27.0
• 0.26.2
• 0.25.0
• 0.24.0
• 0.23.0
• 0.22.0
• 0.21.0
• 0.20.0
• 0.19.0
• 0.18.0
• 0.17.0
• 0.16.0
• 0.15.0
• 0.13.0
• 0.12.0
• 0.11.1
• 0.10.0

Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class BatchReadFeatureValuesRequest.

Request message for FeaturestoreService.BatchReadFeatureValues.

Generated from protobuf message google.cloud.aiplatform.v1.BatchReadFeatureValuesRequest

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ csv_read_instances	Google\Cloud\AIPlatform\V1\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.
↳ bigquery_read_instances	Google\Cloud\AIPlatform\V1\BigQuerySource Similar to csv_read_instances, but from BigQuery source.
↳ featurestore	string 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\FeatureValueDestination Required. Specifies output location and format.
↳ pass_through_fields	array<Google\Cloud\AIPlatform\V1\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	array<Google\Cloud\AIPlatform\V1\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 .
↳ start_time	Google\Protobuf\Timestamp Optional. Excludes Feature values with feature generation timestamp before this timestamp. If not set, retrieve oldest values kept in Feature Store. Timestamp, if present, must not have higher than millisecond precision.

getCsvReadInstances

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.

Returns
Type	Description
Google\Cloud\AIPlatform\V1\CsvSource|null

hasCsvReadInstances

setCsvReadInstances

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.

Parameter
Name	Description
var	Google\Cloud\AIPlatform\V1\CsvSource

Returns
Type	Description
$this

getBigqueryReadInstances

Similar to csv_read_instances, but from BigQuery source.

Returns
Type	Description
Google\Cloud\AIPlatform\V1\BigQuerySource|null

hasBigqueryReadInstances

setBigqueryReadInstances

Similar to csv_read_instances, but from BigQuery source.

Parameter
Name	Description
var	Google\Cloud\AIPlatform\V1\BigQuerySource

Returns
Type	Description
$this

getFeaturestore

Required. The resource name of the Featurestore from which to query Feature values.

Format: projects/{project}/locations/{location}/featurestores/{featurestore}

Returns
Type	Description
string

setFeaturestore

Required. The resource name of the Featurestore from which to query Feature values.

Format: projects/{project}/locations/{location}/featurestores/{featurestore}

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getDestination

Required. Specifies output location and format.

Returns
Type	Description
Google\Cloud\AIPlatform\V1\FeatureValueDestination|null

hasDestination

clearDestination

setDestination

Required. Specifies output location and format.

Parameter
Name	Description
var	Google\Cloud\AIPlatform\V1\FeatureValueDestination

Returns
Type	Description
$this

getPassThroughFields

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.

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setPassThroughFields

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.

Parameter
Name	Description
var	array<Google\Cloud\AIPlatform\V1\BatchReadFeatureValuesRequest\PassThroughField>

Returns
Type	Description
$this

getEntityTypeSpecs

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 .

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setEntityTypeSpecs

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 .

Parameter
Name	Description
var	array<Google\Cloud\AIPlatform\V1\BatchReadFeatureValuesRequest\EntityTypeSpec>

Returns
Type	Description
$this

getStartTime

Optional. Excludes Feature values with feature generation timestamp before this timestamp. If not set, retrieve oldest values kept in Feature Store.

Timestamp, if present, must not have higher than millisecond precision.

Returns
Type	Description
Google\Protobuf\Timestamp|null

hasStartTime

clearStartTime

setStartTime

Optional. Excludes Feature values with feature generation timestamp before this timestamp. If not set, retrieve oldest values kept in Feature Store.

Timestamp, if present, must not have higher than millisecond precision.

Parameter
Name	Description
var	Google\Protobuf\Timestamp

Returns
Type	Description
$this

getReadOption

Returns
Type	Description
string