Consultando o catálogo do sistema

Cada tabela que você cria em um livro contábil do Amazon QLDB tem uma ID exclusiva atribuída pelo sistema. Você pode encontrar o ID de uma tabela, sua lista de índices e outros metadados consultando a tabela information_schema.user_tables do catálogo do sistema.

Todos os IDs atribuídos pelo sistema no QLDB são identificadores universalmente exclusivos (UUID), cada um representado em uma string codificada em Base62. Para obter mais informações, consulte IDs exclusivos no Amazon QLDB.

O exemplo a seguir mostra os resultados de uma consulta que retorna atributos de metadados da tabela VehicleRegistration.

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

{
    tableId: "5PLf9SXwndd63lPaSIa0O6",
    name: "VehicleRegistration",
    indexes: [
        { indexId: "Djg2nt0yIs2GY0T29Kud1z", expr: "[VIN]", status: "ONLINE" },
        { indexId: "4tPW3fUhaVhDinRgKRLhGU", expr: "[LicensePlateNumber]", status: "BUILDING" }
    ],
    status: "ACTIVE"
}

Campos de metadados de tabelas

• tableId – O ID exclusivo da tabela.

• name – O nome da tabela.

• indexes— A lista de índices na tabela.

  • indexId – O ID exclusivo do índice.

  • expr — O caminho do documento indexado. Esse campo é uma string no formato: [fieldName].

  • status— O status atual do índice (BUILDING, FINALIZING, ONLINE, FAILED ouDELETING). O QLDB não usa o índice em consultas até que o status seja ONLINE.

  • message— A mensagem de erro que descreve o motivo pelo qual o índice tem um status FAILED. Esse campo só é incluído para índices com falha.

• status— O status atual da tabela (ACTIVE ou INACTIVE). Uma tabela se torna INACTIVE quando você a DROP.

Para saber como gerenciar tabelas usando as instruções DROP TABLE e UNDROP TABLE, vá para Gerenciar tabelas.