Excluir registros do seu grupo de atributos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Você pode usar a API Amazon SageMaker Feature Store para excluir registros de seus grupos de recursos. Um grupo de atributos é um objeto que contém seus dados de machine learning (ML), em que as colunas de seus dados são descritas por atributos e seus dados estão contidos em registros. Um registro contém valores para atributos associados a um identificador de registro específico.

Há duas configurações de armazenamento para seus grupos de atributos: o armazenamento on-line e o armazenamento offline. O armazenamento on-line mantém apenas o registro com a hora do evento mais recente e normalmente é usado para pesquisas em tempo real para inferência de ML. O armazenamento offline mantém todos os registros e atua como um banco de dados histórico e normalmente é usado para exploração de atributos, treinamento de ML e inferência em lote.

Para obter mais informações sobre os conceitos do Feature Store, consulte Diagramas de ingestão.

Há duas maneiras de excluir registros de seus grupos de atributos, e o comportamento é diferente dependendo da configuração de armazenamento. Nos tópicos a seguir, descreveremos como fazer exclusões de registros de forma temporária e definitiva dos armazenamentos on-line e offline e forneceremos exemplos.

Excluir registros do armazenamento on-line

Você pode excluir um registro do armazenamento on-line de forma temporária ou definitiva com a API DeleteRecord usando o parâmetro de solicitação DeletionMode para especificar SoftDelete (padrão) ou HardDelete. Para obter mais informações sobre a DeleteRecord API, consulte DeleteRecorda Amazon SageMaker API Reference.

Com o armazenamento on-line:

Em ambos os casos, o Feature Store anexa o marcador de registro excluído ao OfflineStore. O marcador de registro excluído é um registro com o mesmo RecordIdentifer que o original, mas com valor is_deleted definido como True, EventTime definido para a entrada de exclusão EventTime e outros valores de atributo definidos como null.

Observe que o EventTime especificado em DeleteRecord deve ser definido posteriormente ao EventTime do registro existente no OnlineStore para esse mesmo RecordIdentifer. Caso contrário, a exclusão não ocorrerá:

Os exemplos a seguir usam a operação delete_record do SDK para Python (Boto3) para excluir um registro de um grupo de atributos. Para excluir um registro de um grupo de atributos, você precisará:

Exemplo de exclusão temporária no armazenamento on-line

Para exclusões temporárias, você precisará usar a API DeleteRecord e poderá usar o padrão DeletionMode ou definir o DeletionMode como SoftDelete.

import boto3
client = boto3.client('sagemaker-featurestore-runtime')

client.delete_record(
    FeatureGroupName='feature-group-name',
    RecordIdentifierValueAsString='record-identifier-value',
    EventTime='deletion-event-time',
    TargetStores=[
        'OnlineStore',
    ],
    DeletionMode='SoftDelete'
)

Exemplo de exclusão irreversível do armazenamento on-line

Para exclusão irreversível, você precisará usar a API DeleteRecord e definir DeletionMode como HardDelete.

import boto3
client = boto3.client('sagemaker-featurestore-runtime')

client.delete_record(
    FeatureGroupName='feature-group-name',
    RecordIdentifierValueAsString='record-identifier-value',
    EventTime='deletion-event-timestamp',
    TargetStores=[
        'OnlineStore',
    ],
    DeletionMode='HardDelete'
)

Excluir registros do armazenamento offline

Com a Amazon SageMaker Feature Store, você pode excluir temporariamente ou não um registro do formato de tabela OfflineStore Iceberg. Com o formato de tabela Iceberg OfflineStore:

Obter o nome da sua tabela Iceberg

Para fazer exclusões temporárias e definitivas da sua tabela Iceberg OfflineStore, você precisará obter o nome da tabela Iceberg, iceberg-table-name. As instruções a seguir pressupõem que você já tenha usado o Feature Store para criar um grupo de atributos usando a configuração de armazenamento offline com o formato de tabela Iceberg, com DisableGlueTableCreation = False (padrão). Para obter mais informações sobre como criar um grupo de atributos, consulte Comece a usar a Amazon SageMaker Feature Store.

Para obter seu iceberg-table-name, use a API DescribeFeatureGroup para obter DataCatalogConfig. Ela contém os metadados de tabela do Glue, que servem como catálogo de dados para o OfflineStore. A TableName dentro da DataCatalogConfig é seu iceberg-table-name.

Exemplo de exclusão temporária e definitiva do armazenamento offline do Amazon Athena

As instruções a seguir usam o Amazon Athena para fazer exclusões temporárias e, em seguida, exclusões definitivas de um registro da tabela Iceberg OfflineStore. Isso pressupõe que o registro que você pretende excluir em seu OfflineStore é um marcador de registro excluído. Para obter informações sobre o marcador de registro excluído em seu OfflineStore, consulte Excluir registros do armazenamento on-line.

Exemplo de exclusão temporária e definitiva do armazenamento offline do Apache Spark

Para excluir temporariamente e, depois, definitivamente um registro da tabela Iceberg OfflineStore usando o Apache Spark, siga as mesmas instruções do Exemplo de exclusão temporária e definitiva do armazenamento offline do Amazon Athena acima, mas usando os procedimentos do Spark. Para obter uma lista completa de procedimentos, consulte Procedimentos do Spark na documentação do Apache Iceberg.