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á.
REDACT_ procedimento REVISION armazenado na Amazon QLDB
Importante
Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre
nota
No momento, todos os ledgers criados antes de 22 de julho de 2021 não são elegíveis para edição. Você pode ver a hora de criação do seu livro contábil no QLDB console da Amazon.
Na AmazonQLDB, use o procedimento REDACT_REVISION armazenado para excluir permanentemente uma revisão de documento individual e inativa no armazenamento indexado e no armazenamento de diário. Esse procedimento armazenado exclui todos os dados do usuário na revisão especificada. No entanto, deixa a sequência do diário e os metadados do documento, incluindo o ID e o hash do documento, inalterados. Essa operação é irreversível.
A revisão do documento especificada deve ser uma revisão inativa no histórico. A revisão ativa mais recente de um documento não está qualificada para redação.
Depois de enviar uma solicitação de redação executando esse procedimento armazenado, QLDB processa a redação dos dados de forma assíncrona. Depois que a redação for concluída, os dados do usuário na revisão especificada (representados pela estrutura data) são substituídos por um novo campo dataHash. O valor desse campo é o hash de Amazon Ion da estrutura data removida. Como resultado, o livro mantém a integridade geral dos dados e permanece criptograficamente verificável por meio das operações de verificação existentes. API
Para ver um exemplo de uma operação de edição com dados de exemplo, consulte Exemplo de redação em Redigir revisões de documentos.
nota
Para aprender a controlar o acesso para executar este comando do PartiQL em tabelas específicas, consulte Introdução ao modo de permissões padrão na Amazon QLDB.
Considerações e limitações de edição
Antes de começar com a redação de dados na AmazonQLDB, certifique-se de analisar as seguintes considerações e limitações:
-
O procedimento
REDACT_REVISIONarmazenado tem como alvo os dados do usuário em uma revisão de documento individual e inativa. Para editar várias revisões, você deve executar o procedimento armazenado uma vez para cada revisão. Você pode editar uma revisão por transação. -
Para redigir campos específicos em uma revisão de documento, você deve usar uma instrução separada de linguagem de manipulação de dados (DML) para modificar a revisão primeiro. Para ter mais informações, consulte Editar um campo específico em uma revisão.
-
Depois de QLDB receber uma solicitação de redação, você não poderá cancelar nem alterar a solicitação. Para confirmar se uma edição foi concluída, você pode verificar se a estrutura
datade uma revisão foi substituída por um campodataHash. Para saber mais, consulte Verificar se uma redação está completa. -
A redação não tem impacto em nenhum QLDB dado que seja replicado fora do QLDB serviço. Isso inclui todas as exportações para o Amazon S3 e fluxos para o Amazon Kinesis Data Streams. Você deve usar outros métodos de retenção de dados para gerenciar quaisquer dados armazenados fora doQLDB.
-
A edição não tem impacto nos valores literais em instruções partiQL que são registradas no diário. Como prática recomendada, você deve executar instruções parametrizadas de forma programática usando espaços reservados de variáveis em vez de valores literais. Um espaço reservado é escrito no diário como um ponto de interrogação (
?) em vez de qualquer informação confidencial que possa exigir edição.Para aprender a executar programaticamente instruções partiQL usando o QLDB driver, consulte os tutoriais de cada linguagem de programação compatível em. Conceitos básicos do driver
Sintaxe
EXEC REDACT_REVISION `block-address`, 'table-id', 'document-id'
Argumentos
- `
block-address` -
A localização do bloco de diário da revisão do documento a ser editada. Um endereço é uma estrutura Amazon Ion que tem dois campos:
strandIdesequenceNo.Esse é um valor literal de Ion indicado por acentos graves. Por exemplo: .
`{strandId:"JdxjkR9bSYB5jMHWcI464T", sequenceNo:17}`Para saber como encontrar o endereço do bloco, consulte Consultar metadados do documento.
- '
table-id' -
O ID exclusivo da tabela cuja revisão do documento você deseja redigir, indicada por aspas simples.
Para saber como encontrar o ID da tabela, consulte Consultar o catálogo do sistema.
- '
document-id' -
O ID exclusivo do documento cuja revisão será redigida, indicada por aspas simples.
Para saber como encontrar o ID do documento, consulte Consultar metadados do documento.
Valor de retorno
Uma estrutura Amazon Ion que representa a revisão do documento a ser editada, no seguinte formato.
{
blockAddress: {
strandId: String,
sequenceNo: Int
},
tableId: String,
documentId: String,
version: Int
}Campos da estrutura de retorno
-
blockAddress: a localização do bloco de diário da revisão a ser editada. Um endereço tem os dois campos a seguir:-
strandId: o ID exclusivo da cadeia do diário que contém o bloco. -
sequenceNo: o número do índice que especifica a localização do bloco dentro da cadeia.
-
-
tableId: o ID exclusivo da tabela cuja revisão você está editando. -
documentId: o ID exclusivo do documento da revisão a ser editada. -
version: o número da versão do documento da revisão a ser editada.
Veja a seguir um exemplo da estrutura de retorno com dados de exemplo.
{
blockAddress: {
strandId: "CsRnx0RDoNK6ANEEePa1ov",
sequenceNo: 134
},
tableId: "6GZumdHggklLdMGyQq9DNX",
documentId: "IXlQPSbfyKMIIsygePeKrZ",
version: 0
}Exemplos
EXEC REDACT_REVISION `{strandId:"7z2P0AyQKWD8oFYmGNhi8D", sequenceNo:7}`, '8F0TPCmdNQ6JTRpiLj2TmW', '05K8zpGYWynDlEOK5afDRc'
