Gerenciar tabelas

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.

Marcar tabelas na criação

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 AWS Management Console ou as operações da API TagResource, UntagResource e ListTagsForResource. Para obter mais informações, consulte Como marcar recursos do Amazon QLDB.

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.

Eliminando tabelas

Para eliminar uma tabela, use uma instrução básica DROP TABLE. 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 a ID atribuída pelo sistema da nova tabela. O status de VehicleRegistration agora deve ser INACTIVE na tabela do catálogo do sistema information_schema.user_tables.

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

Consultando o histórico de tabelas inativas

Além do nome da tabela, você também pode consultar o Função de histórico 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 Consultando o histórico de revisões. Veja a seguir um exemplo que consulta o histórico da ID do documento a ADR2Ll1fGsU4Jr4EqTdnQF partir da 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

Depois de desativar uma tabela no QLDB, você pode usar a instrução UNDROP TABLE 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 serACTIVE.

Para saber como criar, descrever e eliminar índices, vá para Gerenciamento de índices.