Class BatchPredictionJob.InstanceConfig (3.25.0)

public static final class BatchPredictionJob.InstanceConfig extends GeneratedMessageV3 implements BatchPredictionJob.InstanceConfigOrBuilder

Configuration defining how to transform batch prediction input instances to the instances that the Model accepts.

Protobuf type google.cloud.aiplatform.v1.BatchPredictionJob.InstanceConfig

Inheritance

Object > AbstractMessageLite<MessageType,BuilderType> > AbstractMessage > GeneratedMessageV3 > BatchPredictionJob.InstanceConfig

Static Fields

EXCLUDED_FIELDS_FIELD_NUMBER

public static final int EXCLUDED_FIELDS_FIELD_NUMBER
Field Value
TypeDescription
int

INCLUDED_FIELDS_FIELD_NUMBER

public static final int INCLUDED_FIELDS_FIELD_NUMBER
Field Value
TypeDescription
int

INSTANCE_TYPE_FIELD_NUMBER

public static final int INSTANCE_TYPE_FIELD_NUMBER
Field Value
TypeDescription
int

KEY_FIELD_FIELD_NUMBER

public static final int KEY_FIELD_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static BatchPredictionJob.InstanceConfig getDefaultInstance()
Returns
TypeDescription
BatchPredictionJob.InstanceConfig

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static BatchPredictionJob.InstanceConfig.Builder newBuilder()
Returns
TypeDescription
BatchPredictionJob.InstanceConfig.Builder

newBuilder(BatchPredictionJob.InstanceConfig prototype)

public static BatchPredictionJob.InstanceConfig.Builder newBuilder(BatchPredictionJob.InstanceConfig prototype)
Parameter
NameDescription
prototypeBatchPredictionJob.InstanceConfig
Returns
TypeDescription
BatchPredictionJob.InstanceConfig.Builder

parseDelimitedFrom(InputStream input)

public static BatchPredictionJob.InstanceConfig parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static BatchPredictionJob.InstanceConfig parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static BatchPredictionJob.InstanceConfig parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static BatchPredictionJob.InstanceConfig parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static BatchPredictionJob.InstanceConfig parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static BatchPredictionJob.InstanceConfig parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static BatchPredictionJob.InstanceConfig parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static BatchPredictionJob.InstanceConfig parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static BatchPredictionJob.InstanceConfig parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static BatchPredictionJob.InstanceConfig parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static BatchPredictionJob.InstanceConfig parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static BatchPredictionJob.InstanceConfig parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
BatchPredictionJob.InstanceConfig
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<BatchPredictionJob.InstanceConfig> parser()
Returns
TypeDescription
Parser<InstanceConfig>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getDefaultInstanceForType()

public BatchPredictionJob.InstanceConfig getDefaultInstanceForType()
Returns
TypeDescription
BatchPredictionJob.InstanceConfig

getExcludedFields(int index)

public String getExcludedFields(int index)

Fields that will be excluded in the prediction instance that is sent to the Model.

Excluded will be attached to the batch prediction output if key_field is not specified.

When excluded_fields is populated, included_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string excluded_fields = 4;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The excludedFields at the given index.

getExcludedFieldsBytes(int index)

public ByteString getExcludedFieldsBytes(int index)

Fields that will be excluded in the prediction instance that is sent to the Model.

Excluded will be attached to the batch prediction output if key_field is not specified.

When excluded_fields is populated, included_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string excluded_fields = 4;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the excludedFields at the given index.

getExcludedFieldsCount()

public int getExcludedFieldsCount()

Fields that will be excluded in the prediction instance that is sent to the Model.

Excluded will be attached to the batch prediction output if key_field is not specified.

When excluded_fields is populated, included_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string excluded_fields = 4;

Returns
TypeDescription
int

The count of excludedFields.

getExcludedFieldsList()

public ProtocolStringList getExcludedFieldsList()

Fields that will be excluded in the prediction instance that is sent to the Model.

Excluded will be attached to the batch prediction output if key_field is not specified.

When excluded_fields is populated, included_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string excluded_fields = 4;

Returns
TypeDescription
ProtocolStringList

A list containing the excludedFields.

getIncludedFields(int index)

public String getIncludedFields(int index)

Fields that will be included in the prediction instance that is sent to the Model.

If instance_type is array, the order of field names in included_fields also determines the order of the values in the array.

When included_fields is populated, excluded_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string included_fields = 3;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The includedFields at the given index.

getIncludedFieldsBytes(int index)

public ByteString getIncludedFieldsBytes(int index)

Fields that will be included in the prediction instance that is sent to the Model.

If instance_type is array, the order of field names in included_fields also determines the order of the values in the array.

When included_fields is populated, excluded_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string included_fields = 3;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the includedFields at the given index.

getIncludedFieldsCount()

public int getIncludedFieldsCount()

Fields that will be included in the prediction instance that is sent to the Model.

If instance_type is array, the order of field names in included_fields also determines the order of the values in the array.

When included_fields is populated, excluded_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string included_fields = 3;

Returns
TypeDescription
int

The count of includedFields.

getIncludedFieldsList()

public ProtocolStringList getIncludedFieldsList()

Fields that will be included in the prediction instance that is sent to the Model.

If instance_type is array, the order of field names in included_fields also determines the order of the values in the array.

When included_fields is populated, excluded_fields must be empty.

The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

repeated string included_fields = 3;

Returns
TypeDescription
ProtocolStringList

A list containing the includedFields.

getInstanceType()

public String getInstanceType()

The format of the instance that the Model accepts. Vertex AI will convert compatible batch prediction input instance formats to the specified format.

Supported values are:

  • object: Each input is converted to JSON object format.

    • For bigquery, each row is converted to an object.
    • For jsonl, each line of the JSONL input must be an object.
    • Does not apply to csv, file-list, tf-record, or tf-record-gzip.
  • array: Each input is converted to JSON array format.

    • For bigquery, each row is converted to an array. The order of columns is determined by the BigQuery column order, unless included_fields is populated. included_fields must be populated for specifying field orders.
    • For jsonl, if each line of the JSONL input is an object, included_fields must be populated for specifying field orders.
    • Does not apply to csv, file-list, tf-record, or tf-record-gzip.

    If not specified, Vertex AI converts the batch prediction input as follows:

    • For bigquery and csv, the behavior is the same as array. The order of columns is the same as defined in the file or table, unless included_fields is populated.
    • For jsonl, the prediction instance format is determined by each line of the input.
    • For tf-record/tf-record-gzip, each record will be converted to an object in the format of {"b64": <value>}, where <value> is the Base64-encoded string of the content of the record.
    • For file-list, each file in the list will be converted to an object in the format of {"b64": <value>}, where <value> is the Base64-encoded string of the content of the file.

string instance_type = 1;

Returns
TypeDescription
String

The instanceType.

getInstanceTypeBytes()

public ByteString getInstanceTypeBytes()

The format of the instance that the Model accepts. Vertex AI will convert compatible batch prediction input instance formats to the specified format.

Supported values are:

  • object: Each input is converted to JSON object format.

    • For bigquery, each row is converted to an object.
    • For jsonl, each line of the JSONL input must be an object.
    • Does not apply to csv, file-list, tf-record, or tf-record-gzip.
  • array: Each input is converted to JSON array format.

    • For bigquery, each row is converted to an array. The order of columns is determined by the BigQuery column order, unless included_fields is populated. included_fields must be populated for specifying field orders.
    • For jsonl, if each line of the JSONL input is an object, included_fields must be populated for specifying field orders.
    • Does not apply to csv, file-list, tf-record, or tf-record-gzip.

    If not specified, Vertex AI converts the batch prediction input as follows:

    • For bigquery and csv, the behavior is the same as array. The order of columns is the same as defined in the file or table, unless included_fields is populated.
    • For jsonl, the prediction instance format is determined by each line of the input.
    • For tf-record/tf-record-gzip, each record will be converted to an object in the format of {"b64": <value>}, where <value> is the Base64-encoded string of the content of the record.
    • For file-list, each file in the list will be converted to an object in the format of {"b64": <value>}, where <value> is the Base64-encoded string of the content of the file.

string instance_type = 1;

Returns
TypeDescription
ByteString

The bytes for instanceType.

getKeyField()

public String getKeyField()

The name of the field that is considered as a key.

The values identified by the key field is not included in the transformed instances that is sent to the Model. This is similar to specifying this name of the field in excluded_fields. In addition, the batch prediction output will not include the instances. Instead the output will only include the value of the key field, in a field named key in the output:

  • For jsonl output format, the output will have a key field instead of the instance field.
  • For csv/bigquery output format, the output will have have a key column instead of the instance feature columns.

    The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

string key_field = 2;

Returns
TypeDescription
String

The keyField.

getKeyFieldBytes()

public ByteString getKeyFieldBytes()

The name of the field that is considered as a key.

The values identified by the key field is not included in the transformed instances that is sent to the Model. This is similar to specifying this name of the field in excluded_fields. In addition, the batch prediction output will not include the instances. Instead the output will only include the value of the key field, in a field named key in the output:

  • For jsonl output format, the output will have a key field instead of the instance field.
  • For csv/bigquery output format, the output will have have a key column instead of the instance feature columns.

    The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord.

string key_field = 2;

Returns
TypeDescription
ByteString

The bytes for keyField.

getParserForType()

public Parser<BatchPredictionJob.InstanceConfig> getParserForType()
Returns
TypeDescription
Parser<InstanceConfig>
Overrides

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public BatchPredictionJob.InstanceConfig.Builder newBuilderForType()
Returns
TypeDescription
BatchPredictionJob.InstanceConfig.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected BatchPredictionJob.InstanceConfig.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
BatchPredictionJob.InstanceConfig.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public BatchPredictionJob.InstanceConfig.Builder toBuilder()
Returns
TypeDescription
BatchPredictionJob.InstanceConfig.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException