# Excluir uma tabela do Amazon S3
<a name="s3-tables-delete"></a>

Você pode excluir uma tabela usando a API REST do Amazon S3, SDKs da AWS, a AWS Command Line Interface (AWS CLI) ou mecanismos de consulta integrados.

**nota**  
A funcionalidade Tabelas do S3 não é compatível com a operação `DROP TABLE` com `purge=false`. Algumas versões do Apache Spark sempre definem esse sinalizador como `false`, mesmo ao executar comandos `DROP TABLE PURGE`. Para excluir uma tabela, você pode tentar usar `DROP TABLE` novamente com `purge=true` ou usar a operação de API REST [https://docs.aws.amazon.com//AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html](https://docs.aws.amazon.com//AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html) da funcionalidade Tabelas do S3.

**Importante**  
 Ao excluir uma tabela, você precisa saber o seguinte:  
A exclusão de uma tabela é permanente e não pode ser desfeita. Antes de excluir uma tabela, verifique se você fez backup ou replicou todos os dados importantes.
Todos os dados e configurações associados à tabela são perdidos definitivamente.

## Como usar o AWS CLI
<a name="delete-table-CLI"></a>

Esse exemplo mostra como excluir uma tabela usando a AWS CLI. Para usar esse comando, substitua os `{{user input placeholders}}` por suas informações.

```
aws s3tables delete-table \
    --table-bucket-arn arn:aws:s3tables:{{us-east-1}}:{{111122223333}}:bucket/amzn-s3-demo-table-bucket \
    --namespace {{example_namespace}} --name {{example_table}}
```

## Usando um mecanismo de consulta
<a name="create-table-namespace-engine"></a>

Você pode excluir uma tabela em uma sessão do Apache Spark conectada aos buckets de tabela do Amazon S3.

Esse exemplo mostra como excluir uma tabela usando o comando `DROP TABLE PURGE`. Para usar o comando, substitua os `{{user input placeholders}}` por suas próprias informações.

```
spark.sql( 
" DROP TABLE [IF EXISTS] s3tablesbucket.{{example_namespace}}.{{example_table}} PURGE")
```