

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á.

# Gerenciar tabelas
<a name="working.manage-tables"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Esta seção descreve como gerenciar tabelas usando as instruções `DROP TABLE` e `UNDROP TABLE` no Amazon QLDB. Também descreve como marcar tabelas enquanto você as cria. As cotas para o número de tabelas ativas e o total de tabelas que você pode criar são definidas em [Cotas e limites no Amazon QLDB](limits.md#limits.fixed).

**Topics**
+ [

## Marcar tabelas na criação
](#working.manage-tables.tags)
+ [

## Eliminar tabelas
](#working.manage-tables.drop)
+ [

## Consultando o histórico de tabelas inativas
](#working.history.inactive-table)
+ [

## Reativando tabelas
](#working.history.undrop-table)

## Marcar tabelas na criação
<a name="working.manage-tables.tags"></a>

**nota**  
 Atualmente, a marcação de tabelas na criação é suportada apenas para ledgers no modo de permissões `STANDARD`. 

Você já pode marcar os recursos da tabela. Para gerenciar tags para tabelas existentes, use Console de gerenciamento da AWS ou as operações da API `TagResource`, `UntagResource` e `ListTagsForResource`. Para obter mais informações, consulte [Como marcar recursos do Amazon QLDB](tagging.md).

Você também pode definir tags de tabela ao criar a tabela usando o console do QLDB ou especificando-as em uma instrução `CREATE TABLE` de partiQL. O exemplo a seguir cria uma tabela chamada `Vehicle` com a tag `environment=production`.

```
CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'production'}`)
```

Ao marcar os recursos no momento da criação, você elimina a necessidade de executar scripts personalizados de marcação após a criação do recurso. Depois que uma tabela é marcada, você pode controlar o acesso à tabela com base nessas tags. Por exemplo, você pode conceder acesso total somente a tabelas que tenham uma tag específica. Para ver um exemplo de política JSON, consulte [Acesso total a todas as ações com base nas tags da tabela](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-full-tags).

## Eliminar tabelas
<a name="working.manage-tables.drop"></a>

Para eliminar uma tabela, use uma instrução básica [DESCARTAR TABELA](ql-reference.drop-table.md). Quando você coloca uma tabela no QLDB, você está apenas desativando-a.

Por exemplo, a instrução a seguir desativa a tabela `VehicleRegistration`.

```
DROP TABLE VehicleRegistration
```

Uma instrução `DROP TABLE` retorna o ID atribuído pelo sistema da nova tabela. O status de `VehicleRegistration` agora deve ser `INACTIVE` na tabela do catálogo do sistema [information\$1schema.user\$1tables](working.catalog.md).

```
SELECT status FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'
```

## Consultando o histórico de tabelas inativas
<a name="working.history.inactive-table"></a>

Além do nome da tabela, você também pode consultar o [Função de histórico](working.history.md#working.history.function) QLDB com um ID da tabela como primeiro argumento de entrada. Você deve usar o ID da tabela para consultar o histórico de uma tabela inativa. Depois que uma tabela é desativada, você não pode mais consultar seu histórico com o nome da tabela.

Primeiro, encontre o ID da tabela consultando a tabela do catálogo do sistema. Por exemplo, a consulta a seguir retorna o `tableId` da tabela `VehicleRegistration`.

```
SELECT tableId FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'
```

Em seguida, você pode usar esse ID para executar a mesma consulta de histórico de [Consultar o histórico de revisões](working.history.md). Veja a seguir um exemplo que consulta o histórico do ID do documento a `ADR2Ll1fGsU4Jr4EqTdnQF` partir do ID da tabela. `5PLf9SXwndd63lPaSIa0O6`. O ID da tabela é um literal de string que deve estar entre aspas simples.

```
--replace both the table and document IDs with your values
SELECT * FROM history('5PLf9SXwndd63lPaSIa0O6', `2000T`, `2019-06-05T23:59:59Z`) AS h
WHERE h.metadata.id = 'ADR2Ll1fGsU4Jr4EqTdnQF'
```

## Reativando tabelas
<a name="working.history.undrop-table"></a>

Depois de desativar uma tabela no QLDB, você pode usar a instrução [UNDROP TABLE](ql-reference.undrop-table.md) para reativá-la.

Primeiro, encontre o ID da tabela em `information_schema.user_tables`. Por exemplo, a consulta a seguir retorna o `tableId` da tabela `VehicleRegistration`. O status deveria ser `INACTIVE`.

```
SELECT tableId FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'
```

Em seguida, use esse ID para reativar a tabela. Veja a seguir um exemplo que *revela* o ID da tabla `5PLf9SXwndd63lPaSIa0O6`. Nesse caso, o ID da tabela é um identificador exclusivo que você coloca entre aspas duplas.

```
UNDROP TABLE "5PLf9SXwndd63lPaSIa0O6"
```

O status de agora `VehicleRegistration` deveria ser`ACTIVE`.

Para saber como criar, descrever e eliminar índices, vá para [Gerenciamento de Índices](working.manage-indexes.md).