@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAmazonSageMakerFeatureStoreRuntime extends Object implements AmazonSageMakerFeatureStoreRuntime
AmazonSageMakerFeatureStoreRuntime
. Convenient method forms pass through to the
corresponding overload that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
BatchGetRecordResult |
batchGetRecord(BatchGetRecordRequest request)
Retrieves a batch of
Records from a FeatureGroup . |
DeleteRecordResult |
deleteRecord(DeleteRecordRequest request)
Deletes a
Record from a FeatureGroup in the OnlineStore . |
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetRecordResult |
getRecord(GetRecordRequest request)
Use for
OnlineStore serving from a FeatureStore . |
PutRecordResult |
putRecord(PutRecordRequest request)
The
PutRecord API is used to ingest a list of Records into your feature group. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
public BatchGetRecordResult batchGetRecord(BatchGetRecordRequest request)
AmazonSageMakerFeatureStoreRuntime
Retrieves a batch of Records
from a FeatureGroup
.
batchGetRecord
in interface AmazonSageMakerFeatureStoreRuntime
public DeleteRecordResult deleteRecord(DeleteRecordRequest request)
AmazonSageMakerFeatureStoreRuntime
Deletes a Record
from a FeatureGroup
in the OnlineStore
. Feature Store
supports both SoftDelete
and HardDelete
. For SoftDelete
(default), feature
columns are set to null
and the record is no longer retrievable by GetRecord
or
BatchGetRecord
. For HardDelete
, the complete Record
is removed from the
OnlineStore
. In both cases, Feature Store appends the deleted record marker to the
OfflineStore
. The deleted record marker is a record with the same RecordIdentifer
as
the original, but with is_deleted
value set to True
, EventTime
set to the
delete input EventTime
, and other feature values set to null
.
Note that the EventTime
specified in DeleteRecord
should be set later than the
EventTime
of the existing record in the OnlineStore
for that
RecordIdentifer
. If it is not, the deletion does not occur:
For SoftDelete
, the existing (not deleted) record remains in the OnlineStore
, though
the delete record marker is still written to the OfflineStore
.
HardDelete
returns EventTime
: 400 ValidationException
to indicate that the
delete operation failed. No delete record marker is written to the OfflineStore
.
When a record is deleted from the OnlineStore
, the deleted record marker is appended to the
OfflineStore
. If you have the Iceberg table format enabled for your OfflineStore
, you
can remove all history of a record from the OfflineStore
using Amazon Athena or Apache Spark. For
information on how to hard delete a record from the OfflineStore
with the Iceberg table format
enabled, see Delete records from the offline store.
deleteRecord
in interface AmazonSageMakerFeatureStoreRuntime
public GetRecordResult getRecord(GetRecordRequest request)
AmazonSageMakerFeatureStoreRuntime
Use for OnlineStore
serving from a FeatureStore
. Only the latest records stored in the
OnlineStore
can be retrieved. If no Record with RecordIdentifierValue
is found, then an
empty result is returned.
getRecord
in interface AmazonSageMakerFeatureStoreRuntime
public PutRecordResult putRecord(PutRecordRequest request)
AmazonSageMakerFeatureStoreRuntime
The PutRecord
API is used to ingest a list of Records
into your feature group.
If a new record’s EventTime
is greater, the new record is written to both the
OnlineStore
and OfflineStore
. Otherwise, the record is a historic record and it is
written only to the OfflineStore
.
You can specify the ingestion to be applied to the OnlineStore
, OfflineStore
, or both
by using the TargetStores
request parameter.
You can set the ingested record to expire at a given time to live (TTL) duration after the record’s event time,
ExpiresAt
= EventTime
+ TtlDuration
, by specifying the
TtlDuration
parameter. A record level TtlDuration
is set when specifying the
TtlDuration
parameter using the PutRecord
API call. If the input
TtlDuration
is null
or unspecified, TtlDuration
is set to the default
feature group level TtlDuration
. A record level TtlDuration
supersedes the group level
TtlDuration
.
putRecord
in interface AmazonSageMakerFeatureStoreRuntime
public void shutdown()
AmazonSageMakerFeatureStoreRuntime
shutdown
in interface AmazonSageMakerFeatureStoreRuntime
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonSageMakerFeatureStoreRuntime
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AmazonSageMakerFeatureStoreRuntime
request
- The originally executed request.