Comando DynamoDB Delete-Item

A operação DynamoDB Delete-Item é um dos utilitários mais usados ​​no gerenciamento do banco de dados. Ajuda a excluir um único item da sua tabela usando a chave primária. Notavelmente, este comando depende da API DynamoDB DeleteItem. Você pode invocar usando o comando CLI Delete-Item.

A execução de uma operação de exclusão condicional no DynamoDB remove os itens ou itens existentes com valores de atributo esperados. Depois de excluir um item, você também pode retornar os valores de atributo do item usando o parâmetro DynamoDB ReturnValues.

Este artigo se concentra na operação de delete-item no dynamoDB. Entre as áreas em que você deve aprender mais sobre incluir a sinopse de delete-itens, suas opções, a linha de comando e seu exemplo.

DynamoDB Delete-Item Operação Sinopse

A seguir, é apresentada uma sinopse completa da operação de delete-item:

apagar item
--Nome da tabela
--chave
[--esperado ]
[-Condicional-operador ]
[-Valores-retorno ]
[-capacidade consumida de retorno ]
[--return-item-collection-metrics ]
[-Condição-expressão ]
[-Expressão-atributo-nomes ]
[-Expressão-atributo-valores ]
[--cli-input-json ]
[-Generate-Cli-Skleton ]
[--depurar]
[--ndPoint-url ]
[--no-verify-ssl]
[--não-Paginate]
[--saída ]
[--consulta ]
[--perfil ]
[--região ]
[--versão ]
[--cor ]
[--não-sign-request]
[--Ca-Bundle ]
[--cli-read-timeout ]
[--cli-Connect-timeout ]

Opções de comando DynamoDB Delete-Item

A seguir, são apresentadas as principais opções para a operação de delete-item:

--Nome da tabela (string)

Esta opção especifica o nome da tabela do qual você deseja excluir um item.

--chave (mapa)

É um mapa que designa ou anexa os nomes de atributos aos respectivos objetos AttributeValue, representando a chave primária do item que você pretende excluir. Certifique -se de fornecer a chave primária completa.

Por exemplo, se o item tiver uma chave primária simples, você deverá fornecer uma chave de partição correspondente. Por outro lado, verifique se você fornece a chave da partição e a chave de classificação para itens com teclas primárias compostas.

--esperado (mapa)

A opção -esperada é um parâmetro legado. Você deve usar a expressão da condição em vez do parâmetro.

--operador condicional (string)

Este também é um parâmetro herdado e é aconselhável usar o parâmetro conditionExpression. Seus valores possíveis são e/ou.

--Valores de retorno (string)

Se você deseja os atributos do item que você pretende excluir como eles apareceram antes da operação de exclusão, verifique se você inclui o parâmetro de retorno valores. Os valores possíveis para o parâmetro de retorno valores quando usados ​​no comando Delete-Item são nenhum ou All_old.

Se você não especificar o parâmetro dos valores de retorno ou o colocar como nenhum, seu resultado não conterá nenhum atributo do item excluído. Idealmente, ninguém continua sendo a especificação padrão para este parâmetro. No entanto, uma especificação All_old no parâmetro de retorno durante uma operação de delete-item traz de volta o conteúdo do item antigo.

--capacidade consumida de retorno (string)

Este parâmetro determina a profundidade ou nível de detalhe sobre a demanda ou o consumo de rendimento provisionado de que sua resposta deve retornar. Os valores possíveis para esta opção incluem índices, total e nenhum.

Para índices, sua resposta deve incluir a capacidade de consumo agregada para sua operação, juntamente com a capacidade de consumo, que está associada a cada tabela e avaliou o índice secundário.

Por outro lado, as operações com a especificação total traz de volta as respostas que incluem apenas a capacidade de consumo agregada para o seu processo. Finalmente, os valores nenhum são as configurações padrão. Eles não recebem nenhum detalhe sobre a capacidade consumida de sua operação.

--Return-Item-Collection-Metrics (String)

O parâmetro -return-item-collection-Metrics determina se você precisa da resposta da coleta de itens na resposta. Você pode configurá -lo como tamanho ou nenhum, com a configuração de nenhuma sendo o padrão. Em uma configuração de tamanho, seu resultado retorna os detalhes sobre as coleções de itens, se houver algum detalhe.

--Expressão da condição (string)

Uma chamada de API DeleteItem não terá sucesso se o seu comando não satisfazer o requisito de expressão -condição. Esta expressão contém as funções, parâmetros de comparação e parâmetros lógicos.

Como usar a operação de exclusão de exclusão dynamoDB e seu exemplo

O comando DynamoDB Delete-Item exibe dois recursos notáveis. Primeiro, é uma operação idempotente que implica que, se você não especificar as condições, poderá executá -lo várias vezes no mesmo item ou atributo sem trazer de volta uma resposta de erro.

Segundo, o comando DynamoDB Delete-Item é uma operação de singleton. Esse recurso torna impossível executar um único comando enquanto visa excluir todas as linhas da sua mesa.

Um simples comando de exclusão-item deve ficar assim:

AWS DynamoDB Delete-Item \
--Música de nome de mesa \
--Arquivo de chave: // tecla.JSON \
--Valores de retorno all_old \
--Total de capacidade consumida de retorno \
--Tamanho do retorno-itens-colecionários

Uma resposta de amostra para o comando anterior é assim:

Conclusão

O comando DynamoDB Delete-Item desempenha um papel significativo na atualização de suas tabelas e indexos, pois exclui os itens deles. Embora este seja um comando da CLI, você pode excluir os itens das tabelas do DynamoDB usando o console de gerenciamento da AWS ou qualquer um dos sdks da AWS, como o BOTO3 para Python.